日期时间格式说明

日期时间格式说明

概述

在处理和展示日期时间信息时，我们通常需要按照一定的格式来组织和格式化这些信息。本文档提供了一套常用的日期时间格式符号，以及它们的含义、格式和示例，以帮助您更好地理解和使用这些符号。

格式符号详解

符号	描述	格式示例	示例值
G	纪元	AD; Anno Domini	公元
y	年	year	2020; 20
D	一年中的第几天	number(3)	189
M	月份	month	7; 07; Jul; July
d	月份中的天	number(2)	28
Q	季度	number/text	3; 03; Q3; 3rd quarter
E	星期中的天	text	Tue; Tuesday
a	上午/下午	am-pm	PM
h	12小时制小时	number(2)	12
K	上午/下午小时	number(2)	0
k	24小时制小时	number(2)	0
H	24小时制小时	number(2)	0
m	分钟	number(2)	30
s	秒	number(2)	55
S	毫秒/微秒	fraction	978
V	时区ID	zone-id	America/Los_Angeles; Z; -08:30
z	时区名称	zone-name	Pacific Standard Time; PST
O	本地化时区偏移量	offset-O	GMT+8; GMT+08:00; UTC-08:00;
X	时区偏移量	offset-X	Z; -08; -0830; -08:30; -083015; -08:30:15;
Z	时区偏移量	offset-Z	+0000; -0800; -08:00;
''	单引号	literal	’

符号使用示例

• 年份:

  • yyyy

    yyyy
    : 四位数年份表示法，例如 2022。

  • yy

    yy
    : 两位数年份表示法，例如 22。

• 月份:

  • M

    M
    : 单位数月份表示法，例如 3、12。

  • MM

    MM
    : 双位数月份表示法，例如 03、12。

• 当月天数:

  • d

    d
    : 单位数当月日期表示法，例如 5、20。

  • dd

    dd
    : 双位数当月日期表示法，例如 05、20。

• 小时 (24小时制):

  • H

    H
    : 单位数24小时制小时表示法，例如 1、23。

  • HH

    HH
    : 双位数24小时制小时表示法，例如 01、23。

• 分钟:

  • m

    m
    : 单位数分钟表示法，例如 4、59。

  • mm

    mm
    : 双位数分钟表示法，例如 04、59。

• 秒:

  • s

    s
    : 单位数秒钟表示法，例如 8、59。

  • ss

    ss
    : 双位数秒钟表示法，例如 08、59。

• 毫秒/微秒:

  • S

    S
    : 支持1-9位数字，表示毫秒（前3位）、微秒（中间3位）和纳秒（后3位）。CZ目前只支持微秒精度，因此解析时间字符串时纳秒会被丢弃，生成时间字符串时纳秒部分则会置零。不足9位时，从右向左降低精度。

示例

以下是一些使用上述符号的日期时间格式示例：

• yyyy-MM-dd HH:mm:ss.SSSS

  yyyy-MM-dd HH:mm:ss.SSSS
  : 2022-01-10 10:05:02.1232

• yyyy/MM/dd HH:mm:ss.SSSS

  yyyy/MM/dd HH:mm:ss.SSSS
  : 2022/01/10 10:05:0