Startseite
Downloads
Lexikon
Sonstiges
Links
Kontakt
Gästebuch
Statistics
Disclaimer
Name
Time
Syntax
zeit = Time( [option][, convTime, convOpt] ) [;]
Beschreibung
Wiedergabe der aktuellen Uhrzeit, Starten und Stoppen eines Timers oder konvertieren der Zeitwerte vom einen Format in ein anderes. Folgende Formate werden unterstützt (Erklärung in Bemerkungen):
Option
Format
C
hh:mmxx (wobei xx = 'pm' or 'am')
E
sssssssss.uuuuuu
F
uuuuuuuuuuuuuuuuuu
H
hh
L
hh:mm:ss.uuuuuu
M
mmmm
N
hh:mm:ss
R
sssssssss.uuuuuu
S
sssss
T
ssssssssssss
Aufrufparameter
Parameter
Beschreibung
option
Beschreibt das Ausgabeformat der Zeitangabe.
convTime
Die Zeitangabe, die vom Format convOpt in das Format option konvertiert verden soll.
convOpt
Format der, im Parameter convDate, angegegebenen Zeitangabe.
Standardwerte
Parameter
Wert
option
N
convOpt
N
Rückgabewerte
Name/Wert
Bedeutung
zeit
Zeitangabe im, vom Parameter option, abhängigen Format.
Bemerkungen
Wenn keine Option angegeben wurde, dann wird die Option N angenomen.
Nur der erste Buchstabe des Optionsnamen wird interpretiert, Die Groß- Kleinschreibung hat keine Bedeutung. Folgende Optionen für option und convOpt dürfen verwendet werden:
C
Civil. hh:mmxx. Stundenangabe hh kann die Werte von 1 bis 12 annehmen, Minuten - von 00 bis 59 und xx: pm (von 24:00 bis 11:59 Uhr) oder am (sonst).
E
Elapsed. sssssssss.uuuuuu - Anzahl der Sekunden (s) und Mikrosekunden (u) seit dem letzten starten bzw. zurücksetzen des Timers (Option S bzw. R)
F
Full. Die Anzahl von Mikrosekunden uuuuuuuuuuuuuuuuuu seit 00:00:00.000000 am 1. Januar 0001.
H
Hours. hh - Anzahl von Stunden seit der Mitternacht ohne führenden Nullen.
L
Long. hh:mm:ss.uuuuuu - genaue Zeitangabe mit der Anzahl von Mikrosekunden.
M
Minutes. mmmm - Anzahl von Minuten seit der Mitternacht ohne führenden Nullen.
N
Normal. Gibt das aktuelle Datum im Format hh:mm:ss zurück. Das ist die Standardeinstellung.
R
Reset. sssssssss.uuuuuu - Anzahl der Sekunden (s) und Mikrosekunden (u) seit dem letzten starten bzw. zurücksetzen des Timers (Option S bzw. R)
S
Seconds. sssss - Anzahl von Sekunden seit der Mitternacht ohne führenden Nullen.
T
Ticks. ssssssssssss - die Anzahl von Sekunden seit 00:00:00.000000 am 1. Januar 1970. Ohne führenden Blanks bzw. Nullen. Die Ausgabe kann zur Berechnung von Datumintervalen bzw. Zeitstempeln (Timestamp arithmetic) verwendet werden. Die Option NUMERIC DIGITS muss dann auf mindestens 12 gesetzt werden.
Die Funktion liefert negative Zahlen für Datumsangaben vor dem 1. Januar 1970.
Die optionalen Konvertierungsparameter (convTime und convOpt) erlauben es, eine Zeitangabe (convTime) vom Format convOpt in das Zeitformat, das durch die option festgelegt wurde, umzuwandeln (siehe Beispiel 3).
Nicht für alle Kombinationen wird die Umstellung durchgeführt. Wählt man nicht erlaubte bzw. falsche Optionen, so wird das Return Code (RC) 40 zurück gegeben.

Beispiel 1

string = Time()
Say string

Ergebnis 1

19:24:26
Uhrzeit zu diesem Zeitpunkt.

Beispiel 2

string = Time( 'C' )
Say string

Ergebnis 2

7:27pm
Uhrzeit zu diesem Zeitpunkt.

Beispiel 3

cTime = "03:22pm"
string = Time( "N", cTime, "C" )
Say string

Ergebnis 3

15:22:00
Your privacy: This web site has no cookies, no advertising and does not provide access data to anyone for any reason.
Copyright © Janosch R. Kowalczyk 1999, 2010. All rights reserved.
Most recent revision on 24 Aug 2010 (236) - 14:43:38.
Jakoxx Logo
Meine REXX-Regeln
RXCIF-Prozeduren:
Meine Prozeduren
Built-in functions
Standard Return Codes