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

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници