Udostępnij za pośrednictwem

datetime_add()

  • Artykuł

Dotyczy: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Oblicza nową datę/ godzinę z określonego okresu pomnożonego przez określoną kwotę, dodaną do lub odejmowaną od określonej daty/godziny.

Składnia

datetime_add(data,/godzina okresu,)

Dowiedz się więcej na temat konwencji składni.

Parametry

Nazwisko Type Wymagania opis
okres string ✔️ Czas, przez który ma być zwiększany.
kwota int ✔️ Liczba okresów do dodania lub odejmowania od daty/godziny.
data/godzina datetime ✔️ Data do przyrostu według wyniku obliczenia wartości x okresu.

Możliwe wartości okresu:

  • Year (Rok)
  • Kwartał
  • Miesiąc
  • Tydzień
  • Dzień
  • Godzina
  • Minuta
  • Second
  • Milisekunda
  • Mikrosekundy
  • Nanosekund

Zwraca

Data /godzina po dodaniu określonego interwału daty/godziny.

Przykłady

Okres

print  year = datetime_add('year',1,make_datetime(2017,1,1)),
quarter = datetime_add('quarter',1,make_datetime(2017,1,1)),
month = datetime_add('month',1,make_datetime(2017,1,1)),
week = datetime_add('week',1,make_datetime(2017,1,1)),
day = datetime_add('day',1,make_datetime(2017,1,1)),
hour = datetime_add('hour',1,make_datetime(2017,1,1)),
minute = datetime_add('minute',1,make_datetime(2017,1,1)),
second = datetime_add('second',1,make_datetime(2017,1,1))

Wyjście

rok ćwiartka miesiąca tydz. dzień godzina min. drugi
2018-01-01 00:00:00.0000000 2017-04-01 00:00:00.0000000 2017-02-01 00:00:00.0000000 2017-01-08 00:00:00.0000000 2017-01-02 00:00:00.0000000 2017-01-01 01:00:00.0000000 2017-01-01 00:01:00.0000000 2017-01-01 00:00:01.0000000

Kwota

print  year = datetime_add('year',-5,make_datetime(2017,1,1)),
quarter = datetime_add('quarter',12,make_datetime(2017,1,1)),
month = datetime_add('month',-15,make_datetime(2017,1,1)),
week = datetime_add('week',100,make_datetime(2017,1,1))

Wyjście

rok ćwiartka miesiąca tydz.
2012-01-01T00:00:00Z 2020-01-01T00:00:00Z 2015-10-01T00:00:00Z 2018-12-02T00:00:00Z