(PHP 4, PHP 5, PHP 7, PHP 8)
strtotime — Преобразовывает текстовое представление даты на английском языке в метку времени Unix
Первым параметром функция ожидает строку с датой на английском языке, которая
будет преобразована в метку времени Unix (количество секунд, прошедших с 1 января 1970
года 00:00:00 UTC) относительно метки времени, переданной
в параметр baseTimestamp, или текущего времени, если аргумент
baseTimestamp опущен.
Разбор строки даты определён в разделе «Форматы даты и времени»
и содержит несколько тонких вопросов. Знание форматов упростит работу с функцией.
Метка времени Unix, которую возвращает функция, не содержит данных о часовых поясах. Для расчётов с датой/временем обращаются к инструменту с бо́льшими способностями — классу DateTimeImmutable.
Каждый параметр функции будет использовать часовой пояс по умолчанию, если он не указан в нём. Соблюдают осторожность и не указывают разные метки времени в параметрах, если только так не было задумано. О способах установки часового пояса по умолчанию рассказано в описании функции date_default_timezone_get().
datetimeСтрока даты и времени. Объяснение корректных форматов даёт раздел «Форматы даты и времени».
baseTimestampМетка времени, которую функция будет использовать как основу для вычисления относительных дат.
Возвращает метку времени в случае успешного выполнения, иначе false.
Каждый вызов функции для работы с датой и временем генерирует ошибку уровня E_WARNING
при неправильных настройках часового пояса. Смотрите также описание функции
date_default_timezone_set().
| Версия | Описание |
|---|---|
| 8.0.0 |
Теперь параметр baseTimestamp может принимать значение null.
|
Пример #1 Пример использования функции strtotime()
<?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";
Пример #2 Проверка ошибок
<?php
$str = 'Not Good';
if (($timestamp = strtotime($str)) === false) {
echo "Строка ($str) недопустима";
} else {
echo "$str == " . date('l dS \o\f F Y h:i:s A', $timestamp);
}Замечание:
«Относительная» дата в данном случае также означает, что если конкретный компонент метки даты/времени не указан, он будет взят дословно из параметра
baseTimestamp. То есть, вызовstrtotime('February'), если его запустить 31 мая 2022 года, будет интерпретирован как31 февраля 2022, что перенесётся в метку времени3 марта(в високосный год будет2 марта). Вызовstrtotime('1 February')илиstrtotime('first day of February')не допустит этой проблемы.
Замечание:
Если количество лет указано двумя цифрами, то значения 00-69 будут считаться 2000-2069, а 70-99 — 1970-1999. Замечания ниже рассказывают о возможных различиях на 32-битных системах (допустимые даты заканчиваются 2038-01-19 03:14:07).
Замечание:
Корректный диапазон меток времени — это обычно даты с 13 декабря 1901 20:45:54 UTC по 19 января 2038 03:14:07 UTC. (Эти даты соответствуют крайним значениям 32-битного целого числа со знаком.)
В 64-битных версиях PHP корректный диапазон меток времени практически бесконечен, так как 64 битов хватит для представления около 293 миллиардов лет в обоих направлениях.
Замечание:
Использовать эту функцию для математических операций не рекомендовано. Лучше пользоваться методами DateTime::add() и DateTime::sub().
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.'timestamp_sdt' for counting from zero hours of a specific day
<?php
echo $timestamp_sdt = strtotime(date('d.m.Y',time()).'00.00.00')*1000; echo '<br><br>';
echo date('d.m.Y H.i.s', $timestamp_sdt/1000); echo '<br><br>';
?>
will give out:
1734649200000
20.12.2024 00.00.00> 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 DateTimeImmutableAn interesting gotcha I found today which took a second to track down.
strtotime will return false with an empty string, or something that is clearly not a date. But whitespace returns the current time.
<?php
$date = '';
$utc = strtotime($date);
var_dump($date);
var_dump($utc);
$date = 'notADate';
$utc = strtotime($date);
var_dump($date);
var_dump($utc);
$date = ' ';
$utc = strtotime($date);
var_dump($date);
var_dump($utc);
?>
Will return:
string(0) ""
bool(false)
string(8) "notADate"
bool(false)
string(1) " "
int(1757608141)