String.prototype.toLocaleUpperCase()

This translation is incomplete. Please help translate this article from English

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 un Array, 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

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome para AndroidFirefox para AndroidOpera para AndroidSafari en iOSSamsung InternetNode.js
toLocaleUpperCaseChrome Soporte completo 1Edge Soporte completo 12Firefox Soporte completo 1IE Soporte completo 5.5Opera Soporte completo 4Safari Soporte completo 1.3WebView Android Soporte completo 1Chrome Android Soporte completo 18Firefox Android Soporte completo 4Opera Android Soporte completo 10.1Safari iOS Soporte completo 1Samsung Internet Android Soporte completo 1.0nodejs Soporte completo 0.1.100
localeChrome Soporte completo 58Edge Soporte completo 12Firefox Soporte completo 55IE Soporte completo 6Opera Soporte completo 45Safari Soporte completo 10WebView Android Soporte completo 58Chrome Android Soporte completo 58Firefox Android Soporte completo 55Opera Android Soporte completo 42Safari iOS Soporte completo 10Samsung Internet Android Soporte completo 7.0nodejs Soporte completo 13.0.0
Soporte completo 13.0.0
Soporte parcial 0.12
Notas
Notas Before version 13.0.0, only the locale data for en-US is available by default. When other locales are specified, the function silently falls back to en-US. To make full ICU (locale) data available for versions prior to 13, see Node.js documentation on the --with-intl option and how to provide the data.

Leyenda

Soporte completo  
Soporte completo
Ver notas de implementación.
Ver notas de implementación.

Ver también