String.prototype.toLocaleUpperCase()
El método toLocaleUpperCase()
devuelve el valor de la cadena que lo llama convertido en mayúsculas, de acuerdo con las asignaciones de casos específicos de la configuración regional.
Syntaxis
str.toLocaleUpperCase() str.toLocaleUpperCase(locale) str.toLocaleUpperCase([locale, locale, ...])
Parámetros
locale
Optional- El parámetro
locale
indica la configuración regional que se va a utilizar para convertir en mayúsculas según las asignaciones de casos específicos de la configuración regional. Si se proporcionan varios locales en unArray
, se utiliza la mejor configuración regional disponible. La configuración regional predeterminada es la configuración regional actual del entorno de host.
Valor de retorno
Una nueva cadena que representa la cadena de llamada convertida en mayúsculas, de acuerdo con cualquier asignación de mayúsculas de idioma específico.
Exceciones
- Un
RangeError
("invalid language tag: xx_yy") se arroja si un argumento de configuración regional no es una etiqueta de idioma válida. - Un
TypeError
("invalid element in locales argument") se lanzará si un elemento de matriz no es de tipo cadena.
Descripción
El método toLocaleUpperCase()
devuelve el valor de la cadena convertida en mayúsculas según las asignaciones de casos específicos de la configuración regional. toLocaleUpperCase()
no afecta al valor de la cadena en sí. En la mayoría de los casos, esto producirá el mismo resultado que toUpperCase()
, pero para algunas localidades, como turco, cuyas asignaciones de mayúsculas y minúsculas no siguen la mayúsculas y minúsculas en Unicode, puede haber un resultado diferente.
Ejemplos
Usando toLocaleUpperCase()
'alphabet'.toLocaleUpperCase(); // 'ALPHABET'
'i\u0307'.toLocaleUpperCase('lt-LT'); // 'I'
let locales = ['lt', 'LT', 'lt-LT', 'lt-u-co-phonebk', 'lt-x-lietuva'];
'i\u0307'.toLocaleUpperCase(locales); // 'I'
Especificaciones
Especificación | Status | Comentario |
---|---|---|
ECMAScript 3rd Edition (ECMA-262) | Standard | Initial definition. Implemented in JavaScript 1.2. |
ECMAScript 5.1 (ECMA-262) La definición de 'String.prototype.toLocaleUpperCase' en esta especificación. |
Standard | |
ECMAScript 2015 (6th Edition, ECMA-262) La definición de 'String.prototype.toLocaleUpperCase' en esta especificación. |
Standard | |
ECMAScript (ECMA-262) La definición de 'String.prototype.toLocaleUpperCase' en esta especificación. |
Living Standard | |
ECMAScript Internationalization API (ECMA-402) La definición de 'String.prototype.toLocaleUpperCase' en esta especificación. |
Living Standard | ES Intl 2017 added the locale parameter. |
Compatibilidad de navegadores
BCD tables only load in the browser
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.