date_default_timezone_get

(PHP 5 >= 5.1.0, PHP 7)

date_default_timezone_get Récupère le décalage horaire par défaut utilisé par toutes les fonctions date/heure d'un script

Description

date_default_timezone_get ( void ) : string

Cette fonction retourne le décalage horaire en suivant l'ordre de préférences suivant :

  • Lecture du décalage horaire défini en utilisant la fonction date_default_timezone_set() (si elle existe)

  • Avant PHP 5.4.0 uniquement : Lecture de la variable d'environnement TZ (si elle n'est pas vide)

  • Lecture de la valeur de l'option de configuration date.timezone (si elle est définie)

  • Avant PHP 5.4.0 uniquement : Interrogation du système d'exploitation (si le système le supporte et l'autorise). Cette interrogation utilise un algorithme qui tente de deviner le décalage horaire. Aussi, le résultat peut ne pas être attendu dans certaine situation. Une alerte est affichée lorsque cette étape est atteinte. Inutile de la rapporter afin qu'elle soit corrigée, mais définissez plutôt date.timezone de façon plus correcte.

Si tout ce qui précède échoue, date_default_timezone_get() retournera le décalage horaire par défaut de UTC.

Valeurs de retour

Retourne une chaîne de caractères.

Historique

Version Description
5.4.0 La variable d'environnement TZ n'est plus utilisée pour deviner le décalage horaire.
5.4.0 Le décalage horaire n'est plus deviné depuis les informations disponibles via le système d'exploitation.

Exemples

Exemple #1 Récupération du décalage horaire par défaut

<?php
date_default_timezone_set
('Europe/London');

if (
date_default_timezone_get()) {
    echo 
'date_default_timezone_set : ' date_default_timezone_get() . '<br />';
}

if (
ini_get('date.timezone')) {
    echo 
'date.timezone : ' ini_get('date.timezone');
}

?>

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

date_default_timezone_set : Europe/London
date.timezone : Europe/London

Exemple #2 Récupération de l'abréviation d'un décalage horaire

<?php
date_default_timezone_set
('America/Los_Angeles');
echo 
date_default_timezone_get() . ' => ' date('e') . ' => ' date('T');
?>

L'exemple ci-dessus va afficher :

America/Los_Angeles => America/Los_Angeles => PST

Voir aussi