PHP
Referenzliste
date
Datums- und Zeit-Funktionen
Befehl:
string date ( string $Format [, int $Timestamp] )
Parameter-Liste:
Beschreibung | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Das Format des ausgegebenen Datums Zeichenfolge. Siehe die Formatierungsoptionen unten. Es gibt auch mehrere vordefinierten Datumskonstanten, die stattdessen verwendet werden können, so zum Beispiel DATE_RSS enthält die Format-String 'D, d MYH: i: s'.
Hinweis: Weil diese Funktion nur Integer-Zeitstempel akzeptiert, ist die Formatanweisung u nur nützlich, wenn man die Funktion date_format() mit von Benutzern angegebenen Timestamps aus der Funktion date_create() verwendet. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Die optionale Zeitstempel Parameter ist ein integer Unix-Zeitstempel, der standardmässig die aktuelle Ortszeit, wenn ein Zeitstempel ist nicht gegeben. Mit anderen Worten, wird standardmässig der Wert der time(). |
Rückgabewerte:
Gibt eine formatierte Datums-Zeichenkette zurück. Falls ein nicht numerischer Wert als timestamp übergeben wird, wird
FALSE
zurückgegeben und ein Fehler der Stufe E_WARNING
erzeugt. Beschreibung:
Mit date() kann man eine Zeitangabe formatieren oder auswerten. Die Zeitangabe übergeben Sie im Parameter timestamp. Lassen Sie diesen Parameter leer, nimmt die Funktion die aktuelle Zeit. Der Parameter format ist ein String, der festlegt, welche Informationen über die Zeitangabe Sie benötigen.
Aktiv in Version:
(PHP 4, PHP 5, PHP 7)
Hinweis:
Hinweis:
Um einen Zeitstempel aus einem String, der das Datum zu erzeugen, können Sie möglicherweise strtotime() zu verwenden. Zusätzlich bieten einige Datenbanken Funktionen, um deren Datum in Timestamps (wie MySQL »UNIX_TIMESTAMP-Funktion) zu konvertieren.
Tips:
Tips:
Zeitstempel der Start der Anfrage ist in $ _SERVER ['REQUEST_TIME'] seit PHP 5.1 zur Verfügung.
Fehler:
Jeder Aufruf der Datums- und Zeitfunktionen generiert eine
E_NOTICE
-Warnung, wenn die Zeitzone ungültig ist und eine E_STRICT
-Nachricht oder eine E_WARNING
-Warnung, wenn die Systemeinstellung oder die TZ-Umgebungsvariable genutzt wird. Siehe auch date_default_timezone_set(). Siehe auch:
• gmdate()
Formatiert eine GMT/UTC Zeit-/Datumsangabe
• idate()
Formatiert eine local time/date als integer
Gibt Datums- und Zeitinformationen zurück
Uhrzeit der letzten Änderung eines Scripts
• mktime()
Gibt den Unix-Timestamp/Zeitstempel für ein Datum zurück
Formatiert eine Zeit-/Datumsangabe nach den lokalen Einstellungen
• time()
Gibt den aktuellen Unix-Timestamp/Zeitstempel zurück
Wandelt ein beliebiges in englischer Textform angegebenes Datum in einen UNIX-Zeitstempel (Timestamp) um
date() - Beispiel:
Eingabe:
<?php // Die Standard-Zeitzone, die verwendet werden soll, setzen. // Verfügbar seit PHP 5.1 date_default_timezone_set('UTC'); // Gibt etwas aus wie: 'Monday' echo date("l"); // Gibt etwas aus wie: 'Monday 8th of August 2005 03:12:46 PM' echo date('l jS \of F Y h:i:s A'); // Gibt aus: 'July 1, 2000 ist ein Saturday' echo "July 1, 2000 ist ein " . date("l", mktime(0, 0, 0, 7, 1, 2000)); /* Verwende die Konstanten im Format-Parameter */ // Gibt etwas aus wie 'Mon, 15 Aug 2005 15:12:46 UTC' echo date(DATE_RFC822); // Gibt etwas aus wie '2000-07-01T00:00:00+00:00' echo date(DATE_ATOM, mktime(0, 0, 0, 7, 1, 2000)); ?>
Beschreibung:
In diesem String sind folgende Platzhalter m�glich
(*: Ausgabe mit f�hrenden Nullen):
� a - "am" oder "pm"
� A - "AM" oder "PM"
� B - Tage bis Jahresende
� c - ISO 8601 Datum (2004-02-12T15:19:21+00:00)
� d - Tag des Monats *( 01 � 31 )
� D - Tag der Woche ( Wed � 3stellig)
� e - Zeitzonen-Bezeichner (UTC, GMT, Atlantic/Azores)
� F - Monatsangabe (December � ganzes Wort)
� g - Stunde im 12-Stunden-Format (1-12 )
� G - Stunde im 24-Stunden-Format (0-23 )
� h - Stunde im 12-Stunden-Format *(01-12 )
� H - Stunde im 24-Stunden-Format *(00-23 )
� i - Minuten *(00-59)
� I - (grosses i) 1 bei Sommerzeit, 0 bei Winterzeit
� j - Tag des Monats (1-31)
� l - (kleines L) ausgeschriebener Wochentag (Monday)
� L - Schaltjahr = 1, kein Schaltjahr = 0
� m - Monat *(01-12)
� n - Monat (1-12)
� N - Numerische Repr�sentation des Wochentages gem�ss ISO-8601 1 (f�r Montag) bis 7 (f�r Sonntag)
� M - Monatsangabe (Feb � 3stellig)
� o - Jahreszahl gem�ss ISO-8601. Dies ergibt den gleichen Wert wie Y, ausser wenn die ISO-Kalenderwoche (W) zum vorhergehenden oder n�chsten Jahr geh�rt, wobei dann jenes Jahr verwendet wird
� O - Zeitunterschied gegen�ber Greenwich (GMT) in Stunden (z.B.: +0100)
� p - Zeitunterschied zur Greenwich time (GMT) in Stunden mit Doppelpunkt zwischen Stunden und Minuten (z.B.: +02:00)
� r - Formatiertes Datum (z.B.: Tue, 6 Jul 2004 22:58:15 +0200)
� s - Sekunden *(00 � 59)
� S - Englische Aufz�hlung (th f�r 2(second))
� t - Anzahl der Tage des Monats (28 � 31)
� T - Zeitzoneneinstellung des Rechners (z.B. CEST)
� u - Mikrosekunden (z.B.: 654321)
� U - Sekunden seit Beginn der UNIX-Epoche (1.1.1970)
� w - Wochentag (0(Sonntag) bis 6(Samstag))
� W - Wochennummer des Jahres (z.B.: 28)
� Y - Jahreszahl, vierstellig (2001)
� y - Jahreszahl, zweistellig (01)
� z - Tag des Jahres (z.B. 148 (entspricht 29.05.2001))
� Z - Offset der Zeitzone gegen�ber GTM (-43200 � 43200) in Minuten
(*: Ausgabe mit f�hrenden Nullen):
� a - "am" oder "pm"
� A - "AM" oder "PM"
� B - Tage bis Jahresende
� c - ISO 8601 Datum (2004-02-12T15:19:21+00:00)
� d - Tag des Monats *( 01 � 31 )
� D - Tag der Woche ( Wed � 3stellig)
� e - Zeitzonen-Bezeichner (UTC, GMT, Atlantic/Azores)
� F - Monatsangabe (December � ganzes Wort)
� g - Stunde im 12-Stunden-Format (1-12 )
� G - Stunde im 24-Stunden-Format (0-23 )
� h - Stunde im 12-Stunden-Format *(01-12 )
� H - Stunde im 24-Stunden-Format *(00-23 )
� i - Minuten *(00-59)
� I - (grosses i) 1 bei Sommerzeit, 0 bei Winterzeit
� j - Tag des Monats (1-31)
� l - (kleines L) ausgeschriebener Wochentag (Monday)
� L - Schaltjahr = 1, kein Schaltjahr = 0
� m - Monat *(01-12)
� n - Monat (1-12)
� N - Numerische Repr�sentation des Wochentages gem�ss ISO-8601 1 (f�r Montag) bis 7 (f�r Sonntag)
� M - Monatsangabe (Feb � 3stellig)
� o - Jahreszahl gem�ss ISO-8601. Dies ergibt den gleichen Wert wie Y, ausser wenn die ISO-Kalenderwoche (W) zum vorhergehenden oder n�chsten Jahr geh�rt, wobei dann jenes Jahr verwendet wird
� O - Zeitunterschied gegen�ber Greenwich (GMT) in Stunden (z.B.: +0100)
� p - Zeitunterschied zur Greenwich time (GMT) in Stunden mit Doppelpunkt zwischen Stunden und Minuten (z.B.: +02:00)
� r - Formatiertes Datum (z.B.: Tue, 6 Jul 2004 22:58:15 +0200)
� s - Sekunden *(00 � 59)
� S - Englische Aufz�hlung (th f�r 2(second))
� t - Anzahl der Tage des Monats (28 � 31)
� T - Zeitzoneneinstellung des Rechners (z.B. CEST)
� u - Mikrosekunden (z.B.: 654321)
� U - Sekunden seit Beginn der UNIX-Epoche (1.1.1970)
� w - Wochentag (0(Sonntag) bis 6(Samstag))
� W - Wochennummer des Jahres (z.B.: 28)
� Y - Jahreszahl, vierstellig (2001)
� y - Jahreszahl, zweistellig (01)
� z - Tag des Jahres (z.B. 148 (entspricht 29.05.2001))
� Z - Offset der Zeitzone gegen�ber GTM (-43200 � 43200) in Minuten
Beschreibung:
Beschreibung | |
---|---|
5.1.0 | Der gültige Bereich eines Zeitstempels geht von Fr, 13. Dezember 1901 20.45.54 GMT Di, 19. Januar 2038 03.14.07 GMT. (Dies sind die Daten, die an die Minimal-und Maximalwerte für einen 32-Bit-Ganzzahl entsprechen). Doch bevor PHP 5.1.0 wurde dieser Bereich von 01-01-1970 bis 19-01-2038 auf einigen Systemen (zB Windows) begrenzt. |
5.1.0 | Jetzt gibt E_STRICT und E_NOTICE Zeitzone die Fehler. |
5.1.1 | Es gibt nützliche Konstanten von Standard-Datum / Zeit-Formate, die verwendet werden können, um die Format -Parameter angeben. |
date() - Beispiel 2: Escaping von Zeichen in date()
Eingabe:
<?php // Gibt etwas ähnliches aus wie 'Wednesday the 15th' echo date('l \t\h\e jS'); ?>
Beschreibung:
Beschreibung | |
---|---|
5.1.0 | Der gültige Bereich eines Zeitstempels geht von Fr, 13. Dezember 1901 20.45.54 GMT Di, 19. Januar 2038 03.14.07 GMT. (Dies sind die Daten, die an die Minimal-und Maximalwerte für einen 32-Bit-Ganzzahl entsprechen). Doch bevor PHP 5.1.0 wurde dieser Bereich von 01-01-1970 bis 19-01-2038 auf einigen Systemen (zB Windows) begrenzt. |
5.1.0 | Jetzt gibt E_STRICT und E_NOTICE Zeitzone die Fehler. |
5.1.1 | Es gibt nützliche Konstanten von Standard-Datum / Zeit-Formate, die verwendet werden können, um die Format -Parameter angeben. |
date() und mktime() - Beispiele 3:
Eingabe:
<?php $morgen = mktime(0, 0, 0, date("m") , date("d")+1, date("Y")); $letztermonat = mktime(0, 0, 0, date("m")-1, date("d"), date("Y")); $naechstesjahr = mktime(0, 0, 0, date("m"), date("d"), date("Y")+1); ?>
Beschreibung:
Beschreibung | |
---|---|
5.1.0 | Der gültige Bereich eines Zeitstempels geht von Fr, 13. Dezember 1901 20.45.54 GMT Di, 19. Januar 2038 03.14.07 GMT. (Dies sind die Daten, die an die Minimal-und Maximalwerte für einen 32-Bit-Ganzzahl entsprechen). Doch bevor PHP 5.1.0 wurde dieser Bereich von 01-01-1970 bis 19-01-2038 auf einigen Systemen (zB Windows) begrenzt. |
5.1.0 | Jetzt gibt E_STRICT und E_NOTICE Zeitzone die Fehler. |
5.1.1 | Es gibt nützliche Konstanten von Standard-Datum / Zeit-Formate, die verwendet werden können, um die Format -Parameter angeben. |
Datums- und Zeit-Funktionen