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

mktime

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

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

Описание

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

Функция возвращает метку времени Unix, которая соответствует заданным аргументам. Метка времени — целое число, которое содержит количество секунд между началом эпохи Unix, которая началась 1 января 1970 00:00:00 GMT, и датой и временем.

Функция присвоит необязательным параметрам, которые не указали или присвоили значение null, текущие значения, которые соответствуют локальным дате и времени.

Внимание

Обратите внимание, что аргументы идут в странном порядке: month, day, year, а не в более рациональном порядке year, month, day.

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

Номер года состоит из двух или четырёх цифр. Значения от 0 до 69 соответствуют 2000-2069 годам, а от 70 до 100 — 1970-2000 годам. В системах с арифметическим типом time_t в виде 32-разрядного целого числа со знаком, как самым распространённым способом представления времени, в допустимый диапазон параметра year входят значения примерно между 1901 и 2038 годами.

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

Функция mktime() возвращает метку времени Unix по заданным аргументам или false, если метка времени выходит за пределы диапазона целых чисел PHP.

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

Версия Описание
8.0.0 Параметр hour стал обязательным. Функция time() возвращает метку времени Unix без аргументов.
8.0.0 Параметры minute, second, month, day и year теперь принимают значение null.

Примеры

Пример #1 Пример базовой работы функции mktime()

<?php

// Устанавливаем часовой пояс по умолчанию
date_default_timezone_set('UTC');

// Выводит: July 1, 2000 is on a Saturday
echo "July 1, 2000 is on a " . date("l", mktime(0, 0, 0, 7, 1, 2000)) . "\n";

// Выводит что-то вроде: 2006-04-05T01:02:03+00:00
echo date('c', mktime(1, 2, 3, 4, 5, 2006)) . "\n";

Вывод приведённого примера будет похож на: 

July 1, 2000 is on a Saturday
2006-04-05T01:02:03+00:00

Пример #2 Пример получения метки времени функцией mktime()

Функция mktime() полезна для выполнения арифметических операций и проверки дат, поскольку функция автоматически вычисляет правильные значения для входных аргументов, которые выходят за пределы допустимого диапазона. В следующем примере каждая строка кода создаёт строку "Jan-01-1998".

<?php

date_default_timezone_set('America/New_York');

echo date("c", mktime(0, 0, 0, 12, 32, 1997)) . "\n";
echo date("c", mktime(0, 0, 0, 13, 1, 1997)) . "\n";
echo date("c", mktime(0, 0, 0, 1, 1, 1998)) . "\n";
echo date("c", mktime(0, 0, 0, 1, 1, 98)) . "\n";

Вывод приведённого примера будет похож на: 

1998-01-01T00:00:00-05:00
1998-01-01T00:00:00-05:00
1998-01-01T00:00:00-05:00
1998-01-01T00:00:00-05:00

Пример #3 Пример получения метки времени для относительных дат функцией mktime

<?php

date_default_timezone_set('Asia/Tokyo');

$tomorrow = mktime(0, 0, 0, date("m"), date("d") + 1, date("Y"));
print date('c', $tomorrow) . "\n";

$lastmonth = mktime(0, 0, 0, date("m") - 1, date("d"), date("Y"));
print date('c', $lastmonth) . "\n";

$nextyear = mktime(0, 0, 0, date("m"), date("d"), date("Y") + 1) . "\n";
print date('c', $nextyear) . "\n";

Вывод приведённого примера будет похож на: 

2025-09-30T00:00:00+09:00
2025-08-29T00:00:00+09:00
2026-09-29T00:00:00+09:00

Замечание:

Добавление относительных интервалов времени часто надёжнее добавления или вычитания секунд в дне или месяце, поскольку учитывают переходы на летнее время.

Пример #4 Пример получения последнего дня месяца

Последний день любого месяца получится выразить «нулевым» днём следующего месяца, но не -1 днём. Оба следующих примера создадут строку "Последний день февраля 2000 г.: 29".

<?php

$lastday = mktime(0, 0, 0, 3, 0, 2000);
echo 'Последний день февраля в 2000 году: ', date('d', $lastday) . "\n";

$lastday = mktime(0, 0, 0, 4, -31, 2000);
echo 'Последний день февраля в 2000 году: ', date('d', $lastday) . "\n";

Результат выполнения приведённого примера: 

Last day in Feb 2000 is: 29
Last day in Feb 2000 is: 29

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