支援的日期和時間格式

時間格式

此頁面以類似 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」。

注意:

「日期、月份和兩位數年份，帶點或 Tab」格式 (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 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 空格 dayname 空格 'of' 」和「'last' 空格 dayname 空格 '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'。