DATETIME 函式

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

基本用法

整數文字值:

derive type:single value: DATEFORMAT(DATETIME(2015,02,15, 2, 4, 0),'yyyy-MM-dd:HH:mm:ss')

輸出:產生的資料欄中所含的值,為已設定日期格式的值:2015-02-15:02:04:00

資料欄參照值:

derive type:single value: DATEFORMAT( DATETIME(myYear, myMonth, myDay, myHour, myMin, mySec),'MMM yyyy - HH:MM:SS')

輸出:產生含有日期值的資料欄,其中:

  • MMM = myMonth 的縮寫值
  • yyyy = 來自 myYear 的值
  • HH = 來自 myHour 的值
  • MM = 來自 myMin 的值
  • SS = 來自 mySec 的值

語法

derive type:single value:DATEFORMAT(DATETIME(year_integer_col,month_integer_col,day_Integer_col, hour_Integer_col, minute_Integer_col,second_Integer_col ),'date_format_string')

引數是否必要?資料類型說明
year_integer_col整數資料欄名稱或整數文字,代表要套用至函式的年份值
month_integer_col整數資料欄名稱或整數文字,代表要套用至函式的月份值
day_integer_col整數資料欄名稱或整數文字,代表要套用至函式的日值
hour_integer_col整數資料欄名稱或整數常值,代表要套用至函式的小時值
minute_integer_col整數資料欄名稱或整數常值,代表要套用至函式的分鐘值
second_integer_col整數資料欄名稱或整數文字,代表要套用至函式的秒數值
date_format_string字串字串文字,用以識別值要套用至值的日期格式

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

year_integer_col

整數文字或資料欄名稱,其中含有年份的整數值。

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

使用須知:

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

month_integer_col

整數常值或資料欄名稱,其中含有月份的整數值。

  • 值必須為 1 以上,上限值為 12
  • 此函式的來源資料如果有遺漏值,輸出結果也會出現遺漏值。
  • 不支援多個資料欄和萬用字元。

使用須知:

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

day_integer_col

整數文字或資料欄名稱,其中含有日的整數值。

  • 值必須為 1 以上,且任一月份的上限值為 31
  • 此函式的來源資料如果有遺漏值,輸出結果也會出現遺漏值。
  • 不支援多個資料欄和萬用字元。

使用須知:

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

hour_integer_col

整數文字或資料欄名稱,其中含有小時的整數值。

  • 值必須是 0 以上,且小時的上限值為 23
  • 此函式的來源資料如果有遺漏值,輸出結果也會出現遺漏值。
  • 不支援多個資料欄和萬用字元。

使用須知:

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

minute_integer_col

整數文字或資料欄名稱,其中含有分鐘的整數值。

  • 值必須是 0 以上,且分鐘的上限值為 59
  • 此函式的來源資料如果有遺漏值,輸出結果也會出現遺漏值。
  • 不支援多個資料欄和萬用字元。

使用須知:

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

second_integer_col

整數文字或資料欄名稱,其中含有秒數的整數值。

  • 值必須是 0 以上,且秒數的上限值為 59
  • 此函式的來源資料如果有遺漏值,輸出結果也會出現遺漏值。
  • 不支援多個資料欄和萬用字元。

使用須知:

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

date_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 說明文件
需要協助嗎?請前往我們的支援網頁