PHP 8.4.2 Released!

gmmktime

(PHP 4, PHP 5, PHP 7, PHP 8)

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

Описание

gmmktime(
    int $hour,
    ?int $minute = null,
    ?int $second = null,
    ?int $month = null,
    ?int $day = null,
    ?int $year = null
): int|false

Эта функция идентична функции mktime(), за исключением того, что аргументы являются временем по Гринвичу (GMT). gmmktime() внутри использует mktime(), поэтому могут быть использованы только те даты местного времени, которые корректно представляются в этом часовом поясе.

Подобно функции mktime(), необязательные аргументы могут быть опущены в порядке справа налево, при этом все опущенные аргументы предполагаются равными соответствующим компонентам текущего времени по Гринвичу.

Вызов функции gmmktime() без аргументов не поддерживается и приведёт к ошибке 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

Год

Возвращаемые значения

Возвращает временную метку Unix (int) в случае успешного выполнения или false, если временная метка не может быть представлена в виде целого числа PHP.

Список изменений

Версия Описание
8.0.0 hour больше не является необязательным. Если вам нужна временная метка Unix, используйте функцию time().
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));
?>

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

  • The DateTimeImmutable class
  • mktime() - Получает Unix-метку времени для даты
  • date() - Форматирует метку времени эпохи Unix
  • time() - Возвращает метку времени Unix на основе текущего системного времени

Добавить

Примечания пользователей

Пользователи ещё не добавляли примечания для страницы
To Top