Intl.RelativeTimeFormat【国際化相対時間フォーマット】オブジェクト

format【フォーマット】の 例 も参照

const formatterJ = new Intl.RelativeTimeFormat('ja');
const formatterJA = new Intl.RelativeTimeFormat('ja', { numeric: 'auto' });

for (let value of [-3, -2, -1, 0, 1, 2, 3]) {
  console.log(formatterJ.format(value, 'day'), '/', formatterJA.format(value, 'day'));
}
// 出力例：3 日前 / 3 日前
// 出力例：2 日前 / 一昨日
// 出力例：1 日前 / 昨日
// 出力例：0 日後 / 今日
// 出力例：1 日後 / 明日
// 出力例：2 日後 / 明後日
// 出力例：3 日後 / 3 日後

const formatterE = new Intl.RelativeTimeFormat('en');
const formatterEA = new Intl.RelativeTimeFormat('en', { numeric: 'auto' });
for (let value of [-2, -1, 0, 1, 2]) {
  console.log(formatterE.format(value, 'day'), '/',formatterEA.format(value, 'day'));
}
// 出力例：2 days ago / 2 days ago
// 出力例：1 day ago / yesterday
// 出力例：in 0 days / today
// 出力例：in 1 day / tomorrow
// 出力例：in 2 days / in 2 days

const formatterNon = new Intl.RelativeTimeFormat();
console.log(formatterNon.resolvedOptions());
// 出力例：Object { locale: "ja-JP", style: "long", numeric: "always", numberingSystem: "latn" }
console.log(formatterNon.format(1, 'month'));
// 出力例：1 か月後

const formatterFull = new Intl.RelativeTimeFormat('ja-u-nu-fullwide');
console.log(formatterFull.format(123, 'year'));
// 出力例：１２３ 年後

const formatterKanji = new Intl.RelativeTimeFormat('ja', { numberingSystem: 'hanidec'});
console.log(formatterKanji.format(123, 'year'));
// 出力例：一二三 年後

コンストラクタ の 例 も参照

const formatterJ = new Intl.RelativeTimeFormat('ja');
const formatterE = new Intl.RelativeTimeFormat('en');
const formatterJA = new Intl.RelativeTimeFormat('ja', { numeric: 'auto' });
const formatterEA = new Intl.RelativeTimeFormat('en', { numeric: 'auto' });

console.log(formatterJ.format(-1, 'year'), '/', formatterE.format(-1, 'year'));
// 出力例：1 年前 / 1 year ago
console.log(formatterJ.format(0, 'year'), '/', formatterE.format(0, 'year'));
// 出力例：0 年後 / in 0 years
console.log(formatterJ.format(1, 'year'), '/', formatterE.format(1, 'year'));
// 出力例：1 年後 / in 1 year
console.log(formatterJA.format(-1, 'year'), '/', formatterEA.format(-1, 'year'));
// 出力例：昨年 / last year
console.log(formatterJA.format(0, 'year'), '/', formatterEA.format(0, 'year'));
// 出力例：今年 / this year
console.log(formatterJA.format(1, 'year'), '/', formatterEA.format(1, 'year'));
// 出力例：来年 / next year

console.log(formatterJ.format(-1, 'month'), '/', formatterE.format(-1, 'month'));
// 出力例：1 か月前 / 1 month ago
console.log(formatterJ.format(0, 'month'), '/', formatterE.format(0, 'month'));
// 出力例：0 か月後 / in 0 months
console.log(formatterJ.format(1, 'month'), '/', formatterE.format(1, 'month'));
// 出力例：1 か月後 / in 1 month
console.log(formatterJA.format(-1, 'month'), '/', formatterEA.format(-1, 'month'));
// 出力例：先月 / last month
console.log(formatterJA.format(0, 'month'), '/', formatterEA.format(0, 'month'));
// 出力例：今月 / this month
console.log(formatterJA.format(1, 'month'), '/', formatterEA.format(1, 'month'));
// 出力例：来月 / next month

