From c7b1e10b38ea5fbd53b1a39e4cd8154b1c49a42e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=AD=A6=E7=94=B0=20=E6=86=B2=E5=A4=AA=E9=83=8E?= Date: Sat, 14 Nov 2026 12:54:20 +0900 Subject: [PATCH] =?UTF-8?q?datetime=20=E3=82=92=E5=8E=9F=E6=96=87=E3=81=AE?= =?UTF-8?q?=E5=A4=89=E6=9B=B4=E3=81=AB=E8=BF=BD=E5=BE=93=20(14=E3=83=95?= =?UTF-8?q?=E3=82=A1=E3=82=A4=E3=83=AB)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- reference/datetime/book.xml | 7 +++- reference/datetime/dateinterval.xml | 7 +++- .../datetime/datetime/createfromtimestamp.xml | 34 +++++++++++++++++- reference/datetime/datetime/setisodate.xml | 35 ++++++++++++++++++- reference/datetime/datetime/settime.xml | 19 +++++++++- reference/datetime/datetime/settimestamp.xml | 35 ++++++++++++++++++- reference/datetime/datetime/settimezone.xml | 35 ++++++++++++++++++- .../datetimeimmutable/createfromtimestamp.xml | 34 +++++++++++++++++- .../datetime/datetimeimmutable/setisodate.xml | 35 ++++++++++++++++++- .../datetime/datetimeimmutable/settime.xml | 19 +++++++++- .../datetimeimmutable/settimestamp.xml | 35 ++++++++++++++++++- .../datetimeimmutable/settimezone.xml | 35 ++++++++++++++++++- .../datetime/datetimeinterface/getoffset.xml | 35 ++++++++++++++++++- .../datetimeinterface/gettimezone.xml | 35 ++++++++++++++++++- 14 files changed, 386 insertions(+), 14 deletions(-) diff --git a/reference/datetime/book.xml b/reference/datetime/book.xml index a15dea9653f..b8a0f6dde74 100644 --- a/reference/datetime/book.xml +++ b/reference/datetime/book.xml @@ -1,6 +1,6 @@ - + @@ -53,6 +53,7 @@ &reference.datetime.datetimezone; &reference.datetime.dateinterval; &reference.datetime.dateperiod; + &reference.datetime.time.duration; &reference.datetime.reference; @@ -83,6 +84,9 @@ + + Time\TimeException (extends Exception) + @@ -98,6 +102,7 @@ &reference.datetime.datemalformedintervalstringexception; &reference.datetime.datemalformedperiodstringexception; &reference.datetime.datemalformedstringexception; + &reference.datetime.time.timeexception; diff --git a/reference/datetime/dateinterval.xml b/reference/datetime/dateinterval.xml index 1afc7fa0dfc..647a832fc48 100644 --- a/reference/datetime/dateinterval.xml +++ b/reference/datetime/dateinterval.xml @@ -1,6 +1,6 @@ - + @@ -52,6 +52,11 @@ のインスタンスは 比較できません。 + + タイムアウトなど、暦の単位を持たず、長さが一定で比較できる経過時間を扱うには、 + 代わりに PHP 8.6.0 以降で利用できる Time\Duration + を使ってください。 +
diff --git a/reference/datetime/datetime/createfromtimestamp.xml b/reference/datetime/datetime/createfromtimestamp.xml index 391787132d8..b3d633c565c 100644 --- a/reference/datetime/datetime/createfromtimestamp.xml +++ b/reference/datetime/datetime/createfromtimestamp.xml @@ -1,6 +1,6 @@ - + DateTime::createFromTimestamp @@ -17,6 +17,15 @@ Unix タイムスタンプからインスタンスを生成します。 + + 返されるオブジェクトのタイムゾーンは、 + new DateTime('@' . $timestamp) と同様、 + 常に UTC オフセット +00:00 になります。 + date_default_timezone_get + が返すデフォルトのタイムゾーンは使われません。 + 別のタイムゾーンでの日時を得るには、返されたオブジェクトの + DateTime::setTimezone を呼び出してください。 + @@ -67,6 +76,29 @@ echo $date->format('Y-m-d H:i:s.u'); + + + + 結果をデフォルトのタイムゾーンに変換する + +format('Y-m-d H:i:s P e'), "\n"; + +$date->setTimezone(new DateTimeZone(date_default_timezone_get())); +echo $date->format('Y-m-d H:i:s P e'), "\n"; +?> +]]> + + &example.outputs; + + diff --git a/reference/datetime/datetime/setisodate.xml b/reference/datetime/datetime/setisodate.xml index 60c90026baa..5c01c4a1cdc 100644 --- a/reference/datetime/datetime/setisodate.xml +++ b/reference/datetime/datetime/setisodate.xml @@ -1,6 +1,6 @@ - + @@ -78,6 +78,39 @@ + + &reftitle.errors; + + オブジェクトが正しく初期化されていない場合、 + DateObjectError がスローされます。 + たとえば、子クラスのコンストラクタが親クラスのコンストラクタを呼び出さない場合です。 + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.3.0 + + オブジェクトが正しく初期化されていない場合、 + DateObjectError がスローされるようになりました。 + これより前のバージョンでは、Error がスローされていました。 + + + + + + + &reftitle.seealso; diff --git a/reference/datetime/datetime/settime.xml b/reference/datetime/datetime/settime.xml index e7a18244846..07fed4dc125 100644 --- a/reference/datetime/datetime/settime.xml +++ b/reference/datetime/datetime/settime.xml @@ -1,6 +1,6 @@ - + @@ -88,6 +88,15 @@ + + &reftitle.errors; + + オブジェクトが正しく初期化されていない場合、 + DateObjectError がスローされます。 + たとえば、子クラスのコンストラクタが親クラスのコンストラクタを呼び出さない場合です。 + + + &reftitle.changelog; @@ -99,6 +108,14 @@ + + 8.3.0 + + オブジェクトが正しく初期化されていない場合、 + DateObjectError がスローされるようになりました。 + これより前のバージョンでは、Error がスローされていました。 + + 8.1.0 diff --git a/reference/datetime/datetime/settimestamp.xml b/reference/datetime/datetime/settimestamp.xml index 5d2f999adb4..e1f73103bca 100644 --- a/reference/datetime/datetime/settimestamp.xml +++ b/reference/datetime/datetime/settimestamp.xml @@ -1,6 +1,6 @@ - + @@ -61,6 +61,39 @@ + + &reftitle.errors; + + オブジェクトが正しく初期化されていない場合、 + DateObjectError がスローされます。 + たとえば、子クラスのコンストラクタが親クラスのコンストラクタを呼び出さない場合です。 + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.3.0 + + オブジェクトが正しく初期化されていない場合、 + DateObjectError がスローされるようになりました。 + これより前のバージョンでは、Error がスローされていました。 + + + + + + + &reftitle.seealso; diff --git a/reference/datetime/datetime/settimezone.xml b/reference/datetime/datetime/settimezone.xml index 3605700ae7c..2e4d526684f 100644 --- a/reference/datetime/datetime/settimezone.xml +++ b/reference/datetime/datetime/settimezone.xml @@ -1,6 +1,6 @@ - + @@ -62,6 +62,39 @@ + + &reftitle.errors; + + オブジェクトが正しく初期化されていない場合、 + DateObjectError がスローされます。 + たとえば、子クラスのコンストラクタが親クラスのコンストラクタを呼び出さない場合です。 + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.3.0 + + オブジェクトが正しく初期化されていない場合、 + DateObjectError がスローされるようになりました。 + これより前のバージョンでは、Error がスローされていました。 + + + + + + + &reftitle.examples; diff --git a/reference/datetime/datetimeimmutable/createfromtimestamp.xml b/reference/datetime/datetimeimmutable/createfromtimestamp.xml index 62a6ee83cbf..95e819b02ac 100644 --- a/reference/datetime/datetimeimmutable/createfromtimestamp.xml +++ b/reference/datetime/datetimeimmutable/createfromtimestamp.xml @@ -1,6 +1,6 @@ - + DateTimeImmutable::createFromTimestamp @@ -17,6 +17,15 @@ Unix タイムスタンプからインスタンスを生成します。 + + 返されるオブジェクトのタイムゾーンは、 + new DateTimeImmutable('@' . $timestamp) と同様、 + 常に UTC オフセット +00:00 になります。 + date_default_timezone_get + が返すデフォルトのタイムゾーンは使われません。 + 別のタイムゾーンでの日時を得るには、返されたオブジェクトの + DateTimeImmutable::setTimezone を呼び出してください。 + @@ -67,6 +76,29 @@ echo $date->format('Y-m-d H:i:s.u'); + + + + 結果をデフォルトのタイムゾーンに変換する + +format('Y-m-d H:i:s P e'), "\n"; + +$date = $date->setTimezone(new DateTimeZone(date_default_timezone_get())); +echo $date->format('Y-m-d H:i:s P e'), "\n"; +?> +]]> + + &example.outputs; + + diff --git a/reference/datetime/datetimeimmutable/setisodate.xml b/reference/datetime/datetimeimmutable/setisodate.xml index a5707625deb..71958134387 100644 --- a/reference/datetime/datetimeimmutable/setisodate.xml +++ b/reference/datetime/datetimeimmutable/setisodate.xml @@ -1,6 +1,6 @@ - + @@ -61,6 +61,39 @@ + + &reftitle.errors; + + オブジェクトが正しく初期化されていない場合、 + DateObjectError がスローされます。 + たとえば、子クラスのコンストラクタが親クラスのコンストラクタを呼び出さない場合です。 + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.3.0 + + オブジェクトが正しく初期化されていない場合、 + DateObjectError がスローされるようになりました。 + これより前のバージョンでは、Error がスローされていました。 + + + + + + + &reftitle.examples; diff --git a/reference/datetime/datetimeimmutable/settime.xml b/reference/datetime/datetimeimmutable/settime.xml index fa4f6654846..6d2b817d8e8 100644 --- a/reference/datetime/datetimeimmutable/settime.xml +++ b/reference/datetime/datetimeimmutable/settime.xml @@ -1,6 +1,6 @@ - + @@ -70,6 +70,15 @@ + + &reftitle.errors; + + オブジェクトが正しく初期化されていない場合、 + DateObjectError がスローされます。 + たとえば、子クラスのコンストラクタが親クラスのコンストラクタを呼び出さない場合です。 + + + &reftitle.changelog; @@ -81,6 +90,14 @@ + + 8.3.0 + + オブジェクトが正しく初期化されていない場合、 + DateObjectError がスローされるようになりました。 + これより前のバージョンでは、Error がスローされていました。 + + 8.1.0 diff --git a/reference/datetime/datetimeimmutable/settimestamp.xml b/reference/datetime/datetimeimmutable/settimestamp.xml index f7d32216207..43833774853 100644 --- a/reference/datetime/datetimeimmutable/settimestamp.xml +++ b/reference/datetime/datetimeimmutable/settimestamp.xml @@ -1,6 +1,6 @@ - + @@ -46,6 +46,39 @@ + + &reftitle.errors; + + オブジェクトが正しく初期化されていない場合、 + DateObjectError がスローされます。 + たとえば、子クラスのコンストラクタが親クラスのコンストラクタを呼び出さない場合です。 + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.3.0 + + オブジェクトが正しく初期化されていない場合、 + DateObjectError がスローされるようになりました。 + これより前のバージョンでは、Error がスローされていました。 + + + + + + + &reftitle.examples; diff --git a/reference/datetime/datetimeimmutable/settimezone.xml b/reference/datetime/datetimeimmutable/settimezone.xml index 69f120177f7..c5873bb8bee 100644 --- a/reference/datetime/datetimeimmutable/settimezone.xml +++ b/reference/datetime/datetimeimmutable/settimezone.xml @@ -1,6 +1,6 @@ - + @@ -46,6 +46,39 @@ + + &reftitle.errors; + + オブジェクトが正しく初期化されていない場合、 + DateObjectError がスローされます。 + たとえば、子クラスのコンストラクタが親クラスのコンストラクタを呼び出さない場合です。 + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.3.0 + + オブジェクトが正しく初期化されていない場合、 + DateObjectError がスローされるようになりました。 + これより前のバージョンでは、Error がスローされていました。 + + + + + + + &reftitle.examples; diff --git a/reference/datetime/datetimeinterface/getoffset.xml b/reference/datetime/datetimeinterface/getoffset.xml index 97442dfd7c8..fb5736e0b96 100644 --- a/reference/datetime/datetimeinterface/getoffset.xml +++ b/reference/datetime/datetimeinterface/getoffset.xml @@ -1,6 +1,6 @@ - + @@ -51,6 +51,39 @@ + + &reftitle.errors; + + オブジェクトが正しく初期化されていない場合、 + DateObjectError がスローされます。 + たとえば、子クラスのコンストラクタが親クラスのコンストラクタを呼び出さない場合です。 + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.3.0 + + オブジェクトが正しく初期化されていない場合、 + DateObjectError がスローされるようになりました。 + これより前のバージョンでは、Error がスローされていました。 + + + + + + + &reftitle.examples; diff --git a/reference/datetime/datetimeinterface/gettimezone.xml b/reference/datetime/datetimeinterface/gettimezone.xml index a18baf73bf3..32bfa8aaa93 100644 --- a/reference/datetime/datetimeinterface/gettimezone.xml +++ b/reference/datetime/datetimeinterface/gettimezone.xml @@ -1,6 +1,6 @@ - + @@ -51,6 +51,39 @@ + + &reftitle.errors; + + オブジェクトが正しく初期化されていない場合、 + DateObjectError がスローされます。 + たとえば、子クラスのコンストラクタが親クラスのコンストラクタを呼び出さない場合です。 + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.3.0 + + オブジェクトが正しく初期化されていない場合、 + DateObjectError がスローされるようになりました。 + これより前のバージョンでは、Error がスローされていました。 + + + + + + + &reftitle.examples;