The Temporal.Duration() constructor creates Temporal.Duration objects.
This constructor allows you to create instances by directly supplying the underlying data. Like all other Temporal classes, you should usually construct Temporal.Duration objects using the Temporal/Duration/from static method, which can handle a variety of input types.
Syntax
new Temporal.Duration()
new Temporal.Duration(years)
new Temporal.Duration(years, months)
new Temporal.Duration(years, months, weeks)
new Temporal.Duration(years, months, weeks, days)
new Temporal.Duration(years, months, weeks, days, hours)
new Temporal.Duration(years, months, weeks, days, hours, minutes)
new Temporal.Duration(years, months, weeks, days, hours, minutes, seconds)
new Temporal.Duration(years, months, weeks, days, hours, minutes, seconds, milliseconds)
new Temporal.Duration(years, months, weeks, days, hours, minutes, seconds, milliseconds, microseconds)
new Temporal.Duration(years, months, weeks, days, hours, minutes, seconds, milliseconds, microseconds, nanoseconds)
[!NOTE]
Temporal.Duration()can only be constructed withnew. Attempting to call it withoutnewthrows a TypeError.
Parameters
years- : Number of years, or
undefined(which is treated as0).
- : Number of years, or
months- : Number of months, or
undefined(which is treated as0).
- : Number of months, or
weeks- : Number of weeks, or
undefined(which is treated as0).
- : Number of weeks, or
days- : Number of days, or
undefined(which is treated as0).
- : Number of days, or
hours- : Number of hours, or
undefined(which is treated as0).
- : Number of hours, or
minutes- : Number of minutes, or
undefined(which is treated as0).
- : Number of minutes, or
seconds- : Number of seconds, or
undefined(which is treated as0).
- : Number of seconds, or
milliseconds- : Number of milliseconds, or
undefined(which is treated as0).
- : Number of milliseconds, or
microseconds- : Number of microseconds, or
undefined(which is treated as0).
- : Number of microseconds, or
nanoseconds- : Number of nanoseconds, or
undefined(which is treated as0).
- : Number of nanoseconds, or
Return value
A new Temporal.Duration object, possibly unbalanced, with the specified components.
Exceptions
- RangeError
- : Thrown in one of the following cases:
- Any of the parameters is not an integer (including non-finite values).
- A calendar unit (years, months, weeks) has an absolute value ≥ 2<sup>32</sup>.
- The non-calendar part of the duration (days and below), when expressed in seconds, has an absolute value ≥ 2<sup>53</sup>.
- : Thrown in one of the following cases:
Examples
Using Temporal.Duration()
const d = new Temporal.Duration(1, 2, 3, 4, 5, 6, 7, 8, 9, 10);
console.log(d.toString()); // "P1Y2M3W4DT5H6M7.00800901S"
Specifications
Browser compatibility
See also
- Temporal.Duration
- Temporal/Duration/from
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
