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
)