translation(JS): Web/JavaScript/Reference/Global_Objects/Date/toLocal…

…eDateString (#1030)

* translation(JS): Web/JavaScript/Reference/Global_Objects/Date/toLocaleDateString

* Apply suggestions from code review

Co-authored-by: Vitalii Perehonchuk <[email protected]>

Co-authored-by: Vitalii Perehonchuk <[email protected]>

files/uk/web/javascript/reference/global_objects/date/tolocaledatestring/index.md

@@ -0,0 +1,169 @@
+---
+title: Date.prototype.toLocaleDateString()
+slug: Web/JavaScript/Reference/Global_Objects/Date/toLocaleDateString
+tags:
+  - Date
+  - IANA Timezone Format
+  - Internationalization
+  - JavaScript
+  - Method
+  - Prototype
+  - Reference
+browser-compat: javascript.builtins.Date.toLocaleDateString
+---
+
+{{JSRef}}
+
+Метод **`toLocaleDateString()`** повертає рядок із чутливим до мови відображенням тієї частини вказаної дати, яка містить лише календарну дату, в часовому поясі користувацького агента. В тих реалізаціях, що мають підтримку [API `Intl.DateTimeFormat`](/uk/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat), цей метод просто викликає `Intl.DateTimeFormat`.
+
+{{EmbedInteractiveExample("pages/js/date-tolocaledatestring.html")}}
+
+## Синтаксис
+
+```js-nolint
+toLocaleDateString()
+toLocaleDateString(locales)
+toLocaleDateString(locales, options)
+```
+
+### Параметри
+
+Аргументи `locales` та `options` підлаштовують поведінку функції, і дають застосункам змогу задати ту мову, чиї правила форматування слід застосувати.
+
+В тих реалізаціях, які підтримують [API `Intl.DateTimeFormat`](/uk/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat), ці параметри чітко відповідають параметрам конструктора [`Intl.DateTimeFormat()`](/uk/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/DateTimeFormat). Від реалізацій, що не мають підтримки `Intl.DateTimeFormat`, вимагається ігнорувати обидва параметри, що робить вжиту локаль та форму поверненого рядка цілковито залежною від реалізацій.
+
+- `locales` {{optional_inline}}
+
+  - : Рядок із позначенням мови у форматі BCP 47, або масив таких рядків. Відповідає параметрові [`locales`](/uk/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/DateTimeFormat#locales) конструктора `Intl.DateTimeFormat()`.
+
+    В тих реалізаціях, що не мають підтримки `Intl.DateTimeFormat`, цей параметр ігнорується, і зазвичай використовується локаль хоста.
+
+- `options` {{optional_inline}}
+
+  - : Об'єкт, що підлаштовує формат виводу. Відповідає параметрові [`options`](/uk/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/DateTimeFormat#options) конструктора `Intl.DateTimeFormat()`. Опція `timeStyle` повинна залишатися невизначеною — інакше викидатиметься виняток {{jsxref("TypeError")}}. Якщо невизначеними є всі опції: `weekday`, `year`, `month`, та `day` — то значеннями `year`, `month`, і `day` буде встановлено `"numeric"`.
+
+    В реалізаціях без підтримки `Intl.DateTimeFormat` цей параметр ігнорується.
+
+Докладніше про ці параметри та про те, як їх використовувати — в розділі [Конструктор `Intl.DateTimeFormat()`](/uk/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/DateTimeFormat).
+
+### Повернене значення
+
+Рядок, що позначає ту частку переданого примірника {{jsxref("Global_Objects/Date", "Date")}}, яка містить дату, сформований згідно із притаманними мові правилами.
+
+В реалізаціях, що містять `Intl.DateTimeFormat`, це еквівалентно викликові `new Intl.DateTimeFormat(locales, options).format(date)`, де параметр `options` нормалізовано так, як описано вище.
+
+## Швидкодія
+
+Під час форматування великої кількості дат, краще створити окремий об'єкт [`Intl.DateTimeFormat`](/uk/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat), і використовувати його метод [`format()`](/uk/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/format).
+
+## Приклади
+
+### Застосування toLocaleDateString()
+
+В найпростішому випадку, без вказання конкретної локалі, буде повернено рядок, відформатований згідно з усталеними локаллю та опціями.
+
+```js
+const date = new Date(Date.UTC(2012, 11, 12, 3, 0, 0));
+
+// Без аргументів, toLocaleDateString() залежить від реалізації,
+// усталеної локалі та усталеного часового поясу
+console.log(date.toLocaleDateString());
+// "12/11/2012", якщо виконано в локалі en-US та часовому поясі America/Los_Angeles
+```
+
+### Перевірка підтримки аргументів locales та options
+
+Аргументи `locales` та `options` підтримуються поки не у всіх браузерах.
+Для перевірки, чи якась реалізація їх підтримує, можна скористатися перевіркою виконання вимоги відхиляти недійсні позначення мови із викиданням винятку {{jsxref("RangeError")}}:
+
+```js
+function toLocaleDateStringSupportsLocales() {
+  try {
+    new Date().toLocaleDateString("i");
+  } catch (e) {
+    return e.name === "RangeError";
+  }
+  return false;
+}
+```
+
+### Застосування локалей
+
+Цей приклад ілюструє деякі відмінності в локалізованих форматах дати.
+Аби отримати формат згідно з тією мовою, яка використана в користувацькому інтерфейсі застосунку, слід вказати її (разом із можливими запасними варіантами), використавши аргумент `locales`:
+
+```js
+const date = new Date(Date.UTC(2012, 11, 20, 3, 0, 0));
+
+// формати, наведені нижче з урахуванням припущення певного місцевого часового поясу локалі;
+// America/Los_Angeles для US
+
+// Американська англійська послуговується послідовністю місяць-день-рік
+console.log(date.toLocaleDateString("en-US"));
+// "12/20/2012"
+
+// В британській англійській вживають послідовність день-місяць-рік
+console.log(date.toLocaleDateString("en-GB"));
+// "20/12/2012"
+
+// Корея використовує порядок рік-місяць-день
+console.log(date.toLocaleDateString("ko-KR"));
+// "2012. 12. 20."
+
+// В разі перської мови, доволі складно вручну привести дату до сонячної хіджрі
+console.log(date.toLocaleDateString("fa-IR"));
+// "۱۳۹۱/۹/۳۰"
+
+// Араби в більшості арабомовних країн використовують справжні арабські цифри
+console.log(date.toLocaleDateString("ar-EG"));
+// "٢٠‏/١٢‏/٢٠١٢"
+
+// для японської локалі, застосунки можуть вирішити використовувати такий японський
+// календар, де 2012 рік був 24 роком епохи Хейсей
+console.log(date.toLocaleDateString("ja-JP-u-ca-japanese"));
+// "24/12/20"
+
+// в разі запиту мови, яка може не підтримуватись, наприклад — балійської,
+// варто додати запасну мову, в цьому випадку — індонезійську
+console.log(date.toLocaleDateString(["ban", "id"]));
+// "20/12/2012"
+```
+
+### Застосування опцій
+
+Результат, наданий методом `toLocaleDateString()`, можна налаштувати за допомогою аргументу `options`:
+
+```js
+const date = new Date(Date.UTC(2012, 11, 20, 3, 0, 0));
+
+// запитати день тижня разом із довгим форматом дати
+const options = {
+  weekday: "long",
+  year: "numeric",
+  month: "long",
+  day: "numeric",
+};
+console.log(date.toLocaleDateString("de-DE", options));
+// "Donnerstag, 20. Dezember 2012"
+
+// якийсь застосунок може вирішити вжити часовий пояс UTC, і явно показати це
+options.timeZone = "UTC";
+options.timeZoneName = "short";
+console.log(date.toLocaleDateString("en-US", options));
+// "Thursday, December 20, 2012, UTC"
+```
+
+## Специфікації
+
+{{Specifications}}
+
+## Сумісність із браузерами
+
+{{Compat}}
+
+## Дивіться також
+
+- [`Intl.DateTimeFormat`](/uk/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat)
+- {{jsxref("Date.prototype.toLocaleString()")}}
+- {{jsxref("Date.prototype.toLocaleTimeString()")}}
+- {{jsxref("Date.prototype.toString()")}}