Nombres de configuración regional

Un nombre de configuración regional se basa en las convenciones de etiquetado de idioma de IETF BCP 47 ( Windows Vista y versiones posteriores) y se representa mediante LOCALE_SNAME. Por lo general, se usa el patrón <language>-<REGION> . Aquí, el idioma es un código de idioma ISO 639 en minúscula. Los códigos de ISO 639-1 se usan cuando están disponibles. De lo contrario, se usan códigos de ISO 639-2/T. REGION especifica un identificador de país o región ISO 3166-1 en mayúsculas. Por ejemplo, el nombre de configuración regional del inglés (Estados Unidos) es "en-US" y el nombre de configuración regional de Divehi (Maldivas) es "dv-MV".

Nota

La constante LOCALE_NAME_MAX_LENGTH proporciona la longitud máxima de un nombre de configuración regional. Incluye espacio para un carácter nulo de terminación.

Si la configuración regional es una configuración regional neutra (sin región), el valor de LOCALE_SNAME sigue el patrón <language>. Si es una configuración regional neutra para la que el script es significativo, el patrón es <language>-<Script>.

Si una configuración regional debe distinguirse de otra configuración regional para el mismo idioma y región mediante un script diferente, el valor de LOCALE_SNAME sigue el patrón <language>-<Script>-<REGION>, donde Script es un código de script ISO 15924 en mayúsculas inicial. Por ejemplo, el valor LOCALE_SNAME de la configuración regional específica Uzbek (latino, Uzbekistán) es "uz-Latn-UZ". El componente de script no se incluye en los casos en los que un lenguaje se escribe normalmente en un solo script.

Los pedidos de ordenación de las configuraciones regionales se designan mediante identificadores de criterio de ordenación, por ejemplo, SORT_DEFAULT. Para distinguir dos o más pedidos de ordenación para el mismo idioma y región, el nombre de la configuración regional sigue el patrón <language>-<REGION>\_<sort order>. Si debe distinguir el script y el criterio de ordenación, el nombre sigue el patrón <language>-<Script>-<REGION>\_<sort order>. El criterio de ordenación predeterminado nunca se especifica explícitamente, solo el criterio de ordenación alternativo. Por ejemplo, húngaro (Hungría) con SORT_DEFAULT o la SORT_HUNGARIAN_DEFAULT numéricamente equivalente se designa "hu-HU". Húngaro (Hungría) con orden de ordenación SORT_HUNGARIAN_TECHNICAL se designa "hu-HU_technl".

Para una configuración regional de reemplazo, el nombre de la configuración regional debe ser el mismo que el nombre de la configuración regional que se va a reemplazar. Para una configuración regional complementaria, el nombre de la configuración regional debe seguir el patrón de <language>-<REGION>-x-<custom> o <language>-<Script>-<REGION>-x-<custom>, donde <custom> es una cadena alfanumérica específica de la configuración regional complementaria. Por ejemplo, una configuración regional complementaria específica de una empresa llamada Fabricam podría denominarse "en-US-x-fabricam".

Una aplicación puede recuperar los nombres de configuración regional actuales mediante las funciones GetSystemDefaultLocaleName y GetUserDefaultLocaleName . Aunque cada subproceso puede recuperar y establecer su propio identificador de configuración regional con GetThreadLocale y establecerlo con SetThreadLocale, no hay funciones análogas para obtener y establecer la configuración regional por nombre.

Configuraciones regionales e idiomas

Configuraciones regionales personalizadas

Identificadores de configuración regional

Identificadores de criterio de ordenación