--- title: BigInt.prototype.toLocaleString() slug: Web/JavaScript/Reference/Global_Objects/BigInt/toLocaleString tags: - BigInt - Intl - JavaScript - Інтернаціоналізація - метод translation_of: Web/JavaScript/Reference/Global_Objects/BigInt/toLocaleString ---
{{JSRef}}

Метод toLocaleString() повертає рядок, що відображає об'єкт BigInt у відповідності до налаштувань мови.

{{EmbedInteractiveExample("pages/js/bigint-tolocalestring.html")}}

Синтаксис

bigIntObj.toLocaleString([locales [, options]])

Параметри

Аргументи locales та options налаштовують поведінку функції та дозволяють застосункам вказувати мову, чиї правила форматування мають застосовуватись. У тих реалізаціях, які ігнорують аргументи locales та options, локальні налаштування та форма поверненого рядка повністю залежать від реалізації.

Дивіться конструктор Intl.NumberFormat(), щоб дізнатись подробиці щодо цих параметрів та їхнього використання.

Повертає

Рядок, що відображає надане значення BigInt у відповідності до налаштувань мови.

Швидкодія

При форматуванні великої кількості чисел краще створити об'єкт {{jsxref("NumberFormat")}} та використовувати функцію, надану його властивістю {{jsxref("NumberFormat.format")}}.

Приклади

Використання toLocaleString

При загальному використанні, без зазначення мови, повертається рядок у мовному форматі, що стоїть за замовчуванням та з початковими параметрами.

var bigint = 3500n;

bigint.toLocaleString();
// Відображає "3,500" у форматі U.S. English

Використання locales

Цей приклад демонструє деякі варіації локалізованих форматів чисел. Щоб отримати формат мови, задіяної в інтерфейсі вашого застосутку, переконайтесь, що вказали цю мову (та, можливо, кілька запасних мов) за допомогою аргументу locales:

var bigint = 123456789123456789n;

// В німецькій мові крапка розділяє тисячі
console.log(bigint.toLocaleString('de-DE'));
// → 123.456.789.123.456.789

// Арабська у більшості арабськомовних країн використовує Індо-арабські цифри
console.log(bigint.toLocaleString('ar-EG'));
// → ١٢٣٬٤٥٦٬٧٨٩٬١٢٣٬٤٥٦٬٧٨٩

// Індія використовує роздільники тисячі/лакх/крор
console.log(bigint.toLocaleString('en-IN'));
// → 1,23,45,67,89,12,34,56,789

// ключ розширення nu налаштовує систему нумерації, наприклад, китайську десяткову
console.log(bigint.toLocaleString('zh-Hans-CN-u-nu-hanidec'));
// → 一二三,四五六,七八九,一二三,四五六,七八九

// при запиті мови, яка, можливо, не підтримується, наприклад,
// балійської, додайте запасні мови, в даному випадку це індонезійська
console.log(bigint.toLocaleString(['ban', 'id']));
// → 123.456.789.123.456.789

Використання options

Результат методу toLocaleString можна налаштувати за допомогою аргументу options:

var bigint = 123456789123456789n;

// налаштування формату валюти
console.log(bigint.toLocaleString('de-DE', { style: 'currency', currency: 'EUR' }));
// → 123.456.789.123.456.789,00 €

// японська єна не використовує дробові розряди
console.log(bigint.toLocaleString('ja-JP', { style: 'currency', currency: 'JPY' }))
// → ￥123,456,789,123,456,789

// обмежити трьома значущими цифрами
console.log(bigint.toLocaleString('en-IN', { maximumSignificantDigits: 3 }));
// → 1,23,00,00,00,00,00,00,000

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

Специфікація
{{SpecName('ESDraft', '#sec-bigint.prototype.tolocalestring', 'BigInt.prototype.toLocaleString()')}}
{{SpecName('ES Int Draft', '#sup-bigint.prototype.tolocalestring', 'BigInt.prototype.toLocaleString()')}}

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

{{Compat("javascript.builtins.BigInt.toLocaleString")}}

Див. також