【JavaScript】toLocaleString() 数値/日付/配列をロケールに従ってフォーマットする

const value = 123456789.123456;

  // 現在のロケールで数値をフォーマット
console.log( value.toLocaleString() );
>> 123,456,789.123
  // ロケールを指定して数値をフォーマット
console.log( value.toLocaleString("it") );
>> 123.456.789,123
console.log( value.toLocaleString("as") );
>> ১২,৩৪,৫৬,৭৮৯.১২৩

const date = new Date();

  // 現在のロケールで日付をフォーマット
console.log( date.toLocaleString() );
>> 2023/10/20 16:27:48
  // ロケールを指定して日付をフォーマット
console.log( date.toLocaleString("it") );
>> 20/10/2023, 16:27:48
console.log( date.toLocaleString("as") );
>> ২০-১০-২০২৩, অপৰাহ্ন ৪:২৭:৪৮

const array = [1234,2345,"a","b,c",new Date()];

  // 現在のロケールで配列をフォーマット
console.log( array.toLocaleString() );
>> 1,234,2,345,a,b,c,2023/12/14 14:23:35
  // ロケールを指定して配列をフォーマット
console.log( array.toLocaleString("it") );
>> 1.234,2.345,a,b,c,14/12/2023, 14:24:25
console.log( array.toLocaleString("as") );
>> ১,২৩৪,২,৩৪৫,a,b,c,১৪-১২-২০২৩, অপৰাহ্ন ২:২৫:০২

const u16Array = new Uint16Array([1001,1002,1003,1004]);

  // 現在のロケールでTypedArrayをフォーマット
console.log( u16Array.toLocaleString() );
>> 1,001,1,002,1,003,1,004
  // ロケールを指定してTypedArrayをフォーマット
console.log( u16Array.toLocaleString("is") );
>> 1.001,1.002,1.003,1.004
console.log( u16Array.toLocaleString("as") );
>> ১,০০১,১,০০২,১,০০৩,১,০০৪

const object ={a:1,b:2};

console.log( object.toLocaleString() );
>> [object Object]

const value = 123456789.123456;

  // 現在のロケールで数値をフォーマット
console.log( value.toLocaleString() );
>> 123,456,789.123
  // ロケールを指定して数値をフォーマット
console.log( value.toLocaleString("it") );
>> 123.456.789,123
console.log( value.toLocaleString("as") );
>> ১২,৩৪,৫৬,৭৮৯.১২৩

const value = 123.456;
const option = {
    localeMatcher: "best fit",  // ロケールのマッチングアルゴリズム。(使用できる値)

    numberingSystem:"mong",     // 数値体系: 123…は "latn" (値の例)
    notation: "standard" ,      // 数値の表示方法。(使用できる値)
    compactDisplay: "long" ,    // notation:"compact" のとき使用 (使用できる値)
    signDisplay: "always",      // 符号表示。(使用できる値)
    roundingPriority: "auto",   // 丸め精度。(使用できる値)
    roundingMode: "halfExpand", // 丸めタイプ。(使用できる値)
    roundingIncrement: 1 ,      // 丸め判定増加値。(使用できる値)
    trailingZeroDisplay: "auto", // 小数部ゼロ表示。(使用できる値)

    style: "unit",               // 表示スタイル。(使用できる値)
 
     // 以下3行 style:"currency"のとき有効
    currency: "JPY",             // style: ISO 4217 通貨コード。style:"currency"のとき必須。(値の例)
    currencyDisplay: "name",     // 通貨表示のタイプ。(使用できる値)
    currencySign: "standard" ,   // 負数を会計形式で表示するかどうか。(使用できる値)

     // 以下2行 style:"unit"のとき有効
    unit: "kilobyte-per-hour",   // style: "unit"のとき必要(使用できる値)
    unitDisplay: "long",         // 単位の表示方法。(使用できる値)

    useGrouping: true,           // 区切り記号（カンマなど）を使用するかどうか

     // 桁指定①
    minimumSignificantDigits: 5, // 整数・小数含めた最小有効桁数 (説明)
    maximumSignificantDigits: 10, // 整数・小数含めた最大有効桁数 (説明)

     // 桁指定② ①が指定されている時無効
    minimumFractionDigits:4, // 小数部最小桁数 (説明)
    maximumFractionDigits:6  // 小数部最大桁数  (説明)

     // 桁指定③
    minimumIntegerDigits:10, // 整数部最小桁数 (説明)
};
console.log( value.toLocaleString( "ja-JP",option) );
>> +᠐,᠐᠐᠐,᠐᠐᠐,᠑᠒᠓.᠔᠕᠖ キロバイト/時間

const date = new Date();

  // 現在のロケールで日付をフォーマット
console.log( date.toLocaleString() );
>> 2023/10/20 16:27:48
  // ロケールを指定して日付をフォーマット
console.log( date.toLocaleString("it") );
>> 20/10/2023, 16:27:48
console.log( date.toLocaleString("as") );
>> ২০-১০-২০২৩, অপৰাহ্ন ৪:২৭:৪৮

