_________________________________________________________________
DateTime v1.35
~~~~~~~~~~~~~~~~
Datum und Uhrzeit in Batch-Dateien auswerten
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
_________________________________________________________________
Copyright (c) 1990-95
~~~~~~~~~~~~~~~~~~~~~~~~~
DFG / M.Watermann, D-30177 Hannover
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
\\/////
^ ^
( o - )
I
\_/
v
________________________________________________________________
DateTime v1.35 Datum und Uhrzeit in Batch-Dateien auswerten
Inhalt
========
I. Vor-Wort ............................................ 2
II. Anwendung ........................................... 3
III. GetDate / GetTime ................................... 5
IV. Techn. Hintergrund-Informationen .................... 6
V. Nutzungs-Bedingungen ................................ 7
VI. Entwicklungs-Geschichte ............................. 9
Schluß is auf Seite ...................................... 10
DateTime.Txt, Seite 1
DateTime v1.35 Datum und Uhrzeit in Batch-Dateien auswerten
I. Vor-Wort
=============
Diese Programme sind Shareware-Produkte. Shareware ("Anwender-
unterstützte" Software) ist eine Vertriebs-Methode, nicht ein Typ
von Software. Mit Shareware haben Sie die ultimative Geld-zurück-
Garantie: Falls Sie das Produkt nicht benutzen, bezahlen Sie halt
auch nichts dafür.
"Shareware" ist - entgegen einem in Deutschland weitverbreiteten
Mißverständnis - keine freie Software ("Freeware"). Copyright und
Urheber-Gesetze gelten für beides, Shareware wie auch
kommerzielle Software, und die Copyright-Inhaber behalten alle
Rechte, mit einigen spezifischen Ausnahmen wie sie hier angegeben
sind. Shareware-Autoren sind ausgezeichnete Programmierer, gerade
so wie kommerzielle Autoren, und die Programme sind von
vergleichbarer Qualität. (In beiden Fälle werden Sie sowohl gute
Programme wie schlechte finden!) Der Haupt-Unterschied besteht in
der Methode der Verteilung. Der Autor gibt Ihnen speziell das
Recht, die Erprobungs-Version der Software zu kopieren und an
jedermann zu verteilen, so lange für den Vertrieb der Software
keine Vergütung erwartet wird.
Der Vertrieb eines Programmes als Shareware gibt dem Anwender die
Gelegenheit, die Software zu testen, bevor er sie kauft. Wenn Sie
ein Shareware-Programm erprobt haben und es dann weiter benutzen
möchten, sind Sie verpflichtet, die Software beim Autor
registrieren zu lassen. Mit der Registrierung erhalten Sie die
letzte Version der Software ohne "[unregistered]"-Vermerk und
ähnliche Botschaften. Mit Shareware sind Sie in der Lage, die
Software auf Ihrem Computer mit Ihren eigenen Einstellungen und
Peripherie-Geräten zu testen - der einzige Weg zu erfahren, ob es
mit Ihrer eigenen Austattung funktionieren wird. Nach Ihrer
Entscheidung, ob dieses Programm ein Software-Produkt ist, mit
dem Sie arbeiten wollen, dann - und nur dann - bezahlen Sie
dafür: das endgültige Vertrauen durch den Autor! Sobald Sie für
das Programm bezahlen, zahlen Sie auch nur für die Software und
nicht für eine Ankündigung der Software, die oft schon allein
soviel kostet wie die Software selbst und nicht selten bloße
Verheißung bleibt.
DateTime.Txt, Seite 2
DateTime v1.35 Datum und Uhrzeit in Batch-Dateien auswerten
II. Anwendung
===============
Zuweilen möchte man Programme nur aufrufen, wenn eine bestimmte
Uhrzeit ein Wochentag oder ein bestimmtes Datum erreicht ist. DOS
läßt einen mit solchen Wünschen ziemlich allein. Die hier
zusammengestellten Programme nun sollen diesem Umstand abhelfen.
DateTime.EXE ermöglicht Ihnen, in Stapeldateien Datum und Uhrzeit
Ihrer Systemuhr auszuwerten.
Aufruf:
________
DateTime [/?] [/A+|-] [/J] [/M] [/T] [/W] [/S] [/I] [/E]
Je nach benötigter Information und verwendetem Parameter
terminiert das Programm mit einem anderen Errorlevel, den Sie
dann abfragen können:
/J aktuelles [J]ahr [0 .. 99]
/M aktueller [M]onat [1 .. 12]
/T aktuelles [T]agesdatum [1 .. 31]
/W aktueller [W]ochentag [1 .. 7]
/S aktuelle [S]tunde [0 .. 24]
/I aktuelle M[i]nute [0 .. 59]
/E aktuelle S[e]kunde [0 .. 59]
Bei Angabe mehrerer Parameter wird lediglich der =letzte=
ausgeführt. Der Aufruf ohne (oder mit falschem) Parameter zeigt
Ihnen einen kurzen Hilfs-Hinweis, der Errorlevel ist in diesem
Falle 255.
DateTime.Txt, Seite 3
DateTime v1.35 Datum und Uhrzeit in Batch-Dateien auswerten
Eine Besonderheit ist der Programm-Parameter '/A': folgt ihm ein
Plus ("+"), so wird der Ergebnis-Code vor dem Programmende noch
am Bildschirm ausgegeben.
Ein Beispiel für die Verwendung von DateTime finden Sie in der
Datei DT.BAT, die beispielhaft Wochentag, Monat, Tag und Stunde
auswertet.
Beachten Sie bitte, daß die korrekte Funktion des Programmes von
der richtigen Einstellung Ihrer System-Uhr abhängt. Denken Sie
weiterhin daran, die Errorlevel-Abfragen in Ihren Stapeldateien
vom höchsten zum niedrigsten Wert (nicht umgekehrt) durchzugehen.
DateTime.Txt, Seite 4
DateTime v1.35 Datum und Uhrzeit in Batch-Dateien auswerten
III. GetDate / GetTime
========================
Die beiden Programme GETDATE.EXE und GETTIME.EXE sind speziell
für den Gebrauch in Batch-Dateien gestaltet worden. Sie geben
lediglich das Datum bzw. die Uhrzeit aus. Standardmäßig in exakt
jenem Format, das die DOS-Befehle DATE und TIME erwarten.
Darüberhinaus aber auch in mancherlei Variationen. Ein Beispiel
für die Verwendung finden Sie in der Datei GDT.BAT, in der
zunächst das aktuelle Datum und Zeit gesichert, dann Systemdatum
und -zeit verändert und schließlich wieder restauriert werden.
Beide Programme können als sog. Filter bzw. im Piping
(I/O-Redirection) verwendet werden und kennen die folgenden
Aufruf-Parameter:
/L - zusätzliches LineFeed hinter der Ausgabe
/R - (reverse) umgekehrte Reihenfolge der Angaben
/S - zusätzliches LeerZeichen (Space) hinter der Ausgabe
/V - (verbose) ausführliche Ausgabe
Zur Illustration einige Beispiele:
Parameter GetDate GetTime
------- -------
(keine) 26.12.91 00:41.34
/v Donnerstag, 26. Dezember 1991 00 Uhr 41 Min. 32 Sek.
/r 91.12.26 32.41.00
/v /r 1991, Dezember, 26, Donnerstag 32 Sek., 41 Min., 00 Std.
Die Datei GDV.BAT gibt Ihnen ein Beispiel für die Verwendung
dieser Programme: die Pflege einer Protokoll-Datei.
DateTime.Txt, Seite 5
DateTime v1.35 Datum und Uhrzeit in Batch-Dateien auswerten
IV. Techn. Hintergrund-Informationen
=======================================
Alle Programme verwenden Standard-BIOS- und -DOS-Routinen zur
Zeichenein- und -ausgabe. Wegen der Vielzahl unterschiedlicher
(und zum Teil unvollständiger bzw. inkompatibler) BIOS-Fabrikate
kann jedoch keine Garantie für die Funktionsfähigkeit der
Programme auf einem beliebigen Rechner gegeben werden. Die
Geschwindigkeit der Programmausführung ist selbstverständlich vom
verwendeten Computer-Typ (Rechengeschwindigkeit) und Laufwerk
(Lade-Zeit) abhängig.
Die Validierungs-Codes der Programme entnehmen Sie bitte der
Datei *.CRC. Sie können die Integrität der Programme feststellen,
indem Sie die dort angebenen Prüfsummen mit den durch das
beigefügte Programm VALIDATE.COM (Copyright 1988-89 by McAfee
Associates) erzeugten vergleichen. Geben Sie dazu =vor= dem
ersten Aufruf der Programme z.B. ein:
VALIDATE DateTime.EXE
Sollten die Werte voneinander abweichen, sind unsere Programme in
irgendeiner Weise modifiziert worden (gepatcht, Viren-Befall etc.
pp.).
In der Datei *.RAM schließlich finden Sie Angaben über den
Speicherbedarf der Programme.
DateTime.Txt, Seite 6
DateTime v1.35 Datum und Uhrzeit in Batch-Dateien auswerten
IV. Nutzungs-Bedingungen
==========================
DateTime.EXE, GetTime.EXE und GetDate.EXE sowie die zugehörigen
Dateien sind keine sog. 'freie' Software ("Freeware"), sondern
Shareware-Produkte. Durch die Installation dieses Programmes auf
Ihrem System, erklären Sie Ihr Einverständnis mit den folgenden
Punkten und Bedingungen. Sofern Sie mit diesen Bedingungen jedoch
nicht einverstanden sind, haben Sie kein Recht, das Programm oder
die zugehörigen Dateien zu nutzen, Sie sollten es dann auch nicht
installieren und benutzen. Auch die begleitenden Dateien und
unterstützenden Programme sowie die Dokumentation gehören
insgesamt zu diesem Programm-Paket.
Anwender dieses Programmes akzeptieren den folgenden
Haftungsausschluß: "Das Programm wird geliefert wie es ist. Wir
können keinerlei Haftung übernehmen für eventuelle Schäden,
gleich welcher Art, die Ihnen im Zusammenhang mit der Nutzung der
Programme entstehen mögen. Der Autor lehnt alle Garantien ab,
ausdrücklich oder implizit, einschließlich einer Garantie der
Marktgängigkeit und Tauglichkeit für irgendeinen Zweck." Das
einzige, was wir garantieren können, ist, daß die Programme Platz
auf Ihrer Platte verbrauchen >;-))
Dieses Programm ist "Shareware" und wird zur Verfügung gestellt,
um die Anwender zur Erprobung einzuladen. Fühlen Sie sich frei,
die Erprobungs-Kopie mit Ihren Freunden zu teilen, aber bitte
geben Sie es nicht geändert weiter oder als Teil eines anderen
Systems. Jede Veränderung der Programme und ihrer Dokumentation
sowie Disassemblierung, 'reverse engineering', Patchen usw. usf.
sind nicht gestattet und stellen eine strafbare Verletzung des
Urheberrechts dar. Das Wesen von "Anwender-unterstützter"
Software ist, den PC-Benutzer mit Qualitäts-Software zu
versorgen, ohne die leider üblichen hohen Preise, und den
Programmierern einen Anreiz zu bieten, die Entwicklung neuer
Produkte und die Pflege alter fortzusetzen.
DateTime.Txt, Seite 7
DateTime v1.35 Datum und Uhrzeit in Batch-Dateien auswerten
Das Programm darf also zum =privaten= Gebrauch beliebig oft
kopiert und kostenlos weitergegeben werden, soweit der Inhalt der
Diskette bzw. des Archives nicht verändert, d.h. Dateien oder
Kommentare entfernt oder andere hinzufügt werden (Der
vollständige Inhalt ist in der *.INH Datei enthalten). Das
schließt einen gewerblichen Vertrieb ohne ausdrückliche und
schriftliche Zustimmung aus. Alle Urheber-, Verwertungs- und
Vertriebsrechte bleiben wie auch das Copyright in unserem Besitz.
Eine =kommerzielle= Nutzung (d.h. zur Erzielung von
Geschäftsumsatz oder der Einsatz in staatlichen und
halbstaatlichen Organisationen) ist natürlich auch möglich,
allerdings nur mit unserer schriftlichen Genehmigung gestattet.
Kommerzielle Anwender dieses Programmes müssen jede eingesetzte
Kopie registrieren lassen und bezahlen innnerhalb von 30 Tagen
nach dem ersten Gebrauch, andernfalls haben sie kein Recht, das
Programm zu verwenden.
Die Preise für eine kommerzielle Nutzung teilen wir Ihnen auf
Anfrage gerne mit, wenn Sie uns schreiben, was Ihnen der Einsatz
unseres Programmes wert ist - unsere Anschrift finden Sie am Ende
des Dokumentes.
Falls Ihnen das Programm gefällt, würden wir uns auch über eine
kleine Gratifikation in beliebiger Höhe durchaus freuen. <:-)
DateTime.Txt, Seite 8
DateTime v1.35 Datum und Uhrzeit in Batch-Dateien auswerten
V. Entwicklungs-Geschichte
============================
1.32 - Eingabe-Umleitung wird 'durchgereicht';
Ausgabe-Umleitung ermöglicht;
Piping bei GetDate/GetTime modifiziert;
Desqview-Erkennung wg. Performance entfernt;
1.31 - Bildschirm-Ausgabe überarbeitet
(Hilfe-Meldungen gehen an StdErr);
Dokumentation ergänzt und korrigiert;
bei GetDate/GetTime:
Parameter /L (LineFeed) ergänzt;
Parameter /R (reverse) ergänzt;
Parameter /S (Space) ergänzt;
Durchreichen von Daten via Piping ermöglicht;
1.30 - div. kleine Code-Optimierungen;
1.20 - DesqView-Erkennung eingebaut;
Dokumentation gründlich überarbeitet;
1.10 - nur noch eine Programm-Version (mit
XT-BIOS-Aufrufen);
Code entsprechend überarbeitet;
Bindestrich "-" alternativ zum Schrägstrich "/"
als Parameter-Einleitung ermöglicht;
Bildschirmausgabe des Ergebniscodes ermöglicht;
1.00 - first public release
0.xx - Testversionen (internal use only)
DateTime.Txt, Seite 9
DateTime v1.35 Datum und Uhrzeit in Batch-Dateien auswerten
_______________________________________________________________
| |
| |
| Hinweise & Anregungen |
| sind stets willkommen. Sie können Ihre Mitteilungen richten |
| an: |
| |
| (e-mail:) |
| CompuServe : 100014,3525 Matthias Watermann |
| InterNet : m.watermann@oln.comlink.apc.org |
| |
| (snail-mail:) |
| Die Freie Gesellschaft |
| Verlagsbuchhandlung M. Watermann |
| Richard-Wagner-Str. 27, D-30177 Hannover |
| |
| (Konto-Verbindung:) |
| DFG/M.Watermann, Postgiroamt Hannover, |
| BLZ 250 100 30, Kto. Nr. 353 967-307 |
| |
| |
| |
| |
| \\///// |
| ^ ^ |
| ( o - ) |
| I |
| \_/ |
| v |
| |
| |
| |
_______________________________________________________________
======================= END OF DOCUMENT ========================
DateTime.Txt, Seite 10
DateTime