localtime
(PHP 4, PHP 5, PHP 7)
localtime — Возвращает локальное время
Описание
$timestamp
= null
, bool $associative
= false
) : arrayФункция localtime() возвращает массив, аналогичный по структуре, возвращаемой соответствующей функцией C.
Список параметров
-
timestamp
-
Необязательный параметр
timestamp
представляет собой метку времени типа int, по умолчанию равную текущему локальному времени, еслиtimestamp
не указан илиnull
. Другими словами, значение по умолчанию равно результату функции time(). -
associative
-
Если установлен в
false
или не передан, то возвращается обычный массив с числовыми индексами. Если установлен вtrue
, то функция localtime() вернет ассоциативный массив, содержащий все различные элементы структуры, возвращаемой вызовом C-функции localtime. Названия этих ключей соответствуют следующим значениям:-
"tm_sec" - секунды, с
0
до59
-
"tm_min" - минуты, с
0
до59
-
"tm_hour" - часы, с
0
до23
-
"tm_mday" - день месяца, с
1
до31
-
"tm_mon" - месяц года, с
0
(январь) до11
(декабрь) - "tm_year" - количество лет, прошедших с 1900 г.
-
"tm_wday" - день недели, с
0
(воскресенье) до6
(суббота) -
"tm_yday" - порядковый номер дня в году, с
0
до365
-
"tm_isdst" - действует ли летнее время?
Положительное значение, если учитывается,
0
, если не учитывается, отрицателен, если неизвестно.
-
"tm_sec" - секунды, с
Ошибки
Каждый вызов к функциям даты/времени при неправильных настройках временной зоны сгенерирует ошибку уровня E_NOTICE
,
и/или ошибку уровня E_STRICT
или E_WARNING
при использовании системных
настроек или переменной окружения TZ. Смотрите также date_default_timezone_set()
Список изменений
Версия | Описание |
---|---|
8.0.0 |
timestamp теперь допускает значение null.
|
Примеры
Пример #1 Пример использования localtime()
<?php
$localtime = localtime();
$localtime_assoc = localtime(time(), true);
print_r($localtime);
print_r($localtime_assoc);
?>
Результатом выполнения данного примера будет что-то подобное:
Array ( [0] => 24 [1] => 3 [2] => 19 [3] => 3 [4] => 3 [5] => 105 [6] => 0 [7] => 92 [8] => 1 ) Array ( [tm_sec] => 24 [tm_min] => 3 [tm_hour] => 19 [tm_mday] => 3 [tm_mon] => 3 [tm_year] => 105 [tm_wday] => 0 [tm_yday] => 92 [tm_isdst] => 1 )