Temporal.PlainTime.prototype.nanosecond

The nanosecond accessor property of {{jsxref("Temporal.PlainTime")}} instances returns an integer from 0 to 999 representing the nanosecond (10^-9 second) component of this time.

The set accessor of nanosecond is undefined. You cannot change this property directly. Use the {{jsxref("Temporal/PlainTime/with", "with()")}} method to create a new Temporal.PlainTime object with the desired new value.

Examples#

Using nanosecond#

const time = Temporal.PlainTime.from("12:34:56");
console.log(time.nanosecond); // 0

const time2 = Temporal.PlainTime.from("12:34:56.123456789");
console.log(time2.nanosecond); // 789

Changing nanosecond#

const time = Temporal.PlainTime.from("12:34:56");
const newTime = time.with({ nanosecond: 100 });
console.log(newTime.toString()); // 12:34:56.0000001

You can also use {{jsxref("Temporal/PlainTime/add", "add()")}} or {{jsxref("Temporal/PlainTime/subtract", "subtract()")}} to move a certain number of nanoseconds from the current time.

const time = Temporal.PlainTime.from("12:34:56");
const newTime = time.add({ nanoseconds: 100 });
console.log(newTime.toString()); // 12:34:56.0000001

Specifications#

{{Specifications}}

Browser compatibility#

{{Compat}}

See also#

• {{jsxref("Temporal.PlainTime")}}
• {{jsxref("Temporal/PlainTime/with", "Temporal.PlainTime.prototype.with()")}}
• {{jsxref("Temporal/PlainTime/add", "Temporal.PlainTime.prototype.add()")}}
• {{jsxref("Temporal/PlainTime/subtract", "Temporal.PlainTime.prototype.subtract()")}}
• {{jsxref("Temporal/PlainTime/second", "Temporal.PlainTime.prototype.second")}}
• {{jsxref("Temporal/PlainTime/millisecond", "Temporal.PlainTime.prototype.millisecond")}}
• {{jsxref("Temporal/PlainTime/microsecond", "Temporal.PlainTime.prototype.microsecond")}}