TapHome

Data i czas

Funkcje daty i czasu w skrypcie TapHome — DATETIME, NOW, TIMESPAN, LOCALTIMEZONE i DATETIMEADD do tworzenia i manipulowania wartościami daty/czasu.

DATETIME

Tworzy obiekt DateTime. Właściwość DateTime.Ticks to liczba milisekund od 01.01.0001 00:00:00.000. DateTime ma właściwości: 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  )

Przykłady:

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

Zwraca obiekt DateTime ustawiony na bieżącą datę i godzinę w lokalnej strefie czasowej.

NOW()

Przykłady:

VAR now := NOW();

TIMESPAN

Funkcja TIMESPAN tworzy zmienną reprezentującą okres czasu, określony w dniach, godzinach, minutach, sekundach i milisekundach. TIMESPAN ma właściwości do bezpośredniego dostępu do każdego składnika okresu: DAYS, HOURS, MINUTES, SECONDS, MILLISECONDS. TIMESPAN ma także właściwości do dostępu do całkowitej długości czasu w określonych jednostkach (z wartościami ułamkowymi): TOTALDAYS, TOTALHOURS, TOTALMINUTES, TOTALSECONDS, TOTALMILLISECONDS.

TIMESPAN( days, hours, minutes, seconds, milliseconds )

Przykłady:

VAR t := TimeSpan(1, 2, 3, 4, 0);
	t.TOTALSECONDS			

Result ... 93784

LOCALTIMEZONE

Zwraca lokalną strefę czasową jako liczbę milisekund względem czasu UTC.

LOCALTIMEZONE()

Przykłady:

VAR timezoneDiff := LOCALTIMEZONE();

DATETIMEADD

Dodaje określoną liczbę lat, miesięcy, dni, godzin, minut, sekund lub milisekund do istniejącego DateTime i zwraca nowy DateTime.

DATETIMEADD(datetime, years, months, days, hours, minutes, seconds, milliseconds)

Przykłady:

VAR dt := NOW(); VAR yearBefore := DATETIMEADD(dt, -1);