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
Източници
- ECMAScript® 2024 Internationalization API Specification — Intl.DateTimeFormat.prototype.resolvedOptions
- ECMAScript Internationalization API Specification (living draft) — Intl.DateTimeFormat.prototype.resolvedOptions
- ECMAScript Internationalization API Specification (living draft) — CreateDateTimeFormat