

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 日期时间格式字符串
<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_cn/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
+ 'MM'：
  + 以标准格式显示缩写的月份名称
  + 必须是完整日期模式的一部分
+ '哈哈'：
  + 以独立形式显示缩写的月份名称
  + 用于仅限月份的格式
+ 'MMM'：
  + 以标准格式显示完整的月份名称
  + 用于日期和时间戳
+ '哈哈'：
  + 以独立形式显示完整的月份名称
  + 用于仅限月份的格式

时区格式
+ 上午至下午：仅使用 1 个字母
+ 区域 ID (V)：仅使用 2 个字母
+ 区域名称 (z): 
  + 1-3 个字母：显示简称
  + 4 个字母：显示全名
  + 不要使用 5 个或更多字母

偏移格式
+ X 和 x：
  + 1 个字母：显示小时 (\$101) 或小时分钟 (\$10130)
  + 2 个字母：显示不带冒号的小时分钟 (\$10130)
  + 3 个字母：显示带冒号的小时分钟 (\$1 01:30)
  + 4 个字母：显示时 hour-minute-second不带冒号 (\$1013015)
  + 5 个字母： hour-minute-second用冒号显示 (\$1 01:30:15)
  + X 使用 'Z' 表示零偏移
  + x 使用 '\$100'、'\$10000' 或 '\$1 00:00 '作为零偏移量
+ O: 
  + 1 个字母：显示简写形式 (GMT\$18)
  + 4 个字母：显示完整表格 (GMT\$1 08:00)
+ Z: 
  + 1-3 个字母：显示不带冒号的小时分钟 (\$10130)
  + 4 个字母：显示完整的本地化表单
  + 5 个字母： hour-minute-second用冒号显示

可选章节
+ 使用方括号 [] 标记可选内容
+ 您可以嵌套可选部分
+ 所有有效数据都显示在输出中
+ 输入可以省略整个可选部分

**注意**  
符号 'E'、'F'、'q' 和 'Q' 仅适用于日期时间格式（例如 date\$1format）。不要使用它们来解析日期时间（比如 to\$1timestamp）。