console.log(formatterJ.format(-1, 'day'), '/', formatterE.format(-1, 'day'));
// 出力例：1 日前 / 1 day ago
console.log(formatterJ.format(0, 'day'), '/', formatterE.format(0, 'day'));
// 出力例：0 日後 / in 0 days
console.log(formatterJ.format(1, 'day'), '/', formatterE.format(1, 'day'));
// 出力例：1 日後 / in 1 day
console.log(formatterJA.format(-1, 'day'), '/', formatterEA.format(-1, 'day'));
// 出力例：昨日 / yesterday
console.log(formatterJA.format(0, 'day'), '/', formatterEA.format(0, 'day'));
// 出力例：今日 / today
console.log(formatterJA.format(1, 'day'), '/', formatterformatterEA.format(1, 'day'));
// 出力例：明日 / tomorrow

function timeFormat(values, unit) {
  let formatterNarrow = new Intl.RelativeTimeFormat('ja', { numeric: 'auto', style: 'narrow' });
  let formatterShort = new Intl.RelativeTimeFormat('ja', { numeric: 'auto', style: 'short' });
  let formatterLong = new Intl.RelativeTimeFormat('ja', { numeric: 'auto', style: 'long' });
  for (let value of values) {
    let timeNarrow = formatterNarrow.format(value, unit);
    let timeShort = formatterShort.format(value, unit);
    let timeLong = formatterLong.format(value, unit);
    console.log(timeNarrow, '/', timeShort, '/', timeLong);
  }
}

timeFormat([-2, -1, 0, 1, 2], 'year');
// 出力例：2年前 / 2 年前 / 2 年前
// 出力例：昨年 / 昨年 / 昨年
// 出力例：今年 / 今年 / 今年
// 出力例：来年 / 来年 / 来年
// 出力例：2年後 / 2 年後 / 2 年後

timeFormat([-2, -1, 0, 1, 2], 'quarter');
// 出力例：2四半期前 / 2 四半期前 / 2 四半期前
// 出力例：前四半期 / 前四半期 / 前四半期
// 出力例：今四半期 / 今四半期 / 今四半期
// 出力例：翌四半期 / 翌四半期 / 翌四半期
// 出力例：2四半期後 / 2 四半期後 / 2 四半期後

timeFormat([-2, -1, 0, 1, 2], 'month');
// 出力例：2か月前 / 2 か月前 / 2 か月前
// 出力例：先月 / 先月 / 先月
// 出力例：今月 / 今月 / 今月
// 出力例：来月 / 来月 / 来月
// 出力例：2か月後 / 2 か月後 / 2 か月後

timeFormat([-2, -1, 0, 1, 2], 'week');
// 出力例：2週間前 / 2 週間前 / 2 週間前
// 出力例：先週 / 先週 / 先週
// 出力例：今週 / 今週 / 今週
// 出力例：来週 / 来週 / 来週
// 出力例：2週間後 / 2 週間後 / 2 週間後

timeFormat([-3, -2, -1, 0, 1, 2, 3], 'day');
// 出力例：3日前 / 3 日前 / 3 日前
// 出力例：一昨日 / 一昨日 / 一昨日
// 出力例：昨日 / 昨日 / 昨日
// 出力例：今日 / 今日 / 今日
// 出力例：明日 / 明日 / 明日
// 出力例：明後日 / 明後日 / 明後日
// 出力例：3日後 / 3 日後 / 3 日後

timeFormat([-1, 0, 1], 'hour');
// 出力例：1時間前 / 1 時間前 / 1 時間前
// 出力例：1 時間以内 / 1 時間以内 / 1 時間以内
// 出力例：1時間後 / 1 時間後 / 1 時間後

timeFormat([-1, 0, 1], 'minute');
// 出力例：1分前 / 1 分前 / 1 分前
// 出力例：1 分以内 / 1 分以内 / 1 分以内
// 出力例：1分後 / 1 分後 / 1 分後

timeFormat([-1, 0, 1], 'second');
// 出力例：1秒前 / 1 秒前 / 1 秒前
// 出力例：今 / 今 / 今
// 出力例：1秒後 / 1 秒後 / 1 秒後

