Intl.DateTimeFormat.prototype.resolvedOptions()

ローケルを反映しているプロパティと、このDateTimeFormatオブジェクトの初期化中に計算されたオプションをフォーマットしている日時をもった新しいオブジェクトを返します。

構文

dateTimeFormat.resolvedOptions()

説明

ローケルを反映しているプロパティと、このDateTimeFormatオブジェクトの初期化中に計算されたオプションをフォーマットしている日時をもった新しいオブジェクトを返します。オブジェクトは次のプロパティを持っています。:

locale

実際に使われているローケルに対するBCP47言語タグ。入力のBCP47言語タグではUnicode表現値はリクエストされ、このローケルに対して、リクエストされサポートされているキー／バリューペアはlocaleに含まれています。

calendar

numberingSystem

Unicode表現キー"ca" 、"nu"を用いてリクエストされデフォルト値として使われている値

timeZone

options引数でこのプロパティに対して提供されている値。提供されない場合、undefined (ランタイムのデフォルトタイムゾーンを表します。). 警告: アプリケーションは返されたundefined を当てにすべきではありません。将来のバージョンでは、代わりにランタイムのデフォルトタイムゾーンを示すStringを返すかもしれません。

hour12

options引数でこのプロパティに対して提供されデフォルト値として使われている値。

weekday

era

year

month

day

hour

minute

second

timeZoneName

options引数で対応しているプロパティと利用可能な組み合わせと選択したローケルでの日時に対する表現間でマッチしているフォーマットから結果を得ている値。

例

resolvedOptions メソッドを使う

var germanFakeRegion = new Intl.DateTimeFormat("de-XX", { timeZone: "UTC" });
var usedOptions = germanFakeRegion.resolvedOptions();

usedOptions.locale;         // "de"
usedOptions.calendar;       // "gregory"
usedOption.numberingSystem; // "latn"
usedOptions.timeZone;       // "UTC"
usedOptions.month;          // "numeric"

仕様

ブラウザ実装状況

関連情報

• Intl.DateTimeFormat