JavaScript

Intl.DisplayNames() コンストラクター


編集:2023.01.09 by T.A.

[Edge]。→

言語を考慮した、言語、地域、文字体系、通貨の表示名の翻訳を可能にするオブジェクトを生成して返します。

構文
new Intl.DisplayNames([locales[, options]])
locales 省略可 言語コードの文字列、またはそのような文字列の配列です。→Intl:locales

default[](空配列)の場合はローカル システムの初期値になる?。

以下の Unicode 拡張キーが利用できます。→Intl:Unicode 拡張

nu
使用する数値の書式。→NumberingSystem

¶指定する意味はないと思いますが。

options 省略可。以下のプロパティを 1 つ以上持つオブジェクトです。
プロパティと値:
localeMatcher
ロケール照合アルゴリズムを表す文字列。値は以下の何れか。
lookup
best fit (既定値)

Intl:マッチング アルゴリズム

style
書式化スタイルを表す文字列。値は以下の何れか。
DA=new Intl.DisplayNames(○○);
D=DA.of(□□);
long (既定値)。

D: 「日本語」('ja', {style:'long', type:'language'}、'ja')

D: 「Japanese」('en', {style:'long', type:'language'}、'ja')

D: 「日本」('ja', {style:'long', type:'region'}、'JP')

D: 「Japan」('en', {style:'long', type:'region'}、'JP')

D: 「日本語の文字」('ja', {style:'long', type:'script'}、'Jpan')

D: 「Japanese」('en', {style:'long', type:'script'}、'Jpan')

D: 「日本円」('ja', {style:'long', type:'currency'}、'JPY')

D: 「Japanese Yen」('en', {style:'long', type:'currency'}、'JPY')

short

D: 「日本語」('ja', {style:'short', type:'language'}、'ja')

D: 「Japanese」('en', {style:'short', type:'language'}、'ja')

D: 「日本」('ja', {style:'short', type:'region'}、'JP')

D: 「Japan」('en', {style:'short', type:'region'}、'JP')

D: 「日本語の文字」('ja', {style:'short', type:'script'}、'Jpan')

D: 「Japanese」('en', {style:'short', type:'script'}、'Jpan')

D: 「日本円」('ja', {style:'short', type:'currency'}、'JPY')

D: 「Japanese Yen」('en', {style:'short', type:'currency'}、'JPY')

narrow

D: 「日本語」('ja', {style:'narrow', type:'language'}、'ja')

D: 「Japanese」('en', {style:'narrow', type:'language'}、'ja')

D: 「日本」('ja', {style:'narrow', type:'region'}、'JP')

D: 「Japan」('en', {style:'narrow', type:'region'}、'JP')

D: 「日本語の文字」('ja', {style:'narrow', type:'script'}、'Jpan')

D: 「Japanese」('en', {style:'narrow', type:'script'}、'Jpan')

D: 「日本円」('ja', {style:'narrow', type:'currency'}、'JPY')

D: 「Japanese Yen」('en', {style:'narrow', type:'currency'}、'JPY')

¶変わらないようですが。

type
翻訳のタイプを表す文字列。値は以下の何れか。→言語タグ

このプロパティ指定は必須のようです。

DA=new Intl.DisplayNames(○○);
D=DA.of(□□);
language 言語。

D: 「日本語」('ja', {type:'language'}、'ja')

D: 「英語」('ja', {type:'language'}、'en')

D: 「アラビア語」('ja', {type:'language'}、'ar')

region 国。

D: 「日本」('ja', {type:'region'}、'JP')

D: 「アメリカ合衆国」('ja', {type:'region'}、'US')

D: 「オーストラリア」('ja', {type:'region'}、'AU')

script 文字体系。

D: 「日本語の文字」('ja', {type:'script'}、'Jpan')

D: 「ラテン文字」('ja', {type:'script'}、'Latn')

D: 「ハングル」('ja', {type:'script'}、'Hang')

currency 通貨。→。表示例↓

D: 「日本円」('ja', {type:'currency'}、'JPY')

D: 「米ドル」('ja', {type:'currency'}、'USD')

D: 「アイスランド クローナ」('ja', {type:'currency'}、'ISK')

fallback
翻訳に使用する代替法を表す文字列。

仕様: 要求された表示名がシステムにない場合のフォールバック リターンを識別します。

code ¶不明。(既定値)
none ¶不明。
テスト
//●locales
DA=new Intl.DisplayNames('ja-JP', {type:'language'});  //日本語で、使用する種類:言語。
D=DA.of('ja');  //=[string]:日本語
D=DA.of('en');  //=[string]:英語
DA=new Intl.DisplayNames('en-US', {type:'language'});  //日本語で、使用する種類:言語。
D=DA.of('ja');  //=[string]:Japanese
D=DA.of('en');  //=[string]:English
DA=new Intl.DisplayNames('default', {type:'language'});  //初期値言語?で、使用する種類:言語。
D=DA.of('ja');  //=[string]:日本語
D=DA.of('en');  //=[string]:英語
DA=new Intl.DisplayNames([], {type:'language'});  //初期値言語?で、使用する種類:言語。
D=DA.of('ja');  //=[string]:日本語
D=DA.of('en');  //=[string]:英語

//●options
DA=new Intl.DisplayNames('ja', {type:'region'});  //日本語で、国コード。
D=DA.of('US');  //=[string]:アメリカ合衆国
D=DA.of('ja');  //=[string]:ja

DA=new Intl.DisplayNames('ja', {type:'script'});  //日本語で、文字体系。
D=DA.of('Jpan');  //=[string]:日本語の文字
D=DA.of('ja');  //エラー発生:invalid_argument

DA=new Intl.DisplayNames('ja', {type:'currency'});  //日本語で、通貨。
D=DA.of('ja');  //エラー発生:invalid_argument
D=DA.of('JP');  //エラー発生:invalid_argument
D=DA.of('JPY');  //=[string]:日本円

DA=new Intl.DisplayNames('ja', {type:'script'});  //日本語で、文字体系、フォールバック。
D=DA.of('XJpn');  //=[string]:XJpn
DA=new Intl.DisplayNames('ja', {type:'script', fallback:'none'});  //日本語で、文字体系、フォールバック。
D=DA.of('XJpn');  //=[undefined]:undefined
DA=new Intl.DisplayNames('ja', {type:'script', fallback:'code'});  //日本語で、文字体系、フォールバック。
D=DA.of('XJpn');  //=[string]:XJpn

//●localsの複数指定
DA=new Intl.DisplayNames(['ja', 'en'], {type:'language'});  //日本語と英語、タイプ:言語
D=DA.of('ja');  //=[string]:日本語
	//1方法しか翻訳されないようです。
DA=new Intl.DisplayNames(['en', 'ja'], {type:'language'});  //日本語と英語、タイプ:言語
D=DA.of('ja');  //=[string]:Japanese

of()


テスト