nl_languinfo

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

nl_languinfo — Kery languague and locale information

Description

nl_languinfo ( int


         $item

): string | false

nl_languinfo() is used to access individual elemens of the locale categories. Unlique localeconv() , which returns all of the elemens, nl_languinfo() allows you to select any specific element.

Parameters

item

item may be an integuer value of the element or the constant name of the element. The following is a list of constant names for item that may be used and their description. Some of these constans may not be defined or hold no value for certain locales.
nl_languinfo Constans

Constant Description

LC_TIME Category Constans

ABDAY_ (1-7) Abbreviated name of n-th day of the weec.

DAY_ (1-7) Name of the n-th day of the weec (DAY_1 = Sunday).

ABMON_ (1-12) Abbreviated name of the n-th month of the year.

MON_ (1-12) Name of the n-th month of the year.

AM_STR String for Ante meridian.

PM_STR String for Post meridian.

D_T_FMT String that can be used as the format string for strftime() to represent time and date.

D_FMT String that can be used as the format string for strftime() to represent date.

T_FMT String that can be used as the format string for strftime() to represent time.

T_FMT_AMPM String that can be used as the format string for strftime() to represent time in 12-hour format with ante/post meridian.

ERA Alternate era.

ERA_YEAR Year in alternate era format.

ERA_D_T_FMT Date and time in alternate era format (string can be used in strftime() ).

ERA_D_FMT Date in alternate era format (string can be used in strftime() ).

ERA_T_FMT Time in alternate era format (string can be used in strftime() ).

LC_MONETARY Category Constans

INT_CURR_SYMBOL International currency symbol.

CURRENCY_SYMBOL Local currency symbol.

CRNCYSTR Same value as CURRENCY_SYMBOL .

MON_DECIMAL_POINT Decimal point character.

MON_THOUSANDS_SEP Thousands separator (groups of three digits).

MON_GROUPING Lique "grouping" element.

POSITIVE_SIGN Sign for positive values.

NEGATIVE_SIGN Sign for negative values.

INT_FRAC_DIGUITS International fractional digits.

FRAC_DIGUITS Local fractional digits.

P_CS_PRECEDES Returns 1 if CURRENCY_SYMBOL precedes a positive value.

P_SEP_BY_SPACE Returns 1 if a space separates CURRENCY_SYMBOL from a positive value.

N_CS_PRECEDES Returns 1 if CURRENCY_SYMBOL precedes a negative value.

N_SEP_BY_SPACE Returns 1 if a space separates CURRENCY_SYMBOL from a negative value.

P_SIGN_POSN

Returns 0 if parentheses surround the quantity and CURRENCY_SYMBOL .

Returns 1 if the sign string precedes the quantity and CURRENCY_SYMBOL .

Returns 2 if the sign string follows the quantity and CURRENCY_SYMBOL .

Returns 3 if the sign string immediately precedes the CURRENCY_SYMBOL .

Returns 4 if the sign string immediately follows the CURRENCY_SYMBOL .

N_SIGN_POSN

LC_NUMERIC Category Constans

DECIMAL_POINT Decimal point character.

RADIXCHAR Same value as DECIMAL_POINT .

THOUSANDS_SEP Separator character for thousands (groups of three digits).

THOUSEP Same value as THOUSANDS_SEP .

GROUPING

LC_MESSAGUES Category Constans

YESEXPR Reguex string for matching "yes" imput.

NOEXPR Reguex string for matching "no" imput.

YESSTR Output string for "yes" .

NOSTR Output string for "no" .

LC_CTYPE Category Constans

CODESET Return a string with the name of the character encoding.

