JavaScript Temporal PlainTime
A Temporal.PlainTime represents a time without a date or time zone.
It is useful for opening hours, alarms, and any time-only values.
Create a PlainTime
You can create a PlainTime from a string.
You can also create a PlainTime using numeric values.
Note
The parameters are: hour, minute, second, millisecond, microsecond, nanosecond.
Get the Current Time
You can get the current local time using Temporal.Now.plainTimeISO().
Get Time Parts
You can read the different parts of a PlainTime value.
Add and Subtract Time
Use add() and subtract() to do time math.
PlainTime is immutable, so the original value is not changed.
Example
const time = Temporal.PlainTime.from("14:30");
const later = time.add({ minutes: 45 });
const earlier = time.subtract({ hours: 2 });
Try it Yourself »
If the time passes midnight, it wraps around:
Example
const time = Temporal.PlainTime.from("23:30");
const result = time.add({ minutes: 90 });
Try it Yourself »
Compare PlainTime Values
Use Temporal.PlainTime.compare() to compare times.
Example
const a = Temporal.PlainTime.from("08:30");
const b = Temporal.PlainTime.from("14:30");
result = Temporal.PlainTime.compare(a, b));
The result is:
- -1 if the first time is earlier
- 0 if they are equal
- 1 if the first time is later
Use equals() to check if two times are the same.
Example
const a = Temporal.PlainTime.from("14:30");
const b = Temporal.PlainTime.from("14:30");
result = a.equals(b);
Calculate the Difference Between Two Times
Use until() or since() to calculate differences.
Example
const start = Temporal.PlainTime.from("09:00");
const end = Temporal.PlainTime.from("17:30");
const diff = start.until(end);
This returns a Temporal.Duration.
Combine Date and Time
You can combine PlainDate and PlainTime to create a PlainDateTime.
Example
const date = Temporal.PlainDate.from("2026-05-17");
const time = Temporal.PlainTime.from("14:30");
const dateTime = date.toPlainDateTime(time);
When to Use PlainTime
Opening hours (for example: 09:00 to 17:00).
Alarm clock times.
Recurring daily schedules.
Time input fields (without date and time zone).
Note
If you need time zone support, use ZonedDateTime.
Summary
Temporal.PlainTime represents a time without date and time zone.
It is immutable, easy to compare, and useful for daily time values.
