timezone_name_from_abbr() : Guide Complet pour la Conversion d'Abréviations de Fuseaux Horaires en PHP

Qu'est-ce que timezone_name_from_abbr() ?

La fonction timezone_name_from_abbr() est une fonction native de PHP qui permet de convertir une abréviation de fuseau horaire (comme "EST", "PST", "UTC", "CET") en nom complet au format IANA (Internet Assigned Numbers Authority). Cette fonction est essentielle lorsque vous intégrez des données provenant de sources externes qui utilisent des abréviations plutôt que des identifiants complets de fuseaux horaires.

Elle accepte trois paramètres permettant d'affiner la recherche : l'abréviation elle-même, un décalage GMT en secondes (offset), et un indicateur d'heure d'été DST. Cette flexibilité est cruciale pour résoudre les ambiguïtés quand plusieurs fuseaux partagent la même abréviation (par exemple, "CST" peut désigner Central Standard Time, China Standard Time ou Cuba Standard Time).

Dans un contexte de développement web moderne, la gestion précise des fuseaux horaires est devenue un enjeu critique pour les applications internationales. Les utilisateurs attendent une expérience cohérente quel que soit leur emplacement géographique, et la fonction timezone_name_from_abbr() offre un pont essentiel entre les systèmes hérités utilisant des abréviations et les standards modernes basés sur les identifiants IANA.

Premier exemple : conversions simples de fuseaux horaires

Commençons par des exemples concrets montrant les quatre utilisations principales de timezone_name_from_abbr() en PHP :

   📋 Copier le code

<?php
// Exemple 1 : Conversion simple par abréviation
// La conversion la plus directe : d'une abréviation vers un identifiant IANA complet
 $timezone = timezone_name_from_abbr("EST");
echo "EST correspond à : " . $timezone . "<br>";
// Résultat : America/New_York

// Exemple 2 : Recherche par offset GMT uniquement (sans abréviation)
// 7200 secondes = 2 heures = GMT+2
// Utile quand vous connaissez seulement le décalage horaire
 $timezone = timezone_name_from_abbr("", 7200, 0);
echo "GMT+2 (sans DST) : " . $timezone . "<br>";
// Résultat possible : Europe/Berlin, Europe/Paris, ou autre fuseau GMT+2

// Exemple 3 : Gestion robuste des erreurs (ESSENTIEL)
// Vérification obligatoire du retour pour éviter les erreurs en production
 $timezone = timezone_name_from_abbr("XYZ");
if ($timezone === false) {
    echo "❌ Erreur : Abréviation 'XYZ' non reconnue<br>";
} else {
    echo "✅ Fuseau trouvé : " . $timezone . "<br>";
}

// Exemple 4 : Combinaison abréviation + offset pour éliminer les ambiguïtés
// Technique avancée pour garantir le bon fuseau horaire
 $timezone = timezone_name_from_abbr("PST", -28800, 0);
echo "PST avec offset -8h : " . $timezone . "<br>";
// Résultat : America/Los_Angeles
?>

Explication ligne par ligne :

• Lignes 2-4 : Conversion directe de l'abréviation "EST" vers l'identifiant IANA complet "America/New_York" - la méthode la plus simple mais potentiellement ambiguë si plusieurs fuseaux partagent cette abréviation.
• Lignes 6-9 : Recherche par offset GMT uniquement (7200 secondes = +2 heures) en ignorant l'abréviation - utile quand vous connaissez seulement le décalage horaire mais pas l'abréviation exacte.
• Lignes 11-17 : Gestion d'erreur OBLIGATOIRE car la fonction retourne false si aucun fuseau n'est trouvé - ne jamais l'omettre en production pour éviter des erreurs fatales.
• Lignes 19-21 : Technique avancée combinant abréviation ET offset pour lever toute ambiguïté - recommandé pour la fiabilité maximale dans les applications critiques.

Syntaxe complète de timezone_name_from_abbr()

   📋 Copier le code

