mktime
(PHP 4, PHP 5, PHP 7, PHP 8)
mktime — Повертає позначку часу Unix для заданої дати
Опис
mktime( int $hour, ?int $minute = null, ?int $second = null, ?int $month = null, ?int $day = null, ?int $year = null): int|false
Функція повертає мітку часу Unix, що відповідає даті та часу, переданих як аргументи. Мітка часу - це ціле число, що дорівнює різниці в секундах між заданою датою/часом і початком епохи Unix (1 січня 1970 00:00:00 GMT).
Будь-які необов'язкові аргументи, опущені чи рівні null, будуть встановлені в поточне значення відповідно до локальної дати та часу.
Увага
Зверніть увагу, що порядок аргументів непарний: month day year, а не в більш розумній послідовності year month day
Виклик функції mktime() без аргументів не підтримується і призведе до помилки ArgumentCountError
Список параметрів
hour
Кількість годин, що минули з початку дня, вказаного параметрами month dayиyear. Негативні значення визначають годинник до півночі зазначеного дня. Значення більше ніж 23 визначають відповідну годину наступного дня (або днів).
minute
Кількість хвилин, що минули від початку години, вказаної параметром hour. Негативні значення визначають хвилини попередньої години. Значення більше 59 визначають відповідні хвилини наступної години (або годинника).
second
Кількість секунд, що минули від початку хвилини, вказаної параметром minute. Негативні значення визначають секунди попередньої хвилини. Значення більше ніж 59 визначають відповідні секунди наступної хвилини (або хвилин).
month
Кількість місяців, що минули з кінця минулого року. Значення від 1 до 12 визначають нормальні звичайні календарні місяці року. Значення менше 1 (включаючи негативні значення) визначають місяці попереднього року у зворотному порядку, тобто 0 буде груднем, -1 - листопад і т.д. Значення більше ніж 12 визначають відповідний місяць наступного року (або роках).
day
Кількість днів, що пройшли з кінця попереднього місяця. Значення від 1 до 28, 29, 30 чи 31 (залежно від місяця) визначають нормальні дні відповідного місяця. Значення менші за 1 (включаючи негативні значення) визначають дні попереднього місяця, таким чином, 0 є останнім днем попереднього місяця, -1 - передостаннім днем попереднього місяця і т.д. Значення більше за кількість днів відповідного місяця визначають відповідний день наступного місяця (або місяців).
year
Номер року може бути зазначений двома або чотирма цифрами, причому значення між 0-69 будуть трактовані як 2000-2069, а між 70-100 - як 1970-2000. На тих системах, де time_t є 32-бітовим знаковим цілим (найпоширеніший варіант на сьогодні), коректний діапазон для параметра year містить дати десь між 1901 та 2038.
Значення, що повертаються
Функцияmktime() повертає тимчасову мітку Unix відповідно до переданих аргументів або **false**якщо тимчасова мітка не може бути представлена у вигляді цілого числа PHP.
список змін
| Версия | Опис |
|---|---|
| 8.0.0 | hour більше не є необов'язковим. Якщо вам потрібна тимчасова мітка Unix, використовуйте функцію time() |
| 8.0.0 | minutesecondmonthdayиyear тепер допускають значення null. |
Приклади
Приклад #1 Приклад використання функції mktime()****
Приклад #2 Приклад використання mktime()****
Функциюmktime() зручно використовуватиме виконання арифметичних операцій із датами, оскільки вона обчислює правильні значення при некоректних аргументах. Наприклад, у наступному прикладі кожен рядок виведе "Jan-01-1998".
Приклад #3 Останній день місяця
Останній день будь-якого місяця можна визначити як "нульовий" день наступного місяця, не -1 день. Обидва наведені нижче приклади виведуть "Останній день лютого 2000: 29".
Дивіться також
- КлассDateTimeImmutable
- checkdate() - Перевіряє коректність дати за григоріанським календарем
- gmmktime() - Повертає локальну мітку часу Unix для часу за Грінвічем
- date() - Форматує тимчасову мітку Unix
- time() - Повертає поточну мітку системного часу Unix