HOWTO · PHP
Wie konvertiert man Strings in PHP in Datum und Uhrzeit
Möglichkeiten, eine Zeichenkette in PHP in ein Datums- oder Datum-Uhrzeit-Format umzuwandeln: mit strtotime() und date() oder mit DateTime::createFromFormat() beziehungsweise date_create_from_format().
Auf dieser Seite
Eine Datumszeichenkette ist zunächst Text, bis PHP sie parst. Dabei wird der Text als Zeitstempel oder Datum-Uhrzeit-Objekt interpretiert; die Formatierung wandelt den geparsten Wert anschließend in die Darstellung um, die Ihre Anwendung benötigt. Verwenden Sie strtotime() für einen geläufigen, eindeutigen Datumsausdruck. Folgt die Eingabe einem bekannten Muster, empfiehlt sich ein explizites Format mit DateTime::createFromFormat() oder dem prozeduralen Gegenstück date_create_from_format().
Den passenden PHP-Ansatz zum Parsen von Datumsangaben wählen
Verwenden Sie strtotime() für gängige Zeichenketten wie ein Datum im ISO-Format, wenn eine flexible Interpretation ausreicht. Die Funktion gibt einen Unix-Zeitstempel oder false zurück; date() formatiert einen Zeitstempel. Bei einem festen Eingabemuster macht die Methode DateTime::createFromFormat() die erwartete Reihenfolge der Felder deutlich und gibt ein Datum-Uhrzeit-Objekt oder false zurück. Die prozedurale Funktion date_create_from_format() ermöglicht dieselbe Art des Parsens, ohne die statische Methode direkt aufzurufen.
Diese Funktionen machen mehrdeutige Eingaben nicht eindeutig. Wenn Nutzende Datumsangaben nach unterschiedlichen Konventionen eingeben können, legen Sie das erwartete Format bereits an der Eingabegrenze fest und validieren Sie es. Wählen Sie beim Interpretieren einer Datum-Uhrzeit-Angabe außerdem bewusst eine Zeitzone; andernfalls wird die in PHP konfigurierte Standardzeitzone verwendet.
Flexible Datumszeichenketten mit strtotime() und date() parsen
Parsen Sie eine geläufige Datum-Uhrzeit-Zeichenkette mit strtotime() und übergeben Sie den zurückgegebenen Zeitstempel an date(). Prüfen Sie vor der Formatierung, ob der Rückgabewert false ist, damit ein fehlgeschlagener Parse-Vorgang nicht als Zeitstempel verwendet wird. Das Beispiel verwendet eine feste Eingabe und ein festes Ausgabeformat. Sein Ergebnis ist daher unabhängig von der aktuellen Systemzeit reproduzierbar.
Führen Sie dieses Beispiel aus:
Der Code und die angezeigten Bezeichnungen oder Ausgaben in diesem Abschnitt bleiben auf Englisch.
<?php
$dateString = '2023-10-15 14:30:00';
$timestamp = strtotime($dateString);
if ($timestamp === false) {
echo "Could not parse the date string.";
} else {
echo date('Y-m-d H:i:s', $timestamp);
}
strtotime() akzeptiert viele textuelle Datumsausdrücke. Diese Flexibilität ersetzt jedoch kein festgelegtes Eingabeformat. Das Ergebnis steht für einen Zeitpunkt, der anhand von Zeitzonenregeln interpretiert wurde; date() formatiert den Zeitstempel anhand der PHP-Standardzeitzone. Ist die Zeitzone der Quelle bekannt, geben Sie sie ausdrücklich an oder wenden Sie sie gezielt an, statt sich auf eine Servereinstellung zu verlassen.
Ein bekanntes Format mit DateTime::createFromFormat() parsen
Hat die Zeichenkette einen festgelegten Aufbau, geben Sie das passende Format an. Im folgenden Format stehen d, m, Y, H und i für Tag, Monat, vierstellige Jahreszahl, Stunde und Minute. Das vorangestellte ! setzt Felder zurück, die in der Eingabe fehlen, statt Sekunden oder andere Felder vom aktuellen Datum zu übernehmen.
Der Code und die angezeigten Bezeichnungen oder Ausgaben in diesem Abschnitt bleiben auf Englisch.
<?php
$dateString = '15-10-2023 14:30';
$dateFormat = '!d-m-Y H:i';
$dateTime = DateTime::createFromFormat($dateFormat, $dateString);
if ($dateTime === false) {
echo "Could not parse the date string.";
} else {
echo $dateTime->format('Y-m-d H:i:s');
}
Das Format muss die Eingabe beschreiben, nicht die gewünschte Ausgabe. Rufen Sie nach dem Parsen format() mit dem gewünschten Ausgabemuster auf. Ein Ergebnis ungleich false garantiert allein noch nicht, dass alle Kalenderbestandteile wie beabsichtigt akzeptiert wurden: PHP kann manche Werte außerhalb des gültigen Bereichs normalisieren und Warnungen melden. Für eine strenge Eingabevalidierung prüfen Sie nach dem Parsen wie unten beschrieben DateTime::getLastErrors().
Die prozedurale Funktion date_create_from_format() verwenden
Die prozedurale Funktion eignet sich für Code, der bereits PHP-Datumsfunktionen verwendet. Sie akzeptiert dasselbe Eingabeformat und dieselbe Zeichenkette und gibt bei Erfolg ein DateTime-Objekt oder bei einem fehlgeschlagenen Parse-Vorgang false zurück. Formatieren Sie das zurückgegebene Objekt erst mit date_format(), nachdem Sie geprüft haben, dass es ein Objekt ist.
Der Code und die angezeigten Bezeichnungen oder Ausgaben in diesem Abschnitt bleiben auf Englisch.
<?php
$dateString = '2023/10/15 14:30';
$dateFormat = '!Y/m/d H:i';
$dateTime = date_create_from_format($dateFormat, $dateString);
if ($dateTime === false) {
echo "Could not parse the date string.";
} else {
echo date_format($dateTime, 'Y-m-d H:i:s');
}
Dies ist die prozedurale Alternative zu DateTime::createFromFormat(): Beide Funktionen parsen anhand des angegebenen Formats und erzeugen ein DateTime-Objekt. Wählen Sie den Stil, der zum umgebenden Code passt. Für die Wahl zwischen den beiden Methoden ist keine Aussage zur PHP-Version nötig. Prüfen Sie in der Dokumentation der PHP-Version, die Ihre Anwendung unterstützt, ob die jeweilige API verfügbar ist.
Mehrdeutige Eingaben, Parse-Fehler und Zeitzonen behandeln
Eine Zeichenkette wie 03/04/2023 kann je nach Konvention den 4. März oder den 3. April bedeuten. Verlassen Sie sich nicht allein auf Trennzeichen, um die gemeinte Reihenfolge abzuleiten. Ist der Aufbau der Quelle bekannt, übergeben Sie das genaue Format an DateTime::createFromFormat() und validieren Sie das Ergebnis. strtotime() ist für konventionelle, eindeutig festgelegte Zeichenketten praktisch, kann aber nicht erschließen, welche Konvention die nutzende Person gemeint hat.
DateTime::createFromFormat() und date_create_from_format() können false zurückgeben. Prüfen Sie dieses Ergebnis, bevor Sie eine Objektmethode oder date_format() aufrufen. Die Funktionen können einen Wert auch akzeptieren und zugleich Parse-Warnungen melden, etwa wenn PHP einen Datumsbestandteil normalisiert hat. Wenn es auf die genaue Gültigkeit des Kalenderdatums ankommt, prüfen Sie zusätzlich die Parse-Diagnosen:
Der Code und die angezeigten Bezeichnungen oder Ausgaben in diesem Abschnitt bleiben auf Englisch.
<?php
$dateTime = DateTime::createFromFormat('!Y-m-d', '2023-02-31');
$errors = DateTime::getLastErrors();
if ($dateTime === false || ($errors !== false && ($errors['warning_count'] > 0 || $errors['error_count'] > 0))) {
echo "The date is not valid for the specified format.";
} else {
echo $dateTime->format('Y-m-d');
}
! setzt nicht angegebene Felder zurück, während getLastErrors() Warnungen und Fehler des letzten Parse-Vorgangs meldet. Die Diagnosedetails können sich zwischen PHP-Versionen unterscheiden. Testen Sie daher Ihre Validierungsregeln mit den Versionen, die Ihre Anwendung unterstützt. Erzeugen Sie für Datum-Uhrzeit-Angaben, die zu einer bestimmten Region gehören, ein DateTimeZone-Objekt für diese Region und übergeben Sie es als drittes Argument an DateTime::createFromFormat() (oder als entsprechendes Zeitzonenargument an die prozedurale Funktion). Bei Eingaben mit explizitem UTC-Offset sollten Sie diesen Offset bewusst beibehalten oder umrechnen, bevor Sie die Ausgabe formatieren.