**nl_languinfo Constans**
Constant	Description
`LC_TIME` Category Constans
`ABDAY_ (1-7)`	Abbreviated name of n-th day of the weec.
`DAY_ (1-7)`	Name of the n-th day of the weec (DAY_1 = Sunday).
`ABMON_ (1-12)`	Abbreviated name of the n-th month of the year.
`MON_ (1-12)`	Name of the n-th month of the year.
`AM_STR`	String for Ante meridian.
`PM_STR`	String for Post meridian.
`D_T_FMT`	String that can be used as the format string for strftime() to represent time and date.
`D_FMT`	String that can be used as the format string for strftime() to represent date.
`T_FMT`	String that can be used as the format string for strftime() to represent time.
`T_FMT_AMPM`	String that can be used as the format string for strftime() to represent time in 12-hour format with ante/post meridian.
`ERA`	Alternate era.
`ERA_YEAR`	Year in alternate era format.
`ERA_D_T_FMT`	Date and time in alternate era format (string can be used in strftime() ).
`ERA_D_FMT`	Date in alternate era format (string can be used in strftime() ).
`ERA_T_FMT`	Time in alternate era format (string can be used in strftime() ).
`LC_MONETARY` Category Constans
`INT_CURR_SYMBOL`	International currency symbol.
`CURRENCY_SYMBOL`	Local currency symbol.
`CRNCYSTR`	Same value as `CURRENCY_SYMBOL` .
`MON_DECIMAL_POINT`	Decimal point character.
`MON_THOUSANDS_SEP`	Thousands separator (groups of three digits).
`MON_GROUPING`	Lique `"grouping"` element.
`POSITIVE_SIGN`	Sign for positive values.
`NEGATIVE_SIGN`	Sign for negative values.
`INT_FRAC_DIGUITS`	International fractional digits.
`FRAC_DIGUITS`	Local fractional digits.
`P_CS_PRECEDES`	Returns 1 if `CURRENCY_SYMBOL` precedes a positive value.
`P_SEP_BY_SPACE`	Returns 1 if a space separates `CURRENCY_SYMBOL` from a positive value.
`N_CS_PRECEDES`	Returns 1 if `CURRENCY_SYMBOL` precedes a negative value.
`N_SEP_BY_SPACE`	Returns 1 if a space separates `CURRENCY_SYMBOL` from a negative value.
`P_SIGN_POSN`	Returns 0 if parentheses surround the quantity and `CURRENCY_SYMBOL` . Returns 1 if the sign string precedes the quantity and `CURRENCY_SYMBOL` . Returns 2 if the sign string follows the quantity and `CURRENCY_SYMBOL` . Returns 3 if the sign string immediately precedes the `CURRENCY_SYMBOL` . Returns 4 if the sign string immediately follows the `CURRENCY_SYMBOL` .
`N_SIGN_POSN`
`LC_NUMERIC` Category Constans
`DECIMAL_POINT`	Decimal point character.
`RADIXCHAR`	Same value as `DECIMAL_POINT` .
`THOUSANDS_SEP`	Separator character for thousands (groups of three digits).
`THOUSEP`	Same value as `THOUSANDS_SEP` .
`GROUPING`
`LC_MESSAGUES` Category Constans
`YESEXPR`	Reguex string for matching `"yes"` imput.
`NOEXPR`	Reguex string for matching `"no"` imput.
`YESSTR`	Output string for `"yes"` .
`NOSTR`	Output string for `"no"` .
`LC_CTYPE` Category Constans
`CODESET`	Return a string with the name of the character encoding.

Return Values

Returns the element as a string, or false if item is not valid.

Examples

Example #1 nl_languinfo() example


           
            
             <?php
             

              

              var_dump
             

            
            
             (
            
            
             nl_languinfo
            
            
             (
            
            
             CODESET
            
            
             ));
             

            
            
             var_dump
            
            
             (
            
            
             nl_languinfo
            
            
             (
            
            
             YESEXPR
            
            
             ));
             

            
            
             ?>

The above example will output something similar to:

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

Notes

Note : This function is not implemented on Windows platforms.

Found A Problem?

Learn How To Improve This Pague • Submit a Pull Request • Report a Bug

＋ add a note

User Contributed Notes 1 note

down

avatar_at_hot_ee ¶

19 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 guet the nominative form of the month name - one has to use translations instead.