База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Intl.DateTimeFormat: проверка на действително използваните настройки

Използвай `resolvedOptions()`, за да провериш с какви настройки екземплярът действително форматира дата и час, вместо да ги извеждаш от аргументите на конструктора.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

formatter.resolvedOptions()

Intl.DateTimeFormat.prototype.resolvedOptions е метод на екземпляр, който не приема аргументи. Всяко извикване връща нов обикновен обект с настройките, определени при създаването на форматиращия обект. Промяната на резултата не променя форматиращия обект. За разлика от format(), методът не приема дата и не връща форматиран текст. Извикване без обвързване с екземпляра или с несъвместимо this, например {}, предизвиква TypeError.

Резултатът съдържа locale (действително избрания езиков етикет по BCP 47), calendar, numberingSystem и timeZone. Той не е копие на подаденото на конструктора: изборът сред поддържаните езикови и регионални настройки и стойностите по подразбиране могат да повлияят на резултата. Без изрично зададено timeZone форматиращият обект приема часовата зона по подразбиране на средата в момента на създаването си. Идентификаторът на зоната може да бъде нормализиран, затова не разчитай на точно съвпадение с подадения низ.

Без dateStyle и timeStyle свойства като year, month и hour отразяват избрания шаблон; неизползваните компоненти се пропускат. При dateStyle или timeStyle резултатът посочва заявените стилове, без да ги разбива на отделни компоненти. Съчетаването на стил с изрично зададена опция за компонент, например hour, предизвиква TypeError в конструктора.

Ако шаблонът включва час, резултатът съдържа hourCycle и изведеното от него hour12, дори когато заради timeStyle свойството hour отсъства. hour12 е true за h11 и h12 и false за h23 и h24. Ако шаблонът не включва час, и двете свойства се пропускат. При избора на цикъл опцията hour12 има предимство пред hourCycle и разширението на Unicode hc.

Използвай резултата, за да установиш причините за разлики между средите за изпълнение. Поддръжката на опции и данните за локализация могат да се различават, а еднаквите действителни настройки не гарантират еднакъв форматиран текст.

Примери

const formatter = new Intl.DateTimeFormat("en-GB", {
  timeZone: "UTC",
  timeStyle: "short",
  hour12: false,
});
const options = formatter.resolvedOptions();

console.log(options.timeZone);
console.log(options.timeStyle);
console.log(options.hour12);
console.log(Object.hasOwn(options, "hour"));

options.timeZone = "Asia/Tokyo";
console.log(formatter.resolvedOptions().timeZone);

Резултат

UTC
short
false
false
UTC

Кодът извежда последователно `UTC`, `short`, `false`, `false` и `UTC`. Първото `false` означава 24-часов формат, а второто — че обектът няма собствено свойство `hour`. Присвояването на `Asia/Tokyo` променя само върнатия обект.

Свързани уроци

  • JavaScript · Урок 25 · Напреднало · Версия: 4

Източници