| [ Web Proxy ] |
| Viewing: https://developer.mozilla.org/es/docs/Web/JavaScript/Reference/Global_Objects/Array/toLocaleString | [Back] [Original] |
Get to know MDN better
Esta pgina ha sido traducida del ingls por la comunidad. Aprende ms y nete a la comunidad de MDN Web Docs.
This feature is well established and works across many devices and browser versions. Its been available across browsers since julio de 2015.
El mtodo toLocaleString() devuelve una cadena de texto representando los elementos del array. Los elementos son convertidos a texto usando su mtodo toLocaleString y dichos Strings son separados por un caracter especfico para la localidad (como una coma para la separacin de decimales ",").
const array1 = [1, "a", new Date("21 Dec 1997 14:12:00 UTC")];
const localeString = array1.toLocaleString("en", { timeZone: "UTC" });
console.log(localeString);
// Expected output: "1,a,12/21/1997, 2:12:00 PM",
// This assumes "en" locale and UTC timezone - your results may vary
arr.toLocaleString([locales[, options]]);
locales OpcionalUna cadena de texto con una etiqueta de idioma BCP 47, o un array de dichos strings. Para la forma general e interpretacin the los argumentos locales, ver la pgina Intl.
options OpcionalUn objeto con las configuraciones, para nmeros ver Number.prototype.toLocaleString(), y para fechas ver Date.prototype.toLocaleString().
Una cadena de texto representando los elementos del array.
locales y optionsLos elementos del array son convertidos a strings usando sus mtodos toLocaleString.
Object: Object.prototype.toLocaleString()Number: Number.prototype.toLocaleString()Date: Date.prototype.toLocaleString()Siempre mostrar la moneda para los strings y nmeros en el array precios:
var precios = ["$7", 500, 8123, 12];
precios.toLocaleString("es-AR", { style: "currency", currency: "ARS" });
// "$7, $500, $8.123, $12"
Para ms ejemplos, ver tambin Intl, NumberFormat, y DateTimeFormat.
// https://tc39.github.io/ecma402/#sup-array.prototype.tolocalestring
if (!Array.prototype.toLocaleString) {
Object.defineProperty(Array.prototype, "toLocaleString", {
value: function (locales, options) {
// 1. Let O be ? ToObject(this value).
if (this == null) {
throw new TypeError('"this" is null or not defined');
}
var a = Object(this);
// 2. Let len be ? ToLength(? Get(A, "length")).
var len = a.length >>> 0;
// 3. Let separator be the String value for the
// list-separator String appropriate for the
// host environment's current locale (this is
// derived in an implementation-defined way).
// NOTE: In this case, we will use a comma
var separator = ",";
// 4. If len is zero, return the empty String.
if (len === 0) {
return "";
}
// 5. Let firstElement be ? Get(A, "0").
var firstElement = a[0];
// 6. If firstElement is undefined or null, then
// a.Let R be the empty String.
// 7. Else,
// a. Let R be ?
// ToString(?
// Invoke(
// firstElement,
// "toLocaleString",
// locales, options
// )
// )
var r =
firstElement == null
? ""
: firstElement.toLocaleString(locales, options);
// 8. Let k be 1.
var k = 1;
// 9. Repeat, while k < len
while (k < len) {
// a. Let S be a String value produced by
// concatenating R and separator.
var s = r + separator;
// b. Let nextElement be ? Get(A, ToString(k)).
var nextElement = a[k];
// c. If nextElement is undefined or null, then
// i. Let R be the empty String.
// d. Else,
// i. Let R be ?
// ToString(?
// Invoke(
// nextElement,
// "toLocaleString",
// locales, options
// )
// )
r =
nextElement == null
? ""
: nextElement.toLocaleString(locales, options);
// e. Let R be a String value produced by
// concatenating S and R.
r = s + r;
// f. Increase k by 1.
k++;
}
// 10. Return R.
return r;
},
});
}
Si necesitas soportar motores de JavaScript obsoletos que no compatibilizan con Object.defineProperty, es mejor no utilizar los mtodos Array.prototype, ya que no se pueden hacer no-enumerables.
| Specification |
|---|
| ECMAScript 2027 LanguageSpecification # sec-array.prototype.tolocalestring |
| ECMAScript 2027 Internationalization API Specification # sup-array.prototype.tolocalestring |
Array.prototype.toString()IntlObject.prototype.toLocaleString()Number.prototype.toLocaleString()Date.prototype.toLocaleString()This page was last modified on 29 may 2026 by MDN contributors.
ArrayArray.prototype.at()Array.prototype.concat()Array.prototype.copyWithin()Array.prototype.entries()Array.prototype.every()Array.prototype.fill()Array.prototype.filter()Array.prototype.find()Array.prototype.findIndex()findLast()findLastIndex()Array.prototype.flat()Array.prototype.flatMap()Array.prototype.forEach()Array.prototype.includes()Array.prototype.indexOf()Array.prototype.join()Array.prototype.keys()Array.prototype.lastIndexOf()Array.prototype.map()Array.prototype.pop()Array.prototype.push()Array.prototype.reduce()Array.prototype.reduceRight()Array.prototype.reverse()Array.prototype.shift()Array.prototype.slice()Array.prototype.some()Array.prototype.sort()Array.prototype.splice()Array.prototype.toLocaleString()toReversed()Array.prototype.toSorted()toSpliced()Array.prototype.toString()Array.prototype.unshift()Array.prototype.values()with()Array.prototype[@@iterator]()Object/FunctionYour blueprint for a better internet.
Portions of this content are 19982026 by individual mozilla.org contributors. Content available under a Creative Commons license.
| Web Proxy Viewer | New URL | Original Page |