Tasten & Command Beschreibung
=============================


Command-Gruppe "DAT": Datum/Zeit
================================

Die Gruppe der DAT-Commands sendet Datum und Zeit in unterschiedlichen Formaten.
Im "Store"-Profil befinden sich zahlreiche Knöpfe, die das Datum in unter-
schiedlicher Form ausgeben.


/DAT.>.MEM ............: Kopiert das Datum in den RK-DateMemory
/DAT.CW ...............: Kalenderwoche
/DAT.DATE1 ............: Datum im Kurz-Format (15.05.2002)
/DAT.DATE2 ............: Datum im Medium-Format (15. Mai. 02)
/DAT.DATE3 ............: Datum im Lang-Format (Mittwoch, 15. Mai 2002)
/DAT.DATE4 ............: Datum im system-vorgegebenen Format (15.05.2002)
/DAT.DATE5 ............: Datum im "General"-Format (15.05.2002 18:17:43)
/DAT.DATE1.ADD-D [v] ..: Sendet ein berechnetes Datum, <+/- v> Tage vor/zurück (s. Beschreibung unten)
/DAT.DATE1.ADD-M [v] ..: Sendet ein berechnetes Datum, <+/- v> Monate vor/zurück
/DAT.DAY1 .............: Tag (7, 27)
/DAT.DAY2 .............: Tag , immer zweistellig (07, 27)
/DAT.FORMAT str .......: Datum & Zeit in formatierter Ausgabe (s. Beschreibung unten)
/DAT.HOUR1 ............: Stunde (2, 22)
/DAT.HOUR2 ............: Stunde, immer zweistellig (02, 22)
/DAT.MEM.DIF-D.>VAR ...: Setzt akt. VAR auf Differenz zwischen akt./temp. RK-Datum und RK-DateMemory Datum
/DAT.MINUTE1 ..........: Minute (6, 16)
/DAT.MINUTE2 ..........: Minute, immer zweistellig (06, 16)
/DAT.MONTH-E ..........: Monat in englisch (May)
/DAT.MONTH-F ..........: Monat in französisch (Mars)
/DAT.MONTH-G ..........: Monat in deutsch (Mai)
/DAT.MONTH-USER .......: Benutzerdefinierter Monat
/DAT.MONTH-SYS ........: Vom System vorgegebener Monat
/DAT.MONTH-NO1 ........: Monat als Zahl (5, 12)
/DAT.MONTH-NO2 ........: Monat als Zahl, immer zweistellig (05, 12)
/DAT.SECOND1 ..........: Sekunde (4, 55)
/DAT.SECOND2 ..........: Sekunde, immer zweistellig (04, 55)
/DAT.STPWTCH.START ....: Startet die Zählung der Stopuhr
/DAT.STPWTCH.CONT .....: Fährt mit der Zählung der Stopuhr fort
/DAT.STPWTCH.STOP .....: Beendet die Zählung der Stopuhr und zeigt das Ergebnis an
/DAT.TEMP.<.MEM .......: Setzt das temporäre RK-Datum auf das des RK-DateMemory
/DAT.TEMP.ADD-D [v] ...: Addiert (Subtr.) <+/- v> Tage zum temporären RK-Datum hinzu (nicht Sys-Dat) (s. Beschr. unten)
/DAT.TEMP.ASK .........: Ändert das temporäre RK-Datum/-Zeit für DAT-Commands (nicht System-Datum)
/DAT.TEMP.MEM.SWAP ....: Tauscht das temoräre RK-Datum und das RK-DateMemory Datum miteinander aus
/DAT.TEMP.RESET .......: Setzt das temporäre RK-Datum/-Zeit auf aktuelles Datum/Zeit zurück
/DAT.TIME.AMPM1 .......: AM oder PM, zwei Zeichen in groß (PM)
/DAT.TIME.AMPM2 .......: AM oder PM, zwei Zeichen in klein (pm)
/DAT.TIME.AMPM3 .......: AM oder PM, ein Zeichen in groß (P)
/DAT.TIME.AMPM4 .......: AM oder PM, ein Zeichen in klein (p)
/DAT.TIME1 ............: Zeit im Kurz-Format (18:22)
/DAT.TIME2 ............: Zeit im Medium-Format (06:22)
/DAT.TIME3 ............: Zeit im Lang-Format (18:23:28)
/DAT.TIME4 ............: Zeit im system-vorgegebenen Format (22:13:12)
/DAT.TIME1.ADD-H [v] ..: Sendet eine berechnete Zeit, <+/- v> Stunden vor/zurück
/DAT.TIME1.ADD-M [v] ..: Sendet eine berechnete Zeit, <+/- v> Minuten vor/zurück
/DAT.VIEW .............: Zeigt das aktuelle und das temopäre RK-Datum im int. Textbetrachter an
/DAT.WDAY-E ...........: Wochentag in englisch (Saturday)
/DAT.WDAY-F ...........: Wochentag in französisch (Samedi)
/DAT.WDAY-G ...........: Wochentag in deutsch (Sonnabend)
/DAT.WDAY-USER ........: Benutzerdefinierter Wochentag
/DAT.WDAY-SYS .........: Vom System vorgegebener Wochentag
/DAT.YEAR1 ............: Jahr (2002)
/DAT.YEAR2 ............: Jahr, immer zweistellig (02)

Man kann sich das Datumsformat durch Zusammenbau der Commands und Hinzufügen
von Zeichen (Punkte, Leerzeichen etc. )individuell zusammenstellen.

Beispiel: {/DAT.DAY1}. {/DAT.MONTH-G} {/DAT.YEAR1}

Dieses Beispiel gibt den Text im folgenden Format aus: "18. August 2001".

Mit dem TEMP-Commands kann man das Datum und/oder die Zeit für die DAT-Commands
neu setzen, ohne daß dadurch das System-Datum des Computers geändert wird!
Diese Einstellung bleibt bis zum Programm-Ende erhalten, sofern es nicht
mit TEMP.RESET wieder auf das aktuelle Datum bzw. die aktuelle Zeit zurück-
gestellt wird oder durch erneuten Aufruf eines TEMP-Commands geändert wird.

Beispiel: {/DAT.TEMP.ADD-D -1}

Nach diesem Command beziehen sich alle folgenden DAT-Commands auf den
vorherigen Tag.

Ab v8.1 wurde ein RK-DateMemory (Datum-Commands, die ein "MEM" beinhalten)
eingerichtet. Dadurch, daß nun ein zweites Datum zur Verfügung steht, können
fortan auch Datums-Differenzen berechnet werden (/DAT.MEM.DIF-D.>VAR).
Der Ablauf gestaltet sich so, daß das RK-Datum temporär geändert wird, dann
in das RK-DateMemory gespeichert wird und schließlich das RK-Datum neu gesetzt
oder auf das aktuelle Datum gesetzt wird.
Anschließend ist eine Differenzberechnung möglich. Das Ergebnis wird in der
aktuellen VAR abgelegt und steht somit für weitere Berechnungen zur Verfügung.

Beispiel:

{/BTCH.EXPLICIT}
{/DAT.TEMP.ASK}
{/DAT.>.MEM}
{/DAT.TEMP.RESET}
{/DAT.MEM.DIF-D.>VAR}
{/VAR.VIEW}

--> Beachte
Wird das temporäre Datum gesetzt, so entspricht DATE4 > DATE1 und TIME4 > TIME2.
Die sytembezogenen Commands fragen das Datum direkt ab und können nicht temporär
geändert werden. Daher werden die wahrscheinlichsten Entsprechungen eingesetzt.

--> Beachte
Statt durch den OK-Knopf kann das temporäre Datum im ASK-Fenster auch durch einen
Doppelklick auf ein Datum gesetzt werden.

Mit Hilfe der o.g. USER-Commands können auch Abkürzungen und fremdsprachige
Ausdrücke gesendet werden, wie z.B. "Aug.".
Die Definitionen werden in der im Profiles-Ordner befindlichen "UserApp.dat"
vorgenommen.

Die o.g. systemvorgegebenen Formate können auf verschiedenen Rechner unter-
schiedlich aussehen, denn sie sind von den Einstellungen in den Länderein-
stellungen der Windows-Systemsteuerung abhängig.


/DAT.DATE1.ADD-D [v] ..: Sendet ein berechnetes Datum, <+/- v> Tage vor/zurück
/DAT.DATE1.ADD-M [v] ..: Sendet ein berechnetes Datum, <+/- v> Monate vor/zurück
/DAT.TIME1.ADD-H [v] ..: Sendet eine berechnete Zeit, <+/- v> Stunden vor/zurück
/DAT.TIME1.ADD-M [v] ..: Sendet eine berechnete Zeit, <+/- v> Minuten vor/zurück
------------------------

Beispiel: {/DAT.DATE1.ADD-D 3} ...: addiert 3 Tage zum aktuellen Datum und sendet
                                    das berechnete Datum
Beispiel: {/DAT.TIME1.ADD-M -30} .: subtrahiert 30 Minuten von der aktuellen Zeit
                                    und sendet die berechnete Zeit

Ab V8.0 kann anstelle eines festen Parameters die aktuelle VAR eingesetzt werden.
Für diesen Zweck läßt man den Parameter einfach weg.

Beispiel:

{/BTCH.EXPLICIT}
{/VAR.ASK}
{/DAT.DATE1.ADD-D}

/DAT.FORMAT str .......: Datum & Zeit in formatierter Ausgabe
------------------------
Die Ausgabe erfolgte auf einem deutschen Windows-System.

Parameter für "str":
--------------------

Alleinstehende Parameter:

s/d ....: Datum, kurz
m/d ....: Datum, medium
l/d ....: Datum, lang
sys/d ..: Datum, System
s/t ....: Zeit, kurz
m/t ....: Zeit, medium
l/t ....: Zeit, lang
sys/t ..: Zeit, System
sys/dt .: Datum/Zeit, System
gen ....: Datum/Zeit, "general"

Kombinations-Parameter:

Datum (d=day, m=month, y=year):

d ......: 7
dd .....: 07
ddd ....: Di
dddd ...: Dienstag
ddddd ..: 07.05.2002 (= sys/d)
dddddd .: Dienstag, 7. Mai 2002
m ......: 6
mm .....: 06
mmm ....: Jun
mmmm ...: Juni
yy .....: 02
yyyy ...: 2002

Zeit (h=hour, m=minute, s=second, t=time):

h ......: 3
hh .....: 03
m ......: 8
mm .....: 08
s ......: 4
ss .....: 04
am/pm ..: am
AM/PM ..: AM
a/p ....: a
A/P ....: A
ttttt ..: 00:09:41 (= sys/t)

Trennzeichen:

/ ......: Konvertiert in das System-Trennzeichen (dd/mm/yy)
andere .: Jedes andere Trennzeichen ist möglich (dd-mm-yy oder dd.mm.yy oder dd mm yy)

Beispiel: {/DAT.FORMAT s/d}
Beispiel: {/DAT.FORMAT dddd, dd. mmmm yyyy}
Beispiel: {/DAT.FORMAT d-mmm}
Beispiel: {/DAT.FORMAT h:mm:ss am/pm}
Beispiel: {/DAT.FORMAT ddddd ttttt}
