idate
(PHP 5, PHP 7, PHP 8)
idate — Перетворює локальний час/дату на ціле число
Опис
idate(string $format, ?int $timestamp = null): int|false
Перетворює поточну дату та час на ціле число відповідно до рядка форматування format. Якщо аргумент timestamp заданий, розрахунок буде здійснено для цієї тимчасової мітки, якщо ні - буде використано локальний час. Іншими словами, мітка часу timestamp — це необов'язковий аргумент і за умовчанням дорівнює значенню time()
В отличие от функцииdate(), функцияidate() приймає лише один символ у аргументі format
Список параметрів
format
Допустимі символи в рядку аргументу format
символ в format | Опис |
|---|---|
B | Еталонний час/Час Інтернету |
d | День місяця |
h | Година (12-годинний формат) |
H | Година (24 годинний формат) |
i | Хвилини |
I (І у верхньому регістрі) | повертає , якщо активовано DST, або в іншому випадку |
L (l у верхньому регістрі) | повертає для високосного року, в іншому випадку |
m | Номер місяця |
N | День тижня у ISO-8601 (з для понеділка по 7 для неділі) |
o | Рік у ISO-8601 (4 цифри) |
s | Секунди |
t | Кількість днів у поточному місяці |
U | Час у секундах, від початку епохи UNIX - 1 січня 1970 00:00:00 UTC - те саме, що time() |
w | День тижня ( - Неділя) |
W | ISO-8601 - Номер тижня року, тиждень починається з понеділка |
y | Рік (1 або 2 цифри - дивіться примітку нижче) |
Y | Рік (4 цифри) |
z | День року |
Z | Часовий пояс – зміщення в секундах |
timestamp
Необов'язковий параметр timestamp — це ціла (int) мітка часу, за умовчанням рівна поточному місцевому часу, якщо параметр timestamp не вказано або дорівнює **null**Говоря по другому, значение по умолчанию равно результату функцииtime()
Значення, що повертаються
Повертає ціле число (int) у разі успішного виконання або **false**в случае возникновения ошибки.
idate() завжди повертає тип int і не може починатися з нуля, тому idate() може повернути менше цифр, ніж ви очікуєте. Дивіться наведені нижче приклади.
Помилки
Кожен виклик до функцій дати/часу при неправильних налаштуваннях часового поясу згенерує помилку рівня E_WARNING, якщо часовий пояс неправильний. Дивіться також date_default_timezone_set()
список змін
| Версия | Опис |
|---|---|
| 8.2.0 | Додані символи для параметра format: N (День тижня в ISO-8601) та o (Рік ISO-8601). |
| 8.0.0 | timestamp тепер допускає значення null. |
Приклади
Приклад #1 Приклад використання idate()****
Дивіться також
- DateTimeInterface::format() - Повертає дату, відформатовану згідно з переданим форматом
- date() - Форматує тимчасову мітку Unix
- getdate() - Повертає інформацію про дату/час
- time() - Повертає поточну мітку системного часу Unix