localtime

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

localtimeObtiene fecha y hora local

Descripción

localtime(int $timestamp = time(), bool $is_associative = false): array

La función localtime() devuelve un array con la estructura idéntica a la devuelta por la llamada a la función en C.

Parámetros

timestamp

El parámetro opcional timestamp es una marca temporal de Unix de tipo integer que por defecto es la hora local si no se proporciona ningún valor a timestamp. En otras palabras, es de forma predeterminada el valor de la función time().

is_associative

Si está defindo como false o no se proporciona, el array es devuelto como un array indexado numéricamente. Si el argumento está definido como true, localtime() devuelve un array asociativo que contiene todos los diferentes elementos de la estructura devuelta por la llamada a la fucnión de C localtime. Los nombres de las diferentes claves del array asociativo son los siguientes:

  • "tm_sec" - segundos, 0 a 59
  • "tm_min" - minutos, 0 a 59
  • "tm_hour" - horas, 0 a 23
  • "tm_mday" - día del mes, 1 a 31
  • "tm_mon" - mes del año, 0 (Ene) a 11 (Dic)
  • "tm_year" - años desde 1900
  • "tm_wday" - día de la semana, 0 (Domingo) a 6 (Sábado)
  • "tm_yday" - día del año, 0 to 365
  • "tm_isdst" - ¿Está en horario de verano? Valor positivo si es que sí, 0 si es que no, negativo en caso que no se sepa.

Errores/Excepciones

Cada vez que se llame a una función de fecha/hora se generará un E_NOTICE si la zona horaria no es válida, y/o un mensaje E_STRICT o E_WARNING si se emplea la configuración del sistema o la variable global TZ. Véase también date_default_timezone_set()

Historial de cambios

Versión Descripción
5.1.0

Ahora muestra un error E_STRICT y E_NOTICE cuando ocurren errores con zonas horarias.

Ejemplos

Ejemplo #1 Ejemplo de localtime()

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

El resultado del ejemplo sería algo similar 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
)

Ver también

  • getdate() - Obtener información de la fecha/hora