|
|
@@ -1,8 +1,7 @@
|
|
|
<?xml version="1.0" encoding="UTF-8"?>
|
|
|
-<!-- EN-Revision: 17986 -->
|
|
|
+<!-- EN-Revision: 18429 -->
|
|
|
<!-- Reviewed: no -->
|
|
|
<sect1 id="zend.date.overview">
|
|
|
-
|
|
|
<title>Zend_Date API Übersicht</title>
|
|
|
|
|
|
<para>
|
|
|
@@ -12,11 +11,9 @@
|
|
|
</para>
|
|
|
|
|
|
<sect2 id="zend.date.options">
|
|
|
-
|
|
|
<title>Zend_Date Optionen</title>
|
|
|
|
|
|
<sect3 id="zend.date.options.formattype">
|
|
|
-
|
|
|
<title>Auswahl der Art des Datumsformats</title>
|
|
|
|
|
|
<para>
|
|
|
@@ -34,11 +31,9 @@
|
|
|
Codes kann hier nachgelesen werden: <link
|
|
|
linkend="zend.date.constants.phpformats" />
|
|
|
</para>
|
|
|
-
|
|
|
</sect3>
|
|
|
|
|
|
<sect3 id="zend.date.options.fixdst">
|
|
|
-
|
|
|
<title>Sommer-/Winterzeit und Datumsberechnungen</title>
|
|
|
|
|
|
<para>
|
|
|
@@ -52,18 +47,19 @@
|
|
|
Monaten, wenn die <acronym>DST</acronym> Grenze überschritten wird, dazu dass das
|
|
|
Datum eine Stunde verliert und damit zum letzten Tag des Vormonats wird durch das
|
|
|
Erscheinungsbild des "eins fehlt" Fehlers. Um diese Situationen zu vermeiden, kann
|
|
|
- die <acronym>DST</acronym> Änderung durch Verwendung der <code>fix_dst</code> Option
|
|
|
- ignoriert werden. Wenn eine <acronym>DST</acronym> Grenze überschritten wird, wird
|
|
|
- ja normalerweise eine Stunde hinzugefügt oder entfernt abhändig vom Datum. Zum
|
|
|
- Beispiel führt eine Datumsberechnung mit <acronym>DST</acronym> im Frühling zu einem
|
|
|
- Datum welche einen Tag weniger hat als erwartet, wenn die Zeit des Originaldatums
|
|
|
- 00:00:00 war. Da <classname>Zend_Date</classname> auf Zeitpunkten basiert und nicht
|
|
|
- auf Kalenderdaten mit Zeitkomponenten, verliert der Zeitpunkt eine Stunde was zu
|
|
|
- einem Datum führt das einen Kalendertag weniger hat als erwartet. Um solche Problem
|
|
|
- zu verhindern kann die Option <code>fix_dst</code> verwendet werden, welche
|
|
|
- standardmäßig <constant>TRUE</constant> ist. Das führt dazu das die
|
|
|
- <acronym>DST</acronym> keinen Einfluß mehr bei Datumsberechnungen zeigt
|
|
|
- (<methodname>addMonth()</methodname>, <methodname>subMonth()</methodname>).
|
|
|
+ die <acronym>DST</acronym> Änderung durch Verwendung der
|
|
|
+ <property>fix_dst</property> Option ignoriert werden. Wenn eine
|
|
|
+ <acronym>DST</acronym> Grenze überschritten wird, wird ja normalerweise eine Stunde
|
|
|
+ hinzugefügt oder entfernt abhändig vom Datum. Zum Beispiel führt eine
|
|
|
+ Datumsberechnung mit <acronym>DST</acronym> im Frühling zu einem Datum welche einen
|
|
|
+ Tag weniger hat als erwartet, wenn die Zeit des Originaldatums 00:00:00 war. Da
|
|
|
+ <classname>Zend_Date</classname> auf Zeitpunkten basiert und nicht auf Kalenderdaten
|
|
|
+ mit Zeitkomponenten, verliert der Zeitpunkt eine Stunde was zu einem Datum führt das
|
|
|
+ einen Kalendertag weniger hat als erwartet. Um solche Problem zu verhindern kann die
|
|
|
+ Option <property>fix_dst</property> verwendet werden, welche standardmäßig
|
|
|
+ <constant>TRUE</constant> ist. Das führt dazu das die <acronym>DST</acronym> keinen
|
|
|
+ Einfluß mehr bei Datumsberechnungen zeigt (<methodname>addMonth()</methodname>,
|
|
|
+ <methodname>subMonth()</methodname>).
|
|
|
<methodname>Zend_Date::setOptions(array('fix_dst' => false))</methodname> kann
|
|
|
benutzt werden um Hinzufügen oder Entfernen der <acronym>DST</acronym> Anpassung zu
|
|
|
gestatten wenn Datumsberechnungen durchgeführt werden.
|
|
|
@@ -72,16 +68,16 @@
|
|
|
<para>
|
|
|
<emphasis>Wenn die aktuelle Zeitzone innerhalb der Instanz von
|
|
|
<classname>Zend_Date</classname> auf <acronym>UTC</acronym> oder
|
|
|
- <acronym>GMT</acronym> gestellt wird, wird die Option <code>'fix_dst'</code> nicht
|
|
|
- verwendet</emphasis> weil diese zwei Zeitzonen nicht mit <acronym>DST</acronym>
|
|
|
- arbeiten. Wenn die Zeitzone für diese Instanz wieder auf eine Zeitzone gestellt wird
|
|
|
- die nicht <acronym>UTC</acronym> oder <acronym>GMT</acronym> ist, wird die vorher
|
|
|
- definierte 'fix_dst' Option wieder für die Datumsberechnungen verwendet.
|
|
|
+ <acronym>GMT</acronym> gestellt wird, wird die Option '<property>fix_dst</property>'
|
|
|
+ nicht verwendet</emphasis> weil diese zwei Zeitzonen nicht mit
|
|
|
+ <acronym>DST</acronym> arbeiten. Wenn die Zeitzone für diese Instanz wieder auf eine
|
|
|
+ Zeitzone gestellt wird die nicht <acronym>UTC</acronym> oder <acronym>GMT</acronym>
|
|
|
+ ist, wird die vorher definierte 'fix_dst' Option wieder für die Datumsberechnungen
|
|
|
+ verwendet.
|
|
|
</para>
|
|
|
</sect3>
|
|
|
|
|
|
<sect3 id="zend.date.options.extendmonth">
|
|
|
-
|
|
|
<title>Monatsberechnungen</title>
|
|
|
|
|
|
<para>
|
|
|
@@ -93,25 +89,23 @@
|
|
|
welche mit Excel und OpenOffice vertraut sind werden den 3ten März als Ergebnis
|
|
|
erwarten. Das Problem besteht nur wen das Ergebnismonat den Tag der im Originaldatum
|
|
|
gesetzt war, nicht hat. Für Zend Framework Entwickler können das gewünschte
|
|
|
- Verhalten ausgewählen indem die Option <code>extend_month</code> genutzt wird um
|
|
|
- entweder das <acronym>SQL</acronym> Verhalten, wenn die Option
|
|
|
+ Verhalten ausgewählen indem die Option <property>extend_month</property> genutzt
|
|
|
+ wird um entweder das <acronym>SQL</acronym> Verhalten, wenn die Option
|
|
|
<constant>FALSE</constant> ist, oder das Tabellenverhalten, wenn die Option
|
|
|
<constant>TRUE</constant> ist, auszuwählen. Das Standardverhalten für
|
|
|
- <code>extend_month</code> ist <constant>FALSE</constant>, um <acronym>SQL</acronym>
|
|
|
- kompatibles Verhalten zu erlauben. <classname>Zend_Date</classname> führt
|
|
|
- Monatsberechnungen standardmäßig in der Art durch das Daten auf das Monatsende hin
|
|
|
- abgeschnitten werden (wenn notwendig), ohne das in den nächsten Monat umgebrochen
|
|
|
- wird wenn das Originaldatum einen Monatstag bestimmt der die Anzahl der Tag des
|
|
|
- Ergebnismonats überschreitet.
|
|
|
+ <property>extend_month</property> ist <constant>FALSE</constant>, um
|
|
|
+ <acronym>SQL</acronym> kompatibles Verhalten zu erlauben.
|
|
|
+ <classname>Zend_Date</classname> führt Monatsberechnungen standardmäßig in der Art
|
|
|
+ durch das Daten auf das Monatsende hin abgeschnitten werden (wenn notwendig), ohne
|
|
|
+ das in den nächsten Monat umgebrochen wird wenn das Originaldatum einen Monatstag
|
|
|
+ bestimmt der die Anzahl der Tag des Ergebnismonats überschreitet.
|
|
|
<methodname>Zend_Date::setOptions(array('extend_month' => true))</methodname> kann
|
|
|
benutzt werden um Monatsberechnungen wie in populären Tabellenkalkulationen
|
|
|
durchzuführen.
|
|
|
</para>
|
|
|
-
|
|
|
</sect3>
|
|
|
|
|
|
<sect3 id="zend.date.options.cache">
|
|
|
-
|
|
|
<title>
|
|
|
Lokalisierung und Normalisierung von Daten mit Zend_Cache schneller machen
|
|
|
</title>
|
|
|
@@ -128,11 +122,9 @@
|
|
|
<methodname>Zend_Date::setOptions(array('cache' => $adapter))</methodname>
|
|
|
aufgerufen werden.
|
|
|
</para>
|
|
|
-
|
|
|
</sect3>
|
|
|
|
|
|
<sect3 id="zend.date.options.timesync">
|
|
|
-
|
|
|
<title>Syncronisierte Zeiten mit Zend_TimeSync erhalten</title>
|
|
|
|
|
|
<para>
|
|
|
@@ -146,13 +138,10 @@
|
|
|
den Zeitpunkt von bestehenden Instanzen. Am besten ist es also dies innerhalb der
|
|
|
Bootstrap Datei zu setzen.
|
|
|
</para>
|
|
|
-
|
|
|
</sect3>
|
|
|
-
|
|
|
</sect2>
|
|
|
|
|
|
<sect2 id="zend.date.values">
|
|
|
-
|
|
|
<title>Arbeiten mit Datumswerten</title>
|
|
|
|
|
|
<para>
|
|
|
@@ -161,11 +150,11 @@
|
|
|
Verwendung von <ulink
|
|
|
url="http://en.wikipedia.org/wiki/Unix_Time">UNIX Zeitpunkten</ulink>. Damit ein
|
|
|
Datum in einer lokalisierten Art und Weise durchsucht werden kann, muß zuerst eine
|
|
|
- Zeitzone bekannt sein. Die Standardzeitzone ist immer <acronym>GMT</acronym>/UTC. Um die
|
|
|
- Zeitzone des Objektes zu inspizieren kann <methodname>getTimeZone()</methodname>
|
|
|
- verwendet werden. Um die Zeitzone des Objektes zu wechseln kann
|
|
|
- <methodname>setTimeZone()</methodname> verwendet werden. Alle Änderungen des Objektes
|
|
|
- sind immer relativ zu seiner Zeitzone zu sehen.
|
|
|
+ Zeitzone bekannt sein. Die Standardzeitzone ist immer <acronym>GMT</acronym> or
|
|
|
+ <acronym>UTC</acronym>. Um die Zeitzone des Objektes zu inspizieren kann
|
|
|
+ <methodname>getTimeZone()</methodname> verwendet werden. Um die Zeitzone des Objektes zu
|
|
|
+ wechseln kann <methodname>setTimeZone()</methodname> verwendet werden. Alle Änderungen
|
|
|
+ des Objektes sind immer relativ zu seiner Zeitzone zu sehen.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
@@ -174,8 +163,8 @@
|
|
|
da die Manipulationen nur dem Zeitpunkt zugeordnet werden. Das Arbeiten an
|
|
|
<classname>Zend_Date</classname> Objekten die unterschiedliche Zeitzonen haben
|
|
|
funktioniert grundsätzlich abgesehen davon wie vorher erwähnt, da Daten bei der
|
|
|
- Instantiierung von <classname>Zend_Date</classname> zu UNIX Zeitpunkten normalisiert
|
|
|
- werden.
|
|
|
+ Instantiierung von <classname>Zend_Date</classname> zu <acronym>UNIX</acronym>
|
|
|
+ Zeitpunkten normalisiert werden.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
@@ -215,8 +204,8 @@ echo $date3, "\n"; // Ausgabe "Mar 3, 2007 12:00:00 AM"
|
|
|
verdeutlicht <varname>$locale</varname> den <varname>$date</varname> Operand durch
|
|
|
Ersetzen der Monatsnamen und Wochentagsnamen für die <varname>$date</varname>
|
|
|
Zeichenkette, und auch Datumszeichenketten können analysiert werden durch die
|
|
|
- Vorschriften dieses Gebietsschemas (siehe <code><link
|
|
|
- linkend="zend.locale.date.normalize">Zend_Locale_Format::getDate()</link></code>).
|
|
|
+ Vorschriften dieses Gebietsschemas (siehe <link
|
|
|
+ linkend="zend.locale.date.normalize">Zend_Locale_Format::getDate()</link>).
|
|
|
Die automatische Normalisierung von lokalisierten <varname>$date</varname> Angaben einer
|
|
|
Zeichenkette werden nur dann durchgeführt wenn für <varname>$part</varname> eine der
|
|
|
<constant>Zend_Date::DATE</constant>* oder <constant>Zend_Date::TIME</constant>*
|
|
|
@@ -250,11 +239,9 @@ Zend_Registry::set('Zend_Locale', $locale);
|
|
|
// Irgendwo in der eigenen Anwendung
|
|
|
$date = new Zend_Date('31.Feb.2007');
|
|
|
]]></programlisting>
|
|
|
-
|
|
|
</sect2>
|
|
|
|
|
|
<sect2 id="id.date.basic">
|
|
|
-
|
|
|
<title>Grundsätzliche Zend_Date Operationen für die meisten Teile von Daten</title>
|
|
|
|
|
|
<para>
|
|
|
@@ -308,7 +295,6 @@ print $date;
|
|
|
</para>
|
|
|
|
|
|
<sect3 id="id.date.basic.parts">
|
|
|
-
|
|
|
<title>Liste der Datumsabschnitte</title>
|
|
|
|
|
|
<table id="id.date.basic.parts.table">
|
|
|
@@ -327,7 +313,7 @@ print $date;
|
|
|
</entry>
|
|
|
<entry>
|
|
|
UNIX Zeitpunkt, ausgedrückt in Sekunden die vergangen sind seit dem
|
|
|
- 1. Jänner, 1970 00:00:00 <acronym>GMT</acronym>/UTC.
|
|
|
+ 1. Jänner, 1970 00:00:00 <acronym>GMT</acronym>.
|
|
|
</entry>
|
|
|
</row>
|
|
|
<row>
|
|
|
@@ -387,8 +373,8 @@ print $date;
|
|
|
kann. Um die Genauigkeit zu Ändern kann
|
|
|
<methodname>setFractionalPrecision($precision)</methodname> verwendet
|
|
|
werden. Trotzdem ist die Genauigkeit praktisch auf Millisekunden
|
|
|
- begrezt da <classname>Zend_Date</classname> <code><ulink
|
|
|
- url="http://php.net/microtime">microtime()</ulink></code> dafür
|
|
|
+ begrezt da <classname>Zend_Date</classname> <ulink
|
|
|
+ url="http://php.net/microtime">microtime()</ulink> dafür
|
|
|
benutzt.
|
|
|
</entry>
|
|
|
</row>
|
|
|
@@ -430,10 +416,11 @@ print $date;
|
|
|
<varname>$date</varname> extrahiert wenn der
|
|
|
<varname>$date</varname> Operand eine Instanz von
|
|
|
<classname>Zend_Date</classname> ist. Sonst wird versucht den
|
|
|
- <varname>$date</varname> String des Datums
|
|
|
- in ein Zend_Date::DATE_MEDIUM formatiertes Datum zu normalisieren.
|
|
|
- Das Format von <constant>Zend_Date::DATE_MEDIUM</constant> hängt
|
|
|
- vom Gebietsschema des Objektes ab.
|
|
|
+ <varname>$date</varname> String des Datums in ein
|
|
|
+ <constant>Zend_Date::DATE_MEDIUM</constant> formatiertes Datum zu
|
|
|
+ normalisieren. Das Format von
|
|
|
+ <constant>Zend_Date::DATE_MEDIUM</constant> hängt vom Gebietsschema
|
|
|
+ des Objektes ab.
|
|
|
</entry>
|
|
|
</row>
|
|
|
<row>
|
|
|
@@ -472,12 +459,13 @@ print $date;
|
|
|
unterstützt. Die Ausgabe verwendet entweder "GMT" oder "Laut
|
|
|
Gebietsschema unterschiedliche Stunden + Minuten" Format (siehe
|
|
|
Sektion 5 von <acronym>RFC</acronym> 822). Vor
|
|
|
- <acronym>PHP</acronym> 5.2.2, zeigte die Verwendung der DATE_RFC822
|
|
|
- Konstante mit <acronym>PHP</acronym> date Funktionen hier und da
|
|
|
+ <acronym>PHP</acronym> 5.2.2, zeigte die Verwendung der
|
|
|
+ <constant>DATE_RFC822</constant> Konstante mit
|
|
|
+ <acronym>PHP</acronym> date Funktionen hier und da
|
|
|
<ulink url="http://bugs.php.net/bug.php?id=40308">fehlerhafte
|
|
|
Ergebnisse</ulink>. Die Ergebnisse von
|
|
|
<classname>Zend_Date</classname> sind korrekt. Beispiel:
|
|
|
- <code>Mon, 31 Dec 06 23:59:59 GMT</code>
|
|
|
+ Mon, 31 Dec 06 23:59:59 <acronym>GMT</acronym>
|
|
|
</entry>
|
|
|
</row>
|
|
|
<row>
|
|
|
@@ -486,17 +474,15 @@ print $date;
|
|
|
</entry>
|
|
|
<entry>
|
|
|
Für die Ausgabe werden nur vollständige <acronym>ISO</acronym> 8601
|
|
|
- Daten unterstützt. Beispiel: <code>2009-02-14T00:31:30+01:00</code>
|
|
|
+ Daten unterstützt. Beispiel: 2009-02-14T00:31:30+01:00
|
|
|
</entry>
|
|
|
</row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
-
|
|
|
</sect3>
|
|
|
|
|
|
<sect3 id="id.date.basic.operations">
|
|
|
-
|
|
|
<title>Liste der Datums-Operationen</title>
|
|
|
|
|
|
<para>
|
|
|
@@ -520,7 +506,8 @@ print $date;
|
|
|
<entry><methodname>get()</methodname></entry>
|
|
|
<entry>
|
|
|
<para>
|
|
|
- <emphasis>get($part = null, $locale = null)</emphasis>
|
|
|
+ <emphasis><methodname>get($part = null, $locale =
|
|
|
+ null)</methodname></emphasis>
|
|
|
</para>
|
|
|
<para>
|
|
|
<methodname>get($part)</methodname> kann benutzt werden um einen
|
|
|
@@ -529,20 +516,27 @@ print $date;
|
|
|
lokalisiert oder als formatierte Zeichenkette oder Integer
|
|
|
gewünscht ist zurück zu bekommen. Durch Verwendung der BCMath
|
|
|
Erweiterung können nummerische Zeichenkettten statt Integer für
|
|
|
- große Werte zurückgegeben werden. <emphasis>NOTE:</emphasis>
|
|
|
- Anders als <methodname>get()</methodname> geben die anderen
|
|
|
- get*() bequemlichen Methoden nur Instanzen von
|
|
|
- <classname>Zend_Date</classname> zurück welche nur das Datum
|
|
|
- oder die Zeit repräsentieren das ausgewählt oder berechnet
|
|
|
- wurde.
|
|
|
+ große Werte zurückgegeben werden.
|
|
|
</para>
|
|
|
+
|
|
|
+ <note>
|
|
|
+ <title>Verhalten von get()</title>
|
|
|
+ <para>
|
|
|
+ Anders als <methodname>get()</methodname> geben die anderen
|
|
|
+ get*() bequemlichen Methoden nur Instanzen von
|
|
|
+ <classname>Zend_Date</classname> zurück welche nur das Datum
|
|
|
+ oder die Zeit repräsentieren das ausgewählt oder berechnet
|
|
|
+ wurde.
|
|
|
+ </para>
|
|
|
+ </note>
|
|
|
</entry>
|
|
|
</row>
|
|
|
<row>
|
|
|
<entry><methodname>set()</methodname></entry>
|
|
|
<entry>
|
|
|
<para>
|
|
|
- <emphasis>set($date, $part = null, $locale = null)</emphasis>
|
|
|
+ <emphasis><methodname>set($date, $part = null, $locale =
|
|
|
+ null)</methodname></emphasis>
|
|
|
</para>
|
|
|
<para>
|
|
|
Setzt den Abschnitt <varname>$part</varname> des aktuellen
|
|
|
@@ -556,7 +550,8 @@ print $date;
|
|
|
<entry><methodname>add()</methodname></entry>
|
|
|
<entry>
|
|
|
<para>
|
|
|
- <emphasis>add($date, $part = null, $locale = null)</emphasis>
|
|
|
+ <emphasis><methodname>add($date, $part = null, $locale =
|
|
|
+ null)</methodname></emphasis>
|
|
|
</para>
|
|
|
<para>
|
|
|
Addiert den Abschnitt <varname>$part</varname> von
|
|
|
@@ -570,7 +565,8 @@ print $date;
|
|
|
<entry><methodname>sub()</methodname></entry>
|
|
|
<entry>
|
|
|
<para>
|
|
|
- <emphasis>sub($date, $part = null, $locale = null)</emphasis>
|
|
|
+ <emphasis><methodname>sub($date, $part = null, $locale =
|
|
|
+ null)</methodname></emphasis>
|
|
|
</para>
|
|
|
<para>
|
|
|
Subtrahiert den Abschnitt <varname>$part</varname> von
|
|
|
@@ -584,7 +580,8 @@ print $date;
|
|
|
<entry><methodname>copyPart()</methodname></entry>
|
|
|
<entry>
|
|
|
<para>
|
|
|
- <emphasis>copyPart($part, $locale = null)</emphasis>
|
|
|
+ <emphasis><methodname>copyPart($part, $locale =
|
|
|
+ null)</methodname></emphasis>
|
|
|
</para>
|
|
|
<para>
|
|
|
Gibt ein geklontes Objekt zurück, wobei nur der gewünschte
|
|
|
@@ -598,28 +595,25 @@ print $date;
|
|
|
<entry><methodname>compare()</methodname></entry>
|
|
|
<entry>
|
|
|
<para>
|
|
|
- <emphasis>compare($date, $part = null, $locale =
|
|
|
- null)</emphasis>
|
|
|
+ <emphasis><methodname>compare($date, $part = null, $locale =
|
|
|
+ null)</methodname></emphasis>
|
|
|
</para>
|
|
|
<para>
|
|
|
Vergleicht den Abschnitt <varname>$part</varname> des Datums
|
|
|
<varname>$date</varname> mit dem Zeitpunkt des Objektes. Gibt 0
|
|
|
zurück wenn sie gleich sind, 1 wenn wenn der Abschnitt dieses
|
|
|
- Objektes früher war als der Abschnitt von $date und andernfalls
|
|
|
- -1.
|
|
|
+ Objektes früher war als der Abschnitt von
|
|
|
+ <varname>$date</varname> und andernfalls -1.
|
|
|
</para>
|
|
|
</entry>
|
|
|
</row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
-
|
|
|
</sect3>
|
|
|
-
|
|
|
</sect2>
|
|
|
|
|
|
<sect2 id="zend.date.others.comparison">
|
|
|
-
|
|
|
<title>Vergleichen von Daten</title>
|
|
|
|
|
|
<para>
|
|
|
@@ -641,7 +635,8 @@ print $date;
|
|
|
<entry><methodname>equals()</methodname></entry>
|
|
|
<entry>
|
|
|
<para>
|
|
|
- <emphasis>equals($date, $part = null, $locale = null)</emphasis>
|
|
|
+ <emphasis><methodname>equals($date, $part = null, $locale =
|
|
|
+ null)</methodname></emphasis>
|
|
|
</para>
|
|
|
<para>
|
|
|
Gibt <constant>TRUE</constant> zurück wenn der Abschnitt
|
|
|
@@ -656,7 +651,8 @@ print $date;
|
|
|
<entry><methodname>isEarlier()</methodname></entry>
|
|
|
<entry>
|
|
|
<para>
|
|
|
- <emphasis>isEarlier($date, $part = null, $locale = null)</emphasis>
|
|
|
+ <emphasis><methodname>isEarlier($date, $part = null, $locale =
|
|
|
+ null)</methodname></emphasis>
|
|
|
</para>
|
|
|
<para>
|
|
|
Gibt <constant>TRUE</constant> zurück wenn der Abschnitt
|
|
|
@@ -670,7 +666,8 @@ print $date;
|
|
|
<entry><methodname>isLater()</methodname></entry>
|
|
|
<entry>
|
|
|
<para>
|
|
|
- <emphasis>isLater($date, $part = null, $locale = null)</emphasis>
|
|
|
+ <emphasis><methodname>isLater($date, $part = null, $locale =
|
|
|
+ null)</methodname></emphasis>
|
|
|
</para>
|
|
|
<para>
|
|
|
Gibt <constant>TRUE</constant> zurück wenn der Abschnitt
|
|
|
@@ -684,7 +681,7 @@ print $date;
|
|
|
<entry><methodname>isToday()</methodname></entry>
|
|
|
<entry>
|
|
|
<para>
|
|
|
- <emphasis>isToday()</emphasis>
|
|
|
+ <emphasis><methodname>isToday()</methodname></emphasis>
|
|
|
</para>
|
|
|
<para>
|
|
|
Testet ob Jahr, Monat und Tag des heutigen Datums mit dem Datumswert
|
|
|
@@ -697,7 +694,7 @@ print $date;
|
|
|
<entry><methodname>isTomorrow()</methodname></entry>
|
|
|
<entry>
|
|
|
<para>
|
|
|
- <emphasis>isTomorrow()</emphasis>
|
|
|
+ <emphasis><methodname>isTomorrow()</methodname></emphasis>
|
|
|
</para>
|
|
|
<para>
|
|
|
Testet ob Jahr, Monat und Tag des morgigen Datums mit dem Datumswert
|
|
|
@@ -710,7 +707,7 @@ print $date;
|
|
|
<entry><methodname>isYesterday()</methodname></entry>
|
|
|
<entry>
|
|
|
<para>
|
|
|
- <emphasis>isYesterday()</emphasis>
|
|
|
+ <emphasis><methodname>isYesterday()</methodname></emphasis>
|
|
|
</para>
|
|
|
<para>
|
|
|
Testet ob Jahr, Monat und Tag des gestrigen Datums mit dem
|
|
|
@@ -723,7 +720,7 @@ print $date;
|
|
|
<entry><methodname>isLeapYear()</methodname></entry>
|
|
|
<entry>
|
|
|
<para>
|
|
|
- <emphasis>isLeapYear()</emphasis>
|
|
|
+ <emphasis><methodname>isLeapYear()</methodname></emphasis>
|
|
|
</para>
|
|
|
<para>
|
|
|
<methodname>isLeapYear()</methodname> kann benutzt werden ob zu
|
|
|
@@ -740,25 +737,25 @@ print $date;
|
|
|
<entry><methodname>isDate()</methodname></entry>
|
|
|
<entry>
|
|
|
<para>
|
|
|
- <emphasis>isDate($date, $format = null, $locale = null)</emphasis>
|
|
|
+ <emphasis><methodname>isDate($date, $format = null, $locale =
|
|
|
+ null)</methodname></emphasis>
|
|
|
</para>
|
|
|
<para>
|
|
|
Diese Methode prüft ob ein angegebenes Datum ein echtes Datum ist,
|
|
|
und gibt <constant>TRUE</constant> zurück wenn alle Prüfungen in
|
|
|
- Ordnung waren. Sie arbeitet wie <acronym>PHP</acronym>'s checkdate()
|
|
|
- Funktion, kann aber auch lokalisierte Monatsnamen prüfen sowie Daten
|
|
|
- die den Bereich von checkdate() übersteigen
|
|
|
+ Ordnung waren. Sie arbeitet wie <acronym>PHP</acronym>'s
|
|
|
+ <methodname>checkdate()</methodname> Funktion, kann aber auch
|
|
|
+ lokalisierte Monatsnamen prüfen sowie Daten die den Bereich von
|
|
|
+ <methodname>checkdate()</methodname> übersteigen
|
|
|
</para>
|
|
|
</entry>
|
|
|
</row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
-
|
|
|
</sect2>
|
|
|
|
|
|
<sect2 id="zend.date.others.gettingparts">
|
|
|
-
|
|
|
<title>Daten und Teile von Daten erhalten</title>
|
|
|
|
|
|
<para>
|
|
|
@@ -780,7 +777,8 @@ print $date;
|
|
|
<entry><methodname>toString()</methodname></entry>
|
|
|
<entry>
|
|
|
<para>
|
|
|
- <emphasis>toString($format = null, $locale = null)</emphasis>
|
|
|
+ <emphasis><methodname>toString($format = null, $locale =
|
|
|
+ null)</methodname></emphasis>
|
|
|
</para>
|
|
|
<para>
|
|
|
Direkt aufzurufen oder über die magische Methode
|
|
|
@@ -798,7 +796,7 @@ print $date;
|
|
|
<entry><methodname>toArray()</methodname></entry>
|
|
|
<entry>
|
|
|
<para>
|
|
|
- <emphasis>toArray()</emphasis>
|
|
|
+ <emphasis><methodname>toArray()</methodname></emphasis>
|
|
|
</para>
|
|
|
<para>
|
|
|
Gibt eine Array Representation des ausgewählten Datums anhand der
|
|
|
@@ -807,90 +805,100 @@ print $date;
|
|
|
url="http://php.net/getdate">getdate()</ulink> Funktion und
|
|
|
beinhaltet:
|
|
|
</para>
|
|
|
- <para>
|
|
|
- <itemizedlist>
|
|
|
- <listitem>
|
|
|
- <para>
|
|
|
- Tag als Zahl mit '<emphasis>day</emphasis>'
|
|
|
- (<constant>Zend_Date::DAY_SHORT</constant>)
|
|
|
- </para>
|
|
|
- </listitem>
|
|
|
- <listitem>
|
|
|
- <para>
|
|
|
- Monat als Zahl mit '<emphasis>month</emphasis>'
|
|
|
- (<constant>Zend_Date::MONTH_SHORT</constant>)
|
|
|
- </para>
|
|
|
- </listitem>
|
|
|
- <listitem>
|
|
|
- <para>
|
|
|
- Jahr als '<emphasis>year</emphasis>'
|
|
|
- (<constant>Zend_Date::YEAR</constant>)
|
|
|
- </para>
|
|
|
- </listitem>
|
|
|
- <listitem>
|
|
|
- <para>
|
|
|
- Stunde als '<emphasis>hour</emphasis>'
|
|
|
- (<constant>Zend_Date::HOUR_SHORT</constant>)
|
|
|
- </para>
|
|
|
- </listitem>
|
|
|
- <listitem>
|
|
|
- <para>
|
|
|
- Minute als '<emphasis>minute</emphasis>'
|
|
|
- (<constant>Zend_Date::MINUTE_SHORT</constant>)
|
|
|
- </para>
|
|
|
- </listitem>
|
|
|
- <listitem>
|
|
|
- <para>
|
|
|
- Sekunde als '<emphasis>second</emphasis>'
|
|
|
- (<constant>Zend_Date::SECOND_SHORT</constant>)
|
|
|
- </para>
|
|
|
- </listitem>
|
|
|
- <listitem>
|
|
|
- <para>
|
|
|
- Abgekürzte Zeitzone als '<emphasis>timezone</emphasis>'
|
|
|
- (<constant>Zend_Date::TIMEZONE</constant>)
|
|
|
- </para>
|
|
|
- </listitem>
|
|
|
- <listitem>
|
|
|
- <para>
|
|
|
- Unix Zeitpunkt als '<emphasis>timestamp</emphasis>'
|
|
|
- (<constant>Zend_Date::TIMESTAMP</constant>)
|
|
|
- </para>
|
|
|
- </listitem>
|
|
|
- <listitem>
|
|
|
- <para>
|
|
|
- Wochentag als Zahl mit '<emphasis>weekday</emphasis>'
|
|
|
- (<constant>Zend_Date::WEEKDAY_DIGIT</constant>)
|
|
|
- </para>
|
|
|
- </listitem>
|
|
|
- <listitem>
|
|
|
- <para>
|
|
|
- Tag des Jahres als '<emphasis>dayofyear</emphasis>'
|
|
|
- (<constant>Zend_Date::DAY_OF_YEAR</constant>)
|
|
|
- </para>
|
|
|
- </listitem>
|
|
|
- <listitem>
|
|
|
- <para>
|
|
|
- Woche als '<emphasis>week</emphasis>'
|
|
|
- (<constant>Zend_Date::WEEK</constant>)
|
|
|
- </para>
|
|
|
- </listitem>
|
|
|
- <listitem>
|
|
|
- <para>
|
|
|
- Abstand der Zeitzone zu <acronym>GMT</acronym> als
|
|
|
- '<emphasis>gmtsecs</emphasis>'
|
|
|
- (<constant>Zend_Date::GMT_SECS</constant>)
|
|
|
- </para>
|
|
|
- </listitem>
|
|
|
- </itemizedlist>
|
|
|
- </para>
|
|
|
+
|
|
|
+ <itemizedlist>
|
|
|
+ <listitem>
|
|
|
+ <para>
|
|
|
+ Tag als Zahl mit '<emphasis>day</emphasis>'
|
|
|
+ (<constant>Zend_Date::DAY_SHORT</constant>)
|
|
|
+ </para>
|
|
|
+ </listitem>
|
|
|
+
|
|
|
+ <listitem>
|
|
|
+ <para>
|
|
|
+ Monat als Zahl mit '<emphasis>month</emphasis>'
|
|
|
+ (<constant>Zend_Date::MONTH_SHORT</constant>)
|
|
|
+ </para>
|
|
|
+ </listitem>
|
|
|
+
|
|
|
+ <listitem>
|
|
|
+ <para>
|
|
|
+ Jahr als '<emphasis>year</emphasis>'
|
|
|
+ (<constant>Zend_Date::YEAR</constant>)
|
|
|
+ </para>
|
|
|
+ </listitem>
|
|
|
+
|
|
|
+ <listitem>
|
|
|
+ <para>
|
|
|
+ Stunde als '<emphasis>hour</emphasis>'
|
|
|
+ (<constant>Zend_Date::HOUR_SHORT</constant>)
|
|
|
+ </para>
|
|
|
+ </listitem>
|
|
|
+
|
|
|
+ <listitem>
|
|
|
+ <para>
|
|
|
+ Minute als '<emphasis>minute</emphasis>'
|
|
|
+ (<constant>Zend_Date::MINUTE_SHORT</constant>)
|
|
|
+ </para>
|
|
|
+ </listitem>
|
|
|
+
|
|
|
+ <listitem>
|
|
|
+ <para>
|
|
|
+ Sekunde als '<emphasis>second</emphasis>'
|
|
|
+ (<constant>Zend_Date::SECOND_SHORT</constant>)
|
|
|
+ </para>
|
|
|
+ </listitem>
|
|
|
+
|
|
|
+ <listitem>
|
|
|
+ <para>
|
|
|
+ Abgekürzte Zeitzone als '<emphasis>timezone</emphasis>'
|
|
|
+ (<constant>Zend_Date::TIMEZONE</constant>)
|
|
|
+ </para>
|
|
|
+ </listitem>
|
|
|
+
|
|
|
+ <listitem>
|
|
|
+ <para>
|
|
|
+ Unix Zeitpunkt als '<emphasis>timestamp</emphasis>'
|
|
|
+ (<constant>Zend_Date::TIMESTAMP</constant>)
|
|
|
+ </para>
|
|
|
+ </listitem>
|
|
|
+
|
|
|
+ <listitem>
|
|
|
+ <para>
|
|
|
+ Wochentag als Zahl mit '<emphasis>weekday</emphasis>'
|
|
|
+ (<constant>Zend_Date::WEEKDAY_DIGIT</constant>)
|
|
|
+ </para>
|
|
|
+ </listitem>
|
|
|
+
|
|
|
+ <listitem>
|
|
|
+ <para>
|
|
|
+ Tag des Jahres als '<emphasis>dayofyear</emphasis>'
|
|
|
+ (<constant>Zend_Date::DAY_OF_YEAR</constant>)
|
|
|
+ </para>
|
|
|
+ </listitem>
|
|
|
+
|
|
|
+ <listitem>
|
|
|
+ <para>
|
|
|
+ Woche als '<emphasis>week</emphasis>'
|
|
|
+ (<constant>Zend_Date::WEEK</constant>)
|
|
|
+ </para>
|
|
|
+ </listitem>
|
|
|
+
|
|
|
+ <listitem>
|
|
|
+ <para>
|
|
|
+ Abstand der Zeitzone zu <acronym>GMT</acronym> als
|
|
|
+ '<emphasis>gmtsecs</emphasis>'
|
|
|
+ (<constant>Zend_Date::GMT_SECS</constant>)
|
|
|
+ </para>
|
|
|
+ </listitem>
|
|
|
+ </itemizedlist>
|
|
|
</entry>
|
|
|
</row>
|
|
|
<row>
|
|
|
<entry><methodname>toValue()</methodname></entry>
|
|
|
<entry>
|
|
|
<para>
|
|
|
- <emphasis>toValue($part = null)</emphasis>
|
|
|
+ <emphasis><methodname>toValue($part = null)</methodname></emphasis>
|
|
|
</para>
|
|
|
<para>
|
|
|
Gibt eine Integer Repräsentation des ausgewählten Datumsabschnittes
|
|
|
@@ -898,15 +906,23 @@ print $date;
|
|
|
Gebietsschemas des Objektes. Gibt <constant>FALSE</constant> zurück
|
|
|
wenn der Abschnitt <varname>$part</varname> ein nicht numerischer
|
|
|
Wert ist, wie <constant>Zend_Date::MONTH_NAME_SHORT</constant>.
|
|
|
- <emphasis>NOTIZ:</emphasis> Diese Methode ruft <link
|
|
|
- linkend="id.date.basic.operations"><methodname>get()</methodname></link>
|
|
|
- auf und castet das Ergebnis einen <acronym>PHP</acronym> Integer
|
|
|
- Wert, welcher unerwartete Ergebnisse liefern wird, wenn
|
|
|
- <methodname>get()</methodname> eine numerische Zeichenkette
|
|
|
- zurückgibt die eine Zahl enthält welche zu groß für einen
|
|
|
- <acronym>PHP</acronym> Integer Wert auf Ihrem System ist.
|
|
|
- Stattdessen sollte <methodname>get()</methodname> benutzt werden.
|
|
|
</para>
|
|
|
+
|
|
|
+ <note>
|
|
|
+ <title>Grenzen von toValue()</title>
|
|
|
+
|
|
|
+ <para>
|
|
|
+ Diese Methode ruft <link
|
|
|
+ linkend="id.date.basic.operations"><methodname>get()</methodname></link>
|
|
|
+ auf und castet das Ergebnis einen <acronym>PHP</acronym> Integer
|
|
|
+ Wert, welcher unerwartete Ergebnisse liefern wird, wenn
|
|
|
+ <methodname>get()</methodname> eine numerische Zeichenkette
|
|
|
+ zurückgibt die eine Zahl enthält welche zu groß für einen
|
|
|
+ <acronym>PHP</acronym> Integer Wert auf Ihrem System ist.
|
|
|
+ Stattdessen sollte <methodname>get()</methodname> benutzt
|
|
|
+ werden.
|
|
|
+ </para>
|
|
|
+ </note>
|
|
|
</entry>
|
|
|
</row>
|
|
|
<row>
|
|
|
@@ -915,7 +931,8 @@ print $date;
|
|
|
</entry>
|
|
|
<entry>
|
|
|
<para>
|
|
|
- <emphasis>get($part = null, $locale = null)</emphasis>
|
|
|
+ <emphasis><methodname>get($part = null, $locale =
|
|
|
+ null)</methodname></emphasis>
|
|
|
</para>
|
|
|
<para>
|
|
|
Diese Methode gibt den Abschnitt <varname>$part</varname> vom Datum des
|
|
|
@@ -930,7 +947,7 @@ print $date;
|
|
|
<entry><methodname>now()</methodname></entry>
|
|
|
<entry>
|
|
|
<para>
|
|
|
- <emphasis>now($locale = null)</emphasis>
|
|
|
+ <emphasis><methodname>now($locale = null)</methodname></emphasis>
|
|
|
</para>
|
|
|
<para>
|
|
|
Diese bequemliche Funktion ist identisch mit
|
|
|
@@ -943,11 +960,9 @@ print $date;
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
-
|
|
|
</sect2>
|
|
|
|
|
|
<sect2 id="zend.date.others.fractions">
|
|
|
-
|
|
|
<title>Arbeiten mit Sekundenbruchteilen</title>
|
|
|
|
|
|
<para>
|
|
|
@@ -984,11 +999,9 @@ print $date;
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
-
|
|
|
</sect2>
|
|
|
|
|
|
<sect2 id="zend.date.other.sun">
|
|
|
-
|
|
|
<title>Sonnenaufgang / Sonnenuntergang</title>
|
|
|
|
|
|
<para>
|
|
|
@@ -1033,9 +1046,7 @@ print $date;
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
-
|
|
|
</sect2>
|
|
|
-
|
|
|
</sect1>
|
|
|
<!--
|
|
|
vim:se ts=4 sw=4 et:
|