Temporal.Now.plainTimeISO()

The Temporal.Now.plainTimeISO() static method returns the current time as a {{jsxref("Temporal.PlainTime")}} object, in the specified time zone.

Note that although the method contains "ISO" in its name, {{jsxref("Temporal.PlainTime")}} objects do not have associated calendars, as the time format is not calendar-dependent.

Syntax#

Temporal.Now.plainTimeISO()
Temporal.Now.plainTimeISO(timeZone)

Parameters#

• timeZone {{optional_inline}}
• : Either a string or a {{jsxref("Temporal.ZonedDateTime")}} instance representing the time zone to interpret the system time in. If a Temporal.ZonedDateTime instance, its time zone is used. If a string, it can be a named time zone identifier, an offset time zone identifier, or a date-time string containing a time zone identifier or an offset (see time zones and offsets for more information).

Return value#

The current time in the specified time zone, as a {{jsxref("Temporal.PlainTime")}} object. Has the same precision as {{jsxref("Temporal/Now/instant", "Temporal.Now.instant()")}}.

Exceptions#

• {{jsxref("RangeError")}}
• : Thrown if the time zone is invalid.

Examples#

Using Temporal.Now.plainTimeISO()#

// The current time in the system's time zone
const time = Temporal.Now.plainTimeISO();
console.log(time); // e.g.: 06:12:34.567890123

// The current time in the "America/New_York" time zone
const timeInNewYork = Temporal.Now.plainTimeISO("America/New_York");
console.log(timeInNewYork); // e.g.: 23:12:34.567890123

Specifications#

{{Specifications}}

Browser compatibility#

{{Compat}}

See also#

• {{jsxref("Temporal.Now")}}
• {{jsxref("Temporal.PlainTime")}}