PHP | Función setlocale()

La función setlocale() es una función incorporada en PHP que se utiliza para configurar la información de configuración regional. La configuración regional significa asignar a su sistema una ubicación geográfica y luego realizar ciertas funciones según la configuración regional del lugar. Por lo general, los programas que se ocupan de la fecha y la hora de otros lugares se ocupan de esto.
Sintaxis: 
 

setlocale( $category , $locale )

Valores de retorno: Devuelve la nueva configuración regional actual, o FALSO si la funcionalidad de la configuración regional no está implementada en su plataforma, la configuración regional especificada no existe o el nombre de la categoría no es válido.
Parámetro: Esta función acepta dos parámetros como se mencionó anteriormente y se describe a continuación:
 

• Categoría: Es un número entero llamado constante que especifica la categoría de las funciones afectadas por la configuración local: 
  • LC_ALL – para todo lo siguiente
  • LC_COLLATE – para comparación de strings
  • LC_CTYPE : para clasificación y conversión de caracteres
  • LC_MONETARY – para localeconv()
  • LC_NUMERIC – para separador decimal
  • LC_TIME : para formato de fecha y hora con strftime()
  • LC_MESSAGES -para respuestas del sistema
• Configuración regional: por lo general, una array de configuraciones regionales requeridas para las regiones especificadas. 
  • SI LOCALE ES NULL O LA CADENA VACÍA, los nombres de configuración regional se establecerán a partir de los valores de las variables de entorno con los mismos nombres que las categorías anteriores, o desde «LANG».
  • SI LOCALE ES «0»: la configuración de configuración regional no se ve afectada, solo se devuelve la configuración actual.
  • SI LOCALE ES UNA MATRIZ: la configuración de configuración regional no se ve afectada, solo se devuelve la configuración actual.

Los siguientes ejemplos ilustran la función setlocale() en PHP:
Ejemplo 1: Un programa simple para generar la hora definida por el lugar. 
 

<?php
 
// Setting locale to german
setlocale(LC_ALL,"de");
echo strftime("The current german time is %r");
 
// Setting locale to english
setlocale(LC_ALL,"en");
echo strftime(" and the current english time is %r");
?>

Producción: 
 

The current german time is 08:17:45 AM 
and the current english time is 08:17:45 AM

Ejemplo 2: programa para verificar qué nombre de configuración regional para alemán es compatible con el sistema. 
 

<?php
 
// Try different possible locale names for german
$loc_de = setlocale(LC_ALL, 'de_DE@euro', 'de_DE', 'deu_deu');
echo "Preferred locale for german on this system is '$loc_de'";
?>

Producción: 
 

Preferred locale for german on this system is 'German_Germany.1252'

Ejemplo 3: programa simple para usar LC_MONETARY 
 

<?php
 
// Setting locale to english
setlocale(LC_MONETARY,"en");
$loc=localeconv();
print_r($loc);
?>

Producción: 
 

Array
(
    [decimal_point] => .
    [thousands_sep] => 
    [int_curr_symbol] => 
    [currency_symbol] => 
    [mon_decimal_point] => 
    [mon_thousands_sep] => 
    [positive_sign] => 
    [negative_sign] => 
    [int_frac_digits] => 127
    [frac_digits] => 127
    [p_cs_precedes] => 127
    [p_sep_by_space] => 127
    [n_cs_precedes] => 127
    [n_sep_by_space] => 127
    [p_sign_posn] => 127
    [n_sign_posn] => 127
    [grouping] => Array
        (
        )

    [mon_grouping] => Array
        (
        )

)

Referencia: https://www.php.net/manual/en/function.setlocale.php