reference/datetime/datetimeimmutable.xml
14767af0f05dffa6fdb9b49e1a1f4e9ca7022a60
...
...
@@ -1,6 +1,5 @@
1
1
<?xml version="1.0" encoding="utf-8"?>
2
2
<!-- $Revision$ -->
3
-

4
3
<phpdoc:classref xml:id="class.datetimeimmutable" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
5
4

6
5
<title>The DateTimeImmutable class</title>
...
...
@@ -12,8 +11,12 @@
12
11
<section xml:id="datetimeimmutable.intro">
13
12
&reftitle.intro;
14
13
<para>
15
-
This class behaves the same as <classname>DateTime</classname> except it
16
-
never modifies itself but returns a new object instead.
14
+
Representation of date and time.
15
+
</para>
16
+
<para>
17
+
This class behaves the same as <classname>DateTime</classname>
18
+
except new objects are returned when modification methods such as
19
+
<function>DateTime::modify</function> are called.
17
20
</para>
18
21
</section>
19
22
<!-- }}} -->
...
...
@@ -22,40 +25,66 @@
22
25
&reftitle.classsynopsis;
23
26

24
27
<!-- {{{ Synopsis -->
25
-
<classsynopsis>
26
-
<ooclass><classname>DateTimeImmutable</classname></ooclass>
28
+
<classsynopsis class="class">
29
+
<ooclass>
30
+
<classname>DateTimeImmutable</classname>
31
+
</ooclass>
27
32

28
-
<!-- {{{ Class synopsis -->
29
-
<classsynopsisinfo>
30
-
<ooclass>
31
-
<classname>DateTimeImmutable</classname>
32
-
</ooclass>
33
+
<oointerface>
34
+
<modifier>implements</modifier>
35
+
<interfacename>DateTimeInterface</interfacename>
36
+
</oointerface>
33
37

34
-
<oointerface>
35
-
<interfacename>DateTimeInterface</interfacename>
36
-
</oointerface>
37
-
</classsynopsisinfo>
38
-
<!-- }}} -->
39
38
<classsynopsisinfo role="comment">&InheritedConstants;</classsynopsisinfo>
40
39
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.datetimeinterface')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Constants;']]))">
41
-
<xi:fallback />
40
+
<xi:fallback/>
42
41
</xi:include>
43
42

44
43
<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
45
-
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.datetimeimmutable')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[not(@role='procedural')])"/>
46
-
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.datetimeimmutable')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])" />
47
-
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.datetimeinterface')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='DateTimeImmutable'])" />
44
+
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.datetimeimmutable')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='DateTimeImmutable'])">
45
+
<xi:fallback/>
46
+
</xi:include>
47
+
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.datetimeimmutable')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='DateTimeImmutable'])">
48
+
<xi:fallback/>
49
+
</xi:include>
50
+
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.datetimeinterface')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='DateTimeImmutable'])">
51
+
<xi:fallback/>
52
+
</xi:include>
48
53
</classsynopsis>
49
54
<!-- }}} -->
50
55

51
56
</section>
52
57

58
+
<section role="changelog" xml:id="datetimeimmutable.changelog"><!-- {{{ -->
59
+
&reftitle.changelog;
60
+
<para>
61
+
<informaltable>
62
+
<tgroup cols="2">
63
+
<thead>
64
+
<row>
65
+
<entry>&Version;</entry>
66
+
<entry>&Description;</entry>
67
+
</row>
68
+
</thead>
69
+
<tbody>
70
+
<row>
71
+
<entry>7.1.0</entry>
72
+
<entry>
73
+
The <classname>DateTimeImmutable</classname> constructor now includes the
74
+
current microseconds in the constructed value. Before this, it would
75
+
always initialise the microseconds to <literal>0</literal>.
76
+
</entry>
77
+
</row>
78
+
</tbody>
79
+
</tgroup>
80
+
</informaltable>
81
+
</para>
82
+
</section><!-- }}} -->
53
83
</partintro>
54
84

55
85
&reference.datetime.entities.datetimeimmutable;
56
86

57
87
</phpdoc:classref>
58
-

59
88
<!-- Keep this comment at the end of the file
60
89
Local variables:
61
90
mode: sgml
62
91