array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.gmmktime.php', 1 => 'gmmktime', 2 => 'Получает метку Unix-времени для времени UTC', ), 'up' => array ( 0 => 'ref.datetime.php', 1 => 'Функции даты и времени', ), 'prev' => array ( 0 => 'function.gmdate.php', 1 => 'gmdate', ), 'next' => array ( 0 => 'function.gmstrftime.php', 1 => 'gmstrftime', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/datetime/functions/gmmktime.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

gmmktime

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

gmmktime — Получает метку Unix-времени для времени UTC

Описание

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

Функция работает аналогично функции 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

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