|
| Über das Tool |
Das Tool ist ein reines Kommandozeilenprogramm.
Es ist dazu gedacht Funktionen auszuführen, die mit Boardmitteln der Eingabeaufforderung nicht oder nur sehr umständlich ausgeführt werden könnten.
Es diente ursprünglich dazu in Batchdateien Zeitangaben auszugeben, was beispielsweise für Logdateien hilfreich ist, die von einer Batchdatei erzeugt werden.
Die Formatierung der Datums- und Zeitausgabe ist beliebig anpassbar, was auch der eigentliche Existenzgrund des Tools war, denn date /t und time /t sind zu unflexibel, denn deren Ausgabe in Batchdateien umzuformatieren ist leider recht aufwändig.
Dazu kamen aber weitere Funktionen, wie z.B. externe Befehle starten und deren Rückgaben auslesen, Berechnungen und Stringoperationen ausführen, Systemversionsinformationen auslesen, Fallunterscheidungen treffen, Textdateien lesen und schreiben, Skriptdateien nutzen und einiges mehr.
Das Tool kann natürlich auch außerhalb von Batchdateien in einer Eingabeaufforderung von Hand ausgeführt und genutzt werden
und es kann mehr, als nur zu sagen wie spät es ist.
|
| Systemvoraussetzungen |
- Windows XP oder höher
- .Net Framework 3.5
|
| Installation |
Eine Installation ist nicht notwendig.
Das Tool besteht lediglich aus einer einzelnen Exe-Datei, die direkt ausgeführt werden kann.
"Pedate" ist zweisprachig (Deutsch, Englisch). Die Programmsprache richtet sich nach der Systemsprache oder nach Benutzervorgabe.
|
| Hauptfunktionsmerkmale |
• eine einzelne, portable exe-Datei, die Deutsch und Englisch unterstützt
• beliebig formatierte Datum/Zeit-Ausgabe
• aktuelles Datum/Zeit oder gemäß Eingabe
• Erkennung von "beliebig" formatierten Datum/Zeit-Eingaben
• Datum/Zeit-Ein- und -Ausgabe in "beliebigen" Sprachen
• Datum/Zeit-Verschiebungen und Berechnungen
• Berechnung des Osterdatums (West und Ost) und des Adventdatums
• Start externer Programme mit optionaler Auswerten der Rückgabe
• Taschenrechner (Zeitspannen, Wurzeln, Potenzen, Winkelfunktionen, Modulo, Zahlensysteme u.a.)
• diverse Zeichenfolgeoperationen
• Fallunterscheidungen (If-Abfragen)
• Verzweigungen und Schleifen per goto-Anweisungen
• frei zuzuordnende Variablen (Memoryfunktion)
• Parameter von der Konsole und/oder aus Skritpdatei(en) einlesen
• Inhalte einer Textdatei einlesen
• Ausgabe in der Konsole und/oder in eine Textdatei
• Integration in Batchdateien
• detaillierte Versionsinformationsausgabe zur momentanen Windows-Version
• detaillierte Versionsinformationsausgabe der installierten .Net-Framework-Versionen
• Ausgabe der belegten und verfügbaren Speicherplatzgrößen der Festplatten
• Übersicht der wesentlichen Hardware-Komponenten
• Auslesen von Dateieigenschaften
• ausführliche, interne Hilfefunktion
|
| Konzept |
Pedate dient primär dazu Ausgaben zu generieren.
Um die Ausgaben individuell gestalten zu können, können Schalter und Platzhalter in Kombination mit Freitext als Parameter angegeben werden.
Alle Parameter werden in der Reihenfolge links nach rechts abgearbeitet.
Steuerungsparameter (Schalter) beginnen in der Regel mit /
Ausgabeparameter (Platzhalter) beginnen in der Regel mit ~
Alle anderen Parameter werden als Freitext behandelt und unverändert ausgegeben.
Wird kein Parameter angegeben, so wird ein aktueller Zeitstempel ausgegeben.
Siehe: Pedate ~time-stamp ?
Prinzipielles zur Ausgabe: Pedate /clear ?
|
| Exit-Codes |
Pedate setzt nach seiner Ausführung einen Exit-Code (errorlevel):
0 = Ablauf ohne erkannten Fehler beendet
1 = Die Hilfe wurde aufgerufen
2 = Der Schalter /end wurde angewendet
3 = Parameterfehler oder Fehler bei der Ausführung
|
| Hilfe nutzen |
Die generelle Hilfe ist mit /? abrufbar.
Eine detaillierte Hilfe zu einzelnen Parametern ist aufrufbar, indem der fragliche Parameter, gefolgt von einem ? eingegeben wird.
Beispiele:
Pedate /d ? => Hilfe zum Schalter /d
Pedate /l de /d ? => deutsche Hilfe zum Schalter /d
Pedate /l en /d ? => englische Hilfe zum Schalter /d
Beim Aufruf der Hilfe per /? oder ? werden alle anderen Parameter (außer /l de|en) ignoriert.
/? hat Vorrang gegenüber ? und weiter links stehende ? haben Vorrang gegenüber weiter rechts stehenden.
Dieses Verhalten dient dazu in einer Befehlszeile, schnell an geeigneter Stelle ein ? oder /? einfügen zu können und die gewünschte Hilfe zu erhalten ohne dass die Befehlszeile ausgeführt wird.
Beispiele:
Pedate /d 07.03.1966 Der ~date war ein ~dddd. => Der 07.03.1966 war ein Montag.
Pedate /d 07.03.1966 Der ~date ? war ein ~dddd. => Hilfe zum Platzhalter ~date wird ausgegeben
Pedate /d ? 07.03.1966 Der ~date ? war ein ~dddd. => Hilfe zum Schalter /d wird ausgegeben
Pedate /d ? 07.03.1966 Der ~date /? war ein ~dddd. => Die generelle Hilfe wird ausgegeben
Die komplette interne Hilfe kann in eine Text Datei ausgegeben werden, die dann als Handbuch genutzt werden kann.
Das geht mit Pedate /helpfile
Näheres dazu mit Pedate /helpfile ?
(Diese Hilfedatei steht weiter unten auch als Download zur Verfügung.)
|
| Groß-Kleinschreibung |
Bei Freitext bleibt die Schreibweise erhalten.
Bei Platzhaltern wird die Schreibweise weitgehend ignoriert.
Ausnahmen: ~t, ~T, ~tt, ~TT, ~a, ~A, ~am, ~AM, ~p, ~P, ~pm, ~PM und alle kombinierbaren Platzhalter, Bsp.: ~ddMMyyyy
Bei Schaltern wird die Schreibweise ignoriert.
|
| Anwendungsbeispiele |
In der jeweiligen, detaillierten Hilfe finden sich konkrete Anwendungsbeispiele.
|
| Fehlervermeidung |
Zur Vermeidung von Fehlern, bei komplexeren Parameterfolgen, kann zur Diagnose /list verwendet werden.
Siehe: Pedate /list ?
|
| Einstieg |
1. Die generelle Hilfe lesen: Pedate /?
2. Übersicht aller Schalter anzeigen lassen: Pedate / ?
3. Übersicht aller Platzhalter anzeigen lassen: Pedate ~ ?
4. Detaillierte Hilfe nutzen: Pedate /Schalter ? und Pedate ~Platzhalter ?
5. Hilfedatei erzeugen und lesen: Pedate /helpfile
6. Frag Pedant per E-Mail
|
| Lizenz |
"Pedate" ist Freeware und darf ohne Einschränkung benutzt werden.
Für die Benutzung und deren Folgen lehne ich jegliche Haftung ab.
Eine Onlineverbreitung per Download behalte ich mir als Recht vor.
|
| Download |
Aktuelle Version:
Pedate (Version 4.3) | Hilfedatei zur Version 4.3
Vorgängerversionen:
Pedate (Version 4.2)
Pedate (Version 4.1)
Pedate (Version 4.0)
Pedate (Version 3.2)
Pedate (Version 3.1)
Pedate (Version 3.0)
Pedate (Version 2.1)
Pedate (Version 2.0)
Zeitausgabe (Version 1.6)
Zeitausgabe (Version 1.5)
Zeitausgabe (Version 1.4)
Zeitausgabe (Version 1.3)
Zeitausgabe (Version 1.2)
Zeitausgabe (Version 1.0)
|
| Changelog |
| Version 4.3: | Einführung des Parameters /fobj und der Platzhalter fobj... (Dateieigenschaften auslesen (Größe und Datum)) • Ein paar Bugfixes |
| Version 4.2: | Einführung der Platzhalter bios und biosversion (Informationen über das Bios der Hauptplatine) |
| Version 4.1: | Einführung der Rechenarten c2i (Character zu Ganzzahl), c2h (Character zu Hexadezimal), i2c (Ganzzahl zu Character) und h2c (Hexadecimal zu Character) • Einführung des Parameters /vo als kleinere Variante von /v |
| Version 4.0: | Neu eingeführt: Stringoperationen • Textdatei lesen und schreiben • optionale Verwendung von Skriptdateien • Verzweigungen und Schleifen mit /goto
Änderungen: Umbenennung von \t zu °t und \n zu °n • Änderung der Codepage für zavars.cmd bei /v |
| Version 3.2: | Einführung der Rechenarten s2d (String zu Dezimal) und s2i (String zu Ganzzahl) beim Taschenrechner • Einführung eigener Exit-Codes (errorlevel) bei /end code |
| Version 3.1: | Einführung einer Zeitspannenberechnungsfunktion beim Taschenrechner |
| Version 3.0: | Komplette Änderung des Programmablaufs • Einführung diverser neuer Parameter und Funktionen |
| Version 2.1: | Einführung des Parameters /u • Bugfix bei der Ausgabe des Platzhalters ~unix |
| Version 2.0: | Umbenennung des Tools • Umbenennung vieler Platzhalter, Parameter und za-Variablen • Zweisprachigkeit (de/en) • Einführung des Parameters \t • Ein paar Bugfixes |
| Version 1.6: | Einführung der Platzhalter usdatumzeit, usdatum und uszeit • Ein paar Bugfixes |
| Version 1.5: | Einführung der Parameter /dv und /zv und \n • Ein paar Bugfixes • Flexibleres Format für Angaben bei /d und /z |
| Version 1.4: | Umstellung des Ausgabeformats von zeit-stempel: jetzt yyyy-MM-dd_HHmmss (zuvor yyyy-MM-dd-HHmmss) |
| Version 1.3: | Einführung des Parameters /b • Ein paar kleine Bugfixes • Umbenennung des Parameters zur Zeitvorgabe: jetzt /z (zuvor /t) |
| Version 1.2: | Einführung des Parameters /v |
| Version 1.0: | Erste Veröffentlichung |
|
| Bekannte Fehler in Version 4.3 |
bisher keine
|