prevnext   » Startseite » Haupt-Referenz » Funktions-Referenz » splitTime()

splitTime()

Die einzelnen Komponenten (von Sekundenbruchteile bis Jahr) einer Zeitangabe errechnen.

Syntax:

string splitTime ( time )
string/list/map splitTime ( time, mode )

Parameter:

time Bei diesem Parameter handelt es sich um eine Datums- und/oder Zeitangabe. Der Parameter muss vom Typ NONE, INT32, INT64, FLOAT oder STRING sein. Weitere Details zu Zeitangaben sind unter »Zeitangaben« beschrieben.
mode Eine der Konstanten '_STRING', '_LIST' oder '_MAP'. Ohne Angabe wird '_STRING' verwendet.

Beschreibung:

Für die Zeitangabe time werden die einzelnen Komponenten (von Sekundenbruchteile bis Jahr) berechnet und als Funktionsergebnis ausgegeben.

Der Zugriff auf die einzelnen Werte erfolgt über einen Schlüssel oder Index, die in der folgenden Tabelle beschrieben werden:

Schlüssel und Indizes der einzelnen Elemente
Schlüssel Index Beschreibung
'nsec100' _NSEC100 10-7 sec oder 100-Nanosekunden-Anteil einer Sekunde.
'sec' _SEC Sekunden (0..59)
'min' _MIN Minuten (0..59)
'hour' _HOUR Stunden (0..23)
'day' _DAY Tag im Monat (1..31)
'month' _MONTH Monat (1..12)
'year' _YEAR Jahr (-45..+58410)
 
'weekofyear' _WEEKOFYEAR Woche im Jahr year (0..53)
'wyear' _WYEAR Jahr von Woche week (-45..+58410)
'week' _WEEK Woche im Jahre wyear (1..53)
'wday' _WDAY Wochentag (1=Mon,...,7=So)
'yday' _YDAY Tag im Jahr (1..366)
'tday' _TDAY Totale Tage; entspricht dem Zeitformat date
'dsec' _DSEC Sekunden des Tages
 
'is_leapyear' _IS_LEAPYEAR 0, falls das Jahr year kein Schaltjahr ist.
+1, falls das Jahr year ein Schaltjahr ist.
-1, falls noch keine Berechnung erfolgte.
'is_gregorian' _IS_GREGORIAN 0, falls Aufteilung nach julianischem Kalender geschehen ist.
+1, falls Aufteilung nach gregorianischen Kalender geschehen ist.
-1, falls noch keine Berechnung erfolgte.
'gregorian_day' _GREGORIAN_DAY Tag im Zeitformat date des ersten gregorianischen Tages.
Anmerkung zur Wochenberechnung:

Funktionsergebnis:   STRING/LIST/MAP

Der Typ des Funktionsergebnisses wird durch den Parameter mode festgelegt:

Siehe auch:
 Zeitangaben   selectTime() 

Weitere ähnliche Funktionen:

Datum & Zeit
Funktion Kurzinfo
date() Zeitangabe in das Datumsformat (INT32) wandeln.
dayName()
easterDate() Berechne den Ostersonntag einen gegebenen Jahres.
easterDayOfMarch() Berechne den Ostersonntag einen gegebenen Jahres und liefere den März-Tag.
monthName()
mSec() Relative Zeit in Millisekunden zu einem nicht weiter definiertem Startpunkt.
nSec() Relative Zeit in Nanosekunden zu einem nicht weiter definiertem Startpunkt.
printInterval() textausgabe eines Zeitintervalles
printTime() Formatierte Ausgabe einer Datums- und Zeitangabe.
scanInterval()
scanTime()
sec() Relative Zeit in Sekunden zu einem nicht weiter definiertem Startpunkt.
selectTime() Eine einzelne Komponenten (von Sekundenbruchteil bis Jahr) einer Zeitangabe errechnen.
splitTime() Die einzelnen Komponenten (von Sekundenbruchteile bis Jahr) einer Zeitangabe errechnen.
time() Zeitangabe in das Zeitformat (INT64) wandeln.
unix2date() Eine Zeitangabe im Unix-Format in eine Zeitangabe im Datumsformat wandeln.
unix2time() Eine Zeitangabe im Unix-Format in eine 64-Bit-Zeitangabe wandeln.
unixTime() Zeitangabe in das Unix-Zeitformat (INT32) wandeln.
uSec() Relative Zeit in Mikrosekunden zu einem nicht weiter definiertem Startpunkt.