Traducción en curso

El método toLocaleLowerCase() retorna la cadena de texto desde la que se llama convertida en minúsculas, de acuerdo con cualquier localización específica de correspondencia de mayúsculas y minúsculas.
 

Sintaxis

str.toLocaleLowerCase()
str.toLocaleLowerCase(locale) 
str.toLocaleLowerCase([locale, locale, ...])

Parámetros

locale Optional
El parámetro locale indica la localización que se utilizará para convertir a minúsculas de acuerdo con culalquier correspondencia de mayúsculas y minúsculas. Si se proporcionan múltiples locales en un Array, se utiliza el mejor local disponible. La localización por defecto es la localización actual configurada en el host.

Valor retornado

Una nueva cadena que representa la cadena desde la que se llama convertida a minúsculas, de acuerdo con cualquier localización específica de correspondencia de mayúsculas y minúsculas.

Excepciones

  • Una excepción de tipo RangeError ("invalid language tag: xx_yy") se lanzará si el argumento locale no es una etiqueta válida de lenguaje.
  • Una excepción de tipo TypeError ("invalid element in locales argument") se lanzará si un elemento del arreglo no es del tipo cadena.

Descripción

El método toLocaleLowerCase() retorna la cadena de texto desde la que se llama convertida en minúsculas, de acuerdo con cualquier localización específica de correspondencia de mayúsculas y minúsculas.  toLocaleLowerCase() no afecta el valor de la cadena desde la que se llama. En la mayoría de los casos, producirá el mismo resultado que toLowerCase(), pero para algunos locales, como el turco, cuyas correspondencias de mayúsculas y minúsculas no siguen las correpsondencias por defecto de Unicode, podría producir de un resultado diferente.

Ejemplos

Utilizando toLocaleLowerCase()

'ALPHABET'.toLocaleLowerCase(); // 'alphabet'

'\u0130'.toLocaleLowerCase('tr') === 'i';    // true
'\u0130'.toLocaleLowerCase('en-US') === 'i'; // false

let locales = ['tr', 'TR', 'tr-TR', 'tr-u-co-search', 'tr-x-turkish'];
'\u0130'.toLocaleLowerCase(locales) === 'i'; // true

Especificaciones

Especificación Estatus 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.toLocaleLowerCase' en esta especificación.
Standard  
ECMAScript 2015 (6th Edition, ECMA-262)
La definición de 'String.prototype.toLocaleLowerCase' en esta especificación.
Standard  
ECMAScript Latest Draft (ECMA-262)
La definición de 'String.prototype.toLocaleLowerCase' en esta especificación.
Draft  
ECMAScript Internationalization API 4.0 (ECMA-402)
La definición de 'String.prototype.toLocaleLowerCase' en esta especificación.
Draft ES Intl 2017 added the locale parameter.

Compatibilidad entre navegadores

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidiOS SafariSamsung InternetNode.js
Soporte básicoChrome Soporte completo SiEdge Soporte completo SiFirefox Soporte completo 1IE Soporte completo SiOpera Soporte completo SiSafari Soporte completo SiWebView Android Soporte completo SiChrome Android Soporte completo SiEdge Mobile Soporte completo SiFirefox Android Soporte completo 4Opera Android Soporte completo SiSafari iOS Soporte completo SiSamsung Internet Android Soporte completo Sinodejs Soporte completo Si
localeChrome ? Edge ? Firefox Soporte completo 55IE ? Opera ? Safari ? WebView Android ? Chrome Android ? Edge Mobile ? Firefox Android Soporte completo 55Opera Android ? Safari iOS ? Samsung Internet Android ? nodejs ?

Leyenda

Soporte completo  
Soporte completo
Compatibility unknown  
Compatibility unknown

Vea también

Etiquetas y colaboradores del documento

Colaboradores en esta página: MarkCBB
Última actualización por: MarkCBB,