Obtém o horário local

Descrição

localtime(?int $timestamp = null, bool $associative = false): array

A função localtime() retorna um array idêntico à estrutura retornada pela chamada da função em C.

Parâmetros

timestamp: O parâmetro opcional timestamp é um int de timestamp Unix cujo padrão é a hora local atual se timestamp não for informado ou for null. Em outras palavras, o padrão é o valor de time().
associative

Valor Retornado

Se associative for definido para false ou não fornecido, o retorno é um array normal, indexado numericamente. Se associative for definido para true, então localtime() retorna um array associativo contendo os elementos da estrutura retornados pela chamada da função C para o horário local. Os nomes das chaves do array associativo são as seguintes:

"tm_sec" - segundos, 0 a 59
"tm_min" - minutos, 0 a 59
"tm_hour" - horas, 0 a 23
"tm_mday" - dia do mês, 1 a 31
"tm_mon" - mês do ano, 0 (Jan) a 11 (Dez)
"tm_year" - anos desde 1900
"tm_wday" - dia da semana, 0 (Dom) a 6 (Sáb)
"tm_yday" - dia do ano, 0 a 365
"tm_isdst" - Se está em horário de verão Positivo se sim, 0 se não, negativo se é desconhecido.

Erros/Exceções

Toda chamada a uma função de data/hora gerará um E_WARNING se o fuso horário não for válido. Veja também date_default_timezone_set()

Registro de Alterações

Versão	Descrição
8.0.0	`timestamp` agora pode ser nulo.

Exemplos

Example #1 Exemplo da função localtime()

<?php
$localtime = localtime();
$localtime_assoc = localtime(time(), true);
print_r($localtime);
print_r($localtime_assoc);
?>

O exemplo acima produzirá algo semelhante a:

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
)

Veja Também

getdate() - Recupera informações de data/hora