gmmktime

(PHP 4, PHP 5, PHP 7)

gmmktimeВозвращает локальную метку времени Unix для времени по Гринвичу

Описание

gmmktime ( int $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(000712000));
?>

Смотрите также

  • mktime() - Возвращает метку времени Unix для заданной даты
  • date() - Форматирует вывод системной даты/времени
  • time() - Возвращает текущую метку системного времени Unix