Widely available すべての主要ブラウザで対応済み。安心して使用可能。
国際化（Intl） Widely available

Intl

Intl は国際化のための名前空間で、NumberFormat, DateTimeFormat, Collator 等のコンストラクタを提供します。ロケールに応じた適切なフォーマットが可能です。

国際化（Intl）ES2015

概要

Intl は国際化のための名前空間で、NumberFormat, DateTimeFormat, Collator 等のコンストラクタを提供します。ロケールに応じた適切なフォーマットが可能です。

対応ブラウザ

機能 デスクトップ モバイル
Chrome
Edge
Firefox
Safari
Chrome Android
Safari iOS
Intl
24
12
29
10
25
10
Array.toLocaleString

toLocaleString() は Array インスタンスのメソッドで、配列の要素を表す文字列を返します。配列の要素は、それぞれの toLocaleString メソッドを使い、ロケール固有の文字列に変換されます（例えばカンマ "," など）。
1
12
1
1
18
1
Array.toLocaleString.locales parameter

「ロケール」パラメータ
24
79
52
7
25
7
Array.toLocaleString.options parameter

options`パラメータ
24
79
52
7
25
7
BigInt.toLocaleString

toLocaleString() は BigInt 値のメソッドで、この長整数値の言語に合わせた表現の文字列を返します。Intl.NumberFormat API に対応している実装では、このメソッドは Intl.NumberFormat に委譲します。
67
79
68
14
67
14
BigInt.toLocaleString.locales parameter

「ロケール」パラメータ
76
79
70
14
76
14
BigInt.toLocaleString.options parameter

options`パラメータ
76
79
70
14
76
14
Date.toLocaleDateString

toLocaleDateString() は Date インスタンスのメソッドで、この日時の日付部分を、地方時で言語に依存した表現の文字列で返します。 Intl.DateTimeFormat API に対応している実装では、このメソッドは Intl.DateTimeFormat に転送されます。
1
12
1
1
18
1
Date.toLocaleDateString.iana time zone names

`timeZone` オプションの IANA タイムゾーン名
24
14
52
7
25
7
Date.toLocaleDateString.locales parameter

「ロケール」パラメータ
24
12
29
10
25
10
Date.toLocaleDateString.options parameter

options`パラメータ
24
12
29
10
25
10
Date.toLocaleString

toDateString() は Date インスタンスのメソッドで、この日時を、地方時で言語に依存した表現の文字列で返します。 Intl.DateTimeFormat API に対応している実装では、このメソッドは Intl.DateTimeFormat に転送されます。
1
12
1
1
18
1
Date.toLocaleString.iana time zone names

`timeZone` オプションの IANA タイムゾーン名
24
14
52
7
25
7
Date.toLocaleString.locales parameter

「ロケール」パラメータ
24
12
29
10
25
10
Date.toLocaleString.options parameter

options`パラメータ
24
12
29
10
25
10
Date.toLocaleTimeString

toLocaleTimeString() は Date インスタンスのメソッドで、この日時の時刻部分を、地方時で言語に依存した表現の文字列で返します。 Intl.DateTimeFormat API に対応している実装では、このメソッドは Intl.DateTimeFormat に転送されます。
1
12
1
1
18
1
Date.toLocaleTimeString.iana time zone names

`timeZone` オプションの IANA タイムゾーン名
24
14
52
7
25
7
Date.toLocaleTimeString.locales parameter

「ロケール」パラメータ
24
12
29
10
25
10
Date.toLocaleTimeString.options parameter

