Limited support 一部のブラウザのみ対応。使用時はサポート状況を確認すること。

概要

Intl.Locale の info 拡張で、週の開始曜日、週末の曜日、時間制(12時間/24時間)などのロケール固有の情報が取得できます。

対応ブラウザ

機能 デスクトップ モバイル
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
1+対応 (バージョン) 未対応 注釈あり サブ機能の解説は MDN Web Docs (CC BY-SA 2.5)
注釈 2件
対応条件
  • 以前は別名で対応していました: calendars (99)
実装メモ
  • アクセサ・プロパティとして実装されている。
注釈 2件
対応条件
  • 以前は別名で対応していました: calendars (99)
実装メモ
  • アクセサ・プロパティとして実装されている。
注釈 3件
削除済み
  • このバージョンで機能が削除されました (preview)
対応条件
  • 以前は別名で対応していました: calendars (15.4)
実装メモ
  • アクセサ・プロパティとして実装されている。
注釈 2件
対応条件
  • 以前は別名で対応していました: calendars (99)
実装メモ
  • アクセサ・プロパティとして実装されている。
注釈 2件
対応条件
  • 以前は別名で対応していました: calendars (15.4)
実装メモ
  • アクセサ・プロパティとして実装されている。
注釈 2件
対応条件
  • 以前は別名で対応していました: collations (99)
実装メモ
  • アクセサ・プロパティとして実装されている。
注釈 2件
対応条件
  • 以前は別名で対応していました: collations (99)
実装メモ
  • アクセサ・プロパティとして実装されている。
注釈 3件
削除済み
  • このバージョンで機能が削除されました (preview)
対応条件
  • 以前は別名で対応していました: collations (15.4)
実装メモ
  • アクセサ・プロパティとして実装されている。
注釈 2件
対応条件
  • 以前は別名で対応していました: collations (99)
実装メモ
  • アクセサ・プロパティとして実装されている。
注釈 2件
対応条件
  • 以前は別名で対応していました: collations (15.4)
実装メモ
  • アクセサ・プロパティとして実装されている。
注釈 2件
対応条件
  • 以前は別名で対応していました: hourCycles (99)
実装メモ
  • アクセサ・プロパティとして実装されている。
注釈 2件
対応条件
  • 以前は別名で対応していました: hourCycles (99)
実装メモ
  • アクセサ・プロパティとして実装されている。
注釈 3件
削除済み
  • このバージョンで機能が削除されました (preview)
対応条件
  • 以前は別名で対応していました: hourCycles (15.4)
実装メモ
  • アクセサ・プロパティとして実装されている。
注釈 2件
対応条件
  • 以前は別名で対応していました: hourCycles (99)
実装メモ
  • アクセサ・プロパティとして実装されている。
注釈 2件
対応条件
  • 以前は別名で対応していました: hourCycles (15.4)
実装メモ
  • アクセサ・プロパティとして実装されている。
注釈 2件
対応条件
  • 以前は別名で対応していました: numberingSystems (99)
実装メモ
  • アクセサ・プロパティとして実装されている。
注釈 2件
対応条件
  • 以前は別名で対応していました: numberingSystems (99)
実装メモ
  • アクセサ・プロパティとして実装されている。
注釈 3件
削除済み
  • このバージョンで機能が削除されました (preview)
対応条件
  • 以前は別名で対応していました: numberingSystems (15.4)
実装メモ
  • アクセサ・プロパティとして実装されている。
注釈 2件
対応条件
  • 以前は別名で対応していました: numberingSystems (99)
実装メモ
  • アクセサ・プロパティとして実装されている。
注釈 2件
対応条件
  • 以前は別名で対応していました: numberingSystems (15.4)
実装メモ
  • アクセサ・プロパティとして実装されている。
注釈 2件
対応条件
  • 以前は別名で対応していました: textInfo (99)
実装メモ
  • アクセサ・プロパティとして実装されている。
注釈 2件
対応条件
  • 以前は別名で対応していました: textInfo (99)
実装メモ
  • アクセサ・プロパティとして実装されている。
注釈 3件
削除済み
  • このバージョンで機能が削除されました (preview)
対応条件
  • 以前は別名で対応していました: textInfo (15.4)
実装メモ
  • アクセサ・プロパティとして実装されている。
注釈 2件
対応条件
  • 以前は別名で対応していました: textInfo (99)
実装メモ
  • アクセサ・プロパティとして実装されている。
注釈 2件
対応条件
  • 以前は別名で対応していました: textInfo (15.4)
実装メモ
  • アクセサ・プロパティとして実装されている。
注釈 2件
対応条件
  • 以前は別名で対応していました: timeZones (99)
実装メモ
  • アクセサ・プロパティとして実装されている。
注釈 2件
対応条件
  • 以前は別名で対応していました: timeZones (99)
実装メモ
  • アクセサ・プロパティとして実装されている。
注釈 3件
削除済み
  • このバージョンで機能が削除されました (preview)
対応条件
  • 以前は別名で対応していました: timeZones (15.4)
実装メモ
  • アクセサ・プロパティとして実装されている。
注釈 2件
対応条件
  • 以前は別名で対応していました: timeZones (99)
実装メモ
  • アクセサ・プロパティとして実装されている。
注釈 2件
対応条件
  • 以前は別名で対応していました: timeZones (15.4)
実装メモ
  • アクセサ・プロパティとして実装されている。
注釈 2件
対応条件
  • 以前は別名で対応していました: weekInfo (99)
実装メモ
  • アクセサ・プロパティとして実装されている。
注釈 2件
対応条件
  • 以前は別名で対応していました: weekInfo (99)
実装メモ
  • アクセサ・プロパティとして実装されている。
注釈 3件
削除済み
  • このバージョンで機能が削除されました (preview)
対応条件
  • 以前は別名で対応していました: weekInfo (15.4)
実装メモ
  • アクセサ・プロパティとして実装されている。
注釈 2件
対応条件
  • 以前は別名で対応していました: weekInfo (99)
実装メモ
  • アクセサ・プロパティとして実装されている。
注釈 2件
対応条件
  • 以前は別名で対応していました: weekInfo (15.4)
実装メモ
  • アクセサ・プロパティとして実装されている。

基本構文

JAVASCRIPT
// 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.

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

Compare multiple locales

Inspect locale data differences across English, Japanese, and Arabic locales.

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

Build a locale summary row

Create a compact UI summary object from Intl.Locale fields.

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

実務での使いどころ

  • Intl.Locale info の活用

    ロケールの追加情報(週の最初の曜日、時間制)を取得する API。

注意点

  • 一部のブラウザでのみ対応。使用前にブラウザサポートを確認すること。

アクセシビリティ

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

Powered by web-features