localtime

(PHP 4, PHP 5)

localtime — Obtém a hora local

Descrição

array localtime ([ int $timestamp [, bool $is_associative ]] )

A função localtime() retorna uma matriz idêntica àquela da estrutura retornada pela chamada de uma função em C.

Parâmetros

timestamp

O parâmetro opcional timestamp é um integer Unix timestamp cujo padrão é a hora local se timestamp não for dado. Em outras palavras, o padrão é o valor de time().

is_associative

Se definido para FALSE ou não fornecido, então um array é retornado, com índices numéricos. Se o argumento é definido para TRUE então localtime() é um array associativo contendo todos os diferentes elementos da estrutura retornados pela chamada da função C para o localtime. Os nomes das diferentes chaves do array associativo são as seguintes:

  • "tm_sec" - Segundos
  • "tm_min" - Minutos
  • "tm_hour" - Hora
  • "tm_mday" - Dia do mês Meses são de 0 (Jan) à 11 (Dez) e dias da semana são de 0 (Dom) à 6 (Sáb).
  • "tm_mon" - Mês do ano, começa com 0 para Janeiro
  • "tm_year" - Anos desde 1900
  • "tm_wday" - Dia da semana
  • "tm_yday" - Dia do ano
  • "tm_isdst" - Se está em horário de verão

Erros

Toda a chamada a uma função de data/hora irá gerar um se a zona da hora não for valida, e/ou uma mensagem E_STRICT ou E_WARNING se estiver usando a definição do sistema ou a variável de ambiente TZ. Veja também date_default_timezone_set()

Changelog

Versão Descrição
5.1.0

Agora emite E_STRICT e E_NOTICE em erros da zona de horário.

Exemplos

Example #1 Exemplo da localtime()

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

O exemplo acima irá imprimir algo similar à:

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
)