options`パラメータ
24
12
29
10
25
10
Intl.Collator

Intl.Collator オブジェクトは、言語を考慮した文字列の比較を可能にします。
24
12
29
10
25
10
Intl.Collator.Collator

Intl.Collator() コンストラクターは、言語を考慮した文字列の比較を可能にする Intl/Collator オブジェクトを生成します。
24
12
29
10
25
10
Intl.Collator.Collator.options caseFirst parameter

`options.caseFirst` パラメータ
24
18
55
11
25
11
Intl.Collator.Collator.options collation parameter

`options.collat​​ion` パラメータ
86
86
85
14.1
86
14.5
Intl.Collator.Collator.options ignorePunctuation parameter

「options.ignorePunctuation」パラメータ
24
79
29
10
25
10
Intl.Collator.Collator.options localeMatcher parameter

`options.localeMatcher` パラメータ
24
79
29
10
25
10
Intl.Collator.Collator.options numeric parameter

`options.numeric` パラメータ
24
79
29
10
25
10
Intl.Collator.Collator.options sensitivity parameter

「options.sensitivity」パラメータ
24
79
29
10
25
10
Intl.Collator.Collator.options usage parameter

`options.usage` パラメータ
24
79
29
10
25
10
Intl.Collator.compare

Intl.Collator.prototype.compare() メソッドは、 2 つの文字列をこの Intl.Collator オブジェクトのソート順に従って比較します。
24
12
29
10
25
10
Intl.Collator.resolvedOptions

Intl.Collator.prototype.resolvedOptions() メソッドは、この Intl.Collator オブジェクトの初期化時に計算されたロケールと照合オプションを反映したプロパティを持つ新しいオブジェクトを返します。
24
12
29
10
25
10
Intl.Collator.supportedLocalesOf

Intl.Collator.supportedLocalesOf() メソッドは、ランタイムの既定のロケールで代替しなくても照合で対応するロケールを含む配列を返します。
24
12
29
10
25
10
Intl.DateTimeFormat

Intl.DateTimeFormat オブジェクトは、言語に応じた日付と時刻の書式化を可能にします。
24
12
29
10
25
10
Intl.DateTimeFormat.DateTimeFormat

Intl.DateTimeFormat() コンストラクターは Intl.DateTimeFormat オブジェクトを生成します。
24
12
29
10
25
10
Intl.DateTimeFormat.DateTimeFormat.IntlLegacyConstructedSymbol

新しい Intl.DateTimeFormat オブジェクト。
91
91
54
14.1
91
14.5
Intl.DateTimeFormat.DateTimeFormat.locales parameter

「ロケール」パラメータ
24
12
29
10
25
10
Intl.DateTimeFormat.DateTimeFormat.options parameter

options`パラメータ
24
12
29
10
25
10
Intl.DateTimeFormat.DateTimeFormat.options parameter.options calendar parameter

`options.calendar` パラメータ
80
80
76
14.1
80
14.5
Intl.DateTimeFormat.DateTimeFormat.options parameter.options dateStyle parameter

`options.dateStyle` パラメータ
76
79
79
14.1
76
14.5
Intl.DateTimeFormat.DateTimeFormat.options parameter.options dayPeriod parameter

`options.dayPeriod` パラメータ
92
92
90
14.1
92
14.5
Intl.DateTimeFormat.DateTimeFormat.options parameter.options fractionalSecondDigits parameter

「options.fractionalSecondDigits」パラメータ
84
84
84
14.1
84
14.5
Intl.DateTimeFormat.DateTimeFormat.options parameter.options hourCycle parameter

`options.hourCycle` パラメータ
73
18
58
13
73
13
Intl.DateTimeFormat.DateTimeFormat.options parameter.options numberingSystem parameter

`options.numberingSystem` パラメータ
80
80
76
14.1
80
14.5
Intl.DateTimeFormat.DateTimeFormat.options parameter.options timeStyle parameter

`options.timeStyle` パラメータ
76
79
79
14.1
76
14.5
Intl.DateTimeFormat.DateTimeFormat.options parameter.options timeZoneName parameter

`options.timeZoneName` パラメータ
24
12
29
10
25
10
Intl.DateTimeFormat.DateTimeFormat.options parameter.options timeZoneName parameter.extended values

`options.timeZoneName` オプションとしての `shortGeneric`/`longGeneric`/`shortOffset`/`longOffset`
95
95
91
15.4
95
15.4
Intl.DateTimeFormat.DateTimeFormat.options parameter.options timeZone parameter

`options.timeZone` パラメータ
24
12
29
10
25
10
Intl.DateTimeFormat.DateTimeFormat.options parameter.options timeZone parameter.iana time zones

