<?xml version="1.0" encoding="utf-8"?>

<reference xml:id="class.datetime" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">

<title>Die Klasse DateTime</title>

<titleabbrev>DateTime</titleabbrev>

<partintro>

<section xml:id="datetime.intro">

&reftitle.intro;

<para>

Stellt Datum und Uhrzeit dar.

</para>

<para>

Diese Klasse verhält sich wie die Klasse <classname>DateTimeImmutable</classname>,

außer dass die Objekte selbst verändert werden, wenn Modifizierungsmethoden wie

<function>DateTime::modify</function> aufgerufen werden.

</para>

<warning>

<para>

Der Aufruf von Methoden auf Objekten der Klasse

<classname>DateTime</classname> verändert die in diesen Objekten

gekapselten Informationen. Wenn das verhindert werden soll, muss der

Operator <literal>clone</literal> verwendet werden, um ein neues Objekt

zu erzeugen. Um dieses empfohlene Verhalten standardmäßig zu erhalten,

sollte <classname>DateTimeImmutable</classname> anstelle von

<classname>DateTime</classname> verwendet werden.

</para>

</warning>

</section>

<section xml:id="datetime.synopsis">

&reftitle.classsynopsis;

<classsynopsis class="class">

<ooclass>

<classname>DateTime</classname>

</ooclass>

<oointerface>

<modifier>implements</modifier>

<interfacename>DateTimeInterface</interfacename>

</oointerface>

<classsynopsisinfo role="comment">&InheritedConstants;</classsynopsisinfo>

<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;']]))">

<xi:fallback/>

</xi:include>

<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>

<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.datetime')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='DateTime'])">

<xi:fallback/>

</xi:include>

<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.datetime')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='DateTime'])">

<xi:fallback/>

</xi:include>

<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.datetimeinterface')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='DateTime'])">

<xi:fallback/>

</xi:include>

</classsynopsis>

</section>

<section role="changelog" xml:id="datetime.changelog"><!-- {{{ -->

&reftitle.changelog;

<para>

<informaltable>

<tgroup cols="2">

<thead>

<row>

<entry>&Version;</entry>

<entry>&Description;</entry>

</row>

</thead>

<tbody>

<row>

<entry>8.4.0</entry>

<entry>

Die Klassenkonstanten sind nun typisiert.

</entry>

</row>

<row>

<entry>7.2.0</entry>

<entry>

Die Klassenkonstanten von <classname>DateTime</classname> sind nun in

<classname>DateTimeInterface</classname> definiert.

</entry>

</row>

<row>

<entry>7.1.0</entry>

<entry>

Der Konstruktor von <classname>DateTime</classname> bezieht nun die

aktuellen Mikrosekunden in den erzeugten Wert ein. Vorher wurden die

Mikrosekunden immer mit <literal>0</literal> initialisiert.

</entry>

</row>

</tbody>

</tgroup>

</informaltable>

</para>

</section><!-- }}} -->

</partintro>

&reference.datetime.entities.datetime;

</reference>