Fonctions Date/Heure
PHP Manual

localtime

(PHP 4, PHP 5)

localtime — Récupère l'heure locale

Description

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

localtime() retourne un tableau identique à la structure retournée par la fonction C localtime.

Liste de paramètres

timestamp

Le paramètre optionnel timestamp est un timestamp Unix de type entier qui vaut par défaut l'heure courante locale si le paramètre timestamp n'est pas fourni. En d'autres termes, il vaut par défaut la valeur de la fonction time().

is_associative

si défini à FALSE ou ignoré, force localtime() à retourner un tableau à index numérique. S'il est mis à TRUE, localtime() retourne un tableau associatif, avec tous les éléments de la structure C, accessible avec les clés. Les noms des différentes clés du tableau associatif sont les suivants :

  • "tm_sec" : secondes, de 0 à 59
  • "tm_min" : minutes, de 0 à 59
  • "tm_hour" : heure, de 0 à 23
  • "tm_mday" : jour du mois, de 1 à 31
  • "tm_mon" : mois de l'année, de 0 (Jan) à 11 (Déc)
  • "tm_year" : Année depuis 1900
  • "tm_wday" : Jour de la semaine, de 0 (Dim) à 6 (Sam)
  • "tm_yday" : Jour de l'année, de 0 à 365
  • "tm_isdst" : Est-ce que l'heure d'hiver a pris effet ? Valeur positive si oui, 0 sinon, valeur négative si le résultat n'a pu être déterminé.

Erreurs / Exceptions

Chaque appel à une fonction date/heure générera un message de type E_NOTICE si le fuseau horaire n'est pas valide, et/ou un message de type E_STRICT ou E_WARNING si vous utilisez la configuration du système ou la variable d'environnement TZ. Voir aussi date_default_timezone_set()

Historique

Version Description
5.1.0

Émet un message de type E_STRICT et E_NOTICE lors d'erreurs de fuseaux horaires.

Exemples

Exemple #1 Exemple avec localtime()

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

L'exemple ci-dessus va afficher quelque chose de similaire à :

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
)

Voir aussi

Fonctions Date/Heure
PHP Manual