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