Object.prototype.toLocaleString()

Метод toLocaleString() повертає рядок, що відображає об'єкт. Цей метод призначений, щоб бути заміщеним у похідних об'єктах для специфічних задач щодо локалі.

The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.

Синтаксис

obj.toLocaleString()

Значення, що повертається

Рядок, що відображає об'єкт.

Опис

Метод об'єкта toLocaleString повертає результат виклику toString().

Ця функція надана, щоб дати об'єктам загальний метод toLocaleString, хоча не усі його використовуватимуть. Дивіться наведений нижче список.

Об'єкти, які заміщують toLocaleString

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

Приклади

Заміщення toLocaleString() у масиві

На об'єктах Array, toLocaleString() може використовуватись для виводу масиву значень у вигляді рядка, з необов'язковим додаванням специфічних мовних ідентифікаторів (наприклад, символів валюти):

Наприклад:

const testArray = [4, 7, 10];

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

Заміщення toLocaleString() у об'єктах Date

На об'єктах Date, toLocaleString() використовується для виводу дати згідно особливостей мовних налаштувань:

Наприклад:

const testDate = new Date(Date.now());
// "Date Fri May 29 2020 18:04:24 GMT+0100 (Британський літній час)"

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

var frDate = testDate.toLocaleString('fr');
//"29/05/2020 à 18:04:24"

Заміщення toLocaleString() у об'єктах Number

На об'єктах Number , toLocaleString() використовується для виводу чисел згідно особливостей мовних налаштувань, наприклад, з правильними роздільниками:

Наприклад:

const testNumber = 2901234564;
// "2901234564"

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

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

Специфікації

Сумісність з веб-переглядачами

Див. також

• Object.prototype.toString()