Intl.NumberFormat【国際化数値フォーマット】
new Intl.NumberFormat【コンストラクタ】
format【フォーマット関数】
formatRange【フォーマット (範囲)】
formatToParts【フォーマットパーツ取得】
formatRangeToParts【フォーマットパーツ取得 (範囲)】
resolvedOptions【オプション取得】
supportedLocalesOf【サポート ロケール取得】

const num = 1_234_567.89

// 数値
let numFormat = new Intl.NumberFormat();
console.log( numFormat.format(num) );
// 出力：1,234,567.89

// 通貨
numFormat = new Intl.NumberFormat('ja-JP', { style:'currency', currency:'JPY' });
console.log( numFormat.format(num) );
// 出力：￥1,234,568
numFormat = new Intl.NumberFormat('ja-JP', { style:'currency', currency:'JPY', currencyDisplay:'name' });
console.log( numFormat.format(num) );
// 出力：1,234,568円
numFormat = new Intl.NumberFormat('en-US', { style:'currency', currency:'USD' });
console.log( numFormat.format(num) );
// 出力：$1,234,567.89
numFormat = new Intl.NumberFormat('de-DE', { style:'currency', currency:'EUR' });
console.log( numFormat.format(num) );
// 出力：1.234.567,89 €
numFormat = new Intl.NumberFormat('fr-FR', { style:'currency', currency:'EUR' });
console.log( numFormat.format(num) );
// 出力：1 234 567,89 €

// パーセント
numFormat = new Intl.NumberFormat('ja-JP', { style:'percent' });
console.log( numFormat.format(0.50) );
// 出力：50%

// 全角数字
const format_zen = new Intl.NumberFormat(
  'ja-JP',
  { numberingSystem: 'fullwide' }
);
console.log( format_zen.format(num) );
// 出力：１,２３４,５６７.８９

// 漢数字 (拡張 数値フォーマット指定)
const format_kanji = new Intl.NumberFormat(
  'ja-JP-u-nu-hanidec',
  // { numberingSystem: 'hanidec' }
);
console.log( format_kanji.format(num) );
// 出力：一,二三四,五六七.八九

// ゼロパディング
numFormat = new Intl.NumberFormat(
  'ja-JP',
   { useGrouping:false, minimumIntegerDigits:9, minimumFractionDigits:4 }
);
console.log(numFormat.format(num));
// 出力：001234567.8900

const nums = [ 1234, 1234567, 1234567890, 1234567.89 ];
const numFormat = new Intl.NumberFormat();
console.log( nums.map( formatter.format ) );
// 出力：(4) ['1,234', '1,234,567', '1,234,567,890', '1,234,567.89']

const num = 1_234_567.89;
const locales = [ 'ja-JP', 'en-US', 'de-DE', 'fr-FR' ];
const ranges = [ [123, 456], [789, 789] ];
for (const locale of locales) {
  const numFormat = new Intl.NumberFormat(locale);
  const str = numFormat.format( num );
  const str_0 = numFormat.formatRange( ranges[0][0], ranges[0][1] );
  const str_1 = numFormat.formatRange( ranges[1][0], ranges[1][1] );
  console.log( `${str} / ${str_0} / ${str_1}' ('${locale}')` );
}
// 出力：
// 1,234,567.89 / 123～456 / 約789' ('ja-JP')
// 1,234,567.89 / 123–456 / ~789' ('en-US')
// 1.234.567,89 / 123–456 / ≈789' ('de-DE')
// 1 234 567,89 / 123–456 / ≃789' ('fr-FR')

// 表記法
const value = 12_345_678_901;
notations = ['standard', 'scientific', 'engineering', 'compact'];
for (const locale of locales) {
  const format_std = new Intl.NumberFormat(
    locale,
    { notation: 'standard'} // 標準表記
  );
  const str_std = format_std.format( value );
  const format_sci = new Intl.NumberFormat(
    locale,
    { notation: 'scientific'} // 科学表記 (指数表記)
  );
  const str_sci = format_sci.format( value );
  const format_eng = new Intl.NumberFormat(
    locale,
    { notation: 'engineering'} // 工学表記 (10^3n となる指数表記)
  );
  const str_eng = format_eng.format( value );
  const format_short = new Intl.NumberFormat(
    locale,
    { notation: 'compact', compactDisplay: 'short'} // 数単位表記 (短い形式)
  );
  const str_short = format_short.format( value );
  const format_long = new Intl.NumberFormat(
    locale,
    { notation: 'compact', compactDisplay: 'long'} // 数単位表記 (長い形式)
  );
  const str_long = format_long.format( value );
  console.log( `${str_std} / ${str_sci} / ${str_eng} / ${str_short} / ${str_long}' ('${locale}')` );
}
// 出力：
// 12,345,678,901 / 1.235E10 / 12.346E9 / 123億 / 123億' ('ja-JP')
// 12,345,678,901 / 1.235E10 / 12.346E9 / 12B / 12 billion' ('en-US')
// 12.345.678.901 / 1,235E10 / 12,346E9 / 12 Mrd. / 12 Milliarden' ('de-DE')
// 12 345 678 901 / 1,235E10 / 12,346E9 / 12 Md / 12 milliards' ('fr-FR')

