適用於:
Databricks SQL
Databricks Runtime
從year、month、、、dayhour、min、 sec和 timezone欄位建立時間戳記。
語法
make_timestamp(year, month, day, hour, min, sec [, timezone] )
make_timestamp(date [, time [, timezone]] )
Important
這個 time 參數使用了 TIME 資料型態,目前為 Beta。
引數
-
year:一個INTEGER從1到9999的值的表達式。 -
month:一個INTEGER計算值從1(1月)到12(12月)的表達式。 -
day:一個INTEGER計算式,取值從1到31。 -
hour:一個INTEGER值介於0到23之間的表達式。 -
min:一個INTEGER值介於0到59之間的表達式。 -
sec:一個數值表達式,評估得出的值介於 0 到 60 之間。 -
date:一個DATE表示式,提供年份、月份和日域。 -
time:一個可選TIME表達式,提供小時、分鐘和秒欄位。 若省略則預設為00:00:00。 -
timezone:一個可選的表達式,可評估STRING到有效時區,例如CET或UTC。
退貨
A TIMESTAMP。
如果參數超出邊界,函數會升 DATETIME_FIELD_OUT_OF_BOUNDS。 用 try_make_timestamp 來回去 NULL 吧。
若 sec , 60函數將其解釋為 0 ,並為結果加一分鐘。
若 sec 的分數值無法以微秒精度表示,Azure Databricks 會提高 INVALID_FRACTION_OF_SECOND。
常見錯誤條件
範例
> 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