Temporal.ZonedDateTime.prototype.toPlainTime()

Baseline Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

The toPlainTime() method of Temporal.ZonedDateTime instances returns a new Temporal.PlainTime object representing the time portion of this date-time.

Warning: After a Temporal.ZonedDateTime is converted to Temporal.PlainTime, it's no longer time-zone-aware. Subsequent operations like arithmetic or with() operations will not adjust for DST and may not yield the same results as equivalent operations with the original Temporal.ZonedDateTime. However, unless you perform those operations across a time zone offset transition, it's impossible to notice the difference. Therefore, be very careful when performing this conversion because subsequent results may be correct most of the time, but only turn out incorrect when moving across offset transitions like when DST starts or ends.

Syntax

toPlainTime()

Parameters

None.

Return value

A new Temporal.PlainTime object representing the time portion of this date-time.

Examples

Using toPlainTime()

const zdt = Temporal.ZonedDateTime.from(
  "2021-07-01T12:34:56.987654321-04:00[America/New_York]",
);
const plainTime = zdt.toPlainTime();
console.log(plainTime.toString()); // 12:34:56.987654321

Specifications

Specification
Temporal # sec-temporal.zoneddatetime.prototype.toplaintime

Browser compatibility

	Desktop					Mobile							Server
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on iOS	Samsung Internet	WebView Android	WebView on iOS	Bun	Deno	Node.js
`toPlainTime`	144	144	139	128	preview	144	139	95	No	No	144	No	1.4.0	2.7	26.0.0