CKTIS / JavaScript
Date.prototype.toLocaleTimeString() — локализирано форматиране на часа
toLocaleTimeString() връща текстово представяне на часа на обект Date според избраната локализация и опциите. Позволява да зададете часовата зона, компонентите на часа и часовия цикъл, без да променяте датата.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
date.toLocaleTimeString(locales?, options?)Каталожният символ Date.toLocaleTimeString обозначава инстанционния метод Date.prototype.toLocaleTimeString, а не статичен метод на конструктора Date. Извикването date.toLocaleTimeString(locales, options) връща низ, без да променя date. Описаното тук поведение на параметрите важи за среди, които поддържат ECMA-402 (Intl).
locales приема езиков маркер, например pl-PL, или списък с предпочитани маркери. Ако го пропуснете, се използва локализацията по подразбиране на средата. options.timeZone избира часовата зона за показване; в противен случай се използва зоната на средата. Опциите hour, minute и second избират компонентите на часа. Ако hour12 не е зададена, hourCycle: 'h23' задава часове от 0 до 23. Опцията hour12 има предимство пред hourCycle: ако зададете едновременно hour12: true и hourCycle: 'h23', ще се използва 12-часов цикъл. Ако не са посочени стил или компоненти на часа, по подразбиране се включват часът, минутите и секундите.
Можете да използвате timeStyle, например 'short', вместо изрични опции за компонентите. При форматиране на валидна дата комбинирането на timeStyle с опция за компонент, като hour, предизвиква TypeError. При извикване на toLocaleTimeString() за валидна дата задаването на dateStyle също предизвиква TypeError, дори ако това е единствената опция. При невалиден обект Date методът връща "Invalid Date", преди да обработи опциите, затова в този случай комбинирането на timeStyle с hour не предизвиква грешка. Приемник, който не е обект Date, предизвиква TypeError.
Резултатът е предназначен за показване на потребителя, а не за стабилно съхранение или парсване: данните за локализацията могат да променят пунктуацията и интервалите. Примерът фиксира момента, локализацията, часовата зона UTC, часовия цикъл и системата за номериране, за да ограничи вариациите. При многократно форматиране обмислете създаването на един Intl.DateTimeFormat и повторното използване на метода му format.
Примери
const date = new Date('2024-01-15T13:05:09.000Z');
const text = date.toLocaleTimeString('en-GB', {
timeZone: 'UTC',
hourCycle: 'h23',
numberingSystem: 'latn',
hour: '2-digit',
minute: '2-digit',
second: '2-digit'
});
console.log(text);Резултат
13:05:09
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.