Intl.DurationFormat.prototype.resolvedOptions()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
The resolvedOptions()
method of Intl.DurationFormat
instances returns a new object with properties reflecting the options computed during initialization of this DurationFormat
object.
Syntax
resolvedOptions()
Parameters
None.
Return value
A new object with properties reflecting the options computed during the initialization of this DurationFormat
object. The object has the following properties, in the order they are listed:
locale
-
The BCP 47 language tag for the locale actually used, determined by the locale negotiation process. Only the
nu
Unicode extension key, if requested, may be included in the output. numberingSystem
-
The value provided for this property in the
options
argument, or using the Unicode extension key"nu"
, with default filled in as needed. It is a supported numbering system for this locale. The default is locale dependent. style
-
The value provided for this property in the
options
argument, with default filled in as needed. It is either"long"
,"short"
,"narrow"
, or"digital"
. The default is"short"
. years
,yearsDisplay
,months
,monthsDisplay
,weeks
,weeksDisplay
,days
,daysDisplay
,hours
,hoursDisplay
,minutes
,minutesDisplay
,seconds
,secondsDisplay
,milliseconds
,millisecondsDisplay
,nanoseconds
,nanosecondsDisplay
-
The values provided for these properties in the
options
argument, with defaults filled in as needed. For the valid values and defaults for each, see theoptions
argument of the constructor. fractionalDigits
Optional-
The value provided for this property in the
options
argument. It is only present if specified inoptions
. It is an integer from 0 to 9, inclusive.
Examples
Using the resolvedOptions method
const duration = new Intl.DurationFormat("en");
const usedOptions = duration.resolvedOptions();
usedOptions.locale; // "en"
usedOptions.numberingSystem; // "latn"
usedOptions.years; // "long"
usedOptions.yearsDisplay; // "auto"
usedOptions.style; // "long"
Specifications
Specification |
---|
Intl.DurationFormat # sec-Intl.DurationFormat.prototype.resolvedOptions |
Browser compatibility
BCD tables only load in the browser