(PHP 4, PHP 5, PHP 7, PHP 8)
strtotime — Wandelt eine textuelle englische Datums- und Zeitbeschreibung in einen Unix-Zeitstempel um
Diese Funktion erwartet eine Zeichenkette mit einem Datum im englischen
Datumsformat und versucht, dieses Format in einen Unix-Zeitstempel (die
Anzahl der Sekunden seit dem 1. Januar 1970 00:00:00 UTC) zu übersetzen.
Die Angabe wird relativ zum Zeitstempel ausgewertet, der im Parameter
baseTimestamp übergebenen wurde, oder,
falls baseTimestamp nicht übergeben wurde, relativ
zur aktuellen Zeit. Das Format der Zeichenkette, die das auszuwertende
Datum enthält, ist in
Unterstützte Datums- und Zeitformate
definiert, wobei einige Feinheiten zu beachten sind. Es wird dringend
empfohlen, sich dort mit allen Details vertraut zu machen.
Der Unix-Zeitstempel, den diese Funktion zurückgibt, enthält keine Informationen über Zeitzonen. Um Berechnungen mit Datums- und Zeitwerten durchzuführen, sollte das leistungsfähigere DateTimeImmutable verwendet werden.
Jeder Parameter dieser Funktion verwendet die Standardzeitzone, es sei denn, im betreffenden Parameter wird eine Zeitzone angegeben. Es ist darauf zu achten, nicht etwa verschiedene Zeitzonen je Parameter zu verwenden, außer es ist beabsichtigt. Die verschiedenen Möglichkeiten, die Standardzeitzone zu definieren, sind date_default_timezone_get() zu entnehmen.
datetimeEin Datums/Zeit Zeichenkette. Gültige Formate werden unter Datums- und Zeitformate erläutert.
baseTimestampDer Zeitstempel, der als Basis zur Berechnung relativer Daten verwendet wird.
Gibt im Erfolgsfall einen Zeitstempel zurück, andernfalls false.
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()
Beispiel #1 Ein strtotime()-Beispiel
<?php
echo strtotime("now"), "\n";
echo strtotime("10 September 2000"), "\n";
echo strtotime("+1 day"), "\n";
echo strtotime("+1 week"), "\n";
echo strtotime("+1 week 2 days 4 hours 2 seconds"), "\n";
echo strtotime("next Thursday"), "\n";
echo strtotime("last Monday"), "\n";
?>
Beispiel #2 Test auf Fehler
<?php
$str = 'Not Good';
if (($timestamp = strtotime($str)) === false) {
echo "Die Zeichenkette ($str) ist fehlerhaft.";
} else {
echo "$str == " . date('l dS \o\f F Y h:i:s A', $timestamp);
}
?>Hinweis:
"Relatives" Datum bedeutet in diesem Fall auch, dass nicht angegebene Komponenten des Datums-/Zeitstempels unverändert aus dem
baseTimestampübernommen werden. Das heißt, dassstrtotime('February')am 31. Mai 2022 als31 February 2022interpretiert wird, was zum Zeitstempel3 Marchführt (in einem Schaltjahr wäre es2 March). Stattdessenstrtotime('1 February')oderstrtotime('first day of February')zu verwenden, würde dieses Problem vermeiden.
Hinweis:
Wenn die Angabe der Jahreszahl zweistellig erfolgt, werden Werte von 0-69 den Jahren 2000-2069 zugeordnet, die Werte 70-99 ergeben die Jahreszahlen 1970-1999. Zu möglichen Unterschieden auf 32-Bit-Systemen (mögliche Datumsangaben könnten am 2038-01-19 03:14:07 enden) ist der folgende Hinweis zu beachten.
Hinweis:
Der gültige Bereich eines Zeitstempels liegt typischerweise zwischen Fri, 13 Dec 1901 20:45:54 UTC und Tue, 19 Jan 2038 03:14:07 UTC (das sind die Datumsangaben, die dem minimalen und maximalen Wert eines vorzeichenbehafteten 32-bit Integer entsprechen).
Bei 64-Bit-Versionen von PHP ist der gültige Bereich für Zeitstempel praktisch unendlich groß, da 64 Bit etwa 293 Milliarden Jahre in beide Richtungen darstellen können.
Hinweis:
Es ist nicht empfehlenswert, diese Funktion für mathematische Berechnungen zu verwenden. Dafür sollten stattdessen DateTime::add() und DateTime::sub() verwendet werden.
Be careful when using two numbers as the year. I came across this situation:
<?php
echo strtotime('24.11.22');
echo date('d.m.Y H:i:s', 1669324282) . "\n\n";
// But
echo strtotime('24.11.2022');
echo date('d.m.Y H:i:s', 1669237200);
?>
Output:
1669324282
25.11.2022 00:11:22
1669237200
24.11.2022 00:00:00Be aware of this: 1 month before the 31st day, it will return the same month:
<?php
echo date('m', strtotime('2023-05-30 -1 month')) ; //returns 04
echo date('m', strtotime('2023-05-31 -1 month')) ; //returns 05, not 04
?>
So, don't use this to operate on the month of the result.
A better way to know what month was the previous month would be:
<?php
//considering today is 2023-05-31...
$firstOfThisMonth = date('Y-m') . '-01'; //returns 2023-05-01
echo date('m', strtotime($firstOfThisMonth . ' -1 month')) ; //returns 04
?>Not sure why, but
<?php
echo strtotime("+2 hours"), "\n";
echo strtotime("+2 hrs"), "\n";
echo strtotime("+2 hourss"), "\n";
?>
are returning +2 hours, -2 hours, +8 hours. The latter two should be errors instead.> The Unix timestamp that this function returns does not contain information about time zones. In order to do calculations with date/time information, you should use the more capable DateTimeImmutable.
important - does not contain
<?php
date_default_timezone_set('Europe/Berlin');
// .... a lot of code
echo $a = strtotime('yesterday 00:00');
// in $a hour = 23:00:00 and you may not know about it
// https://onlinephp.io/c/ef696
// use DateTimeImmutable