Temporal.PlainTime.prototype.nanosecond

فهرست فصل‌ها دانلود آرشیوناشر

MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونه‌کد

The **nanosecond** accessor property of {{jsxref("Temporal.PlainTime")}} instances returns an integer from 0 to 999 representing the nanosecond (10<sup>-9</sup> 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

js
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

js
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.

js
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")}}