const date = new Date();
const option = {
    localeMatcher: "best fit",  // ロケールのマッチングアルゴリズム。(使用できる値)
    numberingSystem:"latn",     // 数値体系: 123…は "latn" (値の例)

    calendar: "japanese" ,      // 暦の種類。 (使用できる値)

    timeZone: "Asia/Tokyo" ,    // タイムゾーン。 (説明)
    hourCycle: "12h",           // 12/24時制の指定 (使用できる値)
    hour12: true ,              // 12時制の指定 (説明)

    formatMatcher: "best fit",   // フォーマットのマッチングアルゴリズム。(使用できる値)

      // 表示形式 ①      ※②と同時使用するとエラー
  /* ②を有効にするためコメント化
    dateStyle: "full",           // 日付表示形式。(使用できる値)
    timeStyle: "full",           // 時刻表示形式。(使用できる値)
  */
      // 表示形式 ②
    weekday: "long",             // 週の表示形式。(使用できる値)
    era:     "long",             // 時代の表示形式。(使用できる値)
    year:    "2-digit",          // 年の表示形式。(使用できる値)
    month:   "2-digit",          // 月の表示形式。(使用できる値)
    day:     "2-digit",          // 日の表示形式。(使用できる値)
    dayPeriod:"long",            // 日周期の表示形式。(使用できる値)
    hour:     "2-digit",         // 時間の表示形式。(使用できる値)
    minute:   "2-digit",         // 分の表示形式。(使用できる値)
    second:   "2-digit",         // 秒の表示形式。(使用できる値)
    fractionalSecondDigits:2,    // 秒の小数桁数  (説明)
    timeZoneName: "long",        // タイムゾーンの表示形式  (説明)

};
console.log( date.toLocaleString( "ja-JP",option) );
>>令和5年10月26日木曜日 夜07:40:13.67 日本標準時

const array = [1234,2345,"a","b,c",true,null,undefined];

  // 現在のロケールで配列をフォーマット
console.log( array.toLocaleString() );
>> 1,234,2,345,a,b,c,true,,
  // ロケールを指定して配列をフォーマット
console.log( array.toLocaleString("it") );
>> ১,২৩৪,২,৩৪৫,a,b,c,true,,
console.log( array.toLocaleString("as") );
>> ১,২,a,b,true,,

const toLocaleArrayString =( array,locale=null,option={} )=>{
    const loc = typeof locale === "string" ? locale : Intl.NumberFormat().resolvedOptions().locale;
    const opt = option instanceof Object ? option : {};
    opt.useGrouping = false;
    return array.map( e=>{
        
        if( e instanceof Object ) return `"${ e.toLocaleString(loc,opt)}"`;
        switch( typeof e ){
            case "object":return "null";
            case "undefined":return "undefined";
            case "string":case "symbol":
                return `"${ e.toLocaleString(loc,opt) }"`;
            default:
                return e.toLocaleString(loc,opt);
        }
    }).join(",");
};

const array = [123456,new Date(),{a:1,b:2},"a,b,c",null,undefined,Symbol("a,b"),()=>{}];
>> 123456,"2023/10/27 16:59:50","[object Object]","a,b,c",null,undefined,"Symbol(a,b)","()=>{}"

const u16Array = new Uint16Array([1001,1002,1003,1004]);

  // 現在のロケールでTypedArrayをフォーマット
console.log( u16Array.toLocaleString() );
>> 1,001,1,002,1,003,1,004
  // ロケールを指定してTypedArrayをフォーマット
console.log( u16Array.toLocaleString("is") );
>> 1.001,1.002,1.003,1.004
console.log( u16Array.toLocaleString("as") );
>> ১,০০১,১,০০২,১,০০৩,১,০০৪

const object ={a:1,b:2};

console.log( object.toLocaleString() , object.toString());
>> [object Object],[object Object]

const text = "こんにちは";
console.log( text.toLocaleString() , text.toString() );
>> こんにちは,こんにちは

const bool = false;
console.log( bool.toLocaleString() , text.toString() );
>> false,false

const func = function(a){return a;};
console.log( func.toLocaleString() , text.toString() );
>> function(a){return a;},function(a){return a;}

const symbol = Symbol("シンボルです");
console.log( symbol.toLocaleString() , text.toString() );
>> Symbol(シンボルです),Symbol(シンボルです)

const option ={
    minimumSignificantDigits: 5, // 最小有効桁数
    };
console.log( (123).toLocaleString( "ja-JP",option) );
>> 123.00
console.log( (1.23).toLocaleString( "ja-JP",option) );
>> 1.2300

const option ={
    maximumSignificantDigits: 5, // 最小有効桁数
    };
console.log( (123.4567).toLocaleString( "ja-JP",option) );
>> 123.46
console.log( (1234567.89).toLocaleString( "ja-JP",option) );
>> 1,234,600