On this page
nl_langinfo
(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)
nl_langinfo — Query language and locale information
Description
nl_langinfo(int $item): string|false
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-
itemmay be an integer value of the element or the constant name of the element. The following is a list of constant names foritemthat 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_STRString for Ante meridian. PM_STRString for Post meridian. D_T_FMTString that can be used as the format string for strftime() to represent time and date. D_FMTString that can be used as the format string for strftime() to represent date. T_FMTString that can be used as the format string for strftime() to represent time. T_FMT_AMPMString that can be used as the format string for strftime() to represent time in 12-hour format with ante/post meridian. ERAAlternate era. ERA_YEARYear in alternate era format. ERA_D_T_FMTDate and time in alternate era format (string can be used in strftime()). ERA_D_FMTDate in alternate era format (string can be used in strftime()). ERA_T_FMTTime in alternate era format (string can be used in strftime()). LC_MONETARY Category Constants INT_CURR_SYMBOLInternational currency symbol. CURRENCY_SYMBOLLocal currency symbol. CRNCYSTRSame value as CURRENCY_SYMBOL.MON_DECIMAL_POINTDecimal point character. MON_THOUSANDS_SEPThousands separator (groups of three digits). MON_GROUPINGLike "grouping"element.POSITIVE_SIGNSign for positive values. NEGATIVE_SIGNSign for negative values. INT_FRAC_DIGITSInternational fractional digits. FRAC_DIGITSLocal fractional digits. P_CS_PRECEDESReturns 1 if CURRENCY_SYMBOLprecedes a positive value.P_SEP_BY_SPACEReturns 1 if a space separates CURRENCY_SYMBOLfrom a positive value.N_CS_PRECEDESReturns 1 if CURRENCY_SYMBOLprecedes a negative value.N_SEP_BY_SPACEReturns 1 if a space separates CURRENCY_SYMBOLfrom 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_POSNLC_NUMERIC Category Constants DECIMAL_POINTDecimal point character. RADIXCHARSame value as DECIMAL_POINT.THOUSANDS_SEPSeparator character for thousands (groups of three digits). THOUSEPSame value as THOUSANDS_SEP.GROUPINGLC_MESSAGES Category Constants YESEXPRRegex string for matching "yes"input.NOEXPRRegex string for matching "no"input.YESSTROutput string for "yes".NOSTROutput string for "no".LC_CTYPE Category Constants CODESETReturn a string with the name of the character encoding. - Returns 0 if parentheses surround the quantity and
Return Values
Returns the element as a string, or false if item is not valid.
Examples
Example #1 nl_langinfo() example
<?php
var_dump(nl_langinfo(CODESET));
var_dump(nl_langinfo(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.
See Also
- setlocale() - Set locale information
- localeconv() - Get numeric formatting information
© 1997–2023 The PHP Documentation Group
Licensed under the Creative Commons Attribution License v3.0 or later.
https://www.php.net/manual/en/function.nl-langinfo.php