PHP Conference Nagoya 2025

nl_langinfo

(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)

nl_langinfoRassemble des informations sur la langue et la configuration locale

Description

nl_langinfo(int $item): string|false

nl_langinfo() est utilisée pour accéder à chaque élément de la configuration locale. Contrairement à la fonction localeconv() qui renvoie tous les éléments, nl_langinfo() vous permet de sélectionner un élément précis.

Liste de paramètres

item

item peut être la valeur entière d'un élément, ou le nom de sa constante. Voici une liste des noms de constantes pour item qui peuvent être utilisés et leur description. Certaines constantes peuvent ne pas être définies, ou ne contenir aucune valeur pour certaines locales.

Constantes nl_langinfo()
Constante Description
Constantes de la catégorie LC_TIME
ABDAY_(1-7) Nom court du jour de la semaine.
DAY_(1-7) Nom du jour de la semaine (DAY_1 = Dimanche).
ABMON_(1-12) Nom abrégé du mois de l'année.
MON_(1-12) Nom du mois de l'année.
AM_STR Chaîne pour Ante meridian.
PM_STR Chaîne pour Post meridian.
D_T_FMT Chaîne pouvant être utilisée comme chaîne de formatage pour la fonction strftime() pour représenter la date et l'heure.
D_FMT Chaîne pouvant être utilisée comme chaîne de formatage pour la fonction strftime() pour représenter la date.
T_FMT Chaîne pouvant être utilisée comme chaîne de formatage pour la fonction strftime() pour représenter l'heure.
T_FMT_AMPM Chaîne pouvant être utilisée comme chaîne de formatage pour la fonction strftime() pour représenter l'heure au format 12 heures, avec ante/post meridian.
ERA Ère de substitution.
ERA_YEAR Année dans le format d'ère de substitution.
ERA_D_T_FMT Date et heure dans le format d'ère de substitution (chaîne pouvant être utilisée dans la fonction strftime()).
ERA_D_FMT Date dans le format d'ère de substitution (chaîne pouvant être utilisée dans la fonction strftime()).
ERA_T_FMT Heure dans le format d'ère de substitution (chaîne pouvant être utilisée dans la fonction strftime()).
Constantes de la catégorie LC_MONETARY
INT_CURR_SYMBOL Symbole monétaire international.
CURRENCY_SYMBOL Symbole monétaire local.
CRNCYSTR Même valeur que CURRENCY_SYMBOL.
MON_DECIMAL_POINT Caractère de virgule décimale.
MON_THOUSANDS_SEP Séparateur de centaine (groupes de trois lettres).
MON_GROUPING Comme l'élément "grouping".
POSITIVE_SIGN Signe pour les valeurs positives.
NEGATIVE_SIGN Signe pour les valeurs négatives.
INT_FRAC_DIGITS Chiffres partiels internationaux.
FRAC_DIGITS Chiffres partiels locaux.
P_CS_PRECEDES Retourne 1 si CURRENCY_SYMBOL précède une valeur positive.
P_SEP_BY_SPACE Retourne 1 si un espace sépare CURRENCY_SYMBOL d'une valeur positive.
N_CS_PRECEDES Retourne 1 si CURRENCY_SYMBOL précède une valeur négative.
N_SEP_BY_SPACE Retourne 1 si un espace sépare CURRENCY_SYMBOL d'une valeur négative.
P_SIGN_POSN
  • Retourne 0 si des parenthèses entourent la quantité et CURRENCY_SYMBOL.
  • Retourne 1 si la chaîne de signes précède la quantité et CURRENCY_SYMBOL.
  • Retourne 2 si la chaîne de signes suit la quantité et CURRENCY_SYMBOL.
  • Retourne 3 si la chaîne de signes précède immédiatement le CURRENCY_SYMBOL.
  • Retourne 4 si la chaîne de signes suit immédiatement le CURRENCY_SYMBOL.
N_SIGN_POSN
Constantes de la catégorie LC_NUMERIC
DECIMAL_POINT Caractère de virgule décimale.
RADIXCHAR Même valeur que DECIMAL_POINT.
THOUSANDS_SEP Caractère de séparation des centaines (groupe de trois lettres).
THOUSEP Même valeur que THOUSANDS_SEP.
GROUPING  
Constantes de la catégorie LC_MESSAGES
YESEXPR Chaîne d'expression rationnelle pour chercher l'entrée "yes".
NOEXPR Chaîne d'expression rationnelle pour chercher l'entrée "no".
YESSTR Affichage de la chaîne pour "yes".
NOSTR Affichage de la chaîne pour "no".
Constantes de la catégorie LC_CTYPE
CODESET Retourne une chaîne de caractères avec le nom du jeux de caractères.

Valeurs de retour

Retourne l'élément, sous la forme d'une chaîne de caractères ou false si le paramètre item n'est pas valide.

Exemples

Exemple #1 Exemple avec nl_langinfo()

<?php

var_dump
(nl_langinfo(CODESET));
var_dump(nl_langinfo(YESEXPR));
?>

Résultat de l'exemple ci-dessus est similaire à :

string(14) "ANSI_X3.4-1968"
string(5) "^[yY]"

Notes

Note: Cette fonction n'est pas implémentée sur les plates-formes Windows.

Voir aussi

add a note

User Contributed Notes 1 note

up
4
avatar_at_hot_ee
18 years ago
The value MON_(1-12) has special behavior in Russian locale: it returns declinated month names, that can be used as part of a date string, but not on their own.

For instance instead of "Январь" (the proper nominative form) it returns "Января" (form declinated for use in dates).

There seems to be no way to get the nominative form of the month name - one has to use translations instead.
To Top