Temporal.PlainTime.prototype.microsecond
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 microsecond accessor property of Temporal.PlainTime instances returns a integer from 0 to 999 representing the microsecond (10-6 second) component of this time.
The set accessor of microsecond 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 microsecond
js
const time = Temporal.PlainTime.from("12:34:56");
console.log(time.microsecond); // 0
const time2 = Temporal.PlainTime.from("12:34:56.123456789");
console.log(time2.microsecond); // 456
Changing microsecond
js
const time = Temporal.PlainTime.from("12:34:56");
const newTime = time.with({ microsecond: 100 });
console.log(newTime.toString()); // 12:34:56.0001
You can also use add() or subtract() to move a certain number of microseconds from the current time.
js
const time = Temporal.PlainTime.from("12:34:56");
const newTime = time.add({ microseconds: 100 });
console.log(newTime.toString()); // 12:34:56.0001
Specifications
| Specification |
|---|
| Temporal # sec-get-temporal.plaintime.prototype.microsecond |
Browser compatibility
Loading…