Intl.Locale info
getCalendars() は Intl.Locale インスタンスのメソッドで、このロケールの 1 つ以上の固有の暦識別子の配列を返します。
メモ: 一部のブラウザーの一部のバージョンでは、このメソッドが calendars と呼ばれるアクセサープロパティとして実装されていました。しかしこの実装ではアクセスするたびに新しい配列を返すため、locale.calendars === locale.calendars が常に false を返してしまい、この状況を防ぐために、現在はメソッドとして実装されています。詳細については、ブラウザーの互換性の表を確認してください。
対応ブラウザ
| 機能 | デスクトップ | モバイル | ||||
|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Safari | Chrome Android | Safari iOS | |
| 130 | 130 | | 17 | 130 | 17 | |
| ビルトインオブジェクト | ||||||
| getCollations() は Intl.Locale インスタンスのメソッドで、このロケールの 1 つ以上の照合型のリストを返します。 | 130 | 130 | | 17 | 130 | 17 |
| getHourCycles() は Intl.Locale インスタンスのメソッドで、個のロケールの 1 つ以上の固有の時制識別子の配列を返します。 | 130 | 130 | | 17 | 130 | 17 |
| getNumberingSystems() は Intl.Locale インスタンスのメソッドで、個のロケールの 1 つ以上の固有の記数法識別子の配列を返します。 | 130 | 130 | | 17 | 130 | 17 |
| getTextInfo() は Intl.Locale インスタンスのメソッドで、ロケールに対して ltr (左書き) または rtl (右書き) で示される文字の並び順を返します。 | 130 | 130 | | 17 | 130 | 17 |
| getTimeZones() は Intl.Locale インスタンスのメソッドで、このロケールに対応しているタイムゾーンのリストを返します。 | 130 | 130 | | 17 | 130 | 17 |
| getWeekInfo() は Intl.Locale インスタンスのメソッドで、このロケールに対して firstDay、weekend、minimalDays プロパティを持つ weekInfo オブジェクトを返します。 | 130 | 130 | | 17 | 130 | 17 |
- 以前は別名で対応していました: calendars (99)
- アクセサ・プロパティとして実装されている。
- 以前は別名で対応していました: calendars (99)
- アクセサ・プロパティとして実装されている。
- このバージョンで機能が削除されました (preview)
- 以前は別名で対応していました: calendars (15.4)
- アクセサ・プロパティとして実装されている。
- 以前は別名で対応していました: calendars (99)
- アクセサ・プロパティとして実装されている。
- 以前は別名で対応していました: calendars (15.4)
- アクセサ・プロパティとして実装されている。
- 以前は別名で対応していました: collations (99)
- アクセサ・プロパティとして実装されている。
- 以前は別名で対応していました: collations (99)
- アクセサ・プロパティとして実装されている。
- このバージョンで機能が削除されました (preview)
- 以前は別名で対応していました: collations (15.4)
- アクセサ・プロパティとして実装されている。
- 以前は別名で対応していました: collations (99)
- アクセサ・プロパティとして実装されている。
- 以前は別名で対応していました: collations (15.4)
- アクセサ・プロパティとして実装されている。
- 以前は別名で対応していました: hourCycles (99)
- アクセサ・プロパティとして実装されている。
- 以前は別名で対応していました: hourCycles (99)
- アクセサ・プロパティとして実装されている。
- このバージョンで機能が削除されました (preview)
- 以前は別名で対応していました: hourCycles (15.4)
- アクセサ・プロパティとして実装されている。
- 以前は別名で対応していました: hourCycles (99)
- アクセサ・プロパティとして実装されている。
- 以前は別名で対応していました: hourCycles (15.4)
- アクセサ・プロパティとして実装されている。
- 以前は別名で対応していました: numberingSystems (99)
- アクセサ・プロパティとして実装されている。
- 以前は別名で対応していました: numberingSystems (99)
- アクセサ・プロパティとして実装されている。
- このバージョンで機能が削除されました (preview)
- 以前は別名で対応していました: numberingSystems (15.4)
- アクセサ・プロパティとして実装されている。
- 以前は別名で対応していました: numberingSystems (99)
- アクセサ・プロパティとして実装されている。
- 以前は別名で対応していました: numberingSystems (15.4)
- アクセサ・プロパティとして実装されている。
- 以前は別名で対応していました: textInfo (99)
- アクセサ・プロパティとして実装されている。
- 以前は別名で対応していました: textInfo (99)
- アクセサ・プロパティとして実装されている。
- このバージョンで機能が削除されました (preview)
- 以前は別名で対応していました: textInfo (15.4)
- アクセサ・プロパティとして実装されている。
- 以前は別名で対応していました: textInfo (99)
- アクセサ・プロパティとして実装されている。
- 以前は別名で対応していました: textInfo (15.4)
- アクセサ・プロパティとして実装されている。
- 以前は別名で対応していました: timeZones (99)
- アクセサ・プロパティとして実装されている。
- 以前は別名で対応していました: timeZones (99)
- アクセサ・プロパティとして実装されている。
- このバージョンで機能が削除されました (preview)
- 以前は別名で対応していました: timeZones (15.4)
- アクセサ・プロパティとして実装されている。
- 以前は別名で対応していました: timeZones (99)
- アクセサ・プロパティとして実装されている。
- 以前は別名で対応していました: timeZones (15.4)
- アクセサ・プロパティとして実装されている。
- 以前は別名で対応していました: weekInfo (99)
- アクセサ・プロパティとして実装されている。
- 以前は別名で対応していました: weekInfo (99)
- アクセサ・プロパティとして実装されている。
- このバージョンで機能が削除されました (preview)
- 以前は別名で対応していました: weekInfo (15.4)
- アクセサ・プロパティとして実装されている。
- 以前は別名で対応していました: weekInfo (99)
- アクセサ・プロパティとして実装されている。
- 以前は別名で対応していました: weekInfo (15.4)
- アクセサ・プロパティとして実装されている。
基本構文
// Intl.Locale info example
// See MDN Web Docs for detailsライブデモ
Inspect locale calendar info
Read weekInfo, hour cycle, and calendars from Intl.Locale when supported.
Compare multiple locales
Inspect locale data differences across English, Japanese, and Arabic locales.
Build a locale summary row
Create a compact UI summary object from Intl.Locale fields.
実務での使いどころ
-
Intl.Locale info の活用
getCalendars() は Intl.Locale インスタンスのメソッドで、このロケールの 1 つ以上の固有の暦識別子の配列を返します。
注意点
- 一部のブラウザでのみ対応。使用前にブラウザサポートを確認すること。
アクセシビリティ
- JavaScript による動的更新時は、aria-live リージョンで変更をスクリーンリーダーに通知する。