localeconv

(PHP 4 >= 4.0.5, PHP 5, PHP 7)

localeconvObtener información sobre el formato numérico

Descripción

localeconv ( void ) : array

Devuelve una matriz asociativa que contiene información de los formatos numérico y monetario, localizados.

Valores devueltos

localeconv() devuelve información basada en la localidad actual, tal y como haya sido definida mediante setlocale(). La matriz asociativa que devuelve contiene los siguientes campos:

Elemento de la matriz Descripción
decimal_point Caracter de punto decimal
thousands_sep Separador de miles
grouping Matriz que contiene agrupaciones numéricas
int_curr_symbol Símbolo internacional de moneda (i.e. USD)
currency_symbol Símbolo local de moneda (i.e. $)
mon_decimal_point Caracter de punto decimal monetario
mon_thousands_sep Separador de miles monetario
mon_grouping Matriz que contiene agrupaciones de moneda
positive_sign Signo para valores positivos
negative_sign Signo para valores negativos
int_frac_digits Dígitos fraccionarios internacionales
frac_digits Dígitos fraccionarios locales
p_cs_precedes TRUE si currency_symbol precede un valor positivo, FALSE si lo sucede
p_sep_by_space TRUE si un espacio separa currency_symbol de un valor positivo, FALSE de lo contrario
n_cs_precedes TRUE si currency_symbol precede un valor negativo, FALSE si lo sucede
n_sep_by_space TRUE si un espacio separa currency_symbol de un valor negativo, FALSE de lo contrario
p_sign_posn
  • 0 - Paréntesis rodean la cantidad y currency_symbol
  • 1 - La cadena de signo precede la cantidad y currency_symbol
  • 2 - La cadena de signo sucede la cantidad y currency_symbol
  • 3 - La cadena de signo precede inmediatamente currency_symbol
  • 4 - La cadena de signo sucede inmediatamente currency_symbol
n_sign_posn
  • 0 - Paréntesis rodean la cantidad y currency_symbol
  • 1 - La cadena de signo precede la cantidad y currency_symbol
  • 2 - La cadena de signo sucede la cantidad y currency_symbol
  • 3 - La cadena de signo precede inmediatamente currency_symbol
  • 4 - La cadena de signo sucede inmediatamente currency_symbol

Los valores de p_sign_posn y n_sign_posn contienen una cadena de opciones de formato. Cada número representa una de las condiciones listadas anteriormente.

Los campos de agrupamiento contienen matrices que definen el modo en que los números deben ser agrupados. Por ejemplo, el campo de agrupamiento monetario para la localidad nl_NL (en modo UTF-8 con el signo de euro), tendría una matriz de 2 elementos con los valores 3 y 3. Entre más alto sea el índice dentro de la matriz, lo más lejos hacia la izquierda se encuentra el agrupamiento. Si un elemento de la matriz es igual a CHAR_MAX, no se realiza ningún agrupamiento posterior. Si un elemento de la matriz es igual a 0, el elemento anterior deberá ser usado.

Ejemplos

Ejemplo #1 Ejemplo de localeconv()

<?php
if (false !== setlocale(LC_ALL'nl_NL.UTF-8@euro')) {
    
$info_localidad localeconv();
    
print_r($info_localidad);
}
?>

El resultado del ejemplo sería:

Array
(
    [decimal_point] => .
    [thousands_sep] =>
    [int_curr_symbol] => EUR
    [currency_symbol] => €
    [mon_decimal_point] => ,
    [mon_thousands_sep] =>
    [positive_sign] =>
    [negative_sign] => -
    [int_frac_digits] => 2
    [frac_digits] => 2
    [p_cs_precedes] => 1
    [p_sep_by_space] => 1
    [n_cs_precedes] => 1
    [n_sep_by_space] => 1
    [p_sign_posn] => 1
    [n_sign_posn] => 2
    [grouping] => Array
        (
        )

    [mon_grouping] => Array
        (
            [0] => 3
            [1] => 3
        )

)

Ver también

  • setlocale() - Establecer la información del localismo