PHP localeconv() Function

❮ PHP String Reference

Example

Find the United States locale numeric formatting information:

<?php
setlocale(LC_ALL,"US");
$locale_info = localeconv();
print_r($locale_info);
?>

Try it Yourself »

Definition and Usage

The localeconv() function returns an array containing local numeric and monetary formatting information.

The localeconv() function will return the following array elements:

[decimal_point] - Decimal point character
[thousands_sep] - Thousands separator
[int_curr_symbol] - Currency symbol (example: USD)
[currency_symbol] - Currency symbol (example: $)
[mon_decimal_point] - Monetary decimal point character
[mon_thousands_sep] - Monetary thousands separator
[positive_sign] - Positive value character
[negative_sign] - Negative value character
[int_frac_digits] - International fractional digits
[frac_digits] - Local fractional digits
[p_cs_precedes] - True (1) if currency symbol is placed in front of a positive value, False (0) if it is placed behind
[p_sep_by_space] - True (1) if there is a spaces between the currency symbol and a positive value, False (0) otherwise
[n_cs_precedes] - True (1) if currency symbol is placed in front of a negative value, False (0) if it is placed behind
[n_sep_by_space] - True (1) if there is a spaces between the currency symbol and a negative value, False (0) otherwise
[p_sign_posn] - Formatting options:
- 0 - Parentheses surround the quantity and currency symbol
- 1 - The + sign is placed in front of the quantity and currency symbol
- 2 - The + sign is placed after the quantity and currency symbol
- 3 - The + sign is placed immediately in front of the currency symbol
- 4 - The + sign is placed immediately after the currency symbol
[n_sign_posn] - Formatting options:
- 0 - Parentheses surround the quantity and currency symbol
- 1 - The - sign is placed in front of the quantity and currency symbol
- 2 - The - sign is placed after the quantity and currency symbol
- 3 - The - sign is placed immediately in front of the currency symbol
- 4 - The - sign is placed immediately after the currency symbol
[grouping] - Array displaying how numbers are grouped (example: 3 indicates 1 000 000)
[mon_grouping] - Array displaying how monetary numbers are grouped (example: 2 indicates 1 00 00 00)

Tip: To define locale settings, see the setlocale() function.

Tip: To view all available language codes, go to our Language code reference.

Syntax

localeconv()

Technical Details

Return Value:	Returns data based upon the current locale as set by setlocale()
PHP Version:	4.0.5+

❮ PHP String Reference