const num = 1_234_567.89;
const range = [1234.56, 7890.12];
const locales = [ ['ja-JP', 'JPY'], ['en-US', 'USD'], ['de-DE', 'EUR'], ['en-NZ', 'NZD'], ['en-US', 'NZD'] ];
const displays = [ 'code', 'symbol', 'narrowSymbol', 'name' ];
for (const locale of locales) {
  const cur = locale[1];
  console.log( `\n'${locale[0]}', '${cur}'` );
  for (const display of displays) {
    const numFormat = new Intl.NumberFormat(
      locale[0],
      { style: 'currency', currency: cur, currencyDisplay: display }
    );
    const str = numFormat.format( num );
    console.log( `${str} ('${display}')` );
  }
const numFormat = new Intl.NumberFormat(
    locale[0],
    { style: 'currency', currency: cur }
  );
console.log( numFormat.formatRange(range[0], range[1]) );
}
// 出力：
// 'ja-JP', 'JPY'
// JPY 1,234,568 ('code')
// ￥1,234,568 ('symbol')
// ￥1,234,568 ('narrowSymbol')
// 1,234,568円 ('name')
// ￥1,235 ～ ￥7,890
//
// 'en-US', 'USD'
// USD 1,234,567.89 ('code')
// $1,234,567.89 ('symbol')
// $1,234,567.89 ('narrowSymbol')
// 1,234,567.89 US dollars ('name')
// $1,234.56 – $7,890.12
//
// 'de-DE', 'EUR'
// 1.234.567,89 EUR ('code')
// 1.234.567,89 € ('symbol')
// 1.234.567,89 € ('narrowSymbol')
// 1.234.567,89 Euro ('name')
// 1.234,56–7.890,12 €
//
// 'en-NZ', 'NZD'
// NZD 1,234,567.89 ('code')
// $1,234,567.89 ('symbol')
// $1,234,567.89 ('narrowSymbol')
// 1,234,567.89 New Zealand dollars ('name')
// $1,234.56 – $7,890.12
//
// 'en-US', 'NZD'
// NZD 1,234,567.89 ('code')
// NZ$1,234,567.89 ('symbol')
// $1,234,567.89 ('narrowSymbol')
// 1,234,567.89 New Zealand dollars ('name')
// NZ$1,234.56–7,890.12

const locales = [ 'ja-JP', 'en-US', 'de-DE', 'fr-FR' ];
const num = 0.5;
const ranges = [ [0.6, 0.7], [0.9, 1] ];

for (const locale of locales) {
  const formatter = new Intl.NumberFormat(
    locale,
    { style: 'percent', minimumFractionDigits: 2 }
  );
  const str = formatter.format( num );
  const str_0 = formatter.formatRange( ranges[0][0], ranges[0][1] );
  const str_1 = formatter.formatRange( ranges[1][0], ranges[1][1] );
  console.log( `${str} / ${str_0} / ${str_1}' ('${locale}')` );
}
// 出力：
// 50.00% / 60.00% ～ 70.00% / 90.00% ～ 100.00%' ('ja-JP')
// 50.00% / 60.00% – 70.00% / 90.00% – 100.00%' ('en-US')
// 50,00 % / 60,00–70,00 % / 90,00–100,00 %' ('de-DE')
// 50,00 % / 60,00–70,00 % / 90,00–100,00 %' ('fr-FR')

const locales = [ 'ja-JP', 'en-US' ];
const units = [ 'kilogram', 'meter-per-hour', 'minute', 'second' ];
const displays = [ 'short', 'narrow', 'long' ];
const num = 123.45;
const ranges = [[50, 70], [60, 60]];

