(PHP 4, PHP 5, PHP 7, PHP 8)
gmmktime — Получает метку Unix-времени для времени UTC
$hour,$minute = null,$second = null,$month = null,$day = null,$year = nullФункция работает аналогично функции mktime(), но игнорирует смещение времени в текущем часовом поясе и интерпретирует аргументы как UTC-время. Функция gmmktime() внутренне опирается на функцию mktime(), которая возвращает правильный результат только для допустимых для местного часового пояса моментов времени.
Аналогично функции mktime() необязательные аргументы опускают в порядке справа налево, при этом параметрам без аргументов функция установит значения, которые соответствуют компонентам текущего времени UTC.
Вызов функции gmmktime() без аргументов не поддерживается и выбросит ошибку ArgumentCountError. Метку времени без передачи аргументов получают функцией time().
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Год.
Функция возвращает значение int — метку времени Unix, если выполнилась успешно,
значение false, если метка выходит за пределы целочисленного значения PHP.
| Версия | Описание |
|---|---|
| 8.0.0 |
Параметр hour стал обязательным.
Метку времени Unix без передачи аргументов возвращает функция time().
|
| 8.0.0 |
Параметры minute, second, month,
day и year теперь принимают значение null.
|
Пример #1 Базовый пример получения метки UTC-времени функцией gmmktime()
<?php
date_default_timezone_set("Indian/Maldives");
echo "July 1, 2000 is on a " . date("l", gmmktime(0, 0, 0, 7, 1, 2000));Результат выполнения приведённого примера:
July 1, 2000 is on a Saturday