Object.prototype.toLocaleString() - JavaScript

Object.assign()
Object.entries()
Object.getOwnPropertyDescriptors()
Object.groupBy()
Object.isFrozen()
Object.seal()
Object.prototype.__defineGetter__() Deprecated
Object.prototype.__defineSetter__() Deprecated
Object.prototype.__lookupGetter__() Deprecated
Object.prototype.__lookupSetter__() Deprecated
Object.prototype.toLocaleString()
Object.prototype.__proto__ Deprecated
Function.prototype.bind()
Function: displayName Non-standard
Function.prototype.arguments Non-standard Deprecated
Function.prototype.caller Non-standard Deprecated

Instance methods

Object.prototype.__defineGetter__() Deprecated
Object.prototype.__defineSetter__() Deprecated
Object.prototype.__lookupGetter__() Deprecated
Object.prototype.__lookupSetter__() Deprecated
Object.prototype.toLocaleString()
Object.prototype.__proto__ Deprecated
Object instances returns a string representing this object. This method is meant to be overridden by derived objects for locale-specific purposes.

Try it

const date1 = new Date(Date.UTC(2012, 11, 20, 3, 0, 0));

console.log(date1.toLocaleString("ar-EG"));
/ Expected output: "٢٠‏/١٢‏/٢٠١٢ ٤:٠٠:٠٠ ص"

const number1 = 123456.789;

console.log(number1.toLocaleString("de-DE"));
/ Expected output: "123.456,789"

Syntax

toLocaleString()

Parameters

None. However, all objects that override this method are expected to accept at most two parameters, corresponding to locales and options, such as this.toString().

This function is provided to give objects a generic toLocaleString method, even though not all may use it. In the core language, these built-in objects override toLocaleString to provide locale-specific formatting:

Examples

Using the base toLocaleString() method

The base toLocaleString() method simply calls toString().

const obj = {
  toString() {
    return "My Object";
  },
};
console.log(obj.toLocaleString()); / "My Object"

Array toLocaleString() override

Array.prototype.toLocaleString() is used to print array values as a string by invoking each element's toLocaleString() method and joining the results with a locale-specific separator. For example:

const testArray = [4, 7, 10];

const euroPrices = testArray.toLocaleString("fr", {
  style: "currency",
  currency: "EUR",
});
/ "4,00 €,7,00 €,10,00 €"

Date toLocaleString() override

Date.prototype.toLocaleString() is used to print out date displays more suitable for specific locales. For example:

const testDate = new Date();
/ "Fri May 29 2020 18:04:24 GMT+0100 (British Summer Time)"

const deDate = testDate.toLocaleString("de");
/ "29.5.2020, 18:04:24"

const frDate = testDate.toLocaleString("fr");
/ "29/05/2020, 18:04:24"

Number toLocaleString() override

Number.prototype.toLocaleString() is used to print out number displays more suitable for specific locales, e.g., with the correct separators. For example:

const testNumber = 2901234564;
/ "2901234564"

const deNumber = testNumber.toLocaleString("de");
/ "2.901.234.564"

const frNumber = testNumber.toLocaleString("fr");
/ "2 901 234 564"

Specifications

Specification
ECMAScript® 2026 Language Specification # sec-object.prototype.tolocalestring