TIME 函式

用下列三種整數的輸入值來產生時間值:小時、分鐘和秒鐘。
  • 來源值可以是整數常值,或是可推測為整數的資料欄參照值。
  • 如果任一來源值為無效或超出範圍,系統就會傳回遺漏值。
  • 此函式必須被嵌入於其他可接受以日期值做為引數的函式內。請參閱下方的範例。

基本用法

整數常值:

derive type:single value: DATEFORMAT(TIME(23,58,59),'HH mm ss')

輸出:產生含有對應值的資料欄值:

23 58 59

資料欄參照值:

derive type:single value: DATEFORMAT(TIME(myHour, myMinute, mySecond), 'hh-mm-ss')

輸出:產生資料欄值,其中的值:

  • hh = 來自 myHour 資料欄的值
  • mm = 來自 myMinute 資料欄的值
  • ss = 來自 mySecond 資料欄的值

語法

derive type:single value:DATEFORMAT(TIME(hour_integer_col,minute_integer_col,second_integer_col ),'time_format_string')

引數是否必要?資料類型說明
hour_integer_col整數資料欄名稱或整數常值,代表要套用至函式的小時值
minute_integer_col整數資料欄名稱或整數常值,代表要套用至函式的分鐘值
second_integer_col整數資料欄名稱或整數常值,代表待套用至函式的秒鐘值
time_format_string字串識別待套用時間格式值的字串文字

如要進一步瞭解語法標準,請參閱語言文件語法附註一文。

hour_integer_col

整數常值,或是內含小時整數值之資料欄的名稱。值必須為介於 0 到 23 之間的整數。

  • 此函式的來源資料如果有遺漏值,也會導致輸出結果出現遺漏值。
  • 不支援多個資料欄和萬用字元。

使用須知:

是否必要?資料類型示例值
整數 (常值或資料欄參照)15

minute_integer_col

整數常值,或是內含分鐘整數值之資料欄的名稱。值必須為介於 0 到 59 之間的整數。

  • 此函式的來源資料如果有遺漏值,也會導致輸出結果出現遺漏值。
  • 不支援多個資料欄和萬用字元。

使用須知:

是否必要?資料類型示例值
整數 (常值或資料欄參照)23

second_integer_col

整數常值,或是內含秒鐘整數值之資料欄的名稱。值必須為介於 0 到 59 之間的整數。

  • 此函式的來源資料如果有遺漏值,也會導致輸出結果出現遺漏值。
  • 不支援多個資料欄和萬用字元。

使用須知:

是否必要?資料類型示例值
整數 (常值或資料欄參照)45

time_format_string

如要進一步瞭解支援的時間格式字串,請參閱支援的資料類型一文。

如需更多資訊,請參閱 DATEFORMAT 函式一文。

範例

範例 - 日期和時間函式

這個範例會示範如何使用 DATETIME 函式。兩個函式的輸出皆需要使用 DATEFORMAT 函式來設定正確格式。

  • DATE - 輸入三個整數來產生有效的日期時間值:年、月和日。請參閱 DATE 函式一文。
  • TIME - 輸入三個整數來產生有效的日期時間值:時、分和秒。請參閱 TIME 函式一文。
  • DATETIME - 輸入六個整數來產生有效的 Datetime 值:年、月、日、時、分和秒。請參閱 DATETIME 函式一文。
  • DATEFORMAT - 根據提供的格式設定字串來設定有效的 Datetime 值格式。請參閱 DATEFORMAT 函式一文。

來源:

yearmonthdayhourminutesecond
20161011230
20151120152230
20141225183045

轉換:

derive type:single value: DATEFORMAT(DATE (year, month, day),'yyyy-MM-dd') as:'fctn_date'

derive type:single value: DATEFORMAT(TIME (hour, minute, second),'HH-mm-ss') as:'fctn_time'

derive type:single value: DATEFORMAT(DATETIME (year, month, day, hour, minute, second),'yyyy-MM-dd-HH:mm:ss') as:'fctn_datetime'


結果:

注意:所有輸入必須被推測為整數類型,且必須是指定輸入的有效值。例如,月份值必須為 1 到 12 (含首尾) 的整數。

yearmonthdayhourminutesecondfctn_datefctn_timefctn_datetime
201610112302016-10-1102-03-002016-10-11-02:03:00
201511201522302015-11-2015-22-302015-11-20-15:22:30
201412251830452014-12-2518-30-452014-12-25-18:30:45

您可以套用其他日期和時間函式來產生資料欄。如需範例,請參閱 YEAR 函式一文。

本頁內容對您是否有任何幫助?請提供意見:

傳送您對下列選項的寶貴意見...

這個網頁
Google Cloud Dataprep 說明文件
需要協助嗎?請前往我們的支援網頁