支持的日期和时间格式

时间格式

此页面以类似BNF的语法描述了DateTimeImmutable、DateTime、date_create()、date_create_immutable()和strtotime()解析器理解的不同日期/时间格式。

要格式化DateTimeImmutable和DateTime对象，请参考DateTimeInterface::format()方法的文档。

日期格式

此页面以类似BNF的语法描述了DateTimeImmutable、DateTime、date_create()、date_create_immutable()和strtotime()解析器理解的不同日期格式。

要格式化DateTimeImmutable和DateTime对象，请参考DateTimeInterface::format()方法的文档。

注意:

对于 y 和 yy 格式，当使用 y 或 yy 符号时，年份低于 100 的处理方式特殊。如果年份在 0（含）到 69（含）之间，则添加 2000。如果年份在 70（含）到 99（含）之间，则添加 1900。这意味着 "00-01-01" 将被解释为 "2000-01-01"。

注意:

“带点或制表符的日期、月份和两位数年份”格式 (dd [.\t] mm "." yy) 仅适用于 61（含）到 99（含）之间的年份值——在这些年份之外，时间格式 "HH [.:] MM [.:] SS" 优先。

注意:

“年份（仅年份）”格式只有在已找到时间字符串的情况下才能可靠地工作。否则，如果四位数年份与 HH MM 匹配，则会设置这两个日期元素。

要一致地解析仅年份，请使用 DateTimeImmutable::createFromFormat() 和 Y 说明符。

复合格式

此页面以类似 BNF 的语法描述了 DateTimeImmutable、DateTime、date_create()、date_create_immutable() 和 strtotime() 解析器理解的不同复合日期/时间格式。

要格式化DateTimeImmutable和DateTime对象，请参考DateTimeInterface::format()方法的文档。

注意:

“带 ISO 星期的 ISO 年份”和“带 ISO 星期和日期的 ISO 年份”格式中的“W”区分大小写，只能使用大写“W”。

SOAP、XMLRPC 和 WDDX 格式中的“T”区分大小写，只能使用大写“T”。

“Unix 时间戳”格式将时区设置为 UTC。

相对格式

此页面以类似 BNF 的语法描述了 DateTimeImmutable、DateTime、date_create()、date_create_immutable() 和 strtotime() 解析器理解的不同相对日期/时间格式。

要格式化DateTimeImmutable和DateTime对象，请参考DateTimeInterface::format()方法的文档。

注意:

相对语句始终在非相对语句之后处理。这使得“+1周 2008年7月”和“2008年7月 +1周”等效。

此规则的例外情况是：“昨天”、“午夜”、“今天”、“中午”和“明天”。请注意，“明天11:00”和“11:00明天”是不同的。如果今天的日期是“2008年7月23日”，则前者产生“2008-07-24 11:00”，而后者产生“2008-07-24 00:00”。原因是这五个语句直接影响当前时间。

诸如“第一天”之类的关键字取决于使用相对格式字符串的上下文。如果与静态方法或函数一起使用，则引用是当前系统时间戳。但是，如果在DateTime::modify()或DateTimeImmutable::modify()中使用，则引用是调用modify()方法的对象。

注意:

当当前星期几与日期/时间字符串中使用的星期几相同时，请注意以下说明。但是，当前星期几可能是由日期/时间字符串的非相对部分（重新）计算的。

1. “星期几”不会提前到另一天。（例如，“2008年7月23日星期三”表示“2008-07-23”。）
2. “数字 星期几”不会提前到另一天。（例如，“2008年7月23日星期三1”表示“2008-07-23”。）
3. “数字 周 星期几”将首先添加周数，但不会提前到另一天。在这种情况下，“数字 周”和“星期几”是两个不同的块。（例如，“+1周 2008年7月23日星期三”表示“2008-07-30”。）
4. “序数 星期几”会提前到另一天。（例如，“2008年7月23日第一个星期三”表示“2008-07-30”。）
5. “数字 周 序数 星期几”将首先添加周数，然后提前到另一天。在这种情况下，“数字 周”和“序数 星期几”是两个不同的块。（例如，“+1周 2008年7月23日第一个星期三”表示“2008-08-06”。）
6. “序数 星期几 ‘的’ ”不会提前到另一天。（例如，“2008年7月23日第一个星期三的”表示“2008-07-02”，因为带有‘的’的特定短语会将月份的天数重置为‘1’，而此处忽略了‘23日’。）

还要注意，“序数 空格 星期几 空格 ‘的’ ”和“‘最后一个’ 空格 星期几 空格 ‘的’ ”中的“的”具有特殊作用。

1. 它将月份的天数设置为1。
2. “序数 星期几 ‘的’ ”不会提前到另一天。（例如，“2008年7月的第一个星期二”表示“2008-07-01”。）
3. “序数 星期几 ”会提前到另一天。（例如，“2008年7月的第一个星期二”表示“2008-07-08”，另见上列表格中的第4点。）
4. “‘最后一个’ 星期几 ‘的’ ”取当前月份的最后一个星期几。（例如，“2008年7月的最后一个星期三”表示“2008-07-30”。）
5. “‘最后一个’ 星期几”取自当前日期的最后一个星期几。（例如，“2008年7月的最后一个星期三”表示“2008-06-25”；“2008年7月”首先将当前日期设置为“2008-07-01”，然后“最后一个星期三”移动到之前的星期三，即“2008-06-25”。）

注意:

相对月份值是根据它们经过的月份的长度计算的。例如，“+2个月 2011-11-30”将产生“2012-01-30”。这是因为11月有30天，12月有31天，总共61天。

注意:

数字是一个整数；如果给出十进制数，则点（或逗号）可能会被解释为分隔符。例如，'+1.5小时'被解析为'+1 5小时'，而不是'+1小时 +30分钟'。