Zend Framework 1.9.9 Manual

Zum Beispiel kann die Konstante Zend_Date::HOUR in den anbei gezeigten Arten benutzt werden. Wenn mit Wochentagen, Kalendardaten, Stunden, Minuten, 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 GMT/UTC 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).

Jeder Teil von Datum/Zeit hat eine eindeutige Konstante in Zend_Date. Alle durch Zend_Date unterstützten Konstanten sind anbei aufgelistet.

Auf Zend_Date::DATES sollte speziell geachtet werden, da dieser Formatbezeichner eine besondere Bedeutung innerhalb von Zend_Date als Eingabe-Formatbezeichner. Wenn dieser Bezeichner als Eingabeformat für $part 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 dann einfache Fehler zu "beheben" (wenn vorhanden), wie zum Beispiel Jahre, Monate und Tage wenn möglich.

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 ISO Formatsbezeichner. Die folgenden Beispiele zeigen die Verwendung der Konstanten dieser Tabelle um selbst-definierte ISO Formate zu erstelen. Die Länge des Formats ist unlimitiert. Auch die mehrfache Verwendung von Format Konstanten ist gestattet.

Die akzeptierten Formatbezeichner können vom ISO Format zu PHP's date Format geändert werden, wenn man damit mehr Erfahrung hat. Wie auch immer, nicht alle Format welche in der ISO Norm definiert sind, werden durch PHP's date Formatbezeichner unterstützt. Die Verwendung der Zend_Date::setOptions(array('format_type' => 'php')) Methode erlaubt es, für alle Zend_Date Methoden, zwischen der Unterstützung von ISO Formatbezeichnern und PHP date() Typbezeichner zu wählen (siehe Selbst-definierte AUSGABE Formate welche PHP's date() Formatdefinition verwenden).

$locale = new Zend_Locale('de_AT');
$date = new Zend_Date(1234567890, false, $locale);
print $date->toString("'Epoche:GGGG='GGGG, ' Datum:yy.MMMM.dd'yy.MMMM.dd");

Note:

Es muß beachtet werden das sich das Standard ISO Format vom PHP Format unterscheidet was irritierend sein kann wenn man es vorher noch nie verwendet hat. Speziell die Formatbezeichner für Jahr und Minute werden oft nicht auf die erwartete Art und Weise verwendet.

Für das Jahr gibt es zwei vorhandene Bezeichner die oft vertauscht werden. Der Y Bezeichner für das ISO Jahr und den y Bezeichner für das wirkliche Jahr. Der Unterschied ist klein aber signifikant. Y kalkuliert das ISO 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 'dd.MM.yyyy' verwendet den '31.Dezember.2007', aber wenn man 'dd.MM.YYYY' verwendet den '31.Dezember.2008'. Wie man sieht ist das kein Fehler sondern ein erwartetes Verhalten basierend auf den verwendeten Bezeichnern.

Für die Minute ist der 'Unterschied nicht so groß. ISO verwendet den Bezeichner m für die Minute, anders als PHP welches i verwendet. Wenn man also keine Minute erhält dann sollte man sein Format darauf prüfen, ob der richtige Bezeichner verwendet wurde.

Wenn man mit PHP's date Formatdefinition vertrauter ist als mit den ISO Formatdefinitionen, dann kann man durch Verwendung der Methode Zend_Date::setOptions(array('format_type' => 'php')) das Wechseln von ISO Formatdefinition zu PHP date Formatdefinition welche dann für alle Zend_Date Methoden verwendet werden wechseln. Danach müssen alle Format Parameter in » PHP's date() Formatdefintion angegeben werden. Das PHP date Format vermisst einige der Formate welche durch PHP unterstützt werden und umgekehrt. Wenn keine Erfahrung damit besteht sollte auf alle Fälle das ISO Format genommen werden. Und wenn Altlast-Code vorhanden ist der PHP's date Format verwendet, kann dieser entweder manuell in das ISO Format konvertiert werden indem Zend_Locale_Format::convertPhpToIsoFormat() verwendet wird, oder durch Verwendung von setOptions(). Die folgenden Beispiel zeigen die Verwendung der Konstanten anhand der unteren Tabelle für die Erstellung von selbst-definierten Formaten.

$locale = new Zend_Locale('de_AT');
Zend_Date::setOptions(array('format_type' => 'php'));
$date = new Zend_Date(1234567890, false, $locale);

// Ausgabe zum Beispiel 'Februar 16, 2007, 3:36 vorm.'
print $date->toString('F j, Y, g:i a');

print $date->toString("'Format:D M j G:i:s T Y='D M j G:i:s T Y");

Die folgende Tabelle zeit die Liste der PHP date Formatdefinitionen mit Ihrem Äquivalent in Zend_Date Konstanten und der im CLDR/ISO äquivalenten Formatdefintion. In den meisten Fällen wenn das CLDR/ISO Format keine entsprechende Formardefinition enthält, wird die PHP Formatdefinition nicht durch Zend_Locale_Format::convertPhpToIsoFormat() geändert, und die Zend_Date Methoden erkennen dann diese "besonderen" PHP Formatdefinitionen, selbst im Standardmäßigen "ISO" Formatcode.