Intl.DisplayNames【国際化表示名】オブジェクト
メモ
概要
- 国際化対応の表示名 を操作 (下記に対応)
- 言語
- 地域
- 文字体系
- 通貨
- 暦
- 日時フィールド
基本操作
- new DisplayNames【国際化表示名】でオブジェクト生成
- ロケール・表示名タイプ・必要に応じてスタイル等 を指定
- of【表示名取得】メソッドで表示名を取得
関連
外部リンク
- ECMA-402 (英語)
DisplayNames Objects ES2024 Intl (11) ES2023 Intl (10) ES2022 Intl (9)
コンストラクタ・メソッド
コンストラクタ | 説明 |
---|---|
new Intl.DisplayNames ( locales, options ) | コンストラクタ |
メソッド | 説明 | |
---|---|---|
Intl.DisplayNames.prototype. | of ( code ) | 表示名取得 |
Intl.DisplayNames.prototype. | resolvedOptions ( ) | ロケール・オプション取得 |
Intl.DisplayNames. | supportedLocalesOf ( locales [, options ] ) | サポート ロケール取得 |
プロパティ
プロパティ | 説明 | |
---|---|---|
Intl.DisplayNames.prototype | [ @@toStringTag ] | タグ (デフォルト:'Intl.DisplayNames') 実装:DisplayNames[ Symbol.toStringTag ] |
Intl.DisplayNames.prototype. | constructor | コンストラクタ定義 |
Intl.DisplayNames. | prototype | プロトタイプ |
new Intl.DisplayNames【コンストラクタ】
メモ
- Intl.DisplayNames【国際化表示名】 オブジェクトを生成
- 関連
- 外部リンク
- ECMA-402 (英語)
Intl.DisplayNames ( locales, options ) ES2024 Intl (11) ES2023 Intl (10) ES2022 Intl (9) - ISO 639-1コード一覧
- BCP 47 (Best Current Practice) [英語]
- Unicode Locale Data Markup Language (LDML) [英語]
- ECMA-402 (英語)
構文
new Intl.DisplayNames(locales, options)
localesロケール (BCP 47 の言語タグ等)〔実装依存〕
文字列:1ロケール指定
文字列の配列:複数指定可 (適切な1ロケールを自動選択)
optionsオプション の組合せ
locales (ロケール) 実装依存
BCP 47 の言語タグ (一例)
値 | 備考 |
---|---|
ja | 日本語 |
ja-JP | 日本語 (日本) |
en-US | 英語 (アメリカ) |
en-GB | 英語 (イギリス) |
de-DE | ドイツ語 (ドイツ) |
fr-FR | フランス語 (フランス) |
ISO 639-1・639-2 (言語コード) 一例
ISO 639-1 | ISO 639-2 | ISO 639-3 | 備考 |
---|---|---|---|
ja | jpn | jpn | 日本語 |
en | eng | eng | 英語 |
de | deu ger | deu | ドイツ語 |
fr | fra fre | fra | フランス語 |
options (オプション)
オプション | 値 (太字:デフォルト値) | 説明 |
---|---|---|
fallback | 'code':コード 'none':なし | 代替名 (表示名がない場合) |
languageDisplay | 'dialect':日用語 'standard':標準 | 言語表示 (type【タイプ】が'language'【言語】の場合) |
localeMatcher | 'lookup':Lookupアルゴリズム 'best fit':最適アルゴリズム | ロケールマッチングアルゴリズム |
style | 'narrow':縮小形式 'short':短い形式 'long':長い形式 | スタイル |
type (必須) | 'calendar':暦 'currency':通貨 'dateTimeField':日時フィールド 'language':言語 'region':地域 'script':文字体系 | タイプ |
例 (1/2)
例 (2/2)
Intl.DisplayNames.prototype.of【表示名取得】
メモ
- タイプ別コードの表示名を取得
- 実装依存
- 表示形式:コンストラクタ のオプション指定
- 関連
- 外部リンク
- ECMA-402 (英語)
Intl.DisplayNames.prototype.of ( code ) ES2024 Intl (11) ES2023 Intl (10) ES2022 Intl (9) - BCP 47 (Best Current Practice) [英語]
- Unicode Technical Standard #35 (英語)
- Wikipedia
- IETF言語タグ
- ISO 639-1 (言語)
- ISO 639-2 (言語)
- ISO 639-3 (言語)
- ISO 639-1コード一覧 (言語)
- ISO 3166 (地域)
- ISO 3166-1 (地域)
- ISO 15924 (文字体系)
- ISO 4217 (通貨)
- ECMA-402 (英語)
構文
displayNames.of(code)
表示名 (実装依存)
codeタイプ別コード
RangeError 例外code (タイプ別コード)が不正
code (タイプ別コード)
コンストラクタ の options (オプション)の type | code (タイプ別コード) | 例 (実装依存) | ||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
'calendar' (暦) | 暦アルゴリズム (calendar.xml) | 'gregory':西暦(グレゴリオ暦) 'japanese':和暦 'iso8601':ISO-8601 | ||||||||||||||||||||||||||
'currency' (通貨) | ISO 通貨コード (3文字) (currency.xml) | 'JPY':日本円 'USD':米ドル 'GBP':英国ポンド 'EUR':ユーロ | ||||||||||||||||||||||||||
'dateTimeField' (日時フィールド) | 下記のコード
| 'year':年 'month':月 'day':日 'weekday':曜日 | ||||||||||||||||||||||||||
'language' (言語) | unicode_language_subtag [-unicode_script_subtag] [-unicode_region_subtag] [-unicode_variant_subtag] (複数指定可) (unicode_language_id) | 'ja':日本語 'ain':アイヌ語 'ja-JP':日本語 (日本) 'ja-Kana-JP':日本語 (カタカナ、日本) 'ja-392-hepburn':日本語 (日本、ヘボン式ローマ字) 'en':英語 'en-US':アメリカ英語 'en-GB':イギリス英語 | ||||||||||||||||||||||||||
'region' (地域) | 英字2文字 (ISO 3166-1) 3桁の地域コード (UN M.49)〔実装依存〕 (unicode_region_subtag) | 'JP':日本 'US':アメリカ 'GB':イギリス | ||||||||||||||||||||||||||
'script' (文字体系) | 英字4文字 (ISO 15924) (unicode_script_subtag) | 'Hani':漢字 (Han:漢王朝) 'Hira':ひらがな 'Kana':カタカナ 'Hrkt':仮名 (ひらがな+カタカナ) 'Jpan':日本語の文字 (漢字+ひらがな+カタカナ) 'Zsye':絵文字 'Latn':ラテン文字 |
例 (calendar:暦)
例 (currency:通貨)
例 (dateTimeField:日時フィールド)
例 (language:言語)
例 (region:地域)
例 (script:文字体系)
Intl.DisplayNames.prototype.resolvedOptions【ロケール・オプション取得】
メモ
- ロケール・オプションを取得
- 関連
- 外部リンク
- ECMA-402 (英語)
Intl.DisplayNames.prototype.resolvedOptions () ES2024 Intl (11) ES2023 Intl (10) ES2022 Intl (9)
- ECMA-402 (英語)
構文
displayNames.resolvedOptions( )
オブジェクト (下記プロパティ有効)
プロパティ | 説明 |
---|---|
locale | ロケール |
style | スタイル |
type | タイプ |
fallback | 代替名 |
例
Intl.DisplayNames.supportedLocalesOf【サポート ロケール取得】
メモ
- 指定ロケールから、サポート対象のロケールを取得
- 外部リンク
- ECMA-402 (英語)
Intl.DisplayNames.supportedLocalesOf ( locales [ , options ] ) ES2024 Intl (11) ES2023 Intl (10) ES2022 Intl (9)
- ECMA-402 (英語)
構文
Intl.DisplayNames.supportedLocalesOf( locales [, options])
サポートされるロケールの配列
localesBCP 47 言語タグの文字列 または その配列
(new DisplayNames【コンストラクタ】の ロケール詳細 を参照)
optionsマッチングオプション (localeMatcher【ロケールマッチングアルゴリズム】)
(new DisplayNames【コンストラクタ】の オプション詳細 を参照)