← JS Temporal Compare Temporal Display Formats →

JS TutorialLesson #210

JavaScript Temporal Conversion

The table below shows how Temporal types can be converted.

Temporal Conversion Rules

The table below shows how Temporal types can be converted.

From	Plain Date	Plain Time	Plain DateTime	Zoned DateTime	Instant
PlainDate		No	Yes	No	No
PlainTime	No		No	No	No
PlainDateTime	Yes	Yes		Yes	No
ZonedDateTime	Yes	Yes	Yes		Yes
Instant	No	No	No	Yes

Conversion Methods

From	To	Method
Date	Instant	date.toTemporalInstant()

PlainDate	PlainTime	None
PlainDate	PlainDateTime	date.toPlainDateTime()
PlainDate	ZonedTime	None
PlainDate	Instant	None

PlainYearMonth	PlainDate	yearmonth.toPlainDate()
PlainMonthDay	PlainDate	monthday.toPlainDate()

PlainDateTime	PlainDate	datetime.toPlainDate()
PlainDateTime	PlainTime	datetime.toPlainTime()
PlainDateTime	ZonedDateTime	datetime.toZonedDateTime()
PlainDateTime	Instant	None

ZonedDateTime	PlainDate	zoned.toPlainDate()
ZonedDateTime	PlainDateTime	zoned.toPlainDateTime()
ZonedDateTime	PlainTime	zoned.toPlainTime()
ZonedDateTime	Instant	zoned.toInstant()

Instant	ZonedDateTime	zoned.toZonedDateTimeISO()

Legacy Date to Temporal Instant

Example

Example Code

javascript

Try it Yourself

const legacyDate = new Date();

const instant = legacyDate.toTemporalInstant();

PlainDate to PlainDateTime

Examples

Example Code

javascript

Try it Yourself

const date = Temporal.PlainDate.from("2026-05-17");

const dateTime = date.toPlainDateTime();

Combine Date and Time

You can combine PlainDate and PlainTime to create a PlainDateTime object.

Example

Example Code

javascript

Try it Yourself

// Create a PlainDate object

const date = Temporal.PlainDate.from("2026-05-17");

// Create a PlainTime object

const time = Temporal.PlainTime.from("14:30");

// Convert into a PlainDateTime object

const dateTime = date.toPlainDateTime(time);

PlainDateTime to PlainDate

Example

Example Code

javascript

Try it Yourself

const dateTime = Temporal.PlainDateTime.from("2026-05-17T14:30");

const date = dateTime.toPlainDate();

PlainDateTime to PlainTime

Example

Example Code

javascript

Try it Yourself

const dateTime = Temporal.PlainDateTime.from("2026-05-17T14:30");

const time = dateTime.toPlainTime();

PlainDateTime to ZonedDateTime

PlainDateTime does not contain a time zone.

You must provide one to create a ZonedDateTime.

Wrong

Example Code

javascript

Try it Yourself

const dateTime = Temporal.PlainDateTime.from("2026-05-17T14:30");

const zoned = dateTime.toZonedDateTime();

ZonedDateTime to PlainDateTime

Example

Example Code

javascript

Try it Yourself

const zoned = Temporal.ZonedDateTime.from("2026-05-17T14:30:00+02:00[Europe/Oslo]");

const dateTime = zoned.toPlainDateTime();

ZonedDateTime to PlainDate

Example

Example Code

javascript

Try it Yourself

const zoned = Temporal.ZonedDateTime.from("2026-05-17T14:30:00+02:00[Europe/Oslo]");

const date = zoned.toPlainDate();

ZonedDateTime to PlainTime

Example

Example Code

javascript

Try it Yourself

const zoned = Temporal.ZonedDateTime.from("2026-05-17T14:30:00+02:00[Europe/Oslo]");

const time = zoned.toPlainTime();

ZonedDateTime to Instant

Example

Example Code

javascript

Try it Yourself

const zoned = Temporal.ZonedDateTime.from("2026-05-17T14:30:00+02:00[Europe/Oslo]");

const instant = zoned.toInstant();

Instant to ZonedDateTime

Instant does not have a toZonedDateTime() method.

You must convert it to a ISO zone first.

Wrong

Example Code

javascript

Try it Yourself

const instant = Temporal.Instant.from("2026-05-17T12:30:00Z");

const zoned = instant.toZonedDateTime("Europe/Oslo");

Special Temporal Types

From	toPlainDate()	toPlainDateTime()	toZonedDateTime()
PlainYearMonth	YES + day value	No	No
PlainMonthDay	YES + year value	No	No

PlainMonthDay and PlainYearMonth need missing parts before becoming a full date.

PlainYearMonth to PlainDate

Example

Example Code

javascript

Try it Yourself

const yearMonth = new Temporal.PlainYearMonth(2026, 5);

const date = yearMonth.toPlainDate({ day: 17 });

PlainMonthDay to PlainDate

Example

Example Code

javascript

Try it Yourself

const monthDay = new Temporal.PlainYearMonth(2026, 5);

const date = monthDay.toPlainDate({ year: 2026 });

Time Zone Conversion

Converting time from another time zone is handled by the ZonedDateTime method withTimeZone().

Example

Example Code

javascript

Try it Yourself

const zdtOslo = Temporal.Now.zonedDateTimeISO('Europe/Oslo');

const zdtTokyo = zdtOslo.withTimeZone('Asia/Tokyo');