Temporal.PlainTime.prototype.nanosecond
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The nanosecond
accessor property of Temporal.PlainTime
instances returns a 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 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 add()
or 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
Specification |
---|
Temporal proposal # sec-get-temporal.plaintime.prototype.nanosecond |
Browser compatibility
Report problems with this compatibility data on GitHubdesktop | mobile | server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
nanosecond |
Legend
Tip: you can click/tap on a cell for more information.
- In development. Supported in a pre-release version.
- In development. Supported in a pre-release version.
- No support
- No support
- Experimental. Expect behavior to change in the future.
- See implementation notes.
- User must explicitly enable this feature.