Funkcja make_timestamp

Dotyczy:zaznacz pole wyboru oznaczone jako tak Databricks SQL zaznacz pole wyboru oznaczone jako tak Databricks Runtime

Tworzy znacznik czasu z pól year, month, day, hour, min, sec i timezone.

Składnia

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

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

Important

Argument time wykorzystuje TIME typ danych, który jest w wersji beta.

Argumenty

  • year: Wyrażenie oceniające INTEGER wartość od 1 do 9999.
  • month: Wyrażenie INTEGER oceniające wartość od 1 (styczeń) do 12 (grudzień).
  • day: Wyrażenie oceniające INTEGER na wartość od 1 do 31.
  • hour: Wyrażenie oceniające INTEGER wartość od 0 do 23.
  • min: Wyrażenie oceniające INTEGER wartość od 0 do 59.
  • sec: wyrażenie liczbowe oceniające wartość z zakresu od 0 do 60.
  • date: Wyrażenie podawające DATE pola roku, miesiąca i dnia.
  • time: Opcjonalne TIME wyrażenie podawające pola godzina, minuta i sekunda. Wartość domyślna to 00:00:00 w przypadku pominięcia.
  • timezone: Opcjonalne STRING wyrażenie oceniające do prawidłowej strefy czasowej, takiej jak CET lub UTC.

Zwraca

Element TIMESTAMP.

Jeśli argument jest poza granicami, funkcja podnosi DATETIME_FIELD_OUT_OF_BOUNDS. Użyj try_make_timestamp do powrotu NULL .

Jeśli sec jest , 60funkcja interpretuje ją jako 0 i dodaje do wyniku o minutę.

Jeśli sec ma wartość ułamkową, której nie można przedstawić w dokładności mikrosekund, Azure Databricks podnosi INVALID_FRACTION_OF_SECOND.

Typowe warunki błędów

Przykłady

> 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