`options.timeZone` オプションの IANA タイムゾーン名
24
14
52
10
25
10
Intl.DateTimeFormat.format

format() は Intl.DateTimeFormat インスタンスのメソッドで、この Intl.DateTimeFormat オブジェクトのロケールと書式化オプションに従って日付や時刻を書式化します。
24
12
29
10
25
10
Intl.DateTimeFormat.formatRange

formatRange() は Intl.DateTimeFormat インスタンスのメソッドで、この Intl.DateTimeFormat オブジェクトがインスタンス化されたときに提供されたロケールとオプションに基づいて、もっとも簡明な方法で日時の範囲を書式化します。
76
79
91
14.1
76
14.5
Intl.DateTimeFormat.formatRangeToParts

formatRangeToParts() は Intl.DateTimeFormat インスタンスのメソッドで、Intl/DatetimeFormat/formatRange によって返される書式化文字列のそれぞれの部分を表すオブジェクトの配列を返します。これは、ロケール特定のトークンから独自の文字列を構築するのに便利です。
76
79
91
14.1
76
14.5
Intl.DateTimeFormat.formatToParts

formatToParts() は Intl.DateTimeFormat インスタンスのメソッドで、 Intl/DatetimeFormat/format が返す書式化済み文字列の各部分を表すオブジェクトの配列を返します。これは、ロケール固有のトークンからカスタム文字列を構築するのに便利です。
57
18
51
11
57
11
Intl.DateTimeFormat.resolvedOptions

resolvedOptions() は Intl.DateTimeFormat のメソッドで、この DateTimeFormat オブジェクトの初期化時に計算されたロケールや日時や書式化オプションを反映したプロパティを持つ新しいオブジェクトを返します。
24
12
29
10
25
10
Intl.DateTimeFormat.resolvedOptions.computed timezone

計算された「timeZone」
35
14
53
10
35
10
Intl.DateTimeFormat.supportedLocalesOf

Intl.DateTimeFormat.supportedLocalesOf() は静的メソッドで、ランタイムの既定のロケールで代替する必要なく日時の書式で対応されているものを含む配列を返します。
24
12
29
10
25
10
Intl.NumberFormat

Intl.NumberFormat オブジェクトは、言語に依存した数値書式を可能にするオブジェクトのコンストラクターです。
24
12
29
10
25
10
Intl.NumberFormat.NumberFormat

Intl.NumberFormat() コンストラクターは、言語に依存した数値の書式化ができる Intl.NumberFormat オブジェクトを生成します。
24
12
29
10
25
10
Intl.NumberFormat.NumberFormat.IntlLegacyConstructedSymbol

新しい Intl.NumberFormat オブジェクト。
91
91
54
14.1
91
14.5
Intl.NumberFormat.NumberFormat.locales parameter

「ロケール」パラメータ
24
12
29
10
25
10
Intl.NumberFormat.NumberFormat.options parameter