const formatterJ = new Intl.RelativeTimeFormat('ja');
const formatterE = new Intl.RelativeTimeFormat('en');
const formatterJA = new Intl.RelativeTimeFormat('ja', { numeric: 'auto' });
const formatterEA = new Intl.RelativeTimeFormat('en', { numeric: 'auto' });
const values = [-1, 0, 1];

for (let value of values) {
  let array = formatterJ.formatToParts(value, 'year');
  for (let i = 0; i < array.length; i++) {
    console.log(i, array[i]);
  }
  console.log();
}
// 出力例：
// 0 Object { type: "integer", value: "1", unit: "year" }
// 1 Object { type: "literal", value: " 年前" }
//
// 0 Object { type: "integer", value: "0", unit: "year" }
// 1 Object { type: "literal", value: " 年後" }
//
// 0 Object { type: "integer", value: "1", unit: "year" }
// 1 Object { type: "literal", value: " 年後" }

for (let value of values) {
  let array = formatterJA.formatToParts(value, 'year');
  for (let i = 0; i < array.length; i++) {
    console.log(i, array[i]);
  }
  console.log();
}
// 出力例：
// 0 Object { type: "literal", value: "昨年" }
//
// 0 Object { type: "literal", value: "今年" }
//
// 0 Object { type: "literal", value: "来年" }

for (let value of values) {
  let array = formatterE.formatToParts(value, 'year');
  for (let i = 0; i < array.length; i++) {
    console.log(i, array[i]);
  }
  console.log();
}
// 出力例：
// 0 Object { type: "integer", value: "1", unit: "year" }
// 1 Object { type: "literal", value: " year ago" }
//
// 0 Object { type: "literal", value: "in " }
// 1 Object { type: "integer", value: "0", unit: "year" }
// 2 Object { type: "literal", value: " years" }
//
// 0 Object { type: "literal", value: "in " }
// 1 Object { type: "integer", value: "1", unit: "year" }
// 2 Object { type: "literal", value: " year" }

for (let value of values) {
  let array = formatterEA.formatToParts(value, 'year');
  for (let i = 0; i < array.length; i++) {
    console.log(i, array[i]);
  }
  console.log();
}
// 出力例：
// 0 Object { type: "literal", value: "last year" }
//
// 0 Object { type: "literal", value: "this year" }
//
// 0 Object { type: "literal", value: "next year" }

const formatterJ = new Intl.RelativeTimeFormat('ja', { numeric: 'auto', numberingSystem: 'fullwide' });
console.log(formatterJ.resolvedOptions());
// 出力例：Object { locale: "ja", style: "long", numeric: "auto", numberingSystem: "fullwide" }

const formatterE = new Intl.RelativeTimeFormat('en', { style: 'narrow' });
console.log(formatterE.resolvedOptions());
// 出力例：Object { locale: "en", style: "narrow", numeric: "always", numberingSystem: "latn" }

console.log(Intl.RelativeTimeFormat.supportedLocalesOf('ja'));
// 出力例：Array [ "ja" ]

console.log(Intl.RelativeTimeFormat.supportedLocalesOf('ng'));
// 出力例：Array []

let locales = ['ng', 'ja', 'ja-JP', 'en', 'en-US', 'en-GB'];
console.log(Intl.RelativeTimeFormat.supportedLocalesOf(locales));
// 出力例：Array(5) [ "ja", "ja-JP", "en", "en-US", "en-GB" ]

locales = ['ng', 'jpn', 'jpn-JP', 'eng', 'eng-US', 'eng-GB'];
console.log(Intl.RelativeTimeFormat.supportedLocalesOf(locales));
// 出力例：Array(5) [ "ja", "ja-JP", "en", "en-US", "en-GB" ]

console.log(Intl.RelativeTimeFormat.supportedLocalesOf(locales, { localeMatcher: 'lookup' }));
// 出力例：Array(5) [ "ja", "ja-JP", "en", "en-US", "en-GB" ]