make_timestamp函式

適用於:勾選為「是」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