UNIXTIMEFORMAT 函式

依據指定的日期格式字串,設定一組 Unix 時間戳記的格式。

來源值可以是含有 Unix 時間戳記值的資料欄參照。

注意:在套用此函式前,日期值必須先轉換為 Unix 時間戳記。Unix 時間會測量從世界標準時間 1970年 1 月 1 日 00:00:00 算起的毫秒數。請參閱 UNIXTIME 函式一文。

用於此函式的支援格式字串,和用於 DATEFORMAT 函式的支援格式字串相同。如需進一步瞭解這類字串值,請參閱支援的資料類型一文。

  • 如需進一步瞭解 Unix 格式設定或標準日期格式,請參閱 DATEFORMAT 函式一文。
  • 如需進一步瞭解數字類型的格式設定,請參閱 NUMFORMAT 函式一文。

基本用法

derive type:single value: UNIXTIMEFORMAT(MyUnixDate, 'yyyy-MM-dd') as: 'unixDate'

輸出:依據轉換為「年-月-日」格式的 Unix 時間戳記值的 unixDate 資料欄,在 MyUnixDate 資料欄中產生日期時間值。

語法

derive type:single value:UNIXTIMEFORMAT(unixtime_col, date_format_string)

引數是否必要?資料類型說明
unixtime_col日期時間待設定 Unix 時間戳記值格式的資料欄名稱。
date_format_string字串字串文字,用以識別值要套用至值的日期格式

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

unixtime_col

待設定 Unix 時間資料格式的資料欄名稱。

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

使用須知:

是否必要?資料類型示例值
日期時間 (格式採 Unix 時間整數值)myDate

date_format_string

字串值,代表輸入值要套用的日期格式。

注意:如果平台無法識別資料格式字串,其所產生的結果會以字串值寫入。

如需進一步瞭解支援的格式設定字串,請見以下說明:

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

使用須知:

是否必要?資料類型示例值
字串'MM/dd/yyyy'

範例

範例 - Unix 時間戳記格式設定變化

說明unixTimestamp 資料欄轉換newUnixTimestamp 資料欄
數字格式日期 (以年開頭)

1454946120000

1451433600000

1430032020000

derive type:single value:UNIXTIMEFORMAT(unixTimestamp,'yyyy-MM-dd') as:'newUnixTimestamp'

2016-02-08

2015-12-30

2015-04-26

數字格式日期 (美式)

1454946120000

1451433600000

1430032020000

derive type:single value:UNIXTIMEFORMAT(unixTimestamp,'M/d/yy') as:'newUnixTimestamp'

2/8/16

12/30/15

4/26/15

完整寫入的日期

1454946120000

1451433600000

1430032020000

derive type:single value:UNIXTIMEFORMAT(unixTimestamp,'MMMM dd, yyyy') as:'newUnixTimestamp'

2016 年 2 月 8 日

2015 年 12 月 30 日

2015 年 4 月 26 日

縮寫日期
(包含縮寫的
星期幾)

1454946120000

1451433600000

1430032020000

derive type:single value:UNIXTIMEFORMAT(unixTimestamp,'EEE MMM dd, yyyy') as:'newUnixTimestamp'

2016 年 2 月 8 日週一

2015 年 12 月 30 日週三

2015 年 4 月 26 日週日

完整的 24 小時制

1454946120000

1451433600000

1430032020000

derive type:single value:UNIXTIMEFORMAT(unixTimestamp,'HH:mm:ss.SSS') as:'newUnixTimestamp'

15:42:00.000

00:00:00.000

07:07:00.00

12 小時制 (含 AM/PM 標記)

1454946120000

1451433600000

1430032020000

derive type:single value:UNIXTIMEFORMAT(unixTimestamp,'h:mm:ss a') as:'newUnixTimestamp'

注意:在此函式中,使用小寫的小時標記 (hhh) 時,需要使用 AM/PM 標記 (a)。

3:42:00 PM

12:00:00 AM

7:07:00 AM

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

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

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