String.prototype.toLocaleLowerCase()

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.

Pruébalo

Los fuentes para este ejemplo interactivo están almacenados en un repositorio GitHub. Si quieres contribuir en el proyecto de ejemplos interactivos, por favor clona https://github.com/mdn/interactive-examples y envíanos un pull request.

Sintaxis

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

Parámetros

locale Opcional

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()

js
"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

Specification
ECMAScript Language Specification
# sec-string.prototype.tolocalelowercase
ECMAScript Internationalization API Specification
# sup-string.prototype.tolocalelowercase

Compatibilidad con navegadores

BCD tables only load in the browser

Vea también