reference/datetime/datetimeimmutable/modify.xml
c8ba91f7e546462dc66c2a11a7eab6f55c93915b
c8ba91f7e546462dc66c2a11a7eab6f55c93915b
...
...
@@ -1,6 +1,5 @@
1
1
<?xml version="1.0" encoding="utf-8"?>
2
2
<!-- $Revision$ -->
3
-
4
3
<refentry xml:id="datetimeimmutable.modify" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
5
4
<refnamediv>
6
5
<refname>DateTimeImmutable::modify</refname>
...
...
@@ -9,9 +8,9 @@
9
8
10
9
<refsect1 role="description">
11
10
&reftitle.description;
12
-
<methodsynopsis role="oop">
11
+
<methodsynopsis role="DateTimeImmutable">
13
12
<modifier>public</modifier> <type>DateTimeImmutable</type><methodname>DateTimeImmutable::modify</methodname>
14
-
<methodparam><type>string</type><parameter>modify</parameter></methodparam>
13
+
<methodparam><type>string</type><parameter>modifier</parameter></methodparam>
15
14
</methodsynopsis>
16
15
<para>
17
16
Creates a new <type>DateTimeImmutable</type> object with modified timestamp.
...
...
@@ -22,9 +21,8 @@
22
21
<refsect1 role="parameters">
23
22
&reftitle.parameters;
24
23
<variablelist>
25
-
&date.datetime.description.modified;
26
24
<varlistentry>
27
-
<term><parameter>modify</parameter></term>
25
+
<term><parameter>modifier</parameter></term>
28
26
<listitem>
29
27
<para>&date.formats.parameter;</para>
30
28
</listitem>
...
...
@@ -35,12 +33,103 @@
35
33
<refsect1 role="returnvalues">
36
34
&reftitle.returnvalues;
37
35
<para>
38
-
Returns the newly created object&return.falseforfailure;.
36
+
Returns <classname>DateTimeImmutable</classname> on success.
37
+
&return.falseforfailure.style.procedural;
39
38
</para>
40
39
</refsect1>
41
40
42
-
</refentry>
41
+
<refsect1 role="errors">
42
+
&reftitle.errors;
43
+
<para>
44
+
If an invalid Date/Time string is passed,
45
+
<exceptionname>DateMalformedStringException</exceptionname> is thrown.
46
+
Previous to PHP 8.3, this was a warning.
47
+
</para>
48
+
</refsect1>
49
+
50
+
<refsect1 role="changelog">
51
+
&reftitle.changelog;
52
+
<informaltable>
53
+
<tgroup cols="2">
54
+
<thead>
55
+
<row>
56
+
<entry>&Version;</entry>
57
+
<entry>&Description;</entry>
58
+
</row>
59
+
</thead>
60
+
<tbody>
61
+
<row>
62
+
<entry>8.3.0</entry>
63
+
<entry>
64
+
<methodname>DateTimeImmutable::modify</methodname> now throws
65
+
<exceptionname>DateMalformedStringException</exceptionname> if an
66
+
invalid string is passed. Previously, it returned <literal>false</literal>,
67
+
and a warning was emitted.
68
+
</entry>
69
+
</row>
70
+
</tbody>
71
+
</tgroup>
72
+
</informaltable>
73
+
</refsect1>
74
+
<refsect1 role="examples">
75
+
&reftitle.examples;
76
+
<example>
77
+
<title><function>DateTimeImmutable::modify</function> example</title>
78
+
<para>&style.oop;</para>
79
+
<programlisting role="php">
80
+
<![CDATA[
81
+
<?php
82
+
$date = new DateTimeImmutable('2006-12-12');
83
+
$newDate = $date->modify('+1 day');
84
+
echo $newDate->format('Y-m-d');
85
+
?>
86
+
]]>
87
+
</programlisting>
88
+
&examples.outputs;
89
+
<screen>
90
+
<![CDATA[
91
+
2006-12-13
92
+
]]>
93
+
</screen>
94
+
</example>
95
+
<example>
96
+
<title>Beware when adding or subtracting months</title>
97
+
<programlisting role="php">
98
+
<![CDATA[
99
+
<?php
100
+
$date = new DateTimeImmutable('2000-12-31');
43
101
102
+
$newDate1 = $date->modify('+1 month');
103
+
echo $newDate1->format('Y-m-d') . "\n";
104
+
105
+
$newDate2 = $newDate1->modify('+1 month');
106
+
echo $newDate2->format('Y-m-d') . "\n";
107
+
?>
108
+
]]>
109
+
</programlisting>
110
+
&example.outputs;
111
+
<screen>
112
+
<![CDATA[
113
+
2001-01-31
114
+
2001-03-03
115
+
]]>
116
+
</screen>
117
+
</example>
118
+
</refsect1>
119
+
120
+
<refsect1 role="seealso">
121
+
&reftitle.seealso;
122
+
<simplelist>
123
+
<member><function>DateTimeImmutable::add</function></member>
124
+
<member><function>DateTimeImmutable::sub</function></member>
125
+
<member><function>DateTimeImmutable::setDate</function></member>
126
+
<member><function>DateTimeImmutable::setISODate</function></member>
127
+
<member><function>DateTimeImmutable::setTime</function></member>
128
+
<member><function>DateTimeImmutable::setTimestamp</function></member>
129
+
</simplelist>
130
+
</refsect1>
131
+
132
+
</refentry>
44
133
<!-- Keep this comment at the end of the file
45
134
Local variables:
46
135
mode: sgml
47
136