for (const locale of locales) {
  console.log( `\n'${locale}'` );
  for (const unt of units) {
    console.log( `'${unt}'` );
    for (const display of displays) {
      const formatter = new Intl.NumberFormat(
        locale,
        { style: 'unit', unit: unt, unitDisplay: display }
      );
      const str = formatter.format( num );
      const str_0 = formatter.formatRange( ranges[0][0], ranges[0][1] );
      const str_1 = formatter.formatRange( ranges[1][0], ranges[1][1] );
      console.log( `${str} / ${str_0} / ${str_1} ('${display}')` );
    }
  }
}
// 出力：
// 'ja-JP'
// 'kilogram'
// 123.45 kg / 50～70 kg / 約60 kg ('short')
// 123.45kg / 50～70kg / 約60kg ('narrow')
// 123.45 キログラム / 50～70 キログラム / 約60 キログラム ('long')
// 'meter-per-hour'
// 123.45 m/時間 / 50～70 m/時間 / 約60 m/時間 ('short')
// 123.45m/時間 / 50～70m/時間 / 約60m/時間 ('narrow')
// 123.45 メートル/時間 / 50～70 メートル/時間 / 約60 メートル/時間 ('long')
// 'minute'
// 123.45 分 / 50～70 分 / 約60 分 ('short')
// 123.45m / 50～70m / 約60m ('narrow')
// 123.45 分 / 50～70 分 / 約60 分 ('long')
// 'second'
// 123.45 秒 / 50～70 秒 / 約60 秒 ('short')
// 123.45s / 50～70s / 約60s ('narrow')
// 123.45 秒 / 50～70 秒 / 約60 秒 ('long')
//
// 'en-US'
// 'kilogram'
// 123.45 kg / 50–70 kg / ~60 kg ('short')
// 123.45kg / 50–70kg / ~60kg ('narrow')
// 123.45 kilograms / 50–70 kilograms / ~60 kilograms ('long')
// 'meter-per-hour'
// 123.45 m/h / 50–70 m/h / ~60 m/h ('short')
// 123.45m/h / 50–70m/h / ~60m/h ('narrow')
// 123.45 meters per hour / 50–70 meters per hour / ~60 meters per hour ('long')
// 'minute'
// 123.45 min / 50–70 min / ~60 min ('short')
// 123.45m / 50–70m / ~60m ('narrow')
// 123.45 minutes / 50–70 minutes / ~60 minutes ('long')
// 'second'
// 123.45 sec / 50–70 sec / ~60 sec ('short')
// 123.45s / 50–70s / ~60s ('narrow')
// 123.45 seconds / 50–70 seconds / ~60 seconds ('long')

const num = 1_234_567.89;
const range = [1234, 5678];

let numFormat = new Intl.NumberFormat();
console.log( numFormat.format(num) );
// 出力：1,234,567.89
console.log( numFormat.formatToParts(num) );
// 出力：
// (7) [{…}, {…}, {…}, {…}, {…}, {…}, {…}]
// 0: {type: 'integer', value: '1'}
// 1: {type: 'group', value: ','}
// 2: {type: 'integer', value: '234'}
// 3: {type: 'group', value: ','}
// 4: {type: 'integer', value: '567'}
// 5: {type: 'decimal', value: '.'}
// 6: {type: 'fraction', value: '89'}
// length: 7
// [[Prototype]]: Array(0)
console.log( numFormat.formatRange(...range) );
// 出力：1,234～5,678
console.log( numFormat.formatRangeToParts(range[0], range[1]) );
// 出力：
// (7) [{…}, {…}, {…}, {…}, {…}, {…}, {…}]
// 0: {type: 'integer', value: '1', source: 'startRange'}
// 1: {type: 'group', value: ',', source: 'startRange'}
// 2: {type: 'integer', value: '234', source: 'startRange'}
// 3: {type: 'literal', value: '～', source: 'shared'}
// 4: {type: 'integer', value: '5', source: 'endRange'}
// 5: {type: 'group', value: ',', source: 'endRange'}
// 6: {type: 'integer', value: '678', source: 'endRange'}
// length: 7
// [[Prototype]]: Array(0)