string|false timezone_name_from_abbr(string $abbr, int $gmtOffset = -1, int $isDST = -1)

Types de retour possibles :

• string : Nom du fuseau horaire au format IANA (exemples : "Europe/Paris", "America/New_York", "Asia/Tokyo")
• false : Aucun fuseau horaire ne correspond aux paramètres fournis (abréviation inconnue, offset invalide, ou combinaison introuvable)

Description détaillée des trois paramètres

Exemples avancés : maîtriser offset GMT et DST

Ces exemples démontrent comment combiner gmtOffset et isDST pour des résultats précis et sans ambiguïté :

   📋 Copier le code

<?php
echo "<h3>1. Différencier heure d'été et heure d'hiver</h3>";

// EST en heure standard (hiver) : -5 heures
// Le troisième paramètre (0) indique que nous recherchons l'heure standard
 $est_winter = timezone_name_from_abbr("EST", -18000, 0);
echo "EST (hiver, GMT-5) : " . $est_winter . "<br>";

// EDT en heure d'été : -4 heures
// Le troisième paramètre (1) indique que nous recherchons l'heure d'été
 $edt_summer = timezone_name_from_abbr("EDT", -14400, 1);
echo "EDT (été, GMT-4) : " . $edt_summer . "<br>";


echo "<h3>2. Recherche par offset uniquement (technique avancée)</h3>";

// Fuseau GMT+1 sans DST (Europe centrale en hiver)
// L'abréviation vide ("") signifie que nous ne nous basons que sur l'offset
 $tz_plus1 = timezone_name_from_abbr("", 3600, 0);
echo "GMT+1 : " . $tz_plus1 . "<br>";

// Fuseau GMT+5:30 (Inde) - 19800 secondes = 5.5 heures
// Cas particulier d'un offset non-entier (demi-heure)
 $tz_india = timezone_name_from_abbr("", 19800, 0);
echo "GMT+5:30 (Inde) : " . $tz_india . "<br>";

// Fuseau GMT-8 (Côte Pacifique USA)
// Offset négatif pour les fuseaux à l'ouest de Greenwich
 $tz_pacific = timezone_name_from_abbr("", -28800, 0);
echo "GMT-8 : " . $tz_pacific . "<br>";


echo "<h3>3. Résoudre les ambiguïtés d'abréviations</h3>";

// PST seul peut être ambigu
// Sans offset précis, PHP retourne le premier fuseau correspondant trouvé
 $pst_default = timezone_name_from_abbr("PST");
echo "PST sans précision : " . ($pst_default ?: "Non trouvé") . "<br>";

// PST avec offset précis (-8h) : résultat garanti
// En spécifiant l'offset, nous éliminons toute ambiguïté
 $pst_precise = timezone_name_from_abbr("PST", -28800, 0);
echo "PST avec offset -8h : " . $pst_precise . "<br>";


echo "<h3>4. Validation complète avec DateTimeZone</h3>";

// Fonction utilitaire pour valider et afficher les informations d'un fuseau
function getTimezoneWithValidation($abbr, $offset = -1, $dst = -1) {
    $timezone_name = timezone_name_from_abbr($abbr, $offset, $dst);
    
    if ($timezone_name === false) {
        return "❌ Fuseau non trouvé pour : $abbr";
    }
    
    try {
        // Valider que le fuseau est utilisable avec DateTimeZone
        // Ceci garantit que l'identifiant retourné est valide
        $tz = new DateTimeZone($timezone_name);
        $dt = new DateTime('now', $tz);
        
        $offset_hours = $dt->getOffset() / 3600;
        $offset_formatted = sprintf("%+.1f", $offset_hours);
        
        return "✅ $timezone_name (Offset actuel: GMT$offset_formatted)";
        
    } catch (Exception $e) {
        return "⚠️ Erreur : " . $e->getMessage();
    }
}

