Documentación offline PHP master

Locale::canonicalize

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

Locale::canonicalize

locale_canonicalize

Canoniza la cadena que representa la configuración local

Descripción#

public static Locale::canonicalize(string $locale): string
```php

Convierte el string de configuración regional pasada al formato ICU.

Esto no necesariamente indica ni devuelve una configuración regional válida. Es solo una versión de la entrada que se ha estandarizado según las reglas de ICU.

El comportamiento de esta función depende de la versión de ICU que PHP esté utilizando (`INTL_ICU_VERSION`).

## Parámetros

`locale`  
String de configuración regional original.

## Valores devueltos

Cadena canonicalizada en la configuración local.

Devuelve `null` cuando la longitud de `locale` excede `INTL_MAX_LOCALE_LEN`.

## Ejemplos

Ejemplo de `locale_canonicalize`

echo Locale::canonicalize('en-US.utf8') . "\n"; echo Locale::canonicalize('totally-not-valid') . "\n";

```php

Resultado del ejemplo anterior es similar a:

en_US
totally_NOT_VALID