numFormat = new Intl.NumberFormat('en-US', {style: 'currency', currency: 'NZD'});
console.log( numFormat.format(num) );
// 出力：NZ$1,234,567.89
console.log( numFormat.formatToParts(num) );
// 出力：
// (8) [{…}, {…}, {…}, {…}, {…}, {…}, {…}, {…}]
// 0: {type: 'currency', value: 'NZ$'}
// 1: {type: 'integer', value: '1'}
// 2: {type: 'group', value: ','}
// 3: {type: 'integer', value: '234'}
// 4: {type: 'group', value: ','}
// 5: {type: 'integer', value: '567'}
// 6: {type: 'decimal', value: '.'}
// 7: {type: 'fraction', value: '89'}
// length: 8
// [[Prototype]]: Array(0)
console.log( numFormat.formatRange(...range) );
// 出力：NZ$1,234.00–5,678.00
console.log( numFormat.formatRangeToParts(range[0], range[1]) );
// 出力：
// (12) [{…}, {…}, {…}, {…}, {…}, {…}, {…}, {…}, {…}, {…}, {…}, {…}]
// 0: {type: 'currency', value: 'NZ$', source: 'shared'}
// 1: {type: 'integer', value: '1', source: 'startRange'}
// 2: {type: 'group', value: ',', source: 'startRange'}
// 3: {type: 'integer', value: '234', source: 'startRange'}
// 4: {type: 'decimal', value: '.', source: 'startRange'}
// 5: {type: 'fraction', value: '00', source: 'startRange'}
// 6: {type: 'literal', value: '–', source: 'shared'}
// 7: {type: 'integer', value: '5', source: 'endRange'}
// 8: {type: 'group', value: ',', source: 'endRange'}
// 9: {type: 'integer', value: '678', source: 'endRange'}
// 10: {type: 'decimal', value: '.', source: 'endRange'}
// 11: {type: 'fraction', value: '00', source: 'endRange'}
// length: 12
// [[Prototype]]: Array(0)

numFormat = new Intl.NumberFormat('en-US', {style: 'unit', unit: 'megabyte'});
console.log( numFormat.format(num) );
// 出力：1,234,567.89 MB
console.log( numFormat.formatToParts(num) );
// 出力：
// (9) [{…}, {…}, {…}, {…}, {…}, {…}, {…}, {…}, {…}]
// 0: {type: 'integer', value: '1'}
// 1: {type: 'group', value: ','}
// 2: {type: 'integer', value: '234'}
// 3: {type: 'group', value: ','}
// 4: {type: 'integer', value: '567'}
// 5: {type: 'decimal', value: '.'}
// 6: {type: 'fraction', value: '89'}
// 7: {type: 'literal', value: ' '}
// 8: {type: 'unit', value: 'MB'}
// length: 9
// [[Prototype]]: Array(0)
console.log( numFormat.formatRange(...range) );
// 出力：1,234–5,678 MB
console.log( numFormat.formatRangeToParts(range[0], range[1]) );
// 出力：
// (9) [{…}, {…}, {…}, {…}, {…}, {…}, {…}, {…}, {…}]
// 0: {type: 'integer', value: '1', source: 'startRange'}
// 1: {type: 'group', value: ',', source: 'startRange'}
// 2: {type: 'integer', value: '234', source: 'startRange'}
// 3: {type: 'literal', value: '–', source: 'shared'}
// 4: {type: 'integer', value: '5', source: 'endRange'}
// 5: {type: 'group', value: ',', source: 'endRange'}
// 6: {type: 'integer', value: '678', source: 'endRange'}
// 7: {type: 'literal', value: ' ', source: 'shared'}
// 8: {type: 'unit', value: 'MB', source: 'shared'}
// length: 9
// [[Prototype]]: Array(0)

const numFormat = new Intl.NumberFormat();
console.log( numFormat.resolvedOptions() );
// 出力：
// {locale: 'ja', numberingSystem: 'latn', style: 'decimal', minimumIntegerDigits: 1, minimumFractionDigits: 0, …}
// locale: "ja"
// maximumFractionDigits: 3
// minimumFractionDigits: 0
// minimumIntegerDigits: 1
// notation: "standard"
// numberingSystem: "latn"
// roundingIncrement: 1
// roundingMode: "halfExpand"
// roundingPriority: "auto"
// signDisplay: "auto"
// style: "decimal"
// trailingZeroDisplay: "auto"
// useGrouping: "auto"
// [[Prototype]]: Object

console.log( numFormat.format(12345) );
// 出力：12,345
console.log( numFormat.format(12345.6789) );
// 出力：12,345.679

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

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

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

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

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