date

    (PHP 4, PHP 5, PHP 7, PHP 8)

    date — Formatiert einen Unix-Zeitstempel

    Beschreibung

    date(string $format, ?int $timestamp = null): string

    Gibt einen formatierten String anhand eines vorzugebenden Musters zurück. Dabei wird entweder der angegebene Unix-Zeitstempel timestamp verwendet oder die gegenwärtige Zeit, wenn kein Zeitstempel angegegeben wird. Mit anderen Worten ausgedrückt: Der Parameter timestamp ist optional und wird mit dem Wert der Funktion time() vorbelegt.

    Warnung

    Unix-Zeitstempel berücksichtigen keine Zeitzonen. Mit der Klasse DateTimeImmutable und ihrer Formatierungsmethode DateTimeInterface::format() können Datums- und Zeitangaben mit einer angehängten Zeitzone formatiert werden.

    Parameter-Liste

    format

    Von DateTimeInterface::format() akzeptiertes Format.

    Hinweis: Die Funktion date() gibt immer 000000 als Mikrosekunden aus, weil sie einen Parameter vom Typ int benötigt, während DateTimeInterface::format() Mikrosekunden unterstützt, wenn ein Objekt vom Typ DateTimeInterface mit Mikrosekunden erstellt wurde.

    timestamp

    Der optionale Parameter timestamp ist ein Unix-Zeitstempel vom Typ int. Falls timestamp nicht übergeben wird oder null ist, wird die aktuelle lokale Zeit als Standardwert verwendet. Er entspricht dann also dem Ergebnis der Funktion time().

    Rückgabewerte

    Gibt eine formatierte Datums-Zeichenkette zurück.

    Fehler/Exceptions

    Wenn die Zeitzone ungültig ist, wird bei jedem Aufruf einer Datums/Zeit-Funktion ein Fehler der Stufe E_WARNING erzeugt. Siehe auch date_default_timezone_set()

    Changelog

    Version Beschreibung
    8.0.0 timestamp ist jetzt nullbar.

    Beispiele

    Beispiel #1 date()-Beispiele

    <?php
    // Die Standard-Zeitzone setzen, die verwendet werden soll.
    date_default_timezone_set('UTC');

    // Gibt etwas aus wie: Monday
    echo date("l") . "\n";

    // Gibt etwas aus wie: Monday 8th of August 2005 03:12:46 PM
    echo date('l jS \of F Y h:i:s A') . "\n";

    // Gibt aus: July 1, 2000 is on a Saturday
    echo "July 1, 2000 is on a " . date("l", mktime(0, 0, 0, 7, 1, 2000)) . "\n";

    /* Verwenden von Konstanten im Format-Parameter */
    // Gibt etwas aus wie: Wed, 25 Sep 2013 15:28:57 -0700
    echo date(DATE_RFC2822) . "\n";

    // Gibt etwas aus wie: 2000-07-01T00:00:00+00:00
    echo date(DATE_ATOM, mktime(0, 0, 0, 7, 1, 2000));

    Um zu verhindern, dass ein erkanntes Zeichen im Formatstring ersetzt wird, sollte dieses Zeichen mit einem vorangestellten Backslash maskiert werden. Ist das Zeichen mit dem Backslash bereits eine spezielle Zeichenfolge, muss dieser Backslash ebenso maskiert werden.

    Beispiel #2 Maskieren von Zeichen in date()

    <?php
    // Gibt etwas ähnliches aus wie: Wednesday the 15th
    echo date('l \t\h\e jS');

    Es folgen einige Beispiele zur date()-Formatierung. Es ist zu beachten, dass alle anderen Zeichen maskiert werden sollten, da alle Zeichen, die im Augenblick eine spezielle Bedeutung haben, unerwünschte Resultate liefern. Bei allen weiteren Zeichen kann es durchaus möglich sein, dass diesen in zukünftigen PHP-Versionen eine Bedeutung zukommt. Beim Maskieren sollte darauf geachtet werden, einfache Anführungszeichen zu benutzen, damit Zeichenfolgen wie zum Beispiel \n zu keinem Zeilenumbruch führen.

    Beispiel #3 date()-Formatierungen

    <?php
    // Angenommen, heute ist der 10. März 2001, 17:16:18 Uhr und wir
    // befinden uns in der Zeitzone Mountain Standard Time (MST)

    echo date("F j, Y, g:i a") . "\n"; // March 10, 2001, 5:16 pm
    echo date("m.d.y") . "\n"; // 03.10.01
    echo date("j, n, Y") . "\n"; // 10, 3, 2001
    echo date("Ymd") . "\n"; // 20010310
    echo date('h-i-s, j-m-y, it is w Day') . "\n"; // 05-16-18, 10-03-01, 1631 1618 6 Satpm01
    echo date('\i\t \i\s \t\h\e jS \d\a\y.') . "\n"; // it is the 10th day.
    echo date("D M j G:i:s T Y") . "\n"; // Sat Mar 10 17:16:18 MST 2001
    echo date('H:m:s \m \i\s\ \m\o\n\t\h') . "\n"; // 17:03:18 m is month
    echo date("H:i:s") . "\n"; // 17:16:18
    echo date("Y-m-d H:i:s") . "\n"; // 2001-03-10 17:16:18 (the MySQL DATETIME format)

    Um Datumsangaben in anderen Sprachen auszugeben, kann IntlDateFormatter::format() statt date() verwendet werden.

    Anmerkungen

    Hinweis:

    Um einen Zeitstempel aus einer Textrepräsentation eines Datums zu erzeugen, kann die Funktion strtotime() verwendet werden. Einige Datenbanken haben außerdem Funktionen, mit denen ihre Datumsformate in Zeitstempel konvertiert werden können (wie z. B. die Funktion » UNIX_TIMESTAMP von MySQL).

    Tipp

    Der Zeitstempel des Verarbeitungsbeginns der HTTP-Anfrage wird in $_SERVER['REQUEST_TIME'] bereitgestellt.

    Siehe auch

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 1 note

    up
    0
    Anonymous
    3 days ago
    Be careful as this innocent piece of code

<?php
echo date('d.m.Y', null);
?>

outputs a different date on PHP 8 vs. earlier.

In PHP 8 `null` is treated as `null` and will make `date()` use its default value.

While on earlier PHP versions `null` will be cast to `0` therefore outputing `01.01.1970` (Unix Epoc)
    ＋add a note
    To Top