La clase Locale

Introducción#

Una "Locale" es un identificador utilizado para representar los comportamientos regionales de una API. Las locales de PHP están organizadas e identificadas de la misma manera que los CLDR de ICU (y que muchos otros editores de sistemas Unix, tales como Mac, Java, etc.). Las locales se identifican por los etiquetados de lenguaje de la RFC 4646 (que utiliza guiones y no subrayados) además de la notación tradicional con subrayados. Salvo indicación contraria, las funciones de esta clase son capaces de utilizar las dos notaciones.

Ejemplos de identificadores: en-US (Inglés, EE.UU.), zh-Hant-TW (Chino, tradicional, Taiwán), fr-CA, fr-FR (Francés para Canadá y Francia, respectivamente)

La clase Locale y los métodos asociados, son utilizados para interactuar con los identificadores locales: para verificar que un identificador está bien formado, válido, etc. Las extensiones utilizadas por CDR en UAX #35 y heredadas por ICU son válidas, y utilizadas siempre que sea posible en ICU.

Las locales no pueden ser instanciadas. Todas son funciones estáticas.

La cadena null o vacía permite obtener la locale raíz. La raíz es el equivalente de "en_US_POSIX" en CLDR. Los etiquetados de lenguaje (y por lo tanto, los identificadores) no son sensibles a mayúsculas/minúsculas. Existe una función de canonalización que permite obtener la especificación exacta.

Sinopsis de la clase#

Locale

Constantes

public

const

int

Locale::ACTUAL_LOCALE

public

const

int

Locale::VALID_LOCALE

public

const

null

Locale::DEFAULT_LOCALE

null

public

const

string

Locale::LANG_TAG

public

const

string

Locale::EXTLANG_TAG

public

const

string

Locale::SCRIPT_TAG

public

const

string

Locale::REGION_TAG

public

const

string

Locale::VARIANT_TAG

public

const

string

Locale::GRANDFATHERED_LANG_TAG

public

const

string

Locale::PRIVATE_TAG

Métodos

Véase también#

RFC 4646 : etiquetados para identificar los idiomas, RFC 4647 : Coincidencia de etiquetados de idiomas, Proyecto Unicode CLDR: Repositorio Común de Datos de Localización, Registro de subtags de idiomas de IANA, Guía del usuario de ICU: Locale, API de Locale de ICU

Historial de cambios#

Versión	Descripción
8.4.0	Las constantes de clase ahora están tipadas.