本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 日期時間格式字串
您可以在下列常見案例中使用日期時間模式：
+ 使用 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)。