Freigeben über


datetime_diff()

Gilt für: ✅Microsoft Fabric✅Azure Data ExplorerAzure MonitorMicrosoft Sentinel

Berechnet die Anzahl der angegebenen Zeiträume zwischen zwei Datetime-Werten .

Syntax

datetime_diff(Period,datetime1,datetime2)

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name Type Erforderlich Beschreibung
period string ✔️ Die Zeitmessung, die zum Berechnen des Rückgabewerts verwendet wird. Mögliche Werte anzeigen.
datetime1 datetime ✔️ Die linke Seite der Subtraktionsgleichung.
datetime2 datetime ✔️ Die rechte Seite der Subtraktionsgleichung.

Mögliche Werte des Zeitraums

Bei diesen Werten wird die Groß-/Kleinschreibung nicht beachtet:

  • Jahr
  • Quarter
  • Monat
  • Woche
  • Tag
  • Stunde
  • Minute
  • Second
  • Millisekunde
  • Mikrosekunde
  • Nanosekunde

Gibt zurück

Eine ganze Zahl, die die Anzahl der Zeiträume im Ergebnis einer Subtraktion (datetime1 - datetime2) darstellt.

Beispiel

print
year = datetime_diff('year',datetime(2017-01-01),datetime(2000-12-31)),
quarter = datetime_diff('quarter',datetime(2017-07-01),datetime(2017-03-30)),
month = datetime_diff('month',datetime(2017-01-01),datetime(2015-12-30)),
week = datetime_diff('week',datetime(2017-10-29 00:00),datetime(2017-09-30 23:59)),
day = datetime_diff('day',datetime(2017-10-29 00:00),datetime(2017-09-30 23:59)),
hour = datetime_diff('hour',datetime(2017-10-31 01:00),datetime(2017-10-30 23:59)),
minute = datetime_diff('minute',datetime(2017-10-30 23:05:01),datetime(2017-10-30 23:00:59)),
second = datetime_diff('second',datetime(2017-10-30 23:00:10.100),datetime(2017-10-30 23:00:00.900)),
millisecond = datetime_diff('millisecond',datetime(2017-10-30 23:00:00.200100),datetime(2017-10-30 23:00:00.100900)),
microsecond = datetime_diff('microsecond',datetime(2017-10-30 23:00:00.1009001),datetime(2017-10-30 23:00:00.1008009)),
nanosecond = datetime_diff('nanosecond',datetime(2017-10-30 23:00:00.0000000),datetime(2017-10-30 23:00:00.0000007))

Output

year quarter month week day Stunde Minute second millisecond microsecond nanosecond
17 2 13 5 29 2 5 10 100 100 -700