strptime
(PHP 5 >= 5.1.0, PHP 7, PHP 8)
strptime — Розбирає рядок дати/часу, згенерований функцією strftime()
Увага
Функція оголошена застарілої починаючи з PHP 8.1.0. Використовувати цю функцію не рекомендується.
Опис
strptime(string $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 |
список змін
| Версия | Опис |
|---|---|
| 8.1.0 | Функцію оголошено застарілою. Замість неї використовуйте date_parse_from_format() (для синтаксичного аналізу, що не залежить від мовного стандарту) або IntlDateFormatter::parse() (Для синтаксичного аналізу, що залежить від мовного стандарту). |
Приклади
Приклад #1 Приклад використання strptime()****
Висновок наведеного прикладу буде схожим на:
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() позбавлена цього недоліку та рекомендована до використання.
Зауваження :
"tm_sec"включає кілька секунд високосного року (на даний момент до 2-х на рік). Для отримання додаткової інформації про високосні секунди читайте » статтю на вікіпедії
Дивіться також
- IntlDateFormatter::parse() - Перетворює рядок на значення позначки часу
- DateTime::createFromFormat() - Розбирає рядок з датою згідно з вказаним форматом
- checkdate() - Перевіряє коректність дати за григоріанським календарем
- strftime() - Форматує поточну дату/час з урахуванням поточних налаштувань локалі
- date_parse_from_format() - Отримання інформації про задану у визначеному форматі дату