ConFoo 2025

localtime

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

localtimeObté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

Exemplo #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

adicione uma nota

Notas Enviadas por Usuários (em inglês)

Não há notas de usuários para esta página.
To Top