Intl.RelativeTimeFormat

概要

Intl.RelativeTimeFormat は「3日前」「2か月後」のような相対的な時間表現をロケールに応じて生成します。

対応ブラウザ

機能	デスクトップ				モバイル
機能	Chrome	Edge	Firefox	Safari	Chrome Android	Safari iOS
`javascript.builtins.Intl.RelativeTimeFormat`	71	79	65	14	71	14
ビルトインオブジェクト
`Intl.RelativeTimeFormat.RelativeTimeFormat` 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.format` Intl.RelativeTimeFormat.prototype.format() メソッドは value や unit を、この Intl.RelativeTimeFormat オブジェクトのロケールと整形オプションに従って整形します。	71	79	65	14	71	14
`Intl.RelativeTimeFormat.formatToParts` Intl.RelativeTimeFormat.prototype.formatToParts() メソッドは、ロケールを考慮したカスタム書式設定に使用できる相対時間書式を部品単位で表すオブジェクトの配列 (Array) を返します。	71	79	70	14	71	14
`Intl.RelativeTimeFormat.resolvedOptions` Intl.RelativeTimeFormat インスタンスのsolvedOptions() メソッドは、この RelativeTimeFormat オブジェクトの初期化中に計算されたオプションを反映するプロパティを持つ新しいオブジェクトを返します。	71	79	65	14	71	14
`Intl.RelativeTimeFormat.supportedLocalesOf` Intl.RelativeTimeFormat.supportedLocalesOf() 静的メソッドは、ランタイムのデフォルトロケールにフォールバックすることなく、相対時間形式でサポートされている指定されたロケールを含む配列を返します。	71	79	65	14	71	14

1+対応 (バージョン) 未対応 ※注釈ありサブ機能の解説は MDN Web Docs (CC BY-SA 2.5)

基本構文

JAVASCRIPT

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'