echo getTimezoneWithValidation("JST", 32400, 0) . "<br>";
echo getTimezoneWithValidation("CET", 3600, 0) . "<br>";
echo getTimezoneWithValidation("INVALID") . "<br>";


echo "<h3>5. Comparaison systématique des fuseaux avec/sans DST</h3>";

// Tableau de fuseaux pour démontrer les différences DST
 $timezones_dst = [
    ['name' => 'CET (hiver)', 'abbr' => 'CET', 'offset' => 3600, 'dst' => 0],
    ['name' => 'CEST (été)', 'abbr' => 'CEST', 'offset' => 7200, 'dst' => 1],
    ['name' => 'PST (hiver)', 'abbr' => 'PST', 'offset' => -28800, 'dst' => 0],
    ['name' => 'PDT (été)', 'abbr' => 'PDT', 'offset' => -25200, 'dst' => 1],
];

echo "<table border='1' cellpadding='5'>";
echo "<tr><th>Description</th><th>Abréviation</th><th>Résultat IANA</th></tr>";

foreach ($timezones_dst as $tz) {
    // Conversion avec tous les paramètres pour garantir la précision
    $result = timezone_name_from_abbr($tz['abbr'], $tz['offset'], $tz['dst']);
    echo "<tr>";
    echo "<td>{$tz['name']}</td>";
    echo "<td>{$tz['abbr']}</td>";
    echo "<td>" . ($result ?: "Non trouvé") . "</td>";
    echo "</tr>";
}
echo "</table>";
?>

Cas d'usage pratiques : classe TimezoneConverter complète

Voici une classe utilitaire professionnelle pour gérer la conversion, la validation et l'affichage d'informations sur les fuseaux horaires :

   📋 Copier le code

<?php
/**
 * Classe utilitaire professionnelle pour la gestion des fuseaux horaires
 * Encapsule timezone_name_from_abbr() avec validation et formatage
 * 
 * @author Votre Nom
 * @version 1.0
 */
class TimezoneConverter {
    
    /**
     * Récupère les informations complètes d'un fuseau horaire
     * 
     * @param string $abbr Abréviation du fuseau (ex: "EST", "PST")
     * @param int $offset Offset GMT en secondes (défaut: -1 = ignoré)
     * @param int $dst Indicateur DST: -1 (ignoré), 0 (hiver), 1 (été)
     * @return array Informations détaillées du fuseau ou message d'erreur
     */
    public static function getTimezoneInfo($abbr, $offset = -1, $dst = -1) {
        // Conversion de l'abréviation en identifiant IANA
        $timezone_name = timezone_name_from_abbr($abbr, $offset, $dst);
        
        if ($timezone_name === false) {
            return [
                'success' => false,
                'error' => "Fuseau non trouvé pour l'abréviation '$abbr'"
            ];
        }
        
        try {
            // Création de l'objet DateTimeZone pour obtenir des informations détaillées
            $tz = new DateTimeZone($timezone_name);
            $dt = new DateTime('now', $tz);
            
            // Vérifier si le fuseau utilise le DST en examinant les transitions
            // sur une période d'un an à partir de maintenant
            $transitions = $tz->getTransitions(time(), time() + (86400 * 365));
            $has_dst = count($transitions) > 1;
            
            return [
                'success' => true,
                'timezone' => $timezone_name,
                'abbreviation' => $dt->format('T'),
                'current_time' => $dt->format('Y-m-d H:i:s'),
                'offset_seconds' => $dt->getOffset(),
                'offset_hours' => $dt->getOffset() / 3600,
                'offset_formatted' => sprintf("%+03d:%02d", 
                    floor($dt->getOffset() / 3600), 
                    abs($dt->getOffset() % 3600) / 60
                ),
                'has_dst' => $has_dst,
                'is_dst' => $dt->format('I') == 1
            ];
            
        } catch (Exception $e) {
            return [
                'success' => false,
                'error' => $e->getMessage()
            ];
        }
    }
    
