diff --git a/reference/datetime/book.xml b/reference/datetime/book.xml
index a15dea9653..b8a0f6dde7 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 1afc7fa0df..647a832fc4 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 391787132d..b3d633c565 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 60c90026ba..5c01c4a1cd 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 e7a1824484..07fed4dc12 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 5d2f999adb..e1f73103bc 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 3605700ae7..2e4d526684 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 62a6ee83cb..95e819b02a 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 a5707625de..7195813438 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 fa4f665484..6d2b817d8e 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 f7d3221620..4383377485 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 69f120177f..c5873bb8be 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 97442dfd7c..fb5736e0b9 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 a18baf73bf..32bfa8aaa9 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;