Freigeben über

timediff-Funktion

  • Artikel

Gilt für: Häkchen gesetzt jaDatabricks SQL Häkchen gesetzt ja und Databricks Runtime 14.0 und höher

Gibt den Unterschied zwischen zwei Zeitstempeln zurück, die in units gemessen werden. Diese Funktion ist ein Synonym für die Funktion timestampdiff.

Syntax

timediff(unit, start, end)

unit
 { MICROSECOND |
   MILLISECOND |
   SECOND |
   MINUTE |
   HOUR |
   DAY |
   WEEK |
   MONTH |
   QUARTER |
   YEAR }

Argumente

  • unit: Eine Berechnungseinheit.
  • start: Ein TIMESTAMP-Anfangsausdruck.
  • end: Ein TIMESTAMP-Endausdruck.

Gibt zurück

Ein BIGINT.

Ist start größer als end, ist das Ergebnis negativ.

Die Funktion zählt ganze verstrichene Einheiten basierend auf UTC, wobei DAY 86.400 Sekunden entspricht.

Ein Monat gilt als verstrichen, wenn der Kalendermonat erhöht wurde und der Kalendertag und die Uhrzeit mindestens ihren anfänglichen Werten entsprechen. Daraus werden Wochen, Quartale und Jahre berechnet.

Beispiele

-- One second shy of a month elapsed
> SELECT timediff(MONTH, TIMESTAMP'2021-02-28 12:00:00', TIMESTAMP'2021-03-28 11:59:59');
 0

-- One month has passed even though its' not end of the month yet because day and time line up.
> SELECT timediff(MONTH, TIMESTAMP'2021-02-28 12:00:00', TIMESTAMP'2021-03-28 12:00:00');
 1

-- Start is greater than the end
> SELECT timediff(YEAR, DATE'2021-01-01', DATE'1900-03-28');
 -120