Array.prototype.toLocaleString()

BaselineWidely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

toLocaleString() 메서드는 배열의 요소를 나타내는 문자열을 반환합니다. 요소는toLocaleString 메서드를 사용하여 문자열로 변환되고 이 문자열은 locale 고유 문자열(가령 쉼표 ",")에 의해 분리됩니다.

시도해 보기

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]]);

매개변수

localesOptional: A string with a BCP 47 language tag, or an array of such strings. For the general form and interpretation of thelocales argument, see theIntl page.
optionsOptional: An object with configuration properties, for numbers seeNumber.prototype.toLocaleString(), and for dates seeDate.prototype.toLocaleString().

반환 값

배열의 요소를 표현하는 문자열.

설명

배열의 요소는toLocaleString 메서드를 사용하여 문자열로 변환됩니다:

Object:Object.prototype.toLocaleString()
Number:Number.prototype.toLocaleString()
Date:Date.prototype.toLocaleString()

예제

`toLocaleString` 사용

var number = 1337;var date = new Date();var myArr = [number, date, "foo"];var str = myArr.toLocaleString();console.log(str);// '1337,6.12.2013 19:37:35,foo' 출력(log)// Europe/Berlin 시간대로 German (de-DE) locale에서 실행하는 경우

폴리필

// https://tc39.github.io/ecma402/#sup-array.prototype.tolocalestringif (!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;    },  });}

명세

Specification
ECMAScript® 2026 Language Specification # sec-array.prototype.tolocalestring
ECMAScript® 2026 Internationalization API Specification # sup-array.prototype.tolocalestring