    /**
     * Affiche les informations formatées en HTML (avec Bootstrap)
     * 
     * @param string $abbr Abréviation du fuseau (ex: "EST", "PST")
     * @param int $offset Offset GMT en secondes (défaut: -1 = ignoré)
     * @param int $dst Indicateur DST: -1 (ignoré), 0 (hiver), 1 (été)
     */
    public static function displayInfo($abbr, $offset = -1, $dst = -1) {
        $info = self::getTimezoneInfo($abbr, $offset, $dst);
        
        if (!$info['success']) {
            echo "<div class='alert alert-danger'>{$info['error']}</div>";
            return;
        }
        
        // Affichage formaté avec des cartes Bootstrap pour une meilleure présentation
        echo "<div class='card mb-3'>";
        echo "<div class='card-header'><strong>{$info['timezone']}</strong></div>";
        echo "<div class='card-body'>";
        echo "<p><strong>Abréviation actuelle :</strong> {$info['abbreviation']}</p>";
        echo "<p><strong>Heure locale :</strong> {$info['current_time']}</p>";
        echo "<p><strong>Offset GMT :</strong> {$info['offset_formatted']} ({$info['offset_seconds']} secondes)</p>";
        echo "<p><strong>Changement d'heure :</strong> " . ($info['has_dst'] ? 'Oui' : 'Non') . "</p>";
        echo "<p><strong>Actuellement en heure d'été :</strong> " . ($info['is_dst'] ? 'Oui' : 'Non') . "</p>";
        echo "</div></div>";
    }
    
    /**
     * Trouve tous les fuseaux possibles pour une abréviation donnée
     * Utile pour résoudre les ambiguïtés (ex: CST = Central/China/Cuba)
     * 
     * @param string $abbr Abréviation à rechercher
     * @return array Liste des fuseaux possibles avec leurs informations
     */
    public static function findAllForAbbr($abbr) {
        $results = [];
        // Test de tous les offsets possibles de GMT-12 à GMT+14
        $offsets_to_test = range(-12, 14);
        
        foreach ($offsets_to_test as $hour) {
            $offset_seconds = $hour * 3600;
            
            // Test avec et sans DST pour chaque offset
            foreach ([0, 1] as $dst) {
                $tz = timezone_name_from_abbr($abbr, $offset_seconds, $dst);
                
                if ($tz !== false && !in_array($tz, $results)) {
                    $results[] = [
                        'timezone' => $tz,
                        'offset_hours' => $hour,
                        'dst' => $dst
                    ];
                }
            }
        }
        
        return $results;
    }
    
    /**
     * Convertit un fuseau horaire depuis un format utilisateur vers un format IANA
     * Gère les entrées utilisateur variées (abréviations, offsets, noms partiels)
     * 
     * @param string $userInput Entrée utilisateur (ex: "EST", "-5", "New York")
     * @return string|false Identifiant IANA ou false si non trouvé
     */
    public static function convertFromUserInput($userInput) {
        // Cas 1 : Abréviation directe (ex: "EST", "PST")
        if (preg_match('/^[A-Z]{3,5}$/', strtoupper($userInput))) {
            $tz = timezone_name_from_abbr(strtoupper($userInput));
            if ($tz !== false) {
                return $tz;
            }
        }
        
        // Cas 2 : Offset numérique (ex: "-5", "+2")
        if (preg_match('/^[+-]?\d+(\.5)?$/', $userInput)) {
            $hours = floatval($userInput);
            $offset = intval($hours * 3600);
            $tz = timezone_name_from_abbr("", $offset, -1);
            if ($tz !== false) {
                return $tz;
            }
        }
        
        // Cas 3 : Nom partiel (ex: "New York", "Paris")
        $all_timezones = DateTimeZone::listIdentifiers();
        foreach ($all_timezones as $tz) {
            if (stripos($tz, $userInput) !== false) {
                return $tz;
            }
        }
        
        return false;
    }
}

// ===== EXEMPLES D'UTILISATION PRATIQUES =====

