

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

# 日期時間格式字串
<a name="FORMAT_strings"></a>

您可以在下列常見案例中使用日期時間模式：
+ 使用 CSV 和 JSON 資料來源來剖析和格式化日期時間內容時
+ 使用下列函數在字串類型和日期或時間戳記類型之間轉換時：
  + unix\$1timestamp
  + date\$1format
  + to\$1unix\$1timestamp
  + from\$1unixtime
  + to\$1date
  + to\$1timestamp
  + from\$1utc\$1timestamp
  + to\$1utc\$1timestamp

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

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/clean-rooms/latest/sql-reference/FORMAT_strings.html)

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

文字格式
+ 縮寫格式請使用 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 個字母：顯示小時 (\$101) 或小時/分鐘 (\$10130)
  + 2 個字母：顯示不含冒號的小時/分鐘 (\$10130)
  + 3 個字母：顯示含冒號的小時/分鐘 (\$101：30)
  + 4 個字母：顯示不含冒號hour-minute-second (\$1013015)
  + 5 個字母：顯示含冒號的hour-minute-second (\$101：30：15)
  + X 使用 'Z' 進行零位移
  + x 使用 '\$100'、'\$10000' 或 '\$100：00' 進行零位移
+ O: 
  + 1 個字母：顯示簡短格式 (GMT\$18)
  + 4 個字母：顯示完整格式 (GMT\$108：00)
+ Z：
  + 1-3 個字母：顯示不含冒號的小時/分鐘 (\$10130)
  + 4 個字母：顯示完整的當地語系化表單
  + 5 個字母：以冒號顯示hour-minute-second 

選用區段
+ 使用方括號 【 】 標記選用內容
+ 您可以將選用區段巢狀化
+ 所有有效的資料都會顯示在輸出中
+ 輸入可以省略整個選用區段

**注意**  
符號 'E'、'F'、'q' 和 'Q' 僅適用於日期時間格式 （例如 date\$1format)。請勿將它們用於日期時間剖析 （例如 to\$1timestamp)。