localtime()

Avertissement : localtime() a été dépréciée dans PHP 7.0 et supprimée dans PHP 8.0. Cette fonction n'est plus disponible dans les versions modernes de PHP. Pour les projets actuels, utilisez DateTime ou date() avec date_default_timezone_set() pour gérer les conversions de l'heure locale en toute sécurité.

localtime() était une fonction intégrée de PHP qui convertissait un timestamp Unix en un tableau de valeurs de l'heure locale. Ce tableau contenait des informations telles que l'année, le mois, le jour, l'heure, la minute et la seconde de l'heure locale.

Remarque : l'heure locale retournée dépend du fuseau horaire configuré sur le serveur. Utilisez date_default_timezone_set() pour le définir explicitement.

Voici la syntaxe de base de la fonction localtime() :

La syntaxe de localtime() en PHP

<‌?php

localtime(timestamp, is_associative)

Le paramètre timestamp est le timestamp Unix que vous souhaitez convertir, et is_associative est un paramètre booléen optionnel qui détermine si le tableau retourné doit être associatif ou non.

Si is_associative est false ou n'est pas spécifié, le tableau sera indexé numériquement. Le tableau contiendra les valeurs suivantes dans l'ordre :

• 0 : Secondes (0-59).
• 1 : Minutes (0-59).
• 2 : Heures (0-23).
• 3 : Jour du mois (1-31).
• 4 : Mois (0-11, où 0 correspond à janvier).
• 5 : Années depuis 1900.
• 6 : Jour de la semaine (0-6, où 0 correspond à dimanche).
• 7 : Jour de l'année (0-365).
• 8 : Indique si l'heure d'été est en vigueur (1 si oui, 0 si non, -1 si inconnu).

Si is_associative est défini sur true, les clés du tableau porteront les noms suivants, comme ceci :

---

array(
  'tm_sec' => ...,
  'tm_min' => ...,
  'tm_hour' => ...,
  'tm_mday' => ...,
  'tm_mon' => ...,
  'tm_year' => ...,
  'tm_wday' => ...,
  'tm_yday' => ...,
  'tm_isdst' => ...
)

Voici quelques exemples d'utilisation de la fonction localtime() :

Exemple de fonction localtime() en PHP

<‌?php

// Get the current local time
$now = time();
$localtime = localtime($now);
print_r($localtime);

// Get the local time for a specific Unix timestamp
$timestamp = 1646563200; // March 5, 2022, 12:00:00 AM UTC
$localtime = localtime($timestamp);
print_r($localtime);

// Get the local time as an associative array
$now = time();
$localtime = localtime($now, true);
echo "The current year is " . ($localtime['tm_year'] + 1900);

Try it Yourself »

Ces exemples montrent comment vous pouvez utiliser localtime() pour convertir des timestamps Unix en valeurs de l'heure locale et les manipuler comme nécessaire dans votre code PHP.

Pratique

Quelle est la fonction de localtime() en PHP ?

Elle retourne le timestamp Unix pour la date/heure actuelle.Elle retourne une liste de 9 éléments représentant la date et l'heure à la seconde près.Elle convertit le temps GMT en heure locale.Elle convertit l'argument timestamp de l'heure locale au GMT.Elle peut retourner l'heure locale sous forme de tableau associatif si le second argument optionnel est fourni et défini sur true.