Latest web development tutorials
 

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);
?>
Run example »

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