Kapitel 8. Zend_Date

Inhaltsverzeichnis

8.1. Einführung
8.1.1. Definieren Sie immer eine Standard-Zeitzone
8.1.2. Warum Zend_Date?
8.2. Basic Methods
8.2.1. The current date
8.2.2. Zend_Date by Example
8.3. Theory of Operation
8.3.1. Internals
8.4. Zend_Date API Overview
8.4.1. Zend_Date Options
8.4.2. Working with Date Values
8.4.3. Basic Zend_Date Operations Common to Many Date Parts
8.4.4. Comparing Dates
8.4.5. Getting Dates and Date Parts
8.4.6. Working with Fractions of Seconds
8.4.7. Sunrise / Sunset
8.5. Constants for General Date Functions
8.5.1. Using Constants
8.5.2. List of All Constants
8.5.3. Self-Defined OUTPUT Formats with ISO
8.5.4. Self-defined OUTPUT formats using PHP's date() format specifiers

8.1. Einführung

Die Zend_Date Komponente bietet eine umfangreiche aber einfache API zur Manipulation von Datum und Zeit. Die Methoden verarbeiten eine große Auswahl von Datentypen in vielen Kombinationen und erweitern die vorhandenen PHP Datumsfunktionen um eine Vielzahl von Möglichkeiten. Die aktuellste Version der Dokumentation finden Sie unter in unserer Online Dokumentation ( regelmäßig mit SVN syncronisiert ).

Auch wenn Einfachheit das höchste Ziel bleibt, ist die Arbeit beim Umgang mit lokalisierten Datums- und Zeitangaben unweigerlich mit einer gewissen Komplexität verbunden. Daten als auch Zeitangaben werden in verschiedenen Datums- und Zeitzonen oft unterschiedlich dargestellt. Beispielsweise stellen manche die Monatsangabe voran, während andere das Jahr an erste Stelle schreiben um ein Kalenderdatum darzustellen. Für mehr Informationen über die Handhabung von Lokalisierung und Normalisierung lesen Sie bitte im Abschnitt Zend_Locale nach.

Zend_Date unterstützt auch abgekürzte Monatsnamen in vielen Sprachen. Zend_Locale erleichert die Normalisierung von lokalisierten Monatsnamen und Wochentagen zu Zeitpunkten die umgekehrt auch wieder lokalisiert für andere Regionen übersetzt werden können.

8.1.1. Definieren Sie immer eine Standard-Zeitzone

Bevor Sie beliebige datumsrelevante Funktionen in PHP oder dem Zend Framework verwenden, sollten Sie sicherstellen, dass die Standard-Zeitzone in Ihrer Anwendung korrekt definiert ist. Das kann wahlweise mit dem Definieren einer TZ Umgebungsvariablen, der date.timezone Einstellung in der php.ini oder durch die Funktion date_default_timezone_set() erledigt werden. Durch das Setzen einer Standard-Zeitzone können in PHP können alle datums- und zeitabhängigen Funktionen für einen bestimmten Benutzer angepasst werden. Eine vollständige Auflistung der Zeitzoneneinstellungen finden Sie in der CLDR Timezone Identifier List ( Englisch ).

Beispiel 8.1. Definieren einer Standard-Zeitzone

    			<?php
	    			date_default_timezone_set('America/Los_Angeles'); // Zeitzone für die USA, Kalifornien
		    		date_default_timezone_set('Europe/Berlin');       // Zeitzone für Deutschland
			    ?>

Wenn eine Zend_Date Instanz erzeugt wird, wird die Zeitzone des aktuellen Benutzers automatisch als aktuelle Standardzeitzone übernommen. Das erspart das explizite setzen der Sommer-/Winterzeitumstellung (DST).

8.1.2. Warum Zend_Date?

Zend_Date erweitert die Möglichkeiten der PHP Datumsfunktionen um folgende Features:

  • Einfache API

    Zend_Date bietet eine sehr einfache API, die das die besten Datums- und Zeitfunktionalitäten aus vier Programmiersprachen vereint. Beispielsweise ist es möglich, in nur einer Zeile zwei Zeiten miteinander zu vergleichen oder zu addieren.

  • Vollständig Internationalisiert

    Alle vollen und abgekürzten Monatsnamen und Wochentage aus mehr als 130 Sprachen werden unterstützt. Die Methoden ermöglichen die Ein- und Ausgabe von Daten im Format der jeweiligen Lokalen.

  • Unlimitierte Zeitstempel

    Obwohl die PHP 5.2 Dokumentation erklärt: "Die gültige Spanne eines Zeitstempels geht von Fr, 13. Dez 1901 20:45:54 GMT bis Di, 19. Jan 2038 03:14:07 GMT", ermöglicht Zend_Date mit Unterstützung der BCMath Erweiterung eine fast unbegrenzte Zeitspanne. Wenn BCMath nicht verfügbar ist, bietet Zend_Date eine Spanne innerhalb des float-Datentyps auf Ihrem Server. "Die Größe von float ist Plattformabhängig, allerdings ist das Maximum von ~1.8e308 mit einer Genauigkeit von ca. 14 Dezimalstellen ein Standardwert. (das 64 bit IEEE Format)." [http://www.php.net/float]

  • Unterstützung der ISO_8601 Datumsspezifikation

    Die ISO_8601 Datumsspezifikationen werden unterstützt. Sogar teilkonforme ISO_8601 Datumsspezifikationen werden erkannt. Diese Zeitformate sind vor allem bei der Arbeit mit Datenbanken sinnvoll. Selbst wenn zum Beispiel MsSQL und MySQL leicht unterschiedlich mit Datum und Zeit umgehen, werden beide von Zend_Date unterstützt, wenn die Zend_Date::ISO_8601 Format Konstante verwendet wird. Wenn Datumszeichen mit den PHP date() Formaten "Y/m/d" oder "Y-m-d H:i:s" übereinstimmen, verwenden Sie bitte die in Zend_Date eingebaute Unterstützung für ISO 8601 formatierte Daten.

  • Sonnenauf- und Untergang errechnen

    Sie können Sonnenauf-und Untergang für jeden beliebigen Ort und Tag anzeigen, so dass Sie keine einzige Sekunde Tageslicht für Ihr Lieblings-PHP Projekt verpassen :) ( Ich dachte immer Freaks arbeiten ohne Tageslicht )