Temporal.PlainTime

A PlainTime is essentially the time part of a Temporal.PlainDateTime object, with the date information removed. Because the date and time information don't have much interaction, all general information about time properties is documented here.

PlainTime objects can be serialized and parsed using the RFC 9557 format, an extension to the ISO 8601 / RFC 3339 format. The string has the following form:

HH:mm:ss.sssssssss

HH

A two-digit number from 00 to 23. It may be prefixed by the time designator T or t.

mm Optional

A two-digit number from 00 to 59. Defaults to 00.

ss.sssssssss Optional

A two-digit number from 00 to 59. May optionally be followed by a . or , and one to nine digits. Defaults to 00. The HH, mm, and ss components can be separated by : or nothing. You can omit either just ss or both ss and mm, so the time can be one of three forms: HH, HH:mm, or HH:mm:ss.sssssssss.

As an input, you may optionally include the date, offset, time zone identifier, and calendar, in the same format as PlainDateTime, but they will be ignored. A date-only string will be rejected. Other annotations in the [key=value] format are also ignored, and they must not have the critical flag.

When serializing, you can configure the fractional second digits.

Temporal.PlainTime() Experimental

Creates a new Temporal.PlainTime object by directly supplying the underlying data.

Temporal.PlainTime.compare() Experimental

Returns a number (-1, 0, or 1) indicating whether the first time comes before, is the same as, or comes after the second time. Equivalent to comparing the hour, minute, second, millisecond, microsecond, and nanosecond fields one by one.

Temporal.PlainTime.from() Experimental

Creates a new Temporal.PlainTime object from another Temporal.PlainTime object, an object with time properties, or an RFC 9557 string.

These properties are defined on Temporal.PlainTime.prototype and shared by all Temporal.PlainTime instances.

Temporal.PlainTime.prototype.constructor

The constructor function that created the instance object. For Temporal.PlainTime instances, the initial value is the Temporal.PlainTime() constructor.

Temporal.PlainTime.prototype.hour Experimental

Returns a integer from 0 to 23 representing the hour component of this time.

Temporal.PlainTime.prototype.microsecond Experimental

Returns a integer from 0 to 999 representing the microsecond (10^-6 second) component of this time.

Temporal.PlainTime.prototype.millisecond Experimental

Returns a integer from 0 to 999 representing the millisecond (10^-3 second) component of this time.

Temporal.PlainTime.prototype.minute Experimental

Returns a integer from 0 to 59 representing the minute component of this time.

Temporal.PlainTime.prototype.nanosecond Experimental

Returns a integer from 0 to 999 representing the nanosecond (10^-9 second) component of this time.

Temporal.PlainTime.prototype.second Experimental

Returns a integer from 0 to 59 representing the second component of this time.

Temporal.PlainTime.prototype[Symbol.toStringTag]

The initial value of the [Symbol.toStringTag] property is the string "Temporal.PlainTime". This property is used in Object.prototype.toString().

Temporal.PlainTime.prototype.add() Experimental

Returns a new Temporal.PlainTime object representing this time moved forward by a given duration (in a form convertible by Temporal.Duration.from()), wrapping around the clock if necessary.

Temporal.PlainTime.prototype.equals() Experimental

Returns true if this time is equivalent in value to another time (in a form convertible by Temporal.PlainTime.from()), and false otherwise. They are compared by their time values. Equivalent to Temporal.PlainTime.compare(this, other) === 0.

Temporal.PlainTime.prototype.round() Experimental

Returns a new Temporal.PlainTime object representing this time rounded to the given unit.

Temporal.PlainTime.prototype.since() Experimental

Returns a new Temporal.Duration object representing the duration from another time (in a form convertible by Temporal.PlainTime.from()) to this time. The duration is positive if the other time is before this time, and negative if after.

Temporal.PlainTime.prototype.subtract() Experimental

Returns a new Temporal.PlainTime object representing this time moved backward by a given duration (in a form convertible by Temporal.Duration.from()), wrapping around the clock if necessary.

Temporal.PlainTime.prototype.toJSON() Experimental

Returns a string representing this time in the same RFC 9557 format as calling toString(). Intended to be implicitly called by JSON.stringify().

Temporal.PlainTime.prototype.toLocaleString() Experimental

Returns a string with a language-sensitive representation of this time.

Temporal.PlainTime.prototype.toString() Experimental

Returns a string representing this time in the RFC 9557 format.

Temporal.PlainTime.prototype.until() Experimental

Returns a new Temporal.Duration object representing the duration from this time to another time (in a form convertible by Temporal.PlainTime.from()). The duration is positive if the other time is after this time, and negative if before.

Temporal.PlainTime.prototype.valueOf() Experimental

Throws a TypeError, which prevents Temporal.PlainTime instances from being implicitly converted to primitives when used in arithmetic or comparison operations.

Temporal.PlainTime.prototype.with() Experimental

Returns a new Temporal.PlainTime object representing this time with some fields replaced by new values.

• Temporal
• Temporal.Duration
• Temporal.PlainDateTime