Intl.DurationFormat

コンストラクター

Intl.DurationFormat()

新しい Intl.DurationFormat オブジェクトを作成します。

静的メソッド

Intl.DurationFormat.supportedLocalesOf()

指定されたロケールのうち、ランタイムの既定のロケールで代替することなく対応しているものを配列として返します。

インスタンスプロパティ

これらのプロパティは Intl.DurationFormat.prototype で定義されており、すべての Intl.DurationFormat インスタンスで共有されます。

Intl.DurationFormat.prototype.constructor

インスタンスオブジェクトを作成したコンストラクター関数。Intl.DurationFormat インスタンスの場合、初期値は Intl.DurationFormat コンストラクターです。

Intl.DurationFormat.prototype[Symbol.toStringTag]

[Symbol.toStringTag] プロパティの初期値は、文字列 "Intl.DurationFormat" です。このプロパティは、 Object.prototype.toString() で使用されます。

インスタンスメソッド

Intl.DurationFormat.prototype.format()

この DurationFormat オブジェクトのロケールおよび書式設定オプションに従って経過時間を書式化するゲッター関数です。

Intl.DurationFormat.prototype.formatToParts()

書式化された経過時間を各部分で表すオブジェクトの配列 (Array) を返します。

Intl.DurationFormat.prototype.resolvedOptions()

オブジェクトの初期化時に計算されたロケールおよび書式化オプションを反映したプロパティを持つ新しいオブジェクトを返します。

例

Intl.DurationFormat の使用

以下の例は、Intl.DurationFormat オブジェクトを使用して、さまざまなロケールおよびスタイルで再生時間オブジェクトを書式化する方法を示しています。

const duration = {
  hours: 1,
  minutes: 46,
  seconds: 40,
};

// スタイルを "long" に、ロケールを "fr-FR" に設定
new Intl.DurationFormat("fr-FR", { style: "long" }).format(duration);
// "1 heure, 46 minutes et 40 secondes"

// スタイルを "short" に、ロケールを "en" に設定
new Intl.DurationFormat("en", { style: "short" }).format(duration);
// "1 hr, 46 min and 40 sec"

// スタイルを "narrow" に、ロケールを "pt" に設定
new Intl.DurationFormat("pt", { style: "narrow" }).format(duration);
// "1h 46min 40s"

仕様書

ブラウザーの互換性

関連情報

• Intl.DurationFormat のポリフィル (FormatJS)
• Intl
• Temporal.Duration.prototype.toLocaleString()