make_timestamp-Funktion

Gilt für:durch Häkchen mit „Ja“ markiert Databricks SQL durch Häkchen mit „Ja“ markiert Databricks Runtime

Erstellt einen Zeitstempel aus den Feldern year, month, day, hour, min, sec und timezone.

Syntax

make_timestamp(year, month, day, hour, min, sec [, timezone] )

make_timestamp(date [, time [, timezone]] )

Important

Das Argument time verwendet den TIME Datentyp, der sich in der Beta befindet.

Argumente

  • year: Ein Ausdruck, der INTEGER einen Wert von 1 bis 9999 auswertet.
  • month: Ein Ausdruck, der INTEGER auf einen Wert vom 1. (Januar) bis 12. (Dezember) auswertet.
  • day: Ein Ausdruck, der INTEGER einen Wert von 1 bis 31 auswertet.
  • hour: Ein Ausdruck, der INTEGER einen Wert zwischen 0 und 23 auswertet.
  • min: Ein Ausdruck, der INTEGER auf einen Wert zwischen 0 und 59 auswertet.
  • sec: Ein numerischer Ausdruck, der in einen Wert zwischen 0 und 60 ausgewertet wird.
  • date: Ein Ausdruck, der DATE die Felder von Jahr, Monat und Tag angibt.
  • time: Ein optionaler TIME Ausdruck, der die Felder Stunde, Minute und Sekunde angibt. 00:00:00 Wird standardmäßig nicht angegeben.
  • timezone: Ein optionaler STRING Ausdruck, der eine gültige Zeitzone CET wie oder UTCauswertet.

Gibt zurück

Ein TIMESTAMP.

Ist ein Argument außerhalb der Grenzen, erhebt die Funktion DATETIME_FIELD_OUT_OF_BOUNDS. Benutze stattdessen try_make_timestamp , um zurückzukehren NULL .

Ist sec60, interpretiert die Funktion es als und 0 fügt dem Ergebnis eine Minute hinzu.

Wenn sec einen Bruchwert aufweist, der in Mikrosekunden nicht dargestellt werden kann, löst Azure Databricks INVALID_FRACTION_OF_SECOND aus.

Häufige Fehlerbedingungen

Beispiele

> SELECT make_timestamp(2014, 12, 28, 6, 30, 45.887);
 2014-12-28 06:30:45.887
> SELECT make_timestamp(2014, 12, 28, 6, 30, 45.887, 'CET');
 2014-12-27 21:30:45.887
> SELECT make_timestamp(2019, 6, 30, 23, 59, 60);
 2019-07-01 00:00:00
> SELECT make_timestamp(NULL, 7, 22, 15, 30, 0);
 NULL

> SELECT make_timestamp(DATE'2014-12-28', TIME'06:30:45.887');
 2014-12-28 06:30:45.887

> SELECT make_timestamp(DATE'2014-12-28', TIME'06:30:45.887', 'CET');
 2014-12-27 21:30:45.887

> SELECT make_timestamp(DATE'2014-12-28');
 2014-12-28 00:00:00

> SELECT make_timestamp(2024, 13, 1, 0, 0, 0);
  Error: DATETIME_FIELD_OUT_OF_BOUNDS