From 95aca4b4d8fa62815d4bd412fff1a364f842814a Mon Sep 17 00:00:00 2001 From: Ryan Johnson Date: Thu, 29 Apr 2021 16:16:42 -0700 Subject: remove retired locales (#699) --- .../number/tolocalestring/index.html | 155 --------------------- 1 file changed, 155 deletions(-) delete mode 100644 files/uk/web/javascript/reference/global_objects/number/tolocalestring/index.html (limited to 'files/uk/web/javascript/reference/global_objects/number/tolocalestring') diff --git a/files/uk/web/javascript/reference/global_objects/number/tolocalestring/index.html b/files/uk/web/javascript/reference/global_objects/number/tolocalestring/index.html deleted file mode 100644 index ad76c974b3..0000000000 --- a/files/uk/web/javascript/reference/global_objects/number/tolocalestring/index.html +++ /dev/null @@ -1,155 +0,0 @@ ---- -title: Number.prototype.toLocaleString() -slug: Web/JavaScript/Reference/Global_Objects/Number/toLocaleString -tags: - - JavaScript - - Number - - Інтернаціоналізація - - метод - - прототип -translation_of: Web/JavaScript/Reference/Global_Objects/Number/toLocaleString -original_slug: Web/JavaScript/Reference/Global_Objects/Число/toLocaleString ---- -
{{JSRef}}
- -

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

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

Синтаксис

- -
numObj.toLocaleString([locales [, options]])
- -

Параметри

- -

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

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

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

- -

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

- -

Швидкодія

- -

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

- -

Приклади

- -

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

- -

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

- -
var number = 3500;
-
-console.log(number.toLocaleString()); // Відображає "3,500" у форматі U.S. English
-
- -

Перевірка підтримки аргументів locales та options

- -

Аргументи locales та options ще не підтримуються в усіх переглядачах. Для перевірки їхньої підтримки у ES5.1 та новіших реалізаціях можна скористатись вимогою, згідно якої недозволені мовні позначення відхиляються з винятком {{jsxref("Global_Objects/RangeError", "RangeError")}}:

- -
function toLocaleStringSupportsLocales() {
-  var number = 0;
-  try {
-    number.toLocaleString('i');
-  } catch (e) {
-    return e.name === 'RangeError';
-  }
-  return false;
-}
-
- -

До ES5.1, реалізації не були зобов'язані викидати виняток з помилкою діапазону, якщо toLocaleString викликався з аргументами.

- -

Перевірка, яка працює в усіх хостах, в тому числі тих, що підтримують ECMA-262 до версії 5.1, полягає в безпосередньому тестуванні функцій, визначених у ECMA-402 як такі, що зобов'язані підтримувати регіональні налаштування для Number.prototype.toLocaleString:

- -
function toLocaleStringSupportsOptions() {
-  return !!(typeof Intl == 'object' && Intl && typeof Intl.NumberFormat == 'function');
-}
-
- -

Цей код перевіряє наявність глобального об'єкта Intl, перевіряє, що він не дорівнює null та що він має властивість NumberFormat, яка є функцією.

- -

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

- -

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

- -
var number = 123456.789;
-
-// В німецькій десятковим роздільником є кома, а крапка розділяє тисячі
-console.log(number.toLocaleString('de-DE'));
-// → 123.456,789
-
-// Арабська у більшості арабськомовних країн використовує Індо-арабські цифри
-console.log(number.toLocaleString('ar-EG'));
-// → ١٢٣٤٥٦٫٧٨٩
-
-// Індія використовує роздільники тисячі/лакх/крор
-console.log(number.toLocaleString('en-IN'));
-// → 1,23,456.789
-
-// ключ розширення nu налаштовує систему нумерації, наприклад, китайську десяткову
-console.log(number.toLocaleString('zh-Hans-CN-u-nu-hanidec'));
-// → 一二三,四五六.七八九
-
-// при запиті мови, яка, можливо, не підтримується, наприклад,
-// балійської, додайте запасні мови, в даному випадку це індонезійська
-console.log(number.toLocaleString(['ban', 'id']));
-// → 123.456,789
- -

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

- -

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

- -
var number = 123456.789;
-
-// налаштування формату валюти
-console.log(number.toLocaleString('de-DE', { style: 'currency', currency: 'EUR' }));
-// → 123.456,79 €
-
-// японська єна не використовує дробові розряди
-console.log(number.toLocaleString('ja-JP', { style: 'currency', currency: 'JPY' }))
-// → ￥123,457
-
-// обмежити трьома значущими цифрами
-console.log(number.toLocaleString('en-IN', { maximumSignificantDigits: 3 }));
-// → 1,23,000
-
-// Використовувати мову системи з параметрами для форматування чисел
-var num = 30000.65;
-console.log(num.toLocaleString(undefined, {minimumFractionDigits: 2, maximumFractionDigits: 2}));
-// → "30,000.65" де мова системи англійська, або
-// → "30.000,65" де мова системи німецька, або
-// → "30 000,65" де мова системи французька
-
- -

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

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

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

- - - -

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

- -

Див. також

- - -- cgit v1.2.3-54-g00ecf