支持的日期和时间格式

时间格式

本页以 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。

复合格式

本页以 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 week july 2008" 和 "july 2008 +1 week" 等效。

此规则的例外情况包括："yesterday"、"midnight"、"today"、"noon" 和 "tomorrow"。请注意 "tomorrow 11:00" 和 "11:00 tomorrow" 是不同的。假设今天是 "2008 年 7 月 23 日"，第一个会生成 "2008-07-24 11:00"，而第二个会生成 "2008-07-24 00:00"。这是因为这五个语句会直接影响当前时间。

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

注意:

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

1. "dayname" 不会提前到另一天。（例如："Wed July 23rd, 2008" 表示 "2008-07-23"）。
2. "number dayname" 不会提前到另一天。（例如："1 wednesday july 23rd, 2008" 表示 "2008-07-23"）。
3. "number week dayname" 将首先添加周数，但不会提前到另一天。在这种情况下，"number week" 和 "dayname" 是两个不同的块。（例如："+1 week wednesday july 23rd, 2008" 表示 "2008-07-30"）。
4. "ordinal dayname" 会提前到另一天。（例如 "first wednesday july 23rd, 2008" 表示 "2008-07-30"）。
5. "number week ordinal dayname" 将首先添加周数，然后提前到另一天。在这种情况下，"number week" 和 "ordinal dayname" 是两个不同的块。（例如："+1 week first wednesday july 23rd, 2008" 表示 "2008-08-06"）。
6. "ordinal dayname 'of' " 不会提前到另一天。（例如："first wednesday of july 23rd, 2008" 表示 "2008-07-02"，因为包含 'of' 的特定短语会将日重置为 '1'，并且 '23rd' 在这里会被忽略）。

还要注意，"ordinal space dayname space 'of' " 和 "'last' space dayname space 'of' " 中的 "of" 会做一些特殊的事情。

1. 它会将日设置为 1。
2. "ordinal dayname 'of' " 不会提前到另一天。（例如："first tuesday of july 2008" 表示 "2008-07-01"）。
3. "ordinal dayname " 会提前到另一天。（例如："first tuesday july 2008" 表示 "2008-07-08"，另请参阅上述列表中的第 4 点）。
4. "'last' dayname 'of' " 会获取当前月份的最后一个 dayname。（例如："last wed of july 2008" 表示 "2008-07-30"）
5. "'last' dayname" 会从当前日期获取最后一个 dayname。（例如："last wed july 2008" 表示 "2008-06-25"；"july 2008" 首先将当前日期设置为 "2008-07-01"，然后 "last wed" 会移动到上一个星期三，即 "2008-06-25"）。

注意:

相对月值是根据它们所经过的月份的长度来计算的。例如，"+2 month 2011-11-30" 会生成 "2012-01-30"。这是因为 11 月有 30 天，12 月有 31 天，总共为 61 天。

注意:

number 是一个整数；如果给出小数，则小数点（或逗号）可能会被解释为分隔符。例如，'+1.5 hours' 将被解析为 '+1 5 hours'，而不是 '+1 hour +30 minutes'。