options`パラメータ
24
12
29
10
25
10
Intl.NumberFormat.NumberFormat.options parameter.options compactDisplay parameter

`options.compactDisplay` パラメータ
77
79
78
14.1
77
14.5
Intl.NumberFormat.NumberFormat.options parameter.options currencyDisplay parameter

`options.currencyDisplay` パラメータ
77
79
42
14.1
77
14.5
Intl.NumberFormat.NumberFormat.options parameter.options currencySign parameter

「options.currencySign」パラメータ
77
79
78
14.1
77
14.5
Intl.NumberFormat.NumberFormat.options parameter.options currency parameter

`options.currency` パラメータ
24
12
29
10
25
10
Intl.NumberFormat.NumberFormat.options parameter.options localeMatcher parameter

`options.localeMatcher` パラメータ
24
12
29
10
25
10
Intl.NumberFormat.NumberFormat.options parameter.options maximumFractionDigits parameter

「options.maximumFractionDigits」パラメータ
24
12
29
10
25
10
Intl.NumberFormat.NumberFormat.options parameter.options maximumSignificantDigits parameter

「options.maximumSignificantDigits」パラメータ
24
12
29
10
25
10
Intl.NumberFormat.NumberFormat.options parameter.options minimumFractionDigits parameter

「options.minimumFractionDigits」パラメータ
24
12
29
10
25
10
Intl.NumberFormat.NumberFormat.options parameter.options minimumIntegerDigits parameter

「options.minimumIntegerDigits」パラメータ
24
12
29
10
25
10
Intl.NumberFormat.NumberFormat.options parameter.options minimumSignificantDigits parameter

「options.minimumSignificantDigits」パラメータ
24
12
29
10
25
10
Intl.NumberFormat.NumberFormat.options parameter.options notation parameter

`options.notation` パラメータ
77
79
78
14.1
77
14.5
Intl.NumberFormat.NumberFormat.options parameter.options numberingSystem parameter

`options.numberingSystem` パラメータ
24
12
76
14.1
25
14.5
Intl.NumberFormat.NumberFormat.options parameter.options roundingIncrement parameter

`options.roundingIncrement` パラメータ
106
106
116
15.4
106
15.4
Intl.NumberFormat.NumberFormat.options parameter.options roundingMode parameter

`options.roundingMode` パラメータ
106
106
116
15.4
106
15.4
Intl.NumberFormat.NumberFormat.options parameter.options roundingPriority parameter

「options.roundingPriority」パラメータ
106
106
116
15.4
106
15.4
Intl.NumberFormat.NumberFormat.options parameter.options signDisplay parameter

`options.signDisplay` パラメータ
77
79
78
14.1
77
14.5
Intl.NumberFormat.NumberFormat.options parameter.options signDisplay parameter.negative

「負の」値
106
106
116
15.4
106
15.4
Intl.NumberFormat.NumberFormat.options parameter.options style parameter

`options.style` パラメータ
24
12
29
10
25
10
Intl.NumberFormat.NumberFormat.options parameter.options trailingZeroDisplay parameter

「options.trailingZeroDisplay」パラメータ
106
106
116
15.4
106
15.4
Intl.NumberFormat.NumberFormat.options parameter.options unitDisplay parameter

`options.unitDisplay` パラメータ
77
79
78
14.1
77
14.5
Intl.NumberFormat.NumberFormat.options parameter.options unit parameter

`options.unit` パラメータ
77
79
78
14.1
77
14.5
Intl.NumberFormat.NumberFormat.options parameter.options useGrouping parameter

`options.useGrouping` パラメータ
24
12
29
10
25
10
Intl.NumberFormat.NumberFormat.options parameter.options useGrouping parameter.string values

`options.useGrouping` パラメータは、`'always'`、`'auto'`、`'min2'` (`true` および `false` に加えて) を受け入れます。
106
106
116
16.4
106
16.4
Intl.NumberFormat.format

format() は Intl.NumberFormat インスタンスのメソッドで、この Intl.NumberFormat オブジェクトのロケールおよび書式設定オプションに応じて数値を書式化します。
24
12
29
10
25
10
Intl.NumberFormat.format.number parameter-string decimal

`number` パラメータ文字列値は 10 進数です (`Number` ではありません)
106
106
116
15.4
106
15.4
Intl.NumberFormat.formatRange

formatRange() は Intl.NumberFormat インスタンスのメソッドで、この Intl.NumberFormat オブジェクトのロケールおよび書式設定オプションに従って、数値の範囲を書式化します。
106
106
116
15.4
106
15.4
Intl.NumberFormat.formatRangeToParts

formatRangeToParts() は Intl.NumberFormat インスタンスのメソッドで、ロケール固有のトークンを含むオブジェクトの Array を返します。このトークンを使用して、ロケール固有の部分を保持したまま、独自の文字列を構築することができます。これにより、ロケールを認識する数値文字列の書式化範囲を指定することが可能になります。
106
106
116
15.4
106
15.4
Intl.NumberFormat.formatToParts

formatToParts() は Intl.NumberFormat インスタンスのメソッドで、 Intl/NumberFormat/format によって返される、書式化された文字列のそれぞれの部分を表すオブジェクトの配列を返します。これは、ロケール固有のトークンから独自の文字列を構築するのに役立ちます。
64
12
58
13
64
13
Intl.NumberFormat.resolvedOptions

resolvedOptions() は Intl.NumberFormat インスタンスのメソッドで、この NumberFormat オブジェクトの初期化中に計算されたオプションを反映するプロパティを持つ、新しいオブジェクトを返します。
24
12
29
10
25
10
Intl.NumberFormat.supportedLocalesOf

Intl.NumberFormat.supportedLocalesOf() は静的メソッドで、ランタイムの既定のロケールに代替されることなく、数値の書式化に対応する、指定されたロケールを含む配列を返します。
24
12
29
10
25
10
Intl.getCanonicalLocales

Intl.getCanonicalLocales() メソッドは、正規のロケール名を含む配列を返します。重複は省略され、要素は構造的に有効な言語タグとして検証されます。
54
16
48
10.1
54
10.3
Intl.supportedValuesOf

Intl.supportedValuesOf() は静的メソッドで、この実装で対応している暦、文字列の比較方法、通貨、記数法、単位が格納された配列を返します。
99
99
93
15.4
99
15.4
Number.toLocaleString

toLocaleString() は Number 値のメソッドで、この数値を表す言語依存の文字列を返します。 Intl.NumberFormat API に対応している実装においては、このメソッドは Intl.NumberFormat に委譲されます。
1
12
1
1
18
1
Number.toLocaleString.locales parameter

「ロケール」パラメータ
24
12
29
10
26
10
Number.toLocaleString.options parameter

options`パラメータ
24
12
29
10
26
10
Object.toLocaleString

