|
|
@@ -1,13 +1,13 @@
|
|
|
<?xml version="1.0" encoding="UTF-8"?>
|
|
|
<!-- EN-Revision: 20766 -->
|
|
|
-<!-- Reviewed: no -->
|
|
|
+<!-- Reviewed: 20766 -->
|
|
|
<sect1 id="zend.date.overview">
|
|
|
<title>Zend_Date API Übersicht</title>
|
|
|
|
|
|
<para>
|
|
|
- Obwohl die <acronym>API</acronym> von <classname>Zend_Date</classname> simpel und eindeutig
|
|
|
- ist, ist dessen Design flexibel und mächtig durch die Vielzahl an Möglcihkeiten von
|
|
|
- Operationen und Operanden.
|
|
|
+ Obwohl die <acronym>API</acronym> von <classname>Zend_Date</classname> simpel und einheitlich
|
|
|
+ ist, ist dessen Design aufgrund der reichhaltigen Permutationen von
|
|
|
+ Operationen und Operanden flexibel und mächtig.
|
|
|
</para>
|
|
|
|
|
|
<sect2 id="zend.date.options">
|
|
|
@@ -18,19 +18,19 @@
|
|
|
|
|
|
<para>
|
|
|
Viele Methoden benutzen Zeichenketten für Datumsformate so ähnlich wie
|
|
|
- <acronym>PHP</acronym>'s <methodname>date()</methodname>. Wenn man mit den Zeichen
|
|
|
- von <acronym>PHP</acronym>'s Datumsformaten mehr Erfahrung hat als mit den
|
|
|
- <acronym>ISO</acronym> Zeichen für Formate dann kann man
|
|
|
+ <methodname>date()</methodname> von <acronym>PHP</acronym>. Wenn man mit den Zeichen
|
|
|
+ der Datumsformaten von <acronym>PHP</acronym> mehr Erfahrung hat als mit den
|
|
|
+ <acronym>ISO</acronym>-Zeichen für Formate, dann kann man
|
|
|
<methodname>Zend_Date::setOptions(array('format_type' => 'php'))</methodname>
|
|
|
- benutzen. Danach können <acronym>PHP</acronym>'s Zeichen für Datumsformate für alle
|
|
|
- Funktionen verwendet werden die einen <varname>$format</varname> Parameter
|
|
|
+ benutzen. Danach können die Zeichen von <acronym>PHP</acronym> für Datumsformate für alle
|
|
|
+ Funktionen verwendet werden, die einen <varname>$format</varname>-Parameter
|
|
|
akzeptieren. Durch Benutzen von
|
|
|
<methodname>Zend_Date::setOptions(array('format_type' => 'iso'))</methodname> kann
|
|
|
- man wieder auf den Standardmodus zurückwechseln der nur <acronym>ISO</acronym>
|
|
|
- Zeichen für Datumsformate unterstützt. Für eine Liste von unterstützten Zeichen
|
|
|
- Codes kann hier nachgelesen werden: <link
|
|
|
- linkend="zend.date.constants.phpformats">selbst definierte AUSGABE Formate bei
|
|
|
- Verwendung von PHP's date() Formatzeichen</link>
|
|
|
+ man wieder auf den Standardmodus zurückwechseln, der nur <acronym>ISO</acronym>-Zeichen
|
|
|
+ für Datumsformate unterstützt. Für eine Liste von unterstützten Zeichencodes
|
|
|
+ kann hier nachgelesen werden: <link
|
|
|
+ linkend="zend.date.constants.phpformats">selbst definierte AUSGABE-Formate bei
|
|
|
+ Verwendung der date()-Formatzeichen von PHP</link>
|
|
|
</para>
|
|
|
</sect3>
|
|
|
|
|
|
@@ -38,42 +38,42 @@
|
|
|
<title>Sommer-/Winterzeit und Datumsberechnungen</title>
|
|
|
|
|
|
<para>
|
|
|
- Wenn Daten manipuliert werden überschreiten Sie manchmal die <acronym>DST</acronym>
|
|
|
- Grenze (Sommer-/Winterzeit) was normalerweise dazu führt dass das Datum eine Stunde
|
|
|
+ Wenn Daten manipuliert werden, überschreiten sie manchmal die <acronym>DST</acronym>-Grenze
|
|
|
+ (Sommer-/Winterzeit), was normalerweise dazu führt, dass das Datum eine Stunde
|
|
|
verliert oder hinzubekommt. Wenn zum Beispiel ein Monat zu einem Datum vor einer
|
|
|
- <acronym>DST</acronym> Änderung hinzugefügt wird und das Ergebnismonat nach dieser
|
|
|
- Änderung liegt, sieht es so aus als ob das Datum eine Stunde verliert oder
|
|
|
- hinzubekommt durch den Wert des geänderten Datums. Für Grenzstunden, wie Mitternacht
|
|
|
+ <acronym>DST</acronym>-Änderung hinzugefügt wird und der Ergebnismonat nach dieser
|
|
|
+ Änderung liegt, sieht es so aus, als ob das Datum durch den Wert des geänderten Datums
|
|
|
+ eine Stunde verliert oder hinzubekommt. Für Grenzstunden wie Mitternacht,
|
|
|
für den ersten oder letzten Tag eines Monats, führt das Hinzufügen von genügend
|
|
|
- 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
|
|
|
- <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
|
|
|
+ Monaten dazu, dass das Datum eine Stunde verliert, wenn die <acronym>DST</acronym>-Grenze
|
|
|
+ überschritten wird und damit zum letzten Tag des Vormonats wird, was den Anschein
|
|
|
+ eines "eins fehlt" Fehlers erweckt. Um diese Situationen zu vermeiden, kann
|
|
|
+ die <acronym>DST</acronym>-Änderung durch Verwendung der
|
|
|
+ Option <property>fix_dst</property> ignoriert werden. Wenn eine
|
|
|
+ <acronym>DST</acronym>-Grenze überschritten wird, wird ja normalerweise abhängig
|
|
|
+ vom Datum eine Stunde hinzugefügt oder entfernt. 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
|
|
|
+ <classname>Zend_Date</classname> auf Zeitstempeln basiert und nicht auf Kalenderdaten
|
|
|
+ mit Zeitkomponenten, verliert der Zeitstempel 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>,
|
|
|
+ <constant>TRUE</constant> ist. Das führt dazu, dass die <acronym>DST</acronym> keinen
|
|
|
+ Einfluß mehr bei Datumsberechnungen hat (<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.
|
|
|
+ benutzt werden, um Hinzufügen oder Entfernen der <acronym>DST</acronym>-Anpassung zu
|
|
|
+ gestatten, wenn Datumsberechnungen durchgeführt werden.
|
|
|
</para>
|
|
|
|
|
|
<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 '<property>fix_dst</property>'
|
|
|
- nicht verwendet</emphasis> weil diese zwei Zeitzonen nicht mit
|
|
|
+ <acronym>GMT</acronym> gestellt ist, 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
|
|
|
+ Zeitzone gestellt wird, die nicht <acronym>UTC</acronym> oder <acronym>GMT</acronym>
|
|
|
+ ist, wird die vorher definierte Option 'fix_dst' wieder für die Datumsberechnungen
|
|
|
verwendet.
|
|
|
</para>
|
|
|
</sect3>
|
|
|
@@ -82,26 +82,26 @@
|
|
|
<title>Monatsberechnungen</title>
|
|
|
|
|
|
<para>
|
|
|
- Wenn Monate von einem existierenden Datum hinzugefügt oder entfernt werden, kann der
|
|
|
+ Wenn Monate zu einem existierenden Datum hinzugefügt oder davon entfernt werden, kann der
|
|
|
Ergebniswert des Monatstages unerwartet sein, wenn das Originaldatum auf einen Tag
|
|
|
- gefallen ist der Nahe am Ende des Monats ist. Wenn zum Beispiel ein Monat zum 31sten
|
|
|
- Jänner hinzugefügt wird, werden Personen welche mit <acronym>SQL</acronym> vertraut
|
|
|
- sind den 28sten Februar als Ergebnis erwarten. Auf der anderen Seite werden Personen
|
|
|
- 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 <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
|
|
|
+ gefallen ist, der Nahe am Ende des Monats ist. Wenn zum Beispiel ein Monat zum 31sten
|
|
|
+ Jänner hinzugefügt wird, werden Personen, welche mit <acronym>SQL</acronym> vertraut
|
|
|
+ sind, den 28sten Februar als Ergebnis erwarten. Auf der anderen Seite werden Personen,
|
|
|
+ welche mit Excel und OpenOffice vertraut sind, den 3ten März als Ergebnis
|
|
|
+ erwarten. Das Problem besteht nur, wenn der Ergebnismonat den Tag nicht hat,
|
|
|
+ der im Originaldatum gesetzt war. Zend Framework Entwickler können das gewünschte
|
|
|
+ Verhalten beeinflussen, indem die Option <property>extend_month</property> genutzt
|
|
|
+ wird, die bei einem Wert von <constant>FALSE</constant> das
|
|
|
+ <acronym>SQL</acronym>-Verhalten, oder bei einem Wert von <constant>TRUE</constant>
|
|
|
+ das Tabellenverhalten auswählt. Das Standardverhalten für
|
|
|
<property>extend_month</property> ist <constant>FALSE</constant>, um
|
|
|
- <acronym>SQL</acronym> kompatibles Verhalten zu erlauben.
|
|
|
+ <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.
|
|
|
+ durch, dass Daten auf das Monatsende hin abgeschnitten werden (wenn notwendig), ohne
|
|
|
+ dass in den nächsten Monat umgebrochen wird, wenn das Originaldatum einen Monatstag
|
|
|
+ bestimmt, der die Anzahl der Tage des Ergebnismonats überschreitet.
|
|
|
<methodname>Zend_Date::setOptions(array('extend_month' => true))</methodname> kann
|
|
|
- benutzt werden um Monatsberechnungen wie in populären Tabellenkalkulationen
|
|
|
+ benutzt werden, um Monatsberechnungen wie in populären Tabellenkalkulationen
|
|
|
durchzuführen.
|
|
|
</para>
|
|
|
</sect3>
|
|
|
@@ -112,14 +112,14 @@
|
|
|
</title>
|
|
|
|
|
|
<para>
|
|
|
- Man kann <classname>Zend_Date</classname> schneller machen indem ein
|
|
|
- <classname>Zend_Cache</classname> Adapter verwendet wird. Das verschnellert alle
|
|
|
- Methoden von <classname>Zend_Date</classname> wenn lokalisierte Daten verwendet
|
|
|
- werden. Zum Beispiel werden alle Methoden welche
|
|
|
+ Man kann <classname>Zend_Date</classname> schneller machen, indem ein
|
|
|
+ <classname>Zend_Cache</classname>-Adapter verwendet wird. Das verschnellert alle
|
|
|
+ Methoden von <classname>Zend_Date</classname>, wenn lokalisierte Daten verwendet
|
|
|
+ werden. Zum Beispiel werden alle Methoden hiervon profitieren, welche
|
|
|
<constant>Zend_Date::DATE</constant> und <constant>Zend_Date::TIME</constant>
|
|
|
- Konstanten akzeptieren hiervon profitieren. Um einen
|
|
|
- <classname>Zend_Cache</classname> Adapter für <classname>Zend_Date</classname> zu
|
|
|
- setzen muß nur
|
|
|
+ Konstanten akzeptieren. Um einen
|
|
|
+ <classname>Zend_Cache</classname>-Adapter für <classname>Zend_Date</classname> zu
|
|
|
+ verwenden, muß nur
|
|
|
<methodname>Zend_Date::setOptions(array('cache' => $adapter))</methodname>
|
|
|
aufgerufen werden.
|
|
|
</para>
|
|
|
@@ -130,14 +130,14 @@
|
|
|
|
|
|
<para>
|
|
|
Normalerweise unterscheiden sich die Uhren von Servern und Computern voneinander.
|
|
|
- <classname>Zend_Date</classname> ist dazu fähig solche Probleme mit Hilfe von
|
|
|
+ <classname>Zend_Date</classname> ist dazu fähig, solche Probleme mit Hilfe von
|
|
|
<classname>Zend_TimeSync</classname> zu handhaben. Mit
|
|
|
<methodname>Zend_Date::setOptions(array('timesync' => $timeserver))</methodname>
|
|
|
- kann ein Zeitserver gesetzt werden welcher den Unterschied zwischen dem eigenen
|
|
|
- aktuellen Zeitpunkt und dem wirklichen aktuellen Zeitpunkt für alle Instanzen von
|
|
|
- <classname>Zend_Date</classname> setzt. Die Verwendung dieser Option ändern nicht
|
|
|
- den Zeitpunkt von bestehenden Instanzen. Am besten ist es also dies innerhalb der
|
|
|
- Bootstrap Datei zu setzen.
|
|
|
+ kann ein Zeitserver gesetzt werden, welcher den Unterschied zwischen dem eigenen
|
|
|
+ aktuellen Zeitstempel und dem wirklichen aktuellen Zeitstempel für alle Instanzen von
|
|
|
+ <classname>Zend_Date</classname> setzt. Die Verwendung dieser Option ändert nicht
|
|
|
+ den Zeitstempel von bestehenden Instanzen. Am besten ist es also, dies innerhalb der
|
|
|
+ Bootstrap-Datei zu setzen.
|
|
|
</para>
|
|
|
</sect3>
|
|
|
</sect2>
|
|
|
@@ -146,26 +146,26 @@
|
|
|
<title>Arbeiten mit Datumswerten</title>
|
|
|
|
|
|
<para>
|
|
|
- Sobald die Eingabe durch die Erstellung eines <classname>Zend_Date</classname> Objektes
|
|
|
- normalisiert wurde, hat es eine zugeordnete Zeitzone aber eine Interne Darstellung durch
|
|
|
- Verwendung von <ulink
|
|
|
- url="http://en.wikipedia.org/wiki/Unix_Time">UNIX Zeitpunkten</ulink>. Damit ein
|
|
|
+ Sobald die Eingabe durch die Erstellung eines <classname>Zend_Date</classname>-Objekts
|
|
|
+ normalisiert wurde, hat es eine zugeordnete Zeitzone aber die interne Darstellung
|
|
|
+ verwendet <ulink
|
|
|
+ url="http://en.wikipedia.org/wiki/Unix_Time">UNIX Zeitstempel</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> 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.
|
|
|
+ Zeitzone bekannt sein. Die Standardzeitzone ist immer <acronym>GMT</acronym> oder
|
|
|
+ <acronym>UTC</acronym>. Um die Zeitzone des Objekts zu inspizieren, kann
|
|
|
+ <methodname>getTimeZone()</methodname> verwendet werden. Um die Zeitzone des Objekts zu
|
|
|
+ wechseln, kann <methodname>setTimeZone()</methodname> verwendet werden. Alle Änderungen
|
|
|
+ des Objekts sind immer relativ zu seiner Zeitzone zu sehen.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- Aufpassen das nicht Teile von Datumsobjekten die unterschiedliche Zeitzonen haben,
|
|
|
- gemischt oder verglichen werden, da dies Grundsätzlich unerwartete Resultate zeigen kann
|
|
|
- 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 <acronym>UNIX</acronym>
|
|
|
- Zeitpunkten normalisiert werden.
|
|
|
+ Man sollte es vermeiden, Teile von Datumsobjekten mit unterschiedlichen Zeitzonen
|
|
|
+ zu mischen oder zu vergleichen, da dies grundsätzlich unerwartete Resultate zeigen kann,
|
|
|
+ es sei denn, die Manipulationen beziehen sich nur auf den [UNIX-]Zeitstempel. Das Arbeiten mit
|
|
|
+ <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
|
|
|
+ <acronym>UNIX</acronym>-Zeitstempel normalisiert werden.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
@@ -179,10 +179,10 @@
|
|
|
benutzerdefiniertes Format für <varname>$part</varname> verwendet werden, mit Hilfe der
|
|
|
gleichen Mechanismen und Formatdefinitionen wie bei <link
|
|
|
linkend="zend.locale.date.normalize"><methodname>Zend_Locale_Format::getDate()</methodname></link>.
|
|
|
- Wenn ein Datumsobjekt erstellt wird durch Verwendung eines offensichtlich falschen
|
|
|
- Datums (z.B. die Nummer des Monats größer als 12), wird <classname>Zend_Date</classname>
|
|
|
- eine Ausnahme werfen, solange kein spezielles Datumsformat ausgewählt wurde, und z.B.
|
|
|
- <varname>$part</varname> entweder <constant>NULL</constant> oder
|
|
|
+ Wenn ein Datumsobjekt durch Verwendung eines offensichtlich falschen Datums
|
|
|
+ erstellt wird (z.B. wenn die Nummer des Monats größer als 12 ist), wird <classname>Zend_Date</classname>
|
|
|
+ eine Ausnahme werfen, solange kein spezielles Datumsformat ausgewählt wurde, das heißt,
|
|
|
+ <varname>$part</varname> ist entweder <constant>NULL</constant> oder
|
|
|
<constant>Zend_Date::DATES</constant> (ein "fehlertolerantes" Format).
|
|
|
</para>
|
|
|
|
|
|
@@ -203,39 +203,39 @@ echo $date3, "\n"; // Ausgabe "Mar 3, 2007 12:00:00 AM"
|
|
|
</example>
|
|
|
|
|
|
<para>
|
|
|
- Wenn der optionale <varname>$locale</varname> Parameter angegeben wurde, dann
|
|
|
- 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 <link
|
|
|
+ Wenn der optionale Parameter <varname>$locale</varname> angegeben wird, dann
|
|
|
+ macht <varname>$locale</varname> den <varname>$date</varname>-Operand durch
|
|
|
+ Ersetzen der Monatsnamen und Wochentagsnamen für die Zeichenkette
|
|
|
+ <varname>$date</varname> eindeutig und sogar Datumszeichenketten können gemäß den
|
|
|
+ Konventionen dieses Gebietsschemas analysiert werden (siehe <link
|
|
|
linkend="zend.locale.date.normalize">Zend_Locale_Format::getDate()</link>).
|
|
|
- Die automatische Normalisierung von lokalisierten <varname>$date</varname> Angaben einer
|
|
|
+ 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>*
|
|
|
- Konstanten verwendet wird. Das Gebietsschema identifiziert die Sprache welche verwendet
|
|
|
- werden soll um Monatsnamen und Wochentagsnamen zu analysieren wenn
|
|
|
- <varname>$date</varname> eine Zeichenkette ist die ein Datum enthält. Wenn der
|
|
|
+ Konstanten <constant>Zend_Date::DATE</constant>* oder <constant>Zend_Date::TIME</constant>*
|
|
|
+ verwendet wird. Das Gebietsschema identifiziert die Sprache, welche verwendet
|
|
|
+ werden soll, um Monatsnamen und Wochentagsnamen zu analysieren, wenn
|
|
|
+ <varname>$date</varname> eine Zeichenkette ist, die ein Datum enthält. Wenn der
|
|
|
Eingabeparameter <varname>$date</varname> nicht angegeben wurde, dann definiert der
|
|
|
- <varname>$locale</varname> Parameter das Gebietsschema für lokalisierte Ausgaben (z.B.
|
|
|
- das Datumsformat für eine Ausgabe als Zeichenkette). Anzumerken ist auch das der
|
|
|
- <varname>$date</varname> Parameter stattdessen ein Typname sein kann (z.B.
|
|
|
- <varname>$hour</varname> für <methodname>addHour()</methodname>), und das verhindert
|
|
|
- auch nicht das ein <classname>Zend_Date</classname> Objekt als Argument für diesen
|
|
|
- Parameter angegeben werden kann. Wenn keine <varname>$locale</varname> angegeben wurde,
|
|
|
- wird das Gebietsschema des aktuellen Objektes genommen um <varname>$date</varname> zu
|
|
|
+ Parameter <varname>$locale</varname> das Gebietsschema für lokalisierte Ausgaben (z.B.
|
|
|
+ das Datumsformat für eine Ausgabe als Zeichenkette). Anzumerken ist auch, dass der
|
|
|
+ Parameter <varname>$date</varname> stattdessen ein Typname sein kann (z.B.
|
|
|
+ <varname>$hour</varname> für <methodname>addHour()</methodname>) wobei das nicht verhindert,
|
|
|
+ dass ein <classname>Zend_Date</classname> Objekt als Argument für diesen
|
|
|
+ Parameter angegeben werden kann. Wenn <varname>$locale</varname> nicht angegeben wurde,
|
|
|
+ wird das Gebietsschema des aktuellen Objekts genommen, um <varname>$date</varname> zu
|
|
|
interpretieren oder das lokalisierte Format für die Ausgabe auszuwählen.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
Seit Zend Framework 1.7.0 unterstützt <classname>Zend_Date</classname> auch die
|
|
|
- Verwendung eines Anwendungsweiten Gebietsschemas. Man kann ganz einfach eine
|
|
|
- <classname>Zend_Locale</classname> Instanz in der Registry setzen wie anbei gezeigt. Mit
|
|
|
- dieser Schreibweise kann man das manuelle Setzen eines Gebietsschemas für jede Instanz
|
|
|
- vergessen wenn man das selbe Gebietsschema mehrere Male verwenden will.
|
|
|
+ Verwendung eines anwendungsweiten Gebietsschemas. Man kann ganz einfach eine
|
|
|
+ <classname>Zend_Locale</classname>-Instanz in der Registry setzen wie hier gezeigt. Mit
|
|
|
+ dieser Schreibweise braucht man sich nicht um das manuelle Setzen eines Gebietsschemas für jede Instanz
|
|
|
+ zu kümmern, wenn man dasselbe Gebietsschema mehrere Male verwenden will.
|
|
|
</para>
|
|
|
|
|
|
<programlisting language="php"><![CDATA[
|
|
|
-// In der Bootstrap Datei
|
|
|
+// In der Bootstrap-Datei
|
|
|
$locale = new Zend_Locale('de_AT');
|
|
|
Zend_Registry::set('Zend_Locale', $locale);
|
|
|
|
|
|
@@ -249,18 +249,18 @@ $date = new Zend_Date('31.Feb.2007');
|
|
|
|
|
|
<para>
|
|
|
Die Methoden <methodname>add()</methodname>, <methodname>sub()</methodname>,
|
|
|
- <methodname>compare()</methodname>, <methodname>get()</methodname>, und
|
|
|
- <methodname>set()</methodname> arbeiten generell mit Daten. In Jedem Fall wird die
|
|
|
- Operation auf dem Datum durchgeführt das in den Objektinstanz vorhanden ist. Der
|
|
|
- <varname>$date</varname> Operand wird für alle dieser Methoden benötigt, ausser für
|
|
|
+ <methodname>compare()</methodname>, <methodname>get()</methodname> und
|
|
|
+ <methodname>set()</methodname> arbeiten generell mit Daten. In jedem Fall wird die
|
|
|
+ Operation auf dem Datum durchgeführt, das in der Objektinstanz vorhanden ist. Der
|
|
|
+ <varname>$date</varname> Operand wird für alle diese Methoden benötigt, außer für
|
|
|
<methodname>get()</methodname> und kann eine <classname>Zend_Date</classname>
|
|
|
- Objektinstanz, eine nummerische Zeichenkette oder ein Integer sein. Diese Methoden
|
|
|
- nehmen an das <varname>$date</varname> ein Zeitpunkt ist, wenn es kein Objekt ist.
|
|
|
- Trotzdem kontrolliert der <varname>$part</varname> Operand an welchem logischen Teil
|
|
|
+ Objektinstanz, eine numerische Zeichenkette oder ein Integer sein. Diese Methoden
|
|
|
+ nehmen an, dass <varname>$date</varname> ein Zeitstempel ist, wenn es kein Objekt ist.
|
|
|
+ Trotzdem kontrolliert der <varname>$part</varname> Operand, an welchem logischen Teil
|
|
|
der zwei Daten gearbeitet werden soll, was Arbeiten an Teilen von Daten des Objekts
|
|
|
- erlaubt, wie Jahr oder Minute selbst wenn <varname>$date</varname> eine lange Form
|
|
|
+ erlaubt, wie Jahr oder Minute, selbst wenn <varname>$date</varname> eine lange Form
|
|
|
einer Datumszeichenkette enthält wie "Dezember 31, 2007 23:59:59". Das Ergebnis der
|
|
|
- Operation ändert das Datum im Objekt ausser bei <methodname>compare()</methodname> und
|
|
|
+ Operation ändert das Datum im Objekt außer bei <methodname>compare()</methodname> und
|
|
|
<methodname>get()</methodname>.
|
|
|
</para>
|
|
|
|
|
|
@@ -268,7 +268,7 @@ $date = new Zend_Date('31.Feb.2007');
|
|
|
<title>Arbeiten an Teilen von Daten</title>
|
|
|
|
|
|
<programlisting language="php"><![CDATA[
|
|
|
-$date = new Zend_Date(); // $date's Zeitpunkt === time()
|
|
|
+$date = new Zend_Date(); // $date's Zeitstempel === time()
|
|
|
|
|
|
// Ändert $date durch addieren von 12 Stunden
|
|
|
$date->add('12', Zend_Date::HOUR);
|
|
|
@@ -277,25 +277,25 @@ print $date;
|
|
|
</example>
|
|
|
|
|
|
<para>
|
|
|
- Übliche Methoden existieren für jede Kombination von Basisarbeiten und viele normale
|
|
|
- Datumsabschnitte wie in der Tabelle anbei gezeigt. Diese üblichen Methoden erlauben uns
|
|
|
- faulen Programmierern zu vermeiden das die <link
|
|
|
+ Es existieren Komfortmethoden für jede Kombination von Grundoperationen und viele normale
|
|
|
+ Datumsabschnitte wie in der unten stehenden Tabelle gezeigt. Diese Komfortmethoden erlauben uns
|
|
|
+ faulen Programmierern zu vermeiden, dass die <link
|
|
|
linkend="zend.date.constants.list">Konstanten für Datumsabschnitte</link>
|
|
|
- ausgeschrieben werden müssen. Normalerweise sind wir benannt durch Kombination eines
|
|
|
+ ausgeschrieben werden müssen. Bequemerweise sind sie benannt durch Kombination eines
|
|
|
Prefixes (Name der Basisoperation) und einem Suffix (Art des Datumsabschnittes), wie
|
|
|
- <methodname>addYear()</methodname>. In der Liste die anbei steht, existieren alle
|
|
|
+ <methodname>addYear()</methodname>. In der unten stehenden Liste existieren alle
|
|
|
Kombinationen von "Datumsabschnitten" und "Basisoperationen". Zum Beispiel die
|
|
|
Operation "add" existiert für jeden dieser Datumsabschnitte wie
|
|
|
<methodname>addDay()</methodname>, <methodname>addYear()</methodname> und viele mehr.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- Diese üblichen Methoden haben die selbe gleichartige Funktionalität wie die Methoden für
|
|
|
- die Basisoperationen, aber Sie erwarten Zeichenkette und Integer
|
|
|
- <varname>$date</varname> Operanden welche nur die Werte enthalten welche durch den Typ
|
|
|
- definiert sind der durch den Suffix der Methode definiert wurde. Deshalb identifizieren
|
|
|
+ Diese Komfortmethoden haben eine gleichwertige Funktionalität wie die Methoden für
|
|
|
+ die Basisoperationen, aber sie erwarten <varname>$date</varname>-Operanden vom
|
|
|
+ Typ Zeichenkette oder Integer, welche nur die Werte enthalten, die durch den Typ
|
|
|
+ definiert sind, der durch das Suffix der Methode definiert wurde. Deshalb identifizieren
|
|
|
diese Methoden (z.B. "Year" oder "Minute") die Einheit des <varname>$date</varname>
|
|
|
- Operanden wenn <varname>$date</varname> eine Zeichenkette oder ein Integer ist
|
|
|
+ Operanden, wenn <varname>$date</varname> eine Zeichenkette oder ein Integer ist
|
|
|
</para>
|
|
|
|
|
|
<sect3 id="id.date.basic.parts">
|
|
|
@@ -316,11 +316,11 @@ print $date;
|
|
|
<row>
|
|
|
<entry>
|
|
|
<ulink
|
|
|
- url="http://en.wikipedia.org/wiki/Unix_Time">Zeitpunkt</ulink>
|
|
|
+ url="http://en.wikipedia.org/wiki/Unix_Time">Zeitstempel</ulink>
|
|
|
</entry>
|
|
|
|
|
|
<entry>
|
|
|
- UNIX Zeitpunkt, ausgedrückt in Sekunden die vergangen sind seit dem
|
|
|
+ UNIX Zeitstempel, ausgedrückt in Sekunden die vergangen sind seit dem
|
|
|
1. Jänner, 1970 00:00:00 <acronym>GMT</acronym>.
|
|
|
</entry>
|
|
|
</row>
|
|
|
@@ -388,14 +388,14 @@ print $date;
|
|
|
<entry>
|
|
|
Millisekunden bezeichnen Tausendstel einer Sekunde (0-999).
|
|
|
<classname>Zend_Date</classname> unterstützt zwei zusätzliche
|
|
|
- Methoden für das Arbeiten mit Zeiteinheiten die kleiner als Sekunden
|
|
|
+ Methoden für das Arbeiten mit Zeiteinheiten, die kleiner als Sekunden
|
|
|
sind. Normalerweise verwenden <classname>Zend_Date</classname>
|
|
|
- Instanzen eine Genauigkeit welche der von Millisekunden entspricht
|
|
|
+ Instanzen eine Genauigkeit, welche der von Millisekunden entspricht
|
|
|
wie man durch <methodname>getFractionalPrecision()</methodname>
|
|
|
- sehen kann. Um die Genauigkeit zu Ändern kann
|
|
|
+ sehen 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> <ulink
|
|
|
+ Millisekunden begrenzt, da <classname>Zend_Date</classname> <ulink
|
|
|
url="http://php.net/microtime">microtime()</ulink> dafür
|
|
|
benutzt.
|
|
|
</entry>
|
|
|
@@ -408,10 +408,10 @@ print $date;
|
|
|
|
|
|
<entry>
|
|
|
<constant>Zend_Date::DAY_SHORT</constant> wird von
|
|
|
- <varname>$date</varname> extrahiert wenn der
|
|
|
- <varname>$date</varname> Operand eine
|
|
|
- <classname>Zend_Date</classname> Instanz oder eine nummerische
|
|
|
- Zeichenkette ist. Sonst wird versucht den Tag laut den
|
|
|
+ <varname>$date</varname> extrahiert, wenn der
|
|
|
+ Operand <varname>$date</varname> eine
|
|
|
+ <classname>Zend_Date</classname>-Instanz oder eine numerische
|
|
|
+ Zeichenkette ist. Sonst wird versucht, den Tag gemäß den
|
|
|
dokumentierten Konventionen für diese Konstanten zu extrahieren:
|
|
|
<constant>Zend_Date::WEEKDAY_NARROW</constant>,
|
|
|
<constant>Zend_Date::WEEKDAY_NAME</constant>,
|
|
|
@@ -428,9 +428,9 @@ print $date;
|
|
|
|
|
|
<entry>
|
|
|
<constant>Zend_Date::WEEK</constant> wird von
|
|
|
- <varname>$date</varname> extrahiert wenn der
|
|
|
- <varname>$date</varname> Operand eine Instanz von
|
|
|
- <classname>Zend_Date</classname> oder eine nummerische Zeichenkette
|
|
|
+ <varname>$date</varname> extrahiert, wenn der
|
|
|
+ Operand <varname>$date</varname> eine Instanz von
|
|
|
+ <classname>Zend_Date</classname> oder eine numerische Zeichenkette
|
|
|
ist. Sonst wird eine Ausnahme geworfen. (Gregorianischer Kalender
|
|
|
angenommen)
|
|
|
</entry>
|
|
|
@@ -442,13 +442,13 @@ print $date;
|
|
|
<entry>
|
|
|
<constant>Zend_Date::DAY_MEDIUM</constant> wird aus
|
|
|
<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
|
|
|
- <constant>Zend_Date::DATE_MEDIUM</constant> formatiertes Datum zu
|
|
|
+ Operand <varname>$date</varname> eine Instanz von
|
|
|
+ <classname>Zend_Date</classname> ist. Sonst wird versucht, den
|
|
|
+ <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.
|
|
|
+ des Objekts ab.
|
|
|
</entry>
|
|
|
</row>
|
|
|
|
|
|
@@ -456,12 +456,12 @@ print $date;
|
|
|
<entry>Wochentage</entry>
|
|
|
|
|
|
<entry>
|
|
|
- Wochentage werden nummerisch dargestellt von 0 (für Sonntag) bis 6
|
|
|
+ Wochentage werden numerisch dargestellt von 0 (für Sonntag) bis 6
|
|
|
(für Samstag). <constant>Zend_Date::WEEKDAY_DIGIT</constant> wird
|
|
|
aus <varname>$date</varname> extrahiert wenn der
|
|
|
- <varname>$date</varname> Operand eine Instanz von
|
|
|
+ Operand <varname>$date</varname> eine Instanz von
|
|
|
<classname>Zend_Date</classname> oder eine numerische Zeichenkette
|
|
|
- ist. Sonst wird versucht den Tag laut den dokumentierten
|
|
|
+ ist. Sonst wird versucht, den Tag gemäß den dokumentierten
|
|
|
Konventionen für diese Konstanten zu extrahieren:
|
|
|
<constant>Zend_Date::WEEKDAY_NARROW</constant>,
|
|
|
<constant>Zend_Date::WEEKDAY_NAME</constant>,
|
|
|
@@ -476,9 +476,9 @@ print $date;
|
|
|
|
|
|
<entry>
|
|
|
In <classname>Zend_Date</classname> wird der Tag des Jahres als
|
|
|
- Anzahl der Kalendertage dargestellt die seit dem Start des Jahres
|
|
|
+ Anzahl der Kalendertage dargestellt, die seit dem Start des Jahres
|
|
|
vergangen sind (0-365). Wie bei den anderen oben dargestellten
|
|
|
- Einheiten werden Bruchteile auf die nächste ganze Nummer abgerundet.
|
|
|
+ Einheiten, werden Bruchteile auf die nächste ganze Zahl abgerundet.
|
|
|
(Gregorianischer Kalender angenommen)
|
|
|
</entry>
|
|
|
</row>
|
|
|
@@ -489,13 +489,13 @@ print $date;
|
|
|
</entry>
|
|
|
|
|
|
<entry>
|
|
|
- Arpa Daten (bzw <acronym>RFC</acronym> 822 formatierte Daten) werden
|
|
|
+ Arpa-Daten (bzw. <acronym>RFC</acronym> 822 formatierte Daten) werden
|
|
|
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
|
|
|
<constant>DATE_RFC822</constant> Konstante mit
|
|
|
- <acronym>PHP</acronym> date Funktionen hier und da
|
|
|
+ <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:
|
|
|
@@ -522,19 +522,19 @@ print $date;
|
|
|
<title>Liste der Datums-Operationen</title>
|
|
|
|
|
|
<para>
|
|
|
- Die unten angeführten Basisoperationen können statt den bequemlichen Operationen für
|
|
|
- spezielle Datumsabschnitte verwendet werden. Die <link
|
|
|
- linkend="zend.date.constants.list">entsprechenden Konstanten</link> werden für
|
|
|
- den <varname>$part</varname> Parameter verwendet.
|
|
|
+ Die unten aufgeführten Basisoperationen können statt den Komfortoperationen für
|
|
|
+ spezielle Datumsabschnitte verwendet werden, wenn die <link
|
|
|
+ linkend="zend.date.constants.list">entsprechenden Konstanten</link> für
|
|
|
+ den Parameter <varname>$part</varname> verwendet werden.
|
|
|
</para>
|
|
|
|
|
|
<table id="id.date.basic.operations.table">
|
|
|
- <title>Basis Operationen</title>
|
|
|
+ <title>Basisoperationen</title>
|
|
|
|
|
|
<tgroup cols="2">
|
|
|
<thead>
|
|
|
<row>
|
|
|
- <entry>Basis Operationen</entry>
|
|
|
+ <entry>Basisoperationen</entry>
|
|
|
<entry>Erklärung</entry>
|
|
|
</row>
|
|
|
</thead>
|
|
|
@@ -550,12 +550,12 @@ print $date;
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- <methodname>get($part)</methodname> kann benutzt werden um einen
|
|
|
- Datumsabschnitt <varname>$part</varname> dieses Datumsobjektes
|
|
|
+ <methodname>get($part)</methodname> kann benutzt werden, um einen
|
|
|
+ Datumsabschnitt <varname>$part</varname> dieses Datumsobjekts,
|
|
|
welcher in ein Gebietsschema von <varname>$locale</varname>
|
|
|
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
|
|
|
+ Erweiterung können numerische Zeichenketten statt Integer für
|
|
|
große Werte zurückgegeben werden.
|
|
|
</para>
|
|
|
|
|
|
@@ -564,9 +564,9 @@ print $date;
|
|
|
|
|
|
<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
|
|
|
+ get*()-Komfortmethoden 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>
|
|
|
@@ -584,7 +584,7 @@ print $date;
|
|
|
|
|
|
<para>
|
|
|
Setzt den Abschnitt <varname>$part</varname> des aktuellen
|
|
|
- Objektes übereinstimmend mit dem Wert der für diesen Abschnitt
|
|
|
+ Objekts übereinstimmend mit dem Wert, der für diesen Abschnitt
|
|
|
in der Eingabe <varname>$date</varname> und im Gebietsschema
|
|
|
<varname>$locale</varname> gefunden wurde.
|
|
|
</para>
|
|
|
@@ -602,9 +602,9 @@ print $date;
|
|
|
|
|
|
<para>
|
|
|
Addiert den Abschnitt <varname>$part</varname> von
|
|
|
- <varname>$date</varname> welcher im Gebietsschema
|
|
|
- <varname>$locale</varname> geschrieben ist zum Datum des
|
|
|
- aktuellen Objektes.
|
|
|
+ <varname>$date</varname>, welcher im Gebietsschema
|
|
|
+ <varname>$locale</varname> geschrieben ist, zum Datum des
|
|
|
+ aktuellen Objekts.
|
|
|
</para>
|
|
|
</entry>
|
|
|
</row>
|
|
|
@@ -620,9 +620,9 @@ print $date;
|
|
|
|
|
|
<para>
|
|
|
Subtrahiert den Abschnitt <varname>$part</varname> von
|
|
|
- <varname>$date</varname> welcher im Gebietsschema
|
|
|
- <varname>$locale</varname> geschrieben ist vom Datum des
|
|
|
- aktuellen Objektes.
|
|
|
+ <varname>$date</varname>, welcher im Gebietsschema
|
|
|
+ <varname>$locale</varname> geschrieben ist, vom Datum des
|
|
|
+ aktuellen Objekts.
|
|
|
</para>
|
|
|
</entry>
|
|
|
</row>
|
|
|
@@ -638,8 +638,8 @@ print $date;
|
|
|
|
|
|
<para>
|
|
|
Gibt ein geklontes Objekt zurück, wobei nur der gewünschte
|
|
|
- Abschnitt <varname>$part</varname> des Datumsobjektes kopiert
|
|
|
- wird, wobei im Klon das Gebietsschema von
|
|
|
+ Abschnitt <varname>$part</varname> des Datumsobjekts kopiert
|
|
|
+ wird und im Klon das Gebietsschema von
|
|
|
<varname>$locale</varname> gesetzt wird (wenn angegeben).
|
|
|
</para>
|
|
|
</entry>
|
|
|
@@ -656,9 +656,9 @@ print $date;
|
|
|
|
|
|
<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 der Abschnitt dieses
|
|
|
- Objektes früher war als der Abschnitt von
|
|
|
+ <varname>$date</varname> mit dem Zeitstempel des Objekts. Gibt 0
|
|
|
+ zurück, wenn sie gleich sind, 1 wenn der Abschnitt dieses
|
|
|
+ Objekts früher war als der Abschnitt von
|
|
|
<varname>$date</varname> und andernfalls -1.
|
|
|
</para>
|
|
|
</entry>
|
|
|
@@ -700,10 +700,10 @@ print $date;
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- Gibt <constant>TRUE</constant> zurück wenn der Abschnitt
|
|
|
+ Gibt <constant>TRUE</constant> zurück, wenn der Abschnitt
|
|
|
<varname>$part</varname> von <varname>$date</varname> der das
|
|
|
Gebietsschema <varname>$locale</varname> hat, der gleiche ist wie
|
|
|
- der Abschnitt <varname>$part</varname> vom Datum des Objektes,
|
|
|
+ der Abschnitt <varname>$part</varname> vom Datum des Objekts,
|
|
|
andernfalls <constant>FALSE</constant>
|
|
|
</para>
|
|
|
</entry>
|
|
|
@@ -719,8 +719,8 @@ print $date;
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- Gibt <constant>TRUE</constant> zurück wenn der Abschnitt
|
|
|
- <varname>$part</varname> vom Datum des Objektes früher ist als der
|
|
|
+ Gibt <constant>TRUE</constant> zurück, wenn der Abschnitt
|
|
|
+ <varname>$part</varname> vom Datum des Objekts früher ist als der
|
|
|
Abschnitt <varname>$part</varname> von <varname>$date</varname> der
|
|
|
das Gebietsschema <varname>$locale</varname> hat
|
|
|
</para>
|
|
|
@@ -737,8 +737,8 @@ print $date;
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- Gibt <constant>TRUE</constant> zurück wenn der Abschnitt
|
|
|
- <varname>$part</varname> vom Datum des Objektes später ist als der
|
|
|
+ Gibt <constant>TRUE</constant> zurück, wenn der Abschnitt
|
|
|
+ <varname>$part</varname> vom Datum des Objekts später ist als der
|
|
|
Abschnitt <varname>$part</varname> von <varname>$date</varname> der
|
|
|
das Gebietsschema <varname>$locale</varname> hat
|
|
|
</para>
|
|
|
@@ -755,7 +755,7 @@ print $date;
|
|
|
|
|
|
<para>
|
|
|
Testet ob Jahr, Monat und Tag des heutigen Datums mit dem Datumswert
|
|
|
- des Objektes übereinstimmen, wenn die Zeitzone des Objektes
|
|
|
+ des Objekts übereinstimmen, wenn die Zeitzone des Objekts
|
|
|
verwendet wird.
|
|
|
</para>
|
|
|
</entry>
|
|
|
@@ -771,7 +771,7 @@ print $date;
|
|
|
|
|
|
<para>
|
|
|
Testet ob Jahr, Monat und Tag des morgigen Datums mit dem Datumswert
|
|
|
- des Objektes übereinstimmen, wenn die Zeitzone des Objektes
|
|
|
+ des Objekts übereinstimmen, wenn die Zeitzone des Objekts
|
|
|
verwendet wird.
|
|
|
</para>
|
|
|
</entry>
|
|
|
@@ -787,8 +787,8 @@ print $date;
|
|
|
|
|
|
<para>
|
|
|
Testet ob Jahr, Monat und Tag des gestrigen Datums mit dem
|
|
|
- Datumswert des Objektes übereinstimmen, wenn die Zeitzone des
|
|
|
- Objektes verwendet wird.
|
|
|
+ Datumswert des Objekts übereinstimmen, wenn die Zeitzone des
|
|
|
+ Objekts verwendet wird.
|
|
|
</para>
|
|
|
</entry>
|
|
|
</row>
|
|
|
@@ -802,13 +802,13 @@ print $date;
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- <methodname>isLeapYear()</methodname> kann benutzt werden ob zu
|
|
|
- prüfen ob das aktuelle Objekt ein Schaltjahr ist. Sonst kann
|
|
|
+ <methodname>isLeapYear()</methodname> kann benutzt werden, um zu
|
|
|
+ prüfen, ob das aktuelle Objekt ein Schaltjahr ist. Sonst kann
|
|
|
<methodname>Zend_Date::checkLeapYear($year)</methodname> benutzt
|
|
|
- werden um das Jahr <varname>$year</varname> zu prüfen, welches eine
|
|
|
+ werden, um das Jahr <varname>$year</varname> zu prüfen, welches eine
|
|
|
Zeichenkette, ein Integer oder eine Instanz von
|
|
|
<classname>Zend_Date</classname> sein kann. Ist das Jahr ein
|
|
|
- Schaltjahr ?
|
|
|
+ Schaltjahr?
|
|
|
</para>
|
|
|
</entry>
|
|
|
</row>
|
|
|
@@ -823,11 +823,11 @@ print $date;
|
|
|
</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
|
|
|
- <methodname>checkdate()</methodname> Funktion, kann aber auch
|
|
|
- lokalisierte Monatsnamen prüfen sowie Daten die den Bereich von
|
|
|
+ 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 die <acronym>PHP</acronym>-Funktion
|
|
|
+ <methodname>checkdate()</methodname>, kann aber auch
|
|
|
+ lokalisierte Monatsnamen prüfen sowie Daten, die den Bereich von
|
|
|
<methodname>checkdate()</methodname> übersteigen
|
|
|
</para>
|
|
|
</entry>
|
|
|
@@ -838,11 +838,11 @@ print $date;
|
|
|
</sect2>
|
|
|
|
|
|
<sect2 id="zend.date.others.gettingparts">
|
|
|
- <title>Daten und Teile von Daten erhalten</title>
|
|
|
+ <title>Daten und Teile von Daten abfragen</title>
|
|
|
|
|
|
<para>
|
|
|
- Verschiedene Methoden unterstützen das erhalten von Werten die auf eine
|
|
|
- <classname>Zend_Date</classname> Instanz bezug nehmen.
|
|
|
+ Mehrere Methoden erlauben es, Werte abzurufen, die sich auf eine
|
|
|
+ <classname>Zend_Date</classname>-Instanz beziehen.
|
|
|
</para>
|
|
|
|
|
|
<table id="zend.date.others.gettingparts.table">
|
|
|
@@ -869,9 +869,9 @@ print $date;
|
|
|
<para>
|
|
|
Direkt aufzurufen oder über die magische Methode
|
|
|
<methodname>__toString()</methodname>. Die
|
|
|
- <methodname>toString()</methodname> Methode formatiert automatisch
|
|
|
- den Wert des Datumsobjektes anhand der Konventionen des
|
|
|
- Gebietsschemas des Objektes, oder einem optional definierten
|
|
|
+ Methode <methodname>toString()</methodname> formatiert automatisch
|
|
|
+ den Wert des Datumsobjekts anhand der Konventionen des
|
|
|
+ Gebietsschemas des Objekts oder einem optional definierten
|
|
|
Gebietsschema <varname>$locale</varname>. Für eine Liste von
|
|
|
unterstützten Formatcodes kann hier nachgeschaut werden:
|
|
|
<link linkend="zend.date.constants.selfdefinedformats">selbst
|
|
|
@@ -889,10 +889,10 @@ print $date;
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- Gibt eine Array Representation des ausgewählten Datums anhand der
|
|
|
+ Gibt eine Array-Representation des ausgewählten Datums anhand der
|
|
|
Konventionen des Gebietsschemas zurück. Das zurückgegebene Array ist
|
|
|
- identisch zu <acronym>PHP</acronym>'s <ulink
|
|
|
- url="http://php.net/getdate">getdate()</ulink> Funktion und
|
|
|
+ identisch zur <acronym>PHP</acronym>-Funktion <ulink
|
|
|
+ url="http://php.net/getdate">getdate()</ulink> und
|
|
|
beinhaltet:
|
|
|
</para>
|
|
|
|
|
|
@@ -948,7 +948,7 @@ print $date;
|
|
|
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- Unix Zeitpunkt als '<emphasis>timestamp</emphasis>'
|
|
|
+ Unix Zeitstempel als '<emphasis>timestamp</emphasis>'
|
|
|
(<constant>Zend_Date::TIMESTAMP</constant>)
|
|
|
</para>
|
|
|
</listitem>
|
|
|
@@ -994,9 +994,9 @@ print $date;
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- Gibt eine Integer Repräsentation des ausgewählten Datumsabschnittes
|
|
|
- <varname>$part</varname> zurück anhand der Konventionen des
|
|
|
- Gebietsschemas des Objektes. Gibt <constant>FALSE</constant> zurück
|
|
|
+ Gibt eine Integer-Repräsentation des ausgewählten Datumsabschnittes
|
|
|
+ <varname>$part</varname> anhand der Konventionen des
|
|
|
+ Gebietsschemas des Objekts zurück. 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>.
|
|
|
</para>
|
|
|
@@ -1007,11 +1007,11 @@ print $date;
|
|
|
<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
|
|
|
+ auf und castet das Ergebnis in 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.
|
|
|
+ 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>
|
|
|
@@ -1032,7 +1032,7 @@ print $date;
|
|
|
|
|
|
<para>
|
|
|
Diese Methode gibt den Abschnitt <varname>$part</varname> vom Datum
|
|
|
- des Objektes, welches mit dem Gebietsschema
|
|
|
+ des Objekts, welches mit dem Gebietsschema
|
|
|
<varname>$locale</varname> lokalisiert wurde, als formatierten
|
|
|
String oder Integer zurück. Für weitere Informationen hier
|
|
|
weiterlesen: <link linkend="id.date.basic.operations">get()</link>.
|
|
|
@@ -1049,7 +1049,7 @@ print $date;
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- Diese bequemliche Funktion ist identisch mit
|
|
|
+ Diese Komfortfunktion ist identisch mit
|
|
|
<command>new Zend_Date()</command>. Sie gibt das aktuelle Datum als
|
|
|
<classname>Zend_Date</classname> Objekt zurück, welches das
|
|
|
Gebietsschema <varname>$locale</varname> hat.
|
|
|
@@ -1109,7 +1109,7 @@ print $date;
|
|
|
<title>Sonnenaufgang / Sonnenuntergang</title>
|
|
|
|
|
|
<para>
|
|
|
- Drei Methoden geben Zugriff auf geographisch lokalisierte Informationen über die Sonne
|
|
|
+ Drei Methoden geben Zugriff auf geographisch lokalisierte Informationen über die Sonne,
|
|
|
was die Zeit für Sonnenaufgang und Sonnenuntergang beinhaltet.
|
|
|
</para>
|
|
|
|