setlocale

(PHP 3, PHP 4 )

setlocale -- Modifie les informations de localisation

Description

string setlocale ( mixed category, string locale [, string ...])

string setlocale ( mixed category, array locale)

setlocale() retourne la nouvelle configuration locale, ou FALSE si la localisation n'est pas implémentée sur votre plate-forme, si la variable de localisation n'existe pas, ou si la catégorie spécifiée n'est pas valide. Un nom de catégorie invalide générera un message d'alerte.

category est une constante (ou une chaîne) qui spécifie la catégorie de fonction affectées par la configuration de localisation :

Si locale est la chaîne vide "", les noms de locales seront pris dans l'environnement, à partir des variables de même noms que les catégories ci-dessus, ou depuis "LANG".

Si locale est NULL ou vaut "0", la configuration locale ne sera pas modifiée, et la configuration courante sera retournée.

Note : La possibilité de passer plusieurs locales est disponible depuis PHP 4.3.0.

setlocale() retourne la valeur de la locale courante, ou bien FALSE si la fonctionnalité de localisation n'est pas implémentée sur votre plate-forme, si la locale spécifiée n'existe pas, ou si la catégorie n'existe pas. Une catégorie invalide causera aussi l'affichage d'un message d'alerte.

Si locale vaut zéro ou "0", la configuration de localisation ne sera pas modifiée, et seule la valeur courante sera retournée.

Note : Passer plusieurs locales n'était pas disponible avant PHP 4.3.0.

setlocale() retourne la nouvelle valeur locale, ou bien FALSE si la fonctionnalité n'est pas implantée sur votre plate forme, que la configuration spécifiée n'existe pas ou que le nom de catégorie est invalide. Un nom de catégorie invalide causera aussi l'affichage d'une alerte. Les noms de catégories et de configurations locales sont disponibles dans la RFC 1766 et ISO 639.

Note : La valeur retournée par setlocale() dépend du système d'explotiation qui fait tourner PHP. La valeur retournée est exactement celle que la fonction setlocale() du système retourne.

Tuyau : Les utilisateurs de Windows trouverons des informations utiles à propos du paramètre locale sur le site web MSDN de Microsoft. Les valeurs de locales supportées peuvent être trouvées ici et les chaînes de pays/région ici. Les systèmes Windows supportent les codes à trois lettres pour les pays/régions spécifiés par ISO 3166-Alpha-3, qui peut être trouvé sur le site web Unicode .

Exemple 1. Exemple avec setlocale()

<?php
    
/* Configure le script en hollandais */
    
setlocale (LC_ALL, 'nl_NL');

    
/* Affiche : vrijdag 22 december 1978 */
    
echo strftime ("%A %e %B %Y", mktime (0, 0, 0, 12, 22, 1978));
    
    
/* Essai de diff&eacute;rentes valeurs possible pour l'allemand depuis
       &php; 4.3.0 */
       
$loc_de = setlocale (LC_ALL, 'de_DE@euro', 'de_DE', 'de', 'ge');
    echo
"L'identifiant de l'allemand sur ce syst&egrave;me est '$loc_de'";
?>

Exemple 2. Exemple avec setlocale() pour Windows

<?php
    
/* Configure le script en hollandais */
    
setlocale (LC_ALL, 'nld_nld');

    
/* Affiche : vrijdag 22 december 1978 */
    
echo strftime ("%A %d %B %Y", mktime (0, 0, 0, 12, 22, 1978));

    
/* Essai de diff&eacute;rentes valeurs possible pour l'allemand depuis
       &php; 4.3.0 */
    
$loc_de = setlocale (LC_ALL, 'de_DE@euro', 'de_DE', 'deu_deu');
       echo
"L'identifiant de l'allemand sur ce syst&egrave;me est '$loc_de'";
?>