日期時間格式字串 - AWS Clean Rooms

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

日期時間格式字串

您可以在下列常見案例中使用日期時間模式：

  • 使用 CSV 和 JSON 資料來源來剖析和格式化日期時間內容時

  • 使用下列函數在字串類型和日期或時間戳記類型之間轉換時：

    • unix_timestamp

    • date_format

    • to_unix_timestamp

    • from_unixtime

    • to_date

    • to_timestamp

    • from_utc_timestamp

    • to_utc_timestamp

使用下表中的模式字母進行日期和時間戳記剖析和格式化。

日期部分或時間部分 意義 範例
a 當日上午或下午，以上午至下午顯示 PM
D 一年中的某一天，以 3 位數字顯示

189
d 當月日期，以 2 位數字顯示 28
E 星期幾，以文字顯示

星期二

週二
F 對齊當月的星期幾，以 1 位數字顯示 3
G Era 指標，以文字顯示

.ade

安諾多米尼
h AM 或 PM 的時鐘小時，以 2 位數字表示 12
H 一天中的小時，以 0-23 的 2 位數字顯示 0
k 一天的時鐘小時，以 1–24 之間的 2 位數字顯示 1
K 上午或下午小時，以 0–11 之間的 2 位數字顯示 0
m 小時分鐘，以 2 位數字顯示 30
M/L 一年中的月份，以月份顯示

7

07

7 月

7 月
O 本地化區域偏離 UTC

GMT+8

GMT+8：00

UTC-08：00
Q/q 一年的季度，以數字 (1 到 4) 或文字顯示

3

03

Q3

第三季度
s 分鐘的秒數，以 2 位數字顯示 55
S 一秒的分數，以分數表示 978
V 時區識別符，以 zone-id 顯示

America/Los_Angeles

Z

08：30
x 區域偏離 UTC (offset-X)

+0000

-08

-0830

-08：30

-083015

-08：30：15
X 區域偏離 UTC；其中 Z 為零

Z

-08

-0830

-08：30

-083015

-08：30：15
y 年，顯示為一年

2020

20
z 時區名稱，以文字顯示

太平洋標準時間

PST
Z 區域偏離 UTC (offset-Z)

+0000

-0800

-08：00
' 文字逸出，顯示為分隔符號 N/A
'' 單引號，以常值呈現 '
[ 選用區段開始 N/A
] 選用區段結束 N/A

模式字母的數量決定格式類型：

文字格式

  • 縮寫格式請使用 1-3 個字母 （例如，星期一的「星期一」)

  • 完整格式只能使用 4 個字母 （例如，「星期一」)

  • 請勿使用 5 個或更多字母 - 這會導致錯誤

數字格式 (n)

  • 值 n 代表允許的字母數目上限

  • 對於單一字母模式：

    • 輸出使用不含填補的最小數字

  • 對於多個字母模式：

    • 輸出以零填補，以符合字母計數寬度

  • 剖析時，輸入必須包含確切的位數

數字/文字格式

  • 對於 3 個或更多字母，請遵循文字格式規則

  • 對於較少的字母，請遵循數字格式規則

分數格式

  • 使用 1-9 個 'S' 字元 （例如 SSSSSS)

  • 針對剖析：

    • 接受介於 1 和 S 字元數之間的分數

  • 針對格式化：

    • 以零填補以符合 S 字元數

  • 支援高達 6 位數的微秒精確度

  • 可以剖析奈秒，但會截斷額外的數字

年格式

  • 字母計數會設定填補的最小欄位寬度

  • 對於兩個字母：

    • 列印最後兩位數字

    • 2000-2099 之間的剖析年數

  • 對於少於四個字母 （除了兩個）：

    • 僅顯示負數年份的符號

  • 請勿使用 7 個或更多字母 - 這會導致錯誤

月格式

  • 將 'M' 用於標準表單，將 'L' 用於獨立表單

  • 單一 'M' 或 'L'：

    • 顯示不含填補的月份編號 1-12

  • 'MM' 或 'LL'：

    • 顯示含填補的月份編號 01-12

  • 'MMM'：

    • 以標準格式顯示縮寫月份名稱

    • 必須是完整日期模式的一部分

  • 'LLL'：

    • 以獨立形式顯示縮寫月份名稱

    • 使用 進行僅限月份的格式化

  • 'MMMM'：

    • 以標準格式顯示完整月份名稱

    • 將 用於日期和時間戳記

  • 'LLLL'：

    • 以獨立形式顯示完整月份名稱

    • 使用 進行僅限月份的格式化

時區格式

  • am-pm：僅使用 1 個字母

  • 區域 ID (V)：僅使用 2 個字母

  • 區域名稱 (z)：

    • 1-3 個字母：顯示簡短名稱

    • 4 個字母：顯示全名

    • 請勿使用 5 個或更多字母

位移格式

  • X 和 x：

    • 1 個字母：顯示小時 (+01) 或小時/分鐘 (+0130)

    • 2 個字母：顯示不含冒號的小時/分鐘 (+0130)

    • 3 個字母：顯示含冒號的小時/分鐘 (+01：30)

    • 4 個字母：顯示不含冒號hour-minute-second (+013015)

    • 5 個字母：顯示含冒號的hour-minute-second (+01：30：15)

    • X 使用 'Z' 進行零位移

    • x 使用 '+00'、'+0000' 或 '+00：00' 進行零位移

  • O:

    • 1 個字母：顯示簡短格式 (GMT+8)

    • 4 個字母：顯示完整格式 (GMT+08：00)

  • Z：

    • 1-3 個字母：顯示不含冒號的小時/分鐘 (+0130)

    • 4 個字母：顯示完整的當地語系化表單

    • 5 個字母：以冒號顯示hour-minute-second

選用區段

  • 使用方括號 【 】 標記選用內容

  • 您可以將選用區段巢狀化

  • 所有有效的資料都會顯示在輸出中

  • 輸入可以省略整個選用區段

注意

符號 'E'、'F'、'q' 和 'Q' 僅適用於日期時間格式 （例如 date_format)。請勿將它們用於日期時間剖析 （例如 to_timestamp)。