Метод 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
Приклади
Заміщення 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"
Специфікації
Специфікація |
---|
ECMAScript (ECMA-262) The definition of 'Object.prototype.toLocaleString' in that specification. |
Сумісність з веб-переглядачами
BCD tables only load in the browser