echo "<h3>Exemple 1 : Affichage d'informations complètes</h3>";
TimezoneConverter::displayInfo("EST", -18000, 0);
TimezoneConverter::displayInfo("JST", 32400, 0);
TimezoneConverter::displayInfo("CET", 3600, 0);

echo "<h3>Exemple 2 : Récupération programmatique des données</h3>";
 $info = TimezoneConverter::getTimezoneInfo("PST", -28800, 0);
if ($info['success']) {
    echo "Fuseau IANA : {$info['timezone']}<br>";
    echo "Offset : {$info['offset_formatted']}<br>";
    echo "Heure actuelle : {$info['current_time']}<br>";
}

echo "<h3>Exemple 3 : Résoudre l'ambiguïté de 'EST'</h3>";
 $all_est = TimezoneConverter::findAllForAbbr('EST');
echo "<ul>";
foreach ($all_est as $tz) {
    $dst_text = $tz['dst'] ? 'avec DST' : 'sans DST';
    echo "<li>{$tz['timezone']} (GMT{$tz['offset_hours']}, $dst_text)</li>";
}
echo "</ul>";

echo "<h3>Exemple 4 : Conversion depuis un formulaire utilisateur</h3>";
// Simulation de données POST d'un formulaire
 $user_inputs = ["PST", "-8", "New York", "Europe/Paris"];

foreach ($user_inputs as $input) {
    $timezone = TimezoneConverter::convertFromUserInput($input);
    if ($timezone) {
        echo "✅ '$input' → $timezone<br>";
    } else {
        echo "❌ '$input' → Non reconnu<br>";
    }
}

echo "<h3>Exemple 5 : Gestion avancée des heures d'été</h3>";
// Comparaison entre l'heure d'été et l'heure standard pour le même fuseau
 $locations = [
    ['name' => 'New York', 'abbr' => 'EST', 'offset' => -18000],
    ['name' => 'Paris', 'abbr' => 'CET', 'offset' => 3600],
    ['name' => 'Sydney', 'abbr' => 'AEST', 'offset' => 36000],
];

foreach ($locations as $location) {
    echo "<h4>{$location['name']}</h4>";
    
    // Heure standard (hiver)
    $winter = TimezoneConverter::getTimezoneInfo($location['abbr'], $location['offset'], 0);
    if ($winter['success']) {
        echo "Hiver : {$winter['timezone']} ({$winter['offset_formatted']})<br>";
    }
    
    // Heure d'été
    $summer_offset = $location['offset'] + 3600; // +1 heure pour l'été
    $summer = TimezoneConverter::getTimezoneInfo($location['abbr'], $summer_offset, 1);
    if ($summer['success']) {
        echo "Été : {$summer['timezone']} ({$summer['offset_formatted']})<br>";
    }
}
?>

Référence rapide : abréviations courantes de fuseaux horaires

Tableau complet des 20 abréviations les plus utilisées avec leurs équivalents IANA, offsets GMT et informations DST :

Limitations et pièges à éviter avec timezone_name_from_abbr()

Spécifications techniques complètes

Alternatives modernes et meilleures pratiques

1. Utiliser directement les identifiants IANA (Méthode recommandée)

   📋 Copier le code

<?php
// ❌ Approche moins fiable : utiliser timezone_name_from_abbr()
// Risque d'ambiguïté et de résultats imprévisibles
 $tz_name = timezone_name_from_abbr("EST");
if ($tz_name !== false) {
    $tz = new DateTimeZone($tz_name);
}

// ✅ Approche recommandée : utiliser directement l'identifiant IANA
// Plus fiable, plus performant et sans ambiguïté
try {
    $tz = new DateTimeZone("America/New_York");
    $datetime = new DateTime("now", $tz);
    echo "Heure à New York : " . $datetime->format('Y-m-d H:i:s T') . "<br>";
    echo "Offset actuel : " . $datetime->format('P') . "<br>";
} catch (Exception $e) {
    echo "Erreur : " . $e->getMessage();
}

