Temporal PlainDateTime

The Temporal.PlainDateTime Object

The Temporal.PlainDateTime object is a pure date and time object.

It represents a calendar date and a wall-clock time with no time zone.

Example: 2026-05-07T14:30:00.

Example

// Create a PlainDateTime object

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

The T is a literal to separate the date from the time.

What You Should Learn:

• How to use JavaScript Temporal.PlainDateTime
• How to work with date and time without a time zone
• How to add and subtract dates
• How to compare dates safely

Note: PlainDateTime is useful when you need both date and time, but not time zone.

How to Create a PlainDateTime Object

An PlainDateTime object can be created in several different ways:

Create a PlainDateTime with new

You can create a PlainDateTime object using the new constructor.

The constructor takes parameters like year, month, day, hours, and minutes.

Example

// Create a PlainDateTime object

const date = new Temporal.PlainDateTime(2026, 5, 17, 14, 30);

Note: In Temporal objects, months start at 1. In the legacy Date object, months start at 0.

Create a PlainDateTime from a String

You can create a PlainDateTime object from an ISO 8601 / RFC 9557 string.

Example

// Create a PlainDateTime object

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

The T Between Date and Time?

The T is a literal to separate the date from the time.

You should read it as an abbreviation for Time.

It is the separator required by the ISO 8601 format.

Create a PlainDateTime from Now

You can create a PlainDateTime object from current time.

Example

const now = Temporal.Now.plainDateTimeISO();

Add or Subtract PlainDateTime

You can safely add or subtract time.

The original value does not change.

Example

// Create a PlainDateTime object

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

// Add and subtract time

const earlier = date.subtract({ minutes: 30 });

const later = date.add({ hours: 2 });

When to Use PlainDateTime

• Applications where time zone conversion is not required.
• Local event scheduling.
• Appointments without international time zone handling.
• Forms that collect date and time.

Compare PlainDateTime Values

You can compare PlaneDateTime values using the equals() method.

Example

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

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

let result = d1.equals(d2)

Most (*) temporal objects have their own equals() method:

• instant.equals(instant)
• plaindate.equals(plaindate)
• plaintime.equals(plaintime)
• plainyearmonth.equals(plainyearmonth)
• plainmonthday.equals(plainmonthday)
• plaindateTime.equals(plaindatetime)
• zoneddateTime.equals(zoneddtatime)

(*) Duration has not.

Note: Learn More: JavaScript Temporal Compare

Convert to ZonedDateTime

A PlainDateTime object does not include time zone information.

You can convert it to a ZonedDateTime if needed.

Example

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

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

Compare PlainDateTime with Other Types

Temporal.PlainDateTime Methods

Temporal.PlainDateTime Properties

The Temporal.PlainDateTime object has 22 properties of date information.

Display all PlainDateTime PropertiesExample

const date = new Temporal.PlainDateTime(2026, 5, 1, 14, 30);