BigInt.prototype.toLocaleString()

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

Синтаксис

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

Параметри

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

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

Повертає

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

Швидкодія

При форматуванні великої кількості чисел краще створити об'єкт NumberFormat та використовувати функцію, надану його властивістю 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

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

Специфікація
ECMAScript (ECMA-262)
The definition of 'BigInt.prototype.toLocaleString()' in that specification.
ECMAScript Internationalization API (ECMA-402)
The definition of 'BigInt.prototype.toLocaleString()' in that specification.

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

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung InternetNode.js
toLocaleStringChrome Full support 67Edge Full support 79Firefox Full support 68IE No support NoOpera Full support 54Safari Full support 14WebView Android Full support 67Chrome Android Full support 67Firefox Android Full support 68Opera Android Full support 48Safari iOS Full support 14Samsung Internet Android Full support 9.0nodejs Full support 10.4.0
localesChrome Full support 76Edge Full support 79Firefox Full support 70IE No support NoOpera No support NoSafari Full support 14WebView Android Full support 76Chrome Android Full support 76Firefox Android No support NoOpera Android Full support 54Safari iOS Full support 14Samsung Internet Android No support Nonodejs No support No
optionsChrome Full support 76Edge Full support 79Firefox Full support 70IE No support NoOpera No support NoSafari Full support 14WebView Android Full support 76Chrome Android Full support 76Firefox Android No support NoOpera Android Full support 54Safari iOS Full support 14Samsung Internet Android No support Nonodejs No support No

Legend

Full support  
Full support
No support  
No support

Див. також