← 返回首页

Intl.DurationFormat - JavaScript | MDN

Toggle sidebar

Theme

OS default
Light
Dark

日本語

Remember language Learn more

Intl.DurationFormat

Baseline 2025

Newly available

Since March 2025, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Intl.DurationFormat オブジェクトにより、言語に依存した経過時間の書式化ができます。

In this article

コンストラクター

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 オブジェクトを使用して、さまざまなロケールおよびスタイルで再生時間オブジェクトを書式化する方法を示しています。

js
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"

仕様書

Specification

Intl.DurationFormat
# durationformat-objects

ブラウザーの互換性

Enable JavaScript to view this browser compatibility table.

関連情報

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 2025年6月21日 by MDN contributors.

View this page on GitHub • Report a problem with this content

標準組み込みオブジェクト
Intl.DurationFormat
コンストラクター
1. Intl.DurationFormat() コンストラクター
静的メソッド
1. Intl.DurationFormat.supportedLocalesOf()
インスタンスメソッド
1. Intl.DurationFormat.prototype.format()
2. Intl.DurationFormat.prototype.formatToParts()
3. resolvedOptions()
継承
Object/Function
静的メソッド
1. apply()
2. bind()
3. call()
4. toString()
5. [Symbol.hasInstance]()
静的プロパティ
1. displayName
2. length
3. name
4. prototype
5. arguments
6. caller
インスタンスメソッド
1. __defineGetter__()
2. __defineSetter__()
3. __lookupGetter__()
4. __lookupSetter__()
5. hasOwnProperty()
6. isPrototypeOf()
7. propertyIsEnumerable()
8. toLocaleString()
9. toString()
10. valueOf()
インスタンスプロパティ
1. __proto__
2. constructor
関連するページ
Intl
Intl.Collator
Intl.DateTimeFormat
Intl.DisplayNames
Intl.ListFormat
Intl.Locale
Intl.NumberFormat
Intl.PluralRules
Intl.RelativeTimeFormat
Intl.Segmenter