Manuel PHP
Précédent |  | Suivant

# setlocale

(PHP 3, PHP 4 , PHP 5)

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 :

- `LC_ALL` pour toutes les constantes suivantes

- `LC_COLLATE` pour la comparaison de chaînes de caractères. Voir strcoll()

- `LC_CTYPE` pour la classification et la conversion de caractères. Voir strtoupper()

- `LC_MONETARY` pour localeconv()

- `LC_NUMERIC` pour le spéarateur décimal. Voir localeconv()

- `LC_TIME` pour le format de date et d'heure avec strftime()

> Note : Depuis `PHP` 4.2.0, passer `category` en tant que chaîne est déconseillé, utilisez les constantes mentionnées plus haut à la place. Les passer en tant que chaînes (entre guillemets) provoquera l'affichage d'un message d'avertissement.

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é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è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é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ème est '$loc_de'"; ?>`

Précédent | Sommaire | Suivant
rtrim | Niveau supérieur | sha1_file