Firefox Tomorrow

javascript instance method

Temporal.PlainDate.prototype.toPlainDateTime()

View on MDN ↗

The toPlainDateTime() method of PlainDate instances returns a new PlainDateTime object representing this date and a supplied time in the same calendar system.

Syntax

toPlainDateTime()
toPlainDateTime(plainTime)

Parameters

  • plainTime Optional
    • : A string, an object, or a PlainTime instance representing the time component of the resulting PlainDateTime. It is converted to a Temporal.PlainTime object using the same algorithm as Temporal.PlainTime.from(). Defaults to "00:00:00".

Return value

A new Temporal.PlainDateTime object representing the date and time specified by this date and plainTime, interpreted in the calendar system of this date.

Examples

Using toPlainDateTime()

const date = Temporal.PlainDate.from("2021-07-01");
const dateTime = date.toPlainDateTime("12:34:56");
console.log(dateTime.toString()); // 2021-07-01T12:34:56

const midnight = date.toPlainDateTime();
console.log(midnight.toString()); // 2021-07-01T00:00:00

const date2 = Temporal.PlainDate.from("2021-07-01[u-ca=chinese]");
const dateTime2 = date2.toPlainDateTime("12:34:56");
console.log(dateTime2.toString()); // 2021-07-01T12:34:56[u-ca=chinese]

Specifications

SpecificationsStandards references are available on the canonical MDN page.

Browser compatibility

Browser compatibilityCompatibility data is available on the canonical MDN page.

See also