Datum und Zeit
Datums- und Zeitfunktionen der TapHome-Skriptsprache — DATETIME, NOW, TIMESPAN, LOCALTIMEZONE und DATETIMEADD zum Erstellen und Bearbeiten von Datums-/Zeitwerten.
DATETIME
Erzeugt ein DateTime-Objekt. Die Eigenschaft DateTime.Ticks gibt die Anzahl der Millisekunden seit dem 01.01.0001 00:00:00.000 an. DateTime verfügt über die Eigenschaften: TICKS, YEAR, MONTH, DAY, DAYOFWEEK, DAYOFYEAR, HOUR, MINUTE, SECOND, MILLISECOND, KIND, UTCDATETIME, LOCALDATETIME, UNIXTIME.
DATETIME( ticks, DateTimeKind )
DATETIME( string, format )
DATETIME( string, DateTimeKind )
DATETIME( year, month, day, hour, minute, second, millisecond, DateTimeKind )Beispiele:
VAR date:= DATETIME(2014, 12, 8, 23, 54, 12, 456);
VAR date:= DATETIME(2014, 12, 8, 23, 54, 12, 456, DateTimeKind.Local);
VAR date:= DATETIME(2014, 12, 8, 23, 54, 12, 456, DateTimeKind.Utc);
VAR date:= DATETIME("13:36");
VAR date:= DATETIME("2022-08-03T07:39:03.688133+05:00");
VAR date:= DATETIME("03.01 2008 10:00");
VAR date:= DATETIME("mar.01 2008 10:00");
VAR date:= DATETIME("03.01 2008 10:00", "dd.MM yyyy hh:mm");
VAR date:= DATETIME(518832000);
VAR date:= DATETIME(518832000, DateTimeKind.Utc);
VAR date := NOW(); date.YEAR := 1999;
DATETIME date; date.UNIXTIME := 123456;NOW
Gibt ein DateTime-Objekt zurück, das auf das aktuelle Datum und die aktuelle Uhrzeit in der lokalen Zeitzone eingestellt ist.
NOW()Beispiele:
VAR now := NOW();TIMESPAN
Die TIMESPAN-Funktion erstellt eine Variable, die eine Zeitdauer darstellt, angegeben in Tagen, Stunden, Minuten, Sekunden und Millisekunden. TIMESPAN hat Eigenschaften, um auf jede Komponente der Zeitspanne direkt zuzugreifen: DAYS, HOURS, MINUTES, SECONDS, MILLISECONDS. TIMESPAN hat außerdem Eigenschaften, um auf den Gesamtwert der Zeit in bestimmten Einheiten zuzugreifen (einschließlich Bruchteilen): TOTALDAYS, TOTALHOURS, TOTALMINUTES, TOTALSECONDS, TOTALMILLISECONDS.
TIMESPAN( days, hours, minutes, seconds, milliseconds )Beispiele:
VAR t := TimeSpan(1, 2, 3, 4, 0);
t.TOTALSECONDS
Result ... 93784LOCALTIMEZONE
Gibt die lokale Zeitzone als Anzahl Millisekunden Differenz zur UTC-Zeit zurück.
LOCALTIMEZONE()Beispiele:
VAR timezoneDiff := LOCALTIMEZONE();DATETIMEADD
Addiert eine angegebene Anzahl von Jahren, Monaten, Tagen, Stunden, Minuten, Sekunden und Millisekunden zu einem bestehenden DateTime-Wert und gibt ein neues DateTime zurück.
DATETIMEADD(datetime, years, months, days, hours, minutes, seconds, milliseconds)Beispiele:
VAR dt := NOW(); VAR yearBefore := DATETIMEADD(dt, -1);