CKTIS / JavaScript
Date.prototype.toLocaleTimeString() — gelokaliseerde tijdnotatie
toLocaleTimeString() geeft een tekstuele weergave van de tijd van een Date-object terug, volgens de gekozen locale en opties. Je kunt hiermee de tijdzone, tijdonderdelen en uurcyclus instellen zonder de datum te wijzigen.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
date.toLocaleTimeString(locales?, options?)Het catalogussymbool Date.toLocaleTimeString verwijst naar de instantiemethode Date.prototype.toLocaleTimeString, niet naar een statische methode van de Date-constructor. De aanroep date.toLocaleTimeString(locales, options) geeft een tekenreeks terug zonder date te wijzigen. De hier beschreven werking van de parameters geldt voor omgevingen die ECMA-402 (Intl) ondersteunen.
locales accepteert een taaltag, zoals pl-PL, of een lijst met voorkeurstags. Als je deze weglaat, wordt de standaardlocale van de omgeving gebruikt. Met options.timeZone kies je de tijdzone voor de weergave; anders wordt de tijdzone van de omgeving gebruikt. De opties hour, minute en second selecteren tijdonderdelen. Als hour12 niet is ingesteld, kiest hourCycle: 'h23' uren van 0 tot en met 23. De optie hour12 heeft voorrang op hourCycle: als je zowel hour12: true als hourCycle: 'h23' instelt, wordt een 12-uurscyclus gebruikt. Als er geen stijl of tijdonderdelen zijn opgegeven, worden standaard uur, minuten en seconden opgenomen.
Je kunt timeStyle, bijvoorbeeld 'short', gebruiken in plaats van expliciete opties voor tijdonderdelen. Bij het formatteren van een geldige datum leidt de combinatie van timeStyle met een optie voor een tijdonderdeel, zoals hour, tot een TypeError. Als je bij een geldige datum dateStyle opgeeft in een aanroep van toLocaleTimeString(), krijg je ook een TypeError, zelfs als dit de enige optie is. Bij een ongeldige Date geeft de methode "Invalid Date" terug voordat de opties worden verwerkt. De combinatie van timeStyle en hour leidt in dat geval dus niet tot een fout. Een ontvanger die geen Date-object is, veroorzaakt een TypeError.
Het resultaat is bedoeld voor weergave aan gebruikers, niet voor stabiele opslag of parsing: localegegevens kunnen leestekens en spaties veranderen. Het voorbeeld legt het tijdstip, de locale, de UTC-tijdzone, de uurcyclus en het nummeringssysteem vast om variatie te beperken. Voor herhaald formatteren kun je één Intl.DateTimeFormat maken en de methode format ervan hergebruiken.
Voorbeelden
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);Resultaat
13:05:09
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.