A string representing the object.

Object's toLocaleString returns the result of calling toString().

This function is provided to give objects a generic toLocaleString method, even though not all may use it. See the list below.

• Array: Array.prototype.toLocaleString()
• Number: Number.prototype.toLocaleString()
• Date: Date.prototype.toLocaleString()
• TypedArray: TypedArray.prototype.toLocaleString()
• BigInt: BigInt.prototype.toLocaleString()

On Array objects, toLocaleString() can be used to print array values as a string, optionally with locale-specific identifiers (such as currency symbols) appended to them:

For example:

const testArray = [4, 7, 10];

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

On Date objects, toLocaleString() is used to print out date displays more suitable for specific locales:

For example:

const testDate = new Date(Date.now());
// "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"

On Number objects, 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"

• Object.prototype.toString()