toLocaleString() は Object インスタンスのメソッドで、オブジェクトを表す文字列を返します。このメソッドは、ロケール固有の目的のために派生オブジェクトによってオーバーライドするためのものです。
1
12
1
1
18
1
String.localeCompare

localeCompare() は String 値のメソッドで、参照文字列がソート順で指定された文字列の前か後か、または同じかを示す数値を返します。Intl.Collator API に対応している実装では、このメソッドは単に Intl.Collator を呼び出します。
1
12
1
3
18
1
String.localeCompare.locales parameter

「ロケール」パラメータ
24
12
29
10
26
10
String.localeCompare.options parameter

options`パラメータ
24
12
29
10
26
10
String.toLocaleLowerCase

toLocaleLowerCase() は String 値のメソッドで、呼び出した文字列の値を、ロケールに依存した対応付けに基づいて小文字に変換して返します。
1
12
1
1.3
18
1
String.toLocaleLowerCase.locales parameter

BCP 47 言語タグを持つ文字列、またはそのような文字列の配列です。 ロケール固有の大文字小文字の対応付けに従って小文字に変換するために使用するロケールを示します。 引数 locales の一般的な形成と解釈については、Intl メインページの引数の説明 を参照してください。
58
12
55
10
58
10
String.toLocaleUpperCase

toLocaleUpperCase() は String 値のメソッドで、呼び出した文字列の値を、ロケールに依存した対応付けに基づいて大文字に変換して返します。
1
12
1
1.3
18
1
String.toLocaleUpperCase.locales parameter

BCP 47 言語タグを持つ文字列、またはそのような文字列の配列です。 ロケール固有の大文字小文字の対応付けに従って大文字に変換するために使用するロケールを示します。 引数 locales の一般的な形成と解釈については、Intl メインページの引数の説明 を参照してください。
58
12
55
10
58
10
TypedArray.toLocaleString

toLocaleString() は TypedArray インスタンスのメソッドで、型付き配列の要素を表す文字列を返します。要素は toLocaleString メソッドを使用して文字列に変換され、これらの文字列はロケール依存の文字列（カンマ "," など）で区切られます。このメソッドは Array.prototype.toLocaleString() と同じアルゴリズムです。
7
12
51
5.1
18
5
1+対応 (バージョン) 未対応 ※注釈あり サブ機能の解説は MDN Web Docs (CC BY-SA 2.5)
注釈 3件
制限事項
  • このブラウザでは部分的にしか実装されていません
削除済み
  • このバージョンで機能が削除されました (91)
実装メモ
  • フォールバックシンボルのプロパティには `IntlFallback` という記述があります。
注釈 3件
制限事項
  • このブラウザでは部分的にしか実装されていません
削除済み
  • このバージョンで機能が削除されました (91)
実装メモ
  • フォールバックシンボルのプロパティには `IntlFallback` という記述があります。
注釈 3件
制限事項
  • このブラウザでは部分的にしか実装されていません
削除済み
  • このバージョンで機能が削除されました (91)
実装メモ
  • フォールバックシンボルのプロパティには `IntlFallback` という記述があります。
注釈 1件
実装メモ
  • バージョン 71 より前のバージョンでは、`formatToParts()` は `dayperiod` という不正確な大文字小文字の型キーを持つオブジェクトを返していた。バージョン 71 以降では、仕様で定義された `dayPeriod` を使用する。バグ 41402623 を参照のこと。
注釈 1件
実装メモ
  • バージョン 71 より前のバージョンでは、`formatToParts()` は `dayperiod` という不正確な大文字小文字の型キーを持つオブジェクトを返していた。バージョン 71 以降では、仕様で定義された `dayPeriod` を使用する。バグ 41402623 を参照のこと。
注釈 3件
制限事項
  • このブラウザでは部分的にしか実装されていません
削除済み
  • このバージョンで機能が削除されました (91)
実装メモ
  • フォールバックシンボルのプロパティには `IntlFallback` という記述があります。
注釈 3件
制限事項
  • このブラウザでは部分的にしか実装されていません
削除済み
  • このバージョンで機能が削除されました (91)
実装メモ
  • フォールバックシンボルのプロパティには `IntlFallback` という記述があります。
注釈 3件
制限事項
  • このブラウザでは部分的にしか実装されていません
削除済み
  • このバージョンで機能が削除されました (91)
実装メモ
  • フォールバックシンボルのプロパティには `IntlFallback` という記述があります。
注釈 3件
制限事項
  • このブラウザでは部分的にしか実装されていません
削除済み
  • このバージョンで機能が削除されました (14.1)
実装メモ
  • CurrencyDisplay: 'narrowSymbol'` をサポートしていません。
