nl_langinfo

(PHP 4 >= 4.1.0, PHP 5)

nl_langinfo — Query language and locale information

Description

string nl_langinfo ( int $item )

nl_langinfo() is used to access individual elements of the locale categories. Unlike localeconv(), which returns all of the elements, nl_langinfo() allows you to select any specific element.

Parameters

item

item may be an integer 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 constants may not be defined or hold no value for certain locales.

**nl_langinfo Constants**
Constant	Description
LC_TIME Category Constants
`ABDAY_(1-7)`	Abbreviated name of n-th day of the week.
`DAY_(1-7)`	Name of the n-th day of the week (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 Constants
`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`	Like "grouping" element.
`POSITIVE_SIGN`	Sign for positive values.
`NEGATIVE_SIGN`	Sign for negative values.
`INT_FRAC_DIGITS`	International fractional digits.
`FRAC_DIGITS`	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 Constants
`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_MESSAGES Category Constants
`YESEXPR`	Regex string for matching "yes" input.
`NOEXPR`	Regex string for matching "no" input.
`YESSTR`	Output string for "yes".
`NOSTR`	Output string for "no".
LC_CTYPE Category Constants
`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.

Notes

Note: This function is not implemented on Windows platforms.


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.

down

-1

zerof at terra dot com dot br ¶

8 years ago


<?php



$vlr19900 = nl_langinfo (CODESET);

$vlr19901 = nl_langinfo (D_T_FMT);

$vlr19902 = nl_langinfo (D_FMT);

$vlr19903 = nl_langinfo (T_FMT);

$vlr19904 = nl_langinfo (DAY_1);

$vlr19905 = nl_langinfo (ABDAY_1);

$vlr19906 = nl_langinfo (MON_1);

$vlr19907 = nl_langinfo (ABMON_1);

$vlr19908 = nl_langinfo (RADIXCHAR);

$vlr19909 = nl_langinfo (THOUSEP);

$vlr19910 = nl_langinfo (YESEXPR);

$vlr19911 = nl_langinfo (NOEXPR);

$vlr19912 = nl_langinfo (CRNCYSTR);



echo "encoding codeset => " . $vlr19900;

echo "<br /><br />date/time string para strftime => " . $vlr19901;

echo "<br /><br />date string for strftime => " . $vlr19902;

echo "<br /><br />time string for strftime => " . $vlr19903;

echo "<br /><br />long form day name => " . $vlr19904;

echo "<br /><br />short form day name => " . $vlr19905;

echo "<br /><br />long form month name => " . $vlr19906;

echo "<br /><br />short form month name => " . $vlr19907;

echo "<br /><br />decimals separator => " . $vlr19908;

echo "<br /><br />thousands separator => " . $vlr19909;

echo "<br /><br />REGEXP for 'Yes' => " . $vlr19910;

echo "<br /><br />REGEXP for 'No' => " . $vlr19911;

echo "<br /><br />local currency simbol => " . $vlr19912;



?>

add a note

nl_langinfo

Description

Parameters

Return Values

Notes

See Also