Intl.DurationFormat.prototype.resolvedOptions()

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The resolvedOptions() method of Intl.DurationFormat instances returns a new object with properties reflecting the locale and date and time formatting options computed during initialization of this Intl.DurationFormat object.

Syntax

resolvedOptions()

Return value

A new object with properties reflecting the locale and date and time formatting options computed during the initialization of the given Intl.DateTimeFormat object.

Description

The resulting object has the following properties:

locale: The BCP 47 language tag for the locale used. If any Unicode extension values were requested in the input BCP 47 language tag that led to this locale, the key-value pairs that were requested and are supported for this locale are included in locale.
style: One of the strings "long", "short", "narrow", or "digital" identifying the duration formatting style used.
years: One of the strings "long", "short", or "narrow" identifying the formatting style used for the years field.
yearsDisplay: One of the strings "auto" or "always" identifying when to display the years field.
months: One of the strings "long", "short", and "narrow" identifying the formatting style used for the months field.
monthsDisplay: One of the strings "auto" or "always" identifying when to display the months field.
weeks: One of the strings "long", "short", and "narrow" identifying the formatting style used for the weeks field.
weeksDisplay: One of the strings "auto" or "always" identifying when to display the weeks field.
days: One of the strings "long", "short", and "narrow" identifying the formatting style used for the days field.
daysDisplay: One of the strings "auto" or "always" identifying when to display the days field.
hours: One of the strings "long", "short", "narrow", "2-digit", or "numeric" identifying the formatting style used for the hours field.
hoursDisplay: One of the strings "auto" or "always" identifying when to display the hours field.
minutes: One of the strings "long", "short", "narrow", "2-digit", or "numeric" identifying the formatting style used for the minutes field.
minutesDisplay: One of the strings "auto" or "always" identifying when to display the minutes field.
seconds: One of the strings "long", "short", "narrow", "2-digit", or "numeric" identifying the formatting style used for the seconds field.
secondsDisplay: One of the strings "auto" or "always" identifying when to display the seconds field.
milliseconds: One of the strings "long", "short", "narrow", or "numeric" identifying the formatting style used for the milliseconds field.
millisecondsDisplay: One of the strings "auto" or "always" identifying when to display the millisecondsDisplay field.
microseconds: One of the strings "long", "short", "narrow", or "numeric" identifying the formatting style used for the microseconds field.
microsecondsDisplay: One of the strings "auto" or "always" identifying when to display the microsecondsDisplay field.
nanoseconds: One of the strings "long", "short", "narrow", or "numeric" identifying the formatting style used for the nanoseconds field.
nanosecondsDisplay: One of the strings "auto" or "always" identifying when to display the nanosecondsDisplay field.
fractionalDigits: A number, identifying the number of fractional digits used with numeric styles.
numberingSystem: The value provided for this property in the options argument, if present, or the value requested using the Unicode extension key nu or filled in as a default.

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