strptime
(PHP 5 >= 5.1.0, PHP 7)
strptime — Разбирает строку даты/времени, сгенерированную функцией strftime()
Описание
$timestamp
, string $format
) : array|false
strptime() возвращает массив с данными разбора
строки timestamp
, либо false
в случае ошибки.
Названия месяцев и недель, а также другие названия, зависящие от
языка, соответствуют текущим настройкам местоположения, установленным
посредством setlocale() (LC_TIME
).
Список параметров
-
timestamp
(string) -
Строка для разбора (например, строковый результат выполнения функции strftime()).
-
format
(string) -
Формат строки
timestamp
(например, формат, используемый в функции strftime()). Следует обратить внимание на тот факт, что не все возможности форматирования используемые в strftime() будут обрабатываться в strptime(); набор поддерживаемых символов форматирования зависит от ОС и используемой С-библиотеки.За дополнительной информацией о возможностях форматирования обращайтесь на страницу описания функции strftime().
Возвращаемые значения
Возвращает массив или false
в случае возникновения ошибки.
параметры | Описание |
---|---|
"tm_sec" |
Секунды после минут (0-61) |
"tm_min" |
Минуты после часов (0-59) |
"tm_hour" |
Часы после полуночи (0-23) |
"tm_mday" |
День месяца (1-31) |
"tm_mon" |
Месяцы после января (0-11) |
"tm_year" |
Годы после 1900 |
"tm_wday" |
Дни после воскресенья (0-6) |
"tm_yday" |
Дни после 1-го января (0-365) |
"unparsed" |
Часть timestamp , которую не удалось
распознать в соответствии с format
|
Примеры
Пример #1 Пример использования strptime()
<?php
$format = '%d/%m/%Y %H:%M:%S';
$strf = strftime($format);
echo "$strf\n";
print_r(strptime($strf, $format));
?>
Результатом выполнения данного примера будет что-то подобное:
03/10/2004 15:54:19 Array ( [tm_sec] => 19 [tm_min] => 54 [tm_hour] => 15 [tm_mday] => 3 [tm_mon] => 9 [tm_year] => 104 [tm_wday] => 0 [tm_yday] => 276 [unparsed] => )
Примечания
Замечание: Для Windows-платформ эта функция не реализована.
Замечание:
В действительности эта функция вызывает библиотечную функцию
strptime()
. В различных ОС поведение функции может сильно различаться. Функция date_parse_from_format() лишена этого недостатка и рекомендована к использованию в PHP версий 5.3.0 и выше.
Замечание:
"tm_sec"
включает несколько секунд високосного года (на данный момент до 2-х в год). Для получения дополнительной информации о високосных секундах читайте » статью на википедии.
Замечание:
До PHP 5.2.0 эта функция может работать непредсказуемо. В особенности элементы
"tm_sec"
,"tm_min"
и"tm_hour"
могут содержать неопределенные значения.
Смотрите также
- checkdate() - Проверяет корректность даты по григорианскому календарю
- strftime() - Форматирует текущую дату/время с учетом текущих настроек локали
- date_parse_from_format() - Получение информации о заданной в определенном формате дате
- DateTime::createFromFormat() - Разбирает строку с датой согласно указанному формату