PHP localeconv() Function

PHP String Reference : Find the United States locale numeric formatting information

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