Skip to content

Date.prototype.toLocaleTimeString() method ​

The toLocaleTimeString() method writes a Date as text according to a locale. It uses the same machinery as Intl.DateTimeFormat; when no fields or styles are given, it writes only the time.

Syntax ​

toLocaleTimeString()
toLocaleTimeString(locales)
toLocaleTimeString(locales, options)

Parameters ​

locales optional

Same as for the Intl.DateTimeFormat() constructor.

options optional

Same as for the Intl.DateTimeFormat() constructor. dateStyle is not accepted.

Return value ​

A string. An invalid date doesn't throw; it returns 'Invalid Date'.

Exceptions ​

Same as for the Intl.DateTimeFormat() constructor.

In addition, giving dateStyle in options throws TypeError: dateStyle is specified while formatting time is requested.

Default output of the three methods ​

MethodWhen no fields or styles are givenen-US example
toLocaleString()Date and time11/15/2026, 3:05:09 PM
toLocaleDateString()Date only11/15/2026
toLocaleTimeString()Time only3:05:09 PM

Examples ​

js
const moment = new Date(Date.UTC(2026, 10, 15, 15, 5, 9));
console.log(moment.toLocaleTimeString('en-US', { timeZone: 'UTC' }));

Result: the console prints 3:05:09 PM. This output is not verified in the simulator; this method without fields has been compared against a web page in the acceptance tests, using a different moment.

Differences from the web ​

The same as the differences for Intl.DateTimeFormat; see Intl.DateTimeFormat.

See also ​