|
|
@@ -1,34 +1,34 @@
|
|
|
<?xml version="1.0" encoding="UTF-8"?>
|
|
|
<!-- EN-Revision: 21215 -->
|
|
|
-<!-- Reviewed: no -->
|
|
|
+<!-- Reviewed: 21215 -->
|
|
|
<sect1 id="zend.date.constants">
|
|
|
- <title>Konstanten für generelle Datums Funktionen</title>
|
|
|
+ <title>Konstanten für allgemeine Datumsfunktionen</title>
|
|
|
|
|
|
<para>
|
|
|
- Wo auch immer eine <classname>Zend_Date</classname> Methode einen <varname>$parts</varname>
|
|
|
- Parameter besitzt, kann eine der nachfolgenden Konstanten als Argument für diesen Parameter
|
|
|
- benutzt werden, um einen speziellen Teil des Datums auszuwählen, oder um anzuzeigen das ein
|
|
|
- bestimmtes Datumsformat benutzt werden oder gewünscht ist (z.B. <acronym>RFC</acronym> 822).
|
|
|
+ Überall dort, wo eine <classname>Zend_Date</classname>-Methode einen Parameter <varname>$parts</varname>
|
|
|
+ aufweist, kann eine der nachfolgenden Konstanten als Argument für diesen Parameter
|
|
|
+ benutzt werden, um einen speziellen Teil des Datums auszuwählen, oder um anzuzeigen, dass ein
|
|
|
+ bestimmtes Datumsformat benutzt werden soll oder gewünscht ist (z.B. <acronym>RFC</acronym> 822).
|
|
|
</para>
|
|
|
|
|
|
<sect2 id="zend.date.constants.using">
|
|
|
<title>Konstanten benutzen</title>
|
|
|
|
|
|
<para>
|
|
|
- Zum Beispiel kann die Konstante <constant>Zend_Date::HOUR</constant> in den anbei
|
|
|
+ Zum Beispiel kann die Konstante <constant>Zend_Date::HOUR</constant> in den unten
|
|
|
gezeigten Arten benutzt werden. Wenn mit Wochentagen, Kalendardaten, Stunden, Minuten,
|
|
|
- Sekunden oder jedem anderen Datumsabschnitt gearbeitet wird die in verschiedenen Teilen
|
|
|
+ Sekunden oder jedem anderen Datumsabschnitt gearbeitet wird, die in verschiedenen Teilen
|
|
|
der Welt unterschiedlich dargestellt werden, wird die Zeitzone des Objektes automatisch
|
|
|
- benutzt um den richtigen Wert zu berechnen selbst wenn der interne Zeitpunkt der gleiche
|
|
|
- ist für den gleichen Moment der Zeit, unabhängig davon wo auf der Welt sich der Benutzer
|
|
|
- befindet. Unabhängig von der Einheit die involviert ist muß die Ausgabe entweder als
|
|
|
+ benutzt, um den richtigen Wert zu berechnen, selbst wenn der interne Zeitpunkt der gleiche
|
|
|
+ ist für den gleichen Moment der Zeit, unabhängig davon, wo auf der Welt sich der Benutzer
|
|
|
+ befindet. Unabhängig von den verwendeten Einheiten muß die Ausgabe entweder als
|
|
|
<acronym>GMT</acronym> oder <acronym>UTC</acronym> ausgedrückt werden oder lokalisiert
|
|
|
anhand des Gebietsschemas. Die unten angeführte Beispielausgabe zeigt eine Lokalisierung
|
|
|
mit Europe/GMT+1 Stunden (z.B. Österreich, Deutschland, Frankreich).
|
|
|
</para>
|
|
|
|
|
|
<table id="zend.date.constants.using.table">
|
|
|
- <title>Berechnungen die Zend_Date::HOUR beinhalten</title>
|
|
|
+ <title>Berechnungen, die Zend_Date::HOUR beinhalten</title>
|
|
|
|
|
|
<tgroup cols="4">
|
|
|
<thead>
|
|
|
@@ -544,7 +544,7 @@
|
|
|
<entry><constant>Zend_Date::DAYLIGHT</constant></entry>
|
|
|
|
|
|
<entry>
|
|
|
- Sommerzeit oder Winterzeit ? (<constant>TRUE</constant> oder
|
|
|
+ Sommerzeit oder Winterzeit? (<constant>TRUE</constant> oder
|
|
|
<constant>FALSE</constant>)
|
|
|
</entry>
|
|
|
|
|
|
@@ -672,12 +672,12 @@
|
|
|
</table>
|
|
|
|
|
|
<para>
|
|
|
- Auf <constant>Zend_Date::DATES</constant> sollte speziell geachtet werden, da dieser
|
|
|
- Formatbezeichner eine besondere Bedeutung innerhalb von <classname>Zend_Date</classname>
|
|
|
- als <emphasis>Eingabe</emphasis>-Formatbezeichner. Wenn dieser Bezeichner als
|
|
|
+ Beachten Sie vor allem <constant>Zend_Date::DATES</constant>, da dieser Formatbezeichner
|
|
|
+ eine besondere Eigenschaft als <emphasis>Eingabe</emphasis>-Formatbezeichner
|
|
|
+ von <classname>Zend_Date</classname> hat. Wenn dieser Bezeichner als
|
|
|
Eingabeformat für <varname>$part</varname> benutzt wird, erlaubt diese Konstante die
|
|
|
- beste und flexibelste Art um viele ähnliche Datumsformate zu akzeptieren. Heuristik
|
|
|
- wird benutzt um Daten automatisch von einer Eingabe-Zeichenkette zu extrahieren und
|
|
|
+ beste und flexibelste Art, um viele ähnliche Datumsformate zu akzeptieren. Heuristik
|
|
|
+ wird benutzt, um Daten automatisch von einer Eingabe-Zeichenkette zu extrahieren und
|
|
|
dann einfache Fehler zu "beheben" (wenn vorhanden), wie zum Beispiel Jahre, Monate und
|
|
|
Tage wenn möglich.
|
|
|
</para>
|
|
|
@@ -831,33 +831,33 @@
|
|
|
</sect2>
|
|
|
|
|
|
<sect2 id="zend.date.constants.selfdefinedformats">
|
|
|
- <title>Selbst-Definierte AUSGABE Formate mit ISO</title>
|
|
|
+ <title>Selbst-definierte AUSGABE-Formate mit ISO</title>
|
|
|
|
|
|
<para>
|
|
|
- Wenn ein Datumsformat benötigt wird, das oben nicht angeführt ist, kann auch ein
|
|
|
- selbst-definiertes Format erstellt werden, mit Hilfe der unten engeführten
|
|
|
- <acronym>ISO</acronym> Formatsbezeichner. Die folgenden Beispiele zeigen die Verwendung
|
|
|
- der Konstanten dieser Tabelle um selbst-definierte <acronym>ISO</acronym> Formate zu
|
|
|
- erstellen. Die Länge des Formats ist unlimitiert. Auch die mehrfache Verwendung von
|
|
|
- Format Konstanten ist gestattet.
|
|
|
+ Wenn ein Datumsformat benötigt wird, das oben nicht angeführt ist, kann
|
|
|
+ mit Hilfe der unten aufgeführten <acronym>ISO</acronym>-Formatsbezeichner auch ein
|
|
|
+ selbst-definiertes Format erstellt werden. Die folgenden Beispiele zeigen die Verwendung
|
|
|
+ der Konstanten dieser Tabelle, um selbst-definierte <acronym>ISO</acronym>-Formate zu
|
|
|
+ erstellen. Die Länge des Formats ist nicht limitiert. Auch die mehrfache Verwendung von
|
|
|
+ Format-Konstanten ist gestattet.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- Die akzeptierten Formatbezeichner können vom <acronym>ISO</acronym> Format zu
|
|
|
- <acronym>PHP</acronym>'s date Format geändert werden, wenn man damit mehr Erfahrung hat.
|
|
|
- Wie auch immer, nicht alle Format welche in der <acronym>ISO</acronym> Norm definiert
|
|
|
- sind, werden durch <acronym>PHP</acronym>'s date Formatbezeichner unterstützt. Die
|
|
|
+ Die akzeptierten Formatbezeichner können vom <acronym>ISO</acronym>-Format zu
|
|
|
+ date-Format von <acronym>PHP</acronym> geändert werden, wenn man damit mehr Erfahrung hat.
|
|
|
+ Wie auch immer, nicht alle Formate, welche in der <acronym>ISO</acronym>-Norm definiert
|
|
|
+ sind, werden durch <acronym>PHP</acronym>s date-Formatbezeichner unterstützt. Die
|
|
|
Verwendung der
|
|
|
- <methodname>Zend_Date::setOptions(array('format_type' => 'php'))</methodname> Methode
|
|
|
- erlaubt es, für alle <classname>Zend_Date</classname> Methoden, zwischen der
|
|
|
- Unterstützung von <acronym>ISO</acronym> Formatbezeichnern und <acronym>PHP</acronym>
|
|
|
+ Methode <methodname>Zend_Date::setOptions(array('format_type' => 'php'))</methodname>
|
|
|
+ erlaubt es, für alle <classname>Zend_Date</classname>-Methoden, zwischen der
|
|
|
+ Unterstützung von <acronym>ISO</acronym>-Formatbezeichnern und <acronym>PHP</acronym>
|
|
|
<methodname>date()</methodname> Typbezeichner zu wählen (siehe <link
|
|
|
- linkend="zend.date.constants.phpformats">selbst definierte AUSGABE Formate bei
|
|
|
- Verwendung von PHP's date() Formatzeichen</link>).
|
|
|
+ linkend="zend.date.constants.phpformats">selbst definierte AUSGABE-Formate bei
|
|
|
+ Verwendung von PHPs date()-Formatzeichen</link>).
|
|
|
</para>
|
|
|
|
|
|
<example id="zend.date.constants.selfdefinedformats.example-1">
|
|
|
- <title>Selbstdefinition von ISO Formaten</title>
|
|
|
+ <title>Selbstdefinition von ISO-Formaten</title>
|
|
|
|
|
|
<programlisting language="php"><![CDATA[
|
|
|
$locale = new Zend_Locale('de_AT');
|
|
|
@@ -867,7 +867,7 @@ print $date->toString("'Epoche:GGGG='GGGG, ' Datum:yy.MMMM.dd'yy.MMMM.dd");
|
|
|
</example>
|
|
|
|
|
|
<table id="zend.date.constants.selfdefinedformats.table">
|
|
|
- <title>Konstanten für ISO 8601 Datums Ausgaben</title>
|
|
|
+ <title>Konstanten für ISO 8601 Datumsausgaben</title>
|
|
|
|
|
|
<tgroup cols="4">
|
|
|
<thead>
|
|
|
@@ -1241,7 +1241,7 @@ print $date->toString("'Epoche:GGGG='GGGG, ' Datum:yy.MMMM.dd'yy.MMMM.dd");
|
|
|
|
|
|
<row>
|
|
|
<entry>ZZ</entry>
|
|
|
- <entry>Different der Zeitzone</entry>
|
|
|
+ <entry>Differenz der Zeitzone</entry>
|
|
|
<entry><constant>Zend_Date::GMT_DIFF</constant></entry>
|
|
|
<entry><emphasis>+0100</emphasis></entry>
|
|
|
</row>
|
|
|
@@ -1272,8 +1272,8 @@ print $date->toString("'Epoche:GGGG='GGGG, ' Datum:yy.MMMM.dd'yy.MMMM.dd");
|
|
|
|
|
|
<note>
|
|
|
<para>
|
|
|
- Es muß beachtet werden das sich das Standard <acronym>ISO</acronym> Format vom
|
|
|
- <acronym>PHP</acronym> Format unterscheidet was irritierend sein kann wenn man es
|
|
|
+ Es muß beachtet werden, dass sich das Standard-<acronym>ISO</acronym>-Format vom
|
|
|
+ <acronym>PHP</acronym>-Format unterscheidet, was irritierend sein kann, wenn man es
|
|
|
vorher noch nie verwendet hat. Speziell die Formatbezeichner für
|
|
|
<emphasis>Jahr und Minute</emphasis> werden oft nicht auf die
|
|
|
erwartete Art und Weise verwendet.
|
|
|
@@ -1282,22 +1282,22 @@ print $date->toString("'Epoche:GGGG='GGGG, ' Datum:yy.MMMM.dd'yy.MMMM.dd");
|
|
|
<para>
|
|
|
Für das <emphasis>Jahr</emphasis> gibt es zwei vorhandene Bezeichner
|
|
|
die oft vertauscht werden. Der <emphasis>Y</emphasis> Bezeichner für
|
|
|
- das <acronym>ISO</acronym> Jahr und den <emphasis>y</emphasis> Bezeichner für das
|
|
|
+ das <acronym>ISO</acronym>-Jahr und den <emphasis>y</emphasis> Bezeichner für das
|
|
|
wirkliche Jahr. Der Unterschied ist klein aber signifikant.
|
|
|
- <emphasis>Y</emphasis> kalkuliert das <acronym>ISO</acronym> Jahr, welches oft für
|
|
|
- Kalender Formate verwendet wird. Zum Beispiel der 31. Dezember 2007. Das wirkliche
|
|
|
+ <emphasis>Y</emphasis> berechnet das <acronym>ISO</acronym>-Jahr, welches oft für
|
|
|
+ Kalender-Formate verwendet wird. Zum Beispiel der 31. Dezember 2007. Das wirkliche
|
|
|
Jahr ist 2007, aber es ist der erste Tag der ersten Woche, der Woche 1, des Jahres
|
|
|
2008. Deswegen erhält man, wenn man '<command>dd.MM.yyyy</command>' verwendet den
|
|
|
'<command>31.Dezember.2007</command>', aber wenn man '<command>dd.MM.YYYY</command>'
|
|
|
- verwendet den '<command>31.Dezember.2008</command>'. Wie man sieht ist das kein
|
|
|
- Fehler sondern ein erwartetes Verhalten basierend auf den verwendeten Bezeichnern.
|
|
|
+ verwendet den '<command>31.Dezember.2008</command>'. Wie man sieht, ist das kein
|
|
|
+ Fehler, sondern ein erwartetes Verhalten basierend auf den verwendeten Bezeichnern.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- Für die <emphasis>Minute</emphasis> ist der 'Unterschied nicht so
|
|
|
+ Für die <emphasis>Minute</emphasis> ist der Unterschied nicht so
|
|
|
groß. <acronym>ISO</acronym> verwendet den Bezeichner <emphasis>m</emphasis> für die
|
|
|
- Minute, anders als <acronym>PHP</acronym> welches <emphasis>i</emphasis> verwendet.
|
|
|
- Wenn man also keine Minute erhält dann sollte man sein Format darauf prüfen, ob
|
|
|
+ Minute, anders als <acronym>PHP</acronym>, welches <emphasis>i</emphasis> verwendet.
|
|
|
+ Wenn man also keine Minute erhält, dann sollte man sein Format darauf prüfen, ob
|
|
|
der richtige Bezeichner verwendet wurde.
|
|
|
</para>
|
|
|
</note>
|
|
|
@@ -1305,23 +1305,23 @@ print $date->toString("'Epoche:GGGG='GGGG, ' Datum:yy.MMMM.dd'yy.MMMM.dd");
|
|
|
|
|
|
<sect2 id="zend.date.constants.phpformats">
|
|
|
<title>
|
|
|
- Selbst-definierte AUSGABE Formate welche PHP's date() Formatdefinition verwenden
|
|
|
+ Selbst-definierte AUSGABE-Formate, welche die PHP-date()-Formatdefinition verwenden
|
|
|
</title>
|
|
|
|
|
|
<para>
|
|
|
- Wenn man mit <acronym>PHP</acronym>'s date Formatdefinition vertrauter ist als mit den
|
|
|
- <acronym>ISO</acronym> Formatdefinitionen, dann kann man durch Verwendung der Methode
|
|
|
- <methodname>Zend_Date::setOptions(array('format_type' => 'php'))</methodname> das
|
|
|
- Wechseln von <acronym>ISO</acronym> Formatdefinition zu <acronym>PHP</acronym>
|
|
|
- <methodname>date()</methodname> Formatdefinition welche dann für alle
|
|
|
- <classname>Zend_Date</classname> Methoden verwendet werden wechseln. Danach müssen alle
|
|
|
- Format Parameter in <ulink url="http://php.net/date">PHP's
|
|
|
- <methodname>date()</methodname> Formatdefintion</ulink> angegeben werden. Das
|
|
|
- <acronym>PHP</acronym> date Format vermisst einige der Formate welche durch
|
|
|
+ Wenn man mit der <acronym>PHP</acronym>-date-Formatdefinition vertrauter ist als mit den
|
|
|
+ <acronym>ISO</acronym>-Formatdefinitionen, dann kann man durch Verwendung der Methode
|
|
|
+ <methodname>Zend_Date::setOptions(array('format_type' => 'php'))</methodname>
|
|
|
+ von der <acronym>ISO</acronym>-Formatdefinition zur <acronym>PHP</acronym>
|
|
|
+ <methodname>date()</methodname>-Formatdefinition wechseln, welche dann für alle
|
|
|
+ <classname>Zend_Date</classname>-Methoden verwendet werden. Danach müssen alle
|
|
|
+ Format-Parameter in <ulink url="http://php.net/date">PHPs
|
|
|
+ <methodname>date()</methodname>-Formatdefintion</ulink> angegeben werden. Dem
|
|
|
+ <acronym>PHP</acronym>-date-Format fehlen einige der Formate, welche durch
|
|
|
<acronym>ISO</acronym> unterstützt werden und umgekehrt. Wenn keine Erfahrung damit
|
|
|
- besteht sollte auf alle Fälle das <acronym>ISO</acronym> Format genommen werden. Und
|
|
|
- wenn Altlast-Code vorhanden ist der <acronym>PHP</acronym>'s date Format verwendet, kann
|
|
|
- dieser entweder manuell in das <acronym>ISO</acronym> Format konvertiert werden indem
|
|
|
+ besteht, sollte auf alle Fälle das <acronym>ISO</acronym>-Format genommen werden. Und
|
|
|
+ wenn Altlast-Code vorhanden ist, der das <acronym>PHP</acronym>-date-Format verwendet, kann
|
|
|
+ dieser entweder manuell in das <acronym>ISO</acronym>-Format konvertiert werden, indem
|
|
|
<link
|
|
|
linkend="zend.locale.date.normalize">Zend_Locale_Format::convertPhpToIsoFormat()</link>
|
|
|
verwendet wird, oder durch Verwendung von <methodname>setOptions()</methodname>. Die
|
|
|
@@ -1330,7 +1330,7 @@ print $date->toString("'Epoche:GGGG='GGGG, ' Datum:yy.MMMM.dd'yy.MMMM.dd");
|
|
|
</para>
|
|
|
|
|
|
<example id="zend.date.constants.phpformats.example-1">
|
|
|
- <title>Selbstdefinierte Formate mit PHP Bezeichnern</title>
|
|
|
+ <title>Selbstdefinierte Formate mit PHP-Bezeichnern</title>
|
|
|
|
|
|
<programlisting language="php"><![CDATA[
|
|
|
$locale = new Zend_Locale('de_AT');
|
|
|
@@ -1345,33 +1345,33 @@ print $date->toString("'Format:D M j G:i:s T Y='D M j G:i:s T Y");
|
|
|
</example>
|
|
|
|
|
|
<important>
|
|
|
- <title>PHP Datums Format und die Verwendung von Konstanten</title>
|
|
|
+ <title>PHP-Datumsformat und die Verwendung von Konstanten</title>
|
|
|
|
|
|
<para>
|
|
|
- Es ist wichtig anzumerken das die Konstanten von <classname>Zend_Date</classname>
|
|
|
- die <acronym>ISO</acronym> Schreibweise verwenden. Das bedeutet, wenn man für
|
|
|
- <classname>Zend_Date</classname> setzt dass es die <acronym>PHP</acronym>
|
|
|
- Schreibweise verwenden soll, dann sollte man die Konstanten von
|
|
|
- <classname>Zend_Date</classname> nicht verwenden, sondern das gewünschte
|
|
|
+ Es ist wichtig anzumerken, dass die Konstanten von <classname>Zend_Date</classname>
|
|
|
+ die <acronym>ISO</acronym>-Schreibweise verwenden. Das bedeutet, wenn man für
|
|
|
+ <classname>Zend_Date</classname> setzt, dass es die
|
|
|
+ <acronym>PHP</acronym>-Schreibweise verwenden soll, dann sollte man die Konstanten
|
|
|
+ von <classname>Zend_Date</classname> nicht verwenden, sondern das gewünschte
|
|
|
Format manuell selbst definieren. Wenn man dieser Empfehlung nicht folgt, kann das
|
|
|
zu unerwarteten Ergebnissen führen.
|
|
|
</para>
|
|
|
</important>
|
|
|
|
|
|
<para>
|
|
|
- Die folgende Tabelle zeigt die Liste der <acronym>PHP</acronym> date Formatdefinitionen
|
|
|
- mit Ihrem Äquivalent in <classname>Zend_Date</classname> Konstanten und der im
|
|
|
+ Die folgende Tabelle zeigt die Liste der <acronym>PHP</acronym>-date-Formatdefinitionen
|
|
|
+ mit ihrem Äquivalent in <classname>Zend_Date</classname>-Konstanten und der im
|
|
|
<acronym>CLDR</acronym> und <acronym>ISO</acronym> äquivalenten Formatdefintion. In den
|
|
|
- meisten Fällen wenn das <acronym>CLDR</acronym> und <acronym>ISO</acronym> Format keine
|
|
|
- entsprechende Formardefinition enthält, wird die <acronym>PHP</acronym> Formatdefinition
|
|
|
+ meisten Fällen, wenn das <acronym>CLDR</acronym> und <acronym>ISO</acronym>-Format keine
|
|
|
+ entsprechende Formardefinition enthält, wird die <acronym>PHP</acronym>-Formatdefinition
|
|
|
nicht durch <methodname>Zend_Locale_Format::convertPhpToIsoFormat()</methodname>
|
|
|
geändert, und die <classname>Zend_Date</classname> Methoden erkennen dann diese
|
|
|
- "besonderen" <acronym>PHP</acronym> Formatdefinitionen, selbst im Standardmäßigen
|
|
|
- "<acronym>ISO</acronym>" Formatcode.
|
|
|
+ "besonderen" <acronym>PHP</acronym>-Formatdefinitionen, selbst im standardmäßigen
|
|
|
+ "<acronym>ISO</acronym>"-Formatcode.
|
|
|
</para>
|
|
|
|
|
|
<table id="zend.date.constants.phpformats.table">
|
|
|
- <title>Konstanten für PHP date Ausgaben</title>
|
|
|
+ <title>Konstanten für PHP-date-Ausgaben</title>
|
|
|
|
|
|
<tgroup cols="5">
|
|
|
<thead>
|