注釈 3件
制限事項
  • このブラウザでは部分的にしか実装されていません
削除済み
  • このバージョンで機能が削除されました (14.5)
実装メモ
  • CurrencyDisplay: 'narrowSymbol'` をサポートしていません。
注釈 1件
実装メモ
  • Edge 18以前では、数値は小数点以下15桁に丸められます。例えば、`new Intl.NumberFormat('en-US').format(100000000005)` は `"1,000,000,000,000,010"` を返します。
注釈 1件
実装メモ
  • Edge 18以前では、数値は小数点以下15桁に丸められます。例えば、`(100000000005).toLocaleString('en-US')` は `"1,000,000,000,000,010"` を返します。

基本構文

JAVASCRIPT 
// Number formatting
new Intl.NumberFormat('ja-JP', { style: 'currency', currency: 'JPY' })
  .format(1234567); // '¥1,234,567'

// Date Format
new Intl.DateTimeFormat('ja-JP', { dateStyle: 'long' })
  .format(new Date()); // 'April 6, 2026'

ライブデモ

Currency and number formatting

Format the same value for different locales and compare how separators and currency symbols change.

JavaScript
出力
「実行」ボタンを押してください

Date formatting by locale

Render one Date with multiple locale rules to see how calendar output differs.

JavaScript
出力
「実行」ボタンを押してください

実務での使いどころ

  • Intl の活用

    国際化APIの基盤。日付・数値・文字列の地域対応フォーマット機能を提供。

注意点

  • 特になし。すべての主要ブラウザで安定して動作する。

アクセシビリティ

  • JavaScript による動的更新時は、aria-live リージョンで変更をスクリーンリーダーに通知する。

参考リンク

Powered by web-features