Intl.RelativeTimeFormat
Intl.RelativeTimeFormat オブジェクトは言語独自の相対時間の書式化をできるようにします。
対応ブラウザ
| 機能 | デスクトップ | モバイル | ||||
|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Safari | Chrome Android | Safari iOS | |
| 71 | 79 | 65 | 14 | 71 | 14 | |
| Intl.RelativeTimeFormat() コンストラクターは、 Intl/RelativeTimeFormat オブジェクトを生成します。 | 71 | 79 | 65 | 14 | 71 | 14 |
Intl.RelativeTimeFormat.RelativeTimeFormat.locales parameter 「ロケール」パラメータ | 71 | 79 | 65 | 14 | 71 | 14 |
Intl.RelativeTimeFormat.RelativeTimeFormat.options parameter.options localeMatcher parameter `options.localeMatcher` パラメータ | 71 | 79 | 65 | 14 | 71 | 14 |
Intl.RelativeTimeFormat.RelativeTimeFormat.options parameter.options numberingSystem parameter `options.numberingSystem` パラメータ | 71 | 79 | 76 | 14 | 71 | 14 |
Intl.RelativeTimeFormat.RelativeTimeFormat.options parameter.options numeric parameter `options.numeric` パラメータ | 71 | 79 | 65 | 14 | 71 | 14 |
| Intl.RelativeTimeFormat.prototype.format() メソッドは value や unit を、この Intl.RelativeTimeFormat オブジェクトのロケールと整形オプションに従って整形します。 | 71 | 79 | 65 | 14 | 71 | 14 |
| Intl.RelativeTimeFormat.prototype.formatToParts() メソッドは、ロケールを考慮したカスタム書式設定に使用できる相対時間書式を部品単位で表すオブジェクトの配列 (Array) を返します。 | 71 | 79 | 70 | 14 | 71 | 14 |
| Intl.RelativeTimeFormat インスタンスのsolvedOptions() メソッドは、この RelativeTimeFormat オブジェクトの初期化中に計算されたオプションを反映するプロパティを持つ新しいオブジェクトを返します。 | 71 | 79 | 65 | 14 | 71 | 14 |
| Intl.RelativeTimeFormat.supportedLocalesOf() 静的メソッドは、ランタイムのデフォルト ロケールにフォールバックすることなく、相対時間形式でサポートされている指定されたロケールを含む配列を返します。 | 71 | 79 | 65 | 14 | 71 | 14 |
基本構文
const rtf = new Intl.RelativeTimeFormat('ja', { numeric: 'auto' });
rtf.format(-1, 'day'); // 'Yesterday'
rtf.format(2, 'hour'); // '2 hours from now'
rtf.format(-3, 'month'); // '3 months ago'ライブデモ
実務での使いどころ
-
Intl.RelativeTimeFormat の活用
Intl.RelativeTimeFormat オブジェクトは言語独自の相対時間の書式化をできるようにします。
注意点
- 特になし。すべての主要ブラウザで安定して動作する。
アクセシビリティ
- JavaScript による動的更新時は、aria-live リージョンで変更をスクリーンリーダーに通知する。