Datum a čas
Funkce skriptu TapHome pro datum a čas — DATETIME, NOW, TIMESPAN, LOCALTIMEZONE a DATETIMEADD pro vytváření a manipulaci s hodnotami data/času.
DATETIME
Vytvoří objekt DateTime. Vlastnost DateTime.Ticks je počet milisekund od 1.1.0001 00:00:00.000. DateTime má vlastnosti: 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 )Příklady:
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
Vrací DateTime objekt nastavený na aktuální datum a čas v místním časovém pásmu.
NOW()Příklady:
VAR now := NOW();TIMESPAN
Funkce TIMESPAN vytváří proměnnou, která reprezentuje délku času, udanou v dnech, hodinách, minutách, sekundách a milisekundách. TIMESPAN má vlastnosti pro přímý přístup ke každé složce časového intervalu: DAYS, HOURS, MINUTES, SECONDS, MILLISECONDS. TIMESPAN má i vlastnosti pro přístup k celkovým hodnotám času v konkrétních jednotkách (včetně zlomkových hodnot): TOTALDAYS, TOTALHOURS, TOTALMINUTES, TOTALSECONDS, TOTALMILLISECONDS.
TIMESPAN( days, hours, minutes, seconds, milliseconds )Příklady:
VAR t := TimeSpan(1, 2, 3, 4, 0);
t.TOTALSECONDS
Výsledek ... 93784LOCALTIMEZONE
Vrací lokální časové pásmo jako počet milisekund od UTC času.
LOCALTIMEZONE()Příklady:
VAR timezoneDiff := LOCALTIMEZONE();DATETIMEADD
Přidá zadaný počet let, měsíců, dnů, hodin, minut, sekund a milisekund k existujícímu DateTime a vrátí nový DateTime.
DATETIMEADD(datetime, years, months, days, hours, minutes, seconds, milliseconds)Příklady:
VAR dt := NOW(); VAR yearBefore := DATETIMEADD(dt, -1);