// ✅ Avantages de l'approche directe :
// - Pas d'ambiguïté possible
// - Performance meilleure (pas de recherche)
// - Résultat prévisible et stable
// - Code plus maintenable
?>

2. Lister et explorer toutes les abréviations disponibles

   📋 Copier le code

<?php
// Obtenir toutes les abréviations disponibles dans le système
// Cette méthode retourne un tableau structuré avec toutes les abréviations
 $abbreviations = DateTimeZone::listAbbreviations();

echo "<h4>Statistiques générales :</h4>";
echo "Nombre total d'abréviations : " . count($abbreviations) . "<br><br>";

// Afficher les informations détaillées pour "EST"
if (isset($abbreviations['est'])) {
    echo "<h4>Tous les fuseaux pour l'abréviation EST :</h4>";
    echo "<pre>";
    print_r($abbreviations['est']);
    echo "</pre>";
}

// Rechercher toutes les abréviations contenant "ST" (Standard Time)
echo "<h4>Abréviations contenant 'ST' :</h4><ul>";
 $count = 0;
foreach ($abbreviations as $abbr => $zones) {
    if (stripos($abbr, 'st') !== false) {
        echo "<li><strong>" . strtoupper($abbr) . "</strong> - " . count($zones) . " fuseau(x) associé(s)</li>";
        $count++;
    }
}
echo "</ul>";
echo "<p>Total : $count abréviations trouvées</p>";

// Analyser les ambiguïtés
echo "<h4>Abréviations ambiguës (plusieurs fuseaux) :</h4><ul>";
foreach ($abbreviations as $abbr => $zones) {
    if (count($zones) > 5) {
        echo "<li><strong>" . strtoupper($abbr) . "</strong> : " . count($zones) . " fuseaux différents</li>";
    }
}
echo "</ul>";

// Fonction utilitaire pour trouver le fuseau le plus courant pour une abréviation
function findMostCommonTimezone($abbr) {
    $abbreviations = DateTimeZone::listAbbreviations();
    
    if (!isset($abbreviations[$abbr])) {
        return false;
    }
    
    // Compter les occurrences de chaque fuseau pour trouver le plus courant
    $timezone_counts = [];
    foreach ($abbreviations[$abbr] as $tz_info) {
        $tz = $tz_info['timezone_id'];
        if (!isset($timezone_counts[$tz])) {
            $timezone_counts[$tz] = 0;
        }
        $timezone_counts[$tz]++;
    }
    
    // Trier par nombre d'occurrences et retourner le plus courant
    arsort($timezone_counts);
    return key($timezone_counts);
}

echo "<h4>Fuseaux les plus courants pour des abréviations ambiguës :</h4>";
 $ambiguous_abbrs = ['CST', 'IST', 'WST'];
foreach ($ambiguous_abbrs as $abbr) {
    $most_common = findMostCommonTimezone($abbr);
    if ($most_common) {
        echo "$abbr → $most_common<br>";
    } else {
        echo "$abbr → Non trouvé<br>";
    }
}
?>

3. Obtenir tous les identifiants de fuseaux horaires par région

   📋 Copier le code

<?php
// Obtenir tous les identifiants de fuseaux horaires disponibles
// Cette méthode retourne tous les identifiants IANA valides
 $all_timezones = DateTimeZone::listIdentifiers();
echo "<h4>Statistiques globales :</h4>";
echo "Nombre total de fuseaux IANA : " . count($all_timezones) . "<br><br>";

// Filtrer par région européenne
 $europe_timezones = DateTimeZone::listIdentifiers(DateTimeZone::EUROPE);
echo "<h4>Fuseaux horaires européens (" . count($europe_timezones) . " au total) :</h4><ul>";
foreach (array_slice($europe_timezones, 0, 15) as $tz) {
    echo "<li>$tz</li>";
}
echo "<li><em>... et " . (count($europe_timezones) - 15) . " autres fuseaux européens</em></li></ul>";

// Statistiques par région
echo "<h4>Répartition des fuseaux par région :</h4>";
 $regions = [
    'AFRICA' => DateTimeZone::AFRICA,
    'AMERICA' => DateTimeZone::AMERICA,
    'ANTARCTICA' => DateTimeZone::ANTARCTICA,
    'ASIA' => DateTimeZone::ASIA,
    'ATLANTIC' => DateTimeZone::ATLANTIC,
    'AUSTRALIA' => DateTimeZone::AUSTRALIA,
    'EUROPE' => DateTimeZone::EUROPE,
    'INDIAN' => DateTimeZone::INDIAN,
    'PACIFIC' => DateTimeZone::PACIFIC,
];

echo "<table border='1' cellpadding='5'>";
echo "<tr><th>Région</th><th>Nombre de fuseaux</th><th>Exemples</th></tr>";

foreach ($regions as $name => $const) {
    $tz_list = DateTimeZone::listIdentifiers($const);
    $count = count($tz_list);
    $examples = implode(", ", array_slice($tz_list, 0, 3));
    
    echo "<tr>";
    echo "<td><strong>$name</strong></td>";
    echo "<td>$count</td>";
    echo "<td>$examples...</td>";
    echo "</tr>";
}
echo "</table>";

// Créer un sélecteur HTML pour un formulaire
echo "<h4>Exemple de sélecteur HTML pour formulaire :</h4>";
echo "<select name='timezone' class='form-control'>";
foreach (array_slice($all_timezones, 0, 20) as $tz) {
    echo "<option value='$tz'>$tz</option>";
}
echo "<option disabled>... et " . (count($all_timezones) - 20) . " autres</option>";
echo "</select>";

// Fonction utilitaire pour rechercher des fuseaux par nom de ville ou pays
function searchTimezonesByLocation($search_term) {
    $all_timezones = DateTimeZone::listIdentifiers();
    $matches = [];
    
    foreach ($all_timezones as $tz) {
        if (stripos($tz, $search_term) !== false) {
            $matches[] = $tz;
        }
    }
    
    return $matches;
}

echo "<h4>Recherche de fuseaux par nom de lieu :</h4>";
 $search_terms = ['York', 'Paris', 'Tokyo', 'London'];
foreach ($search_terms as $term) {
    $results = searchTimezonesByLocation($term);
    echo "$term : " . implode(", ", $results) . "<br>";
}

// Fonction pour obtenir des informations détaillées sur un fuseau
function getTimezoneDetails($timezone_id) {
    try {
        $tz = new DateTimeZone($timezone_id);
        $now = new DateTime('now', $tz);
        
        // Obtenir les transitions pour l'année en cours
        $year = (int)$now->format('Y');
        $transitions = $tz->getTransitions(
            mktime(0, 0, 0, 1, 1, $year),
            mktime(0, 0, 0, 12, 31, $year)
        );
        
        $details = [
            'timezone_id' => $timezone_id,
            'current_time' => $now->format('Y-m-d H:i:s'),
            'offset' => $now->getOffset(),
            'offset_formatted' => $now->format('P'),
            'abbreviation' => $now->format('T'),
            'is_dst' => $now->format('I') == 1,
            'transitions' => $transitions
        ];
        
        return $details;
    } catch (Exception $e) {
        return ['error' => $e->getMessage()];
    }
}

echo "<h4>Informations détaillées pour des fuseaux courants :</h4>";
 $sample_timezones = ['America/New_York', 'Europe/Paris', 'Asia/Tokyo'];
foreach ($sample_timezones as $tz_id) {
    $details = getTimezoneDetails($tz_id);
    if (!isset($details['error'])) {
        echo "<strong>{$details['timezone_id']}</strong> : ";
        echo "{$details['current_time']} ({$details['abbreviation']}, {$details['offset_formatted']})";
        echo " - DST: " . ($details['is_dst'] ? 'Oui' : 'Non') . "<br>";
    }
}
?>