Description of Keys & Commands
==============================
Note: English translation still under construction!

Command-Group "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 ............: To copy date into RK-DateMemory
/DAT.CW ...............: Calendar week
/DAT.DATE1 ............: Date, short format (15.05.2002)
/DAT.DATE2 ............: Date, medium format (15. Mai. 02)
/DAT.DATE3 ............: Date, long format (Mittwoch, 15. Mai 2002)
/DAT.DATE4 ............: Date, system default format (15.05.2002)
/DAT.DATE5 ............: Date, general format (15.05.2002 18:17:43)
/DAT.DATE1.ADD-D [v] ..: To send a calculated date, <+/- v> days in future/past (see description below)
/DAT.DATE1.ADD-M [v] ..: To send a calculated date, <+/- v> monthes in future/past
/DAT.DAY1 .............: Day (7, 27)
/DAT.DAY2 .............: Day, 2 digits always (07, 27)
/DAT.FORMAT str .......: Date/Time, formatted output (see description below)
/DAT.HOUR1 ............: Hour (2, 22)
/DAT.HOUR2 ............: Hour, 2 digits always (02, 22)
/DAT.MEM.DIF-D.>VAR ...: To set current VAR to the difference between current/temp-date and RK-DateMemory-date
/DAT.MINUTE1 ..........: Minute (6, 16)
/DAT.MINUTE2 ..........: Minute, 2 digits always (06, 16)
/DAT.MONTH-E ..........: Month name, english (May)
/DAT.MONTH-F ..........: Month name, french (Mars)
/DAT.MONTH-G ..........: Month name, german (Mai)
/DAT.MONTH-USER .......: Month name, user-defined
/DAT.MONTH-SYS ........: Month name, system default format
/DAT.MONTH-NO1 ........: Month as number (5, 12)
/DAT.MONTH-NO2 ........: Month as number, 2 digits always (05, 12)
/DAT.SECOND1 ..........: Second (4, 55)
/DAT.SECOND2 ..........: Second, 2 digits always (04, 55)
/DAT.STPWTCH.START ....: To start stopwatch
/DAT.STPWTCH.CONT .....: To continue stopwatch
/DAT.STPWTCH.STOP .....: To stop stopwatch and to show result
/DAT.TEMP.<.MEM .......: To set RK-temp-date to RK-DateMemory-date
/DAT.TEMP.ADD-D [v] ...: To add/sub <+/- v> days to RK-temp-date for DAT commands (not system date)(see descr. below)
/DAT.TEMP.ASK .........: To change RK-temp-date/ -time for DAT commands (not system date)
/DAT.TEMP.MEM.SWAP ....: To swap between RK-temp-date and RK-DateMemory-date
/DAT.TEMP.RESET .......: To reset RK-temp-date/ -time to current date
/DAT.TIME.AMPM1 .......: AM or PM, two letters in uppercase (PM)
/DAT.TIME.AMPM2 .......: AM or PM, two letters in lowercase (pm)
/DAT.TIME.AMPM3 .......: AM or PM, one letter  in uppercase (P)
/DAT.TIME.AMPM4 .......: AM or PM, one letter  in lowercase (p)
/DAT.TIME1 ............: Time, short format (18:22)
/DAT.TIME2 ............: Time, medium format (06:22)
/DAT.TIME3 ............: Time, long format (18:23:28)
/DAT.TIME4 ............: Time, system default format (22:13:12)
/DAT.TIME1.ADD-H [v] ..: To send a calculated time, <+/- v> hours in future/past
/DAT.TIME1.ADD-M [v] ..: To send a calculated time, <+/- v> minutes in future/past
/DAT.VIEW .............: To view current and RK-temp-date in the int. text viewer
/DAT.WDAY-E ...........: Weekday, english (Saturday)
/DAT.WDAY-F ...........: Weekday, french (Samedi)
/DAT.WDAY-G ...........: Weekday, german (Sonnabend)
/DAT.WDAY-USER ........: Weekday, user-defined
/DAT.WDAY-SYS .........: Weekday, system default format
/DAT.YEAR1 ............: Year (2001)
/DAT.YEAR2 ............: year, 2 digits only (01)

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

Example: {/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.

Example: {/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.

Example:

{/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] ..: To send a calculated date, <+/- v> days in future/past
/DAT.DATE1.ADD-M [v] ..: To send a calculated date, <+/- v> monthes in future/past
/DAT.TIME1.ADD-H [v] ..: To send a calculated time, <+/- v> hours in future/past
/DAT.TIME1.ADD-M [v] ..: To send a calculated time, <+/- v> minutes in future/past
------------------------

Example: {/DAT.DATE1.ADD-D 3} ...: adds 3 days to current date and sends calculated date
Example: {/DAT.TIME1.ADD-M -30} .: subs 30 minutes from current time and sends calculated time

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

Example:

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


/DAT.FORMAT str .......: Date/Time, formatted output
------------------------
The output was generated on a german Windows system.

Parameter for "str":
--------------------

Stand alone parameters:

s/d ....: short date
m/d ....: medium date
l/d ....: long date
sys/d ..: system date
s/t ....: short time
m/t ....: medium time
l/t ....: long time
sys/t ..: system time
sys/dt .: system date & time
gen ....: system general date/time

Combination parameters:

Date (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

Time (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)

Separators:

/ ......: Converts to system separator (dd/mm/yy)
other ..: Any other separator possible (dd-mm-yy or dd.mm.yy or dd mm yy)

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