From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- .../global_objects/intl/locale/basename/index.html | 75 ++++ .../global_objects/intl/locale/calendar/index.html | 159 ++++++++ .../intl/locale/casefirst/index.html | 92 +++++ .../intl/locale/collation/index.html | 166 ++++++++ .../intl/locale/hourcycle/index.html | 96 +++++ .../global_objects/intl/locale/index.html | 104 +++++ .../global_objects/intl/locale/language/index.html | 67 ++++ .../global_objects/intl/locale/locale/index.html | 61 +++ .../global_objects/intl/locale/maximize/index.html | 79 ++++ .../global_objects/intl/locale/minimize/index.html | 78 ++++ .../intl/locale/numberingsystem/index.html | 419 +++++++++++++++++++++ .../global_objects/intl/locale/numeric/index.html | 65 ++++ .../global_objects/intl/locale/region/index.html | 67 ++++ .../global_objects/intl/locale/script/index.html | 67 ++++ .../global_objects/intl/locale/tostring/index.html | 67 ++++ 15 files changed, 1662 insertions(+) create mode 100644 files/ja/web/javascript/reference/global_objects/intl/locale/basename/index.html create mode 100644 files/ja/web/javascript/reference/global_objects/intl/locale/calendar/index.html create mode 100644 files/ja/web/javascript/reference/global_objects/intl/locale/casefirst/index.html create mode 100644 files/ja/web/javascript/reference/global_objects/intl/locale/collation/index.html create mode 100644 files/ja/web/javascript/reference/global_objects/intl/locale/hourcycle/index.html create mode 100644 files/ja/web/javascript/reference/global_objects/intl/locale/index.html create mode 100644 files/ja/web/javascript/reference/global_objects/intl/locale/language/index.html create mode 100644 files/ja/web/javascript/reference/global_objects/intl/locale/locale/index.html create mode 100644 files/ja/web/javascript/reference/global_objects/intl/locale/maximize/index.html create mode 100644 files/ja/web/javascript/reference/global_objects/intl/locale/minimize/index.html create mode 100644 files/ja/web/javascript/reference/global_objects/intl/locale/numberingsystem/index.html create mode 100644 files/ja/web/javascript/reference/global_objects/intl/locale/numeric/index.html create mode 100644 files/ja/web/javascript/reference/global_objects/intl/locale/region/index.html create mode 100644 files/ja/web/javascript/reference/global_objects/intl/locale/script/index.html create mode 100644 files/ja/web/javascript/reference/global_objects/intl/locale/tostring/index.html (limited to 'files/ja/web/javascript/reference/global_objects/intl/locale') diff --git a/files/ja/web/javascript/reference/global_objects/intl/locale/basename/index.html b/files/ja/web/javascript/reference/global_objects/intl/locale/basename/index.html new file mode 100644 index 0000000000..5157d8c0bd --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/intl/locale/basename/index.html @@ -0,0 +1,75 @@ +--- +title: Intl.Locale.prototype.baseName +slug: Web/JavaScript/Reference/Global_Objects/Intl/Locale/baseName +tags: + - Internationalization + - JavaScript + - Property + - Prototype + - Reference + - プロパティ + - 国際化 +translation_of: Web/JavaScript/Reference/Global_Objects/Intl/Locale/baseName +--- +
{{JSRef}}
+ +

Intl.Locale.prototype.baseName プロパティは、 Locale の文字列表現の部分文字列を返し、そこには Locale についての中核情報が含まれています。

+ +

解説

+ +

{{jsxref("Locale", "Intl.Locale")}} オブジェクトは、解析されたロケールとそのロケールのオプションを表します。 baseName プロパティは、ロケールに関する基本的な情報を、完全なデータ文字列の部分文字列の形で返します。具体的には、このプロパティは言語を含む部分文字列を返し、文字体系や地域があればそれも返します。

+ +

baseName は 言語 ["-" 文字体系] ["-" 地域] *("-" variant) の形で unicode_language_id grammar の部分文字列を返します。

+ +

例

+ +

基本的な例

+ +
let myLoc = new Intl.Locale("fr-Latn-CA"); // ロケールをカナダのフランス語に設定
+console.log(myLoc.toString()); // "fr-Latn-CA-u-ca-gregory" と表示
+console.log(myLoc.baseName); // "fr-Latn-CA" と表示
+ +

入力文字列のオプション付きの例

+ +
// 言語を日本語、地域を日本に設定する。
+
+// カレンダーをグレゴリオ暦、時制を24時制にする
+let japan = new Intl.Locale("ja-JP-u-ca-gregory-hc-24");
+console.log(japan.toString()); // "ja-JP-u-ca-gregory-hc-h24" と表示
+console.log(japan.baseName); // "ja-JP" と表示
+ +

入力文字列を上書きするオプション付きの例

+ +
// 入力文字列は言語がオランダ語、地域がベルギーであることを示していますが、
+
+// ただし、オプションオブジェクトで地域を上書きしており、オランダに設定しています
+let dutch = new Intl.Locale("nl-Latn-BE", {region: "NL"});
+
+console.log(dutch.baseName); // "nl-Latn-NL" と表示
+ +

仕様書

+ + + + + + + + + + + + +
仕様書
{{SpecName('ES Int Draft', '#sec-Intl.Locale.prototype.baseName')}}
+ +

ブラウザーの互換性

+ + + +
{{Compat("javascript.builtins.Intl.Locale.baseName")}}
+ +

関連情報

+ + diff --git a/files/ja/web/javascript/reference/global_objects/intl/locale/calendar/index.html b/files/ja/web/javascript/reference/global_objects/intl/locale/calendar/index.html new file mode 100644 index 0000000000..4df268ee41 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/intl/locale/calendar/index.html @@ -0,0 +1,159 @@ +--- +title: Intl.Locale.prototype.calendar +slug: Web/JavaScript/Reference/Global_Objects/Intl/Locale/calendar +tags: + - Internationalization + - JavaScript + - Property + - Prototype + - Reference + - プロパティ + - 国際化 +translation_of: Web/JavaScript/Reference/Global_Objects/Intl/Locale/calendar +--- +
{{JSRef}}
+ +

Intl.Locale.prototype.calendar プロパティは、 Locale で使用される暦の種類を返すアクセサープロパティです。

+ +

解説

+ +

calendar プロパティは Locale の一部、 Locale の暦を示す部分を返します。世界の大部分はグレゴリオ暦を使用していますが、世界各地で使用されている地域暦もいくつかあります。以下の表に、有効な Unicode 暦キー文字列をすべて示します。

+ +

Unicode 暦キー

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Unicode 暦キー
Calendar key (name)説明
buddhistタイの仏教暦
chinese古来の中国の暦
copticコプト暦
dangi古来の韓国の暦
ethioaaEthiopic calendar, Amete Alem (epoch approx. 5493 B.C.E)
ethiopicEthiopic calendar, Amete Mihret (epoch approx, 8 C.E.)
gregoryグレゴリオ暦
hebrew古来のヘブライ暦
indianインド暦
islamicイスラム暦
islamic-umalquraIslamic calendar, Umm al-Qura
islamic-tblaIslamic calendar, tabular (intercalary years [2,5,7,10,13,16,18,21,24,26,29] - astronomical epoch)
islamic-civilIslamic calendar, tabular (intercalary years [2,5,7,10,13,16,18,21,24,26,29] - civil epoch)
islamic-rgsaIslamic calendar, Saudi Arabia sighting
iso8601ISO カレンダー (ISO 8601 カレンダーの曜日規則を使用したグレゴリオ暦)
japanese日本の皇紀
persianペルシャ暦
roc中華民国暦
+
islamicc 暦は非推奨です。 islamic-civil を使用してください。
+ +

islamicc

+ 		Civil (algorithmic) Arabic calendar
+ +

例

+ +

ロケール文字列へのカレンダーの追加

+ +

暦は、ロケールキーの「拡張キー」に該当します。これらのキーは、ロケールに関するデータを追加するもので、拡張子 -u を使用してロケール識別子に追加します。したがって、 {{jsxref("Locale/Locale", "Intl.Locale")}} コンストラクターに渡される初期のロケール識別子文字列に暦の種類を追加することができます。暦の種類を追加するには、まず文字列に -u 拡張を追加します。次に、暦の種類を追加することを示すために -ca 拡張を追加します。最後に、暦を文字列に追加します。

+ +
let frBuddhist = new Intl.Locale("fr-FR-u-ca-buddhist");
+console.log(frBuddhist.calendar); // "buddhist" と表示
+ +

構成オブジェクトによる暦の追加

+ +

{{jsxref("Locale/Locale", "Intl.Locale")}} コンストラクターには、オプションで構成オブジェクトの引数があり、カレンダーを含めた拡張の種類を渡すために使用することができます。構成オブジェクトの calendar プロパティを望みの暦の値に設定し、コンストラクターに渡します。

+ +
let frBuddhist = new Intl.Locale("fr-FR", {calendar: "buddhist"});
+console.log(frBuddhist.calendar); // "buddhist" と表示
+
+ +

仕様書

+ + + + + + + + + + + + +
仕様書
{{SpecName('ES Int Draft', '#sec-Intl.Locale.prototype.calendar')}}
+ +

ブラウザーの互換性

+ + + +
{{Compat("javascript.builtins.Intl.Locale.calendar")}}
+ +

関連情報

+ + diff --git a/files/ja/web/javascript/reference/global_objects/intl/locale/casefirst/index.html b/files/ja/web/javascript/reference/global_objects/intl/locale/casefirst/index.html new file mode 100644 index 0000000000..6f337ab869 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/intl/locale/casefirst/index.html @@ -0,0 +1,92 @@ +--- +title: Intl.Locale.prototype.caseFirst +slug: Web/JavaScript/Reference/Global_Objects/Intl/Locale/caseFirst +tags: + - Internationalization + - Intl + - JavaScript + - Property + - Prototype + - Reference + - プロパティ + - 国際化 +translation_of: Web/JavaScript/Reference/Global_Objects/Intl/Locale/caseFirst +--- +
{{JSRef}}
+ +

Intl.Locale.prototype.caseFirst プロパティは、ロケールの照合規則に大文字・小文字を考慮するかどうかを返すアクセサプロパティです。

+ +

解説

+ +

ロケールの照合規則は、そのロケールでの文字列の並び順を決定するために用いられます。ロケールによっては、照合処理で文字の大文字・小文字を使用する場合があります。この追加ルールは、 {{jsxref("Locale", "Locale")}} の caseFirst プロパティで表現することができます。

+ +

caseFirst プロパティには下記の表にある通り、3種類の値を指定することができます。

+ +

caseFirst の値

+ + + + + + + + + + + + + + + + + + + + + + +
値説明
upper大文字は小文字よりも前に並べられます。
lower小文字は大文字よりも前に並べられます。
false大文字・小文字で特別な並べ替えはしません。
+ +

例

+ +

ロケール文字列による caseFirst 値の設定

+ +

Unicode ロケール文字列仕様書では、 caseFirst が表す値は kf キーに対応します。 kf はロケール文字列の「拡張子サブタグ」として扱われます。これらのサブタグは、ロケールに関するデータを追加するもので、 -u 拡張を使用してロケール識別子に追加されます。つまり、 caseFirst の値は、 Locale コンストラクターに渡される初期のロケール識別子文字列に追加することができます。 caseFirst の値を追加するには、まず文字列に -u 拡張キーを追加します。次に、照合順序の型を追加することを示すために -kf 拡張キーを追加します。最後に、 caseFirst の値を文字列に追加します。

+ +
let caseFirstStr = new Intl.Locale("fr-Latn-FR-u-kf-upper");
+console.log(caseFirstStr.caseFirst); // "upper" と表示
+ +

構成オブジェクト引数による caseFirst の値の設定

+ +

{{jsxref("Locale/Locale", "Intl.Locale")}} コンストラクターには、オプションで構成オブジェクトの引数があり、拡張の種類を渡すために使用することができます。構成オブジェクトの caseFirst プロパティを望みの caseFirst の値に設定し、コンストラクターに渡します。

+ +
let caseFirstObj= new Intl.Locale("en-Latn-US", {caseFirst: "lower"});
+console.log(us12hour.caseFirst); // "lower" と表示
+ +

仕様書

+ + + + + + + + + + + + +
仕様書
{{SpecName('ES Int Draft', '#sec-Intl.Locale.prototype.caseFirst')}}
+ +

ブラウザーの互換性

+ + + +
{{Compat("javascript.builtins.Intl.Locale.caseFirst")}}
+ +

関連情報

+ + diff --git a/files/ja/web/javascript/reference/global_objects/intl/locale/collation/index.html b/files/ja/web/javascript/reference/global_objects/intl/locale/collation/index.html new file mode 100644 index 0000000000..d2dad676cb --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/intl/locale/collation/index.html @@ -0,0 +1,166 @@ +--- +title: Intl.Locale.prototype.collation +slug: Web/JavaScript/Reference/Global_Objects/Intl/Locale/collation +tags: + - Internationalization + - Intl + - JavaScript + - Property + - Prototype + - Reference + - プロパティ + - 国際化 +translation_of: Web/JavaScript/Reference/Global_Objects/Intl/Locale/collation +--- +
{{JSRef}}
+ +

Intl.Locale.prototype.collation プロパティは、 Locale の照合種別を返すアクセサープロパティです。

+ +

解説

+ +

照合とは、文字列を並べ替える処理のことです。検索クエリの結果からデータベース内のレコードの順序付けまで、文字列を特定の順序に並べ替えて配置しなければならない場合に使用されます。文字列を順番に配置するという考えは些細なことのように思えるかもしれませんが、順序の考え方は地域や言語によって異なることがあります。 collation プロパティは、 JavaScript プログラマーが特定のロケールで使用される照合種別に簡単にアクセスできるようにすることを助けます。

+ +

利用可能な照合種別は下記の表にあります。 Unicode 照合仕様書 から引用したものです。

+ +

有効な照合種別

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
照合種別説明
big5hanラテン文字はピンイン順、漢字は big5 文字セット順 (中国語で使用)
compat前の版の順序で、互換性のため
dict辞書形式の順序 (シンハラ語など)
+
+

direct 照合順は非推奨です。使用しないでください。

+
+ +

direct

+ 		バイナリコードポイント順 (ヒンズー語で使用)
ducet既定の Unicode 照合順で、要素表順
emoji絵文字に推奨の順序
eorヨーロッパ語の順序の規則
gb2312ラテン文字はピンイン順、漢字は gb2312han 順 (中国語で使用)
phonebk電話帳形式の順序 (ドイツ語など)
phonetic発音順 (発音に基づく順序)
pinyinラテン文字と漢字はピンイン順 (中国語で使用)
reformedリフォーム順 (スウェーデン語など)
search文字列検索のための特殊な照合種別
searchjl韓国語の頭文字子音検索用の特殊な照合種別
standard各言語の既定の照合順
strokeラテン文字はピンイン順、漢字は画数順 (中国語で使用)
trad歴史的な形の順序 (スペイン語など)
unihanラテン文字はピンイン順、漢字は Unihan 部首画数順 (中国語で使用)
zhuyin +

ラテン文字はピンイン順、漢字とパパラモフォは注音順 (中国語で使用)

+
+ +

例

+ +

他のロケールのサブタグと同様、照合種別はロケール文字列やコンストラクターの構成オブジェクトの引数で {{jsxref("Locale", "Intl.Locale")}} オブジェクトに追加することができます。

+ +

ロケール文字列による照合種別の追加

+ +

Unicode ロケール文字列仕様書では、照合種別はロケールキーの「拡張子サブタグ」となります。これらのサブタグは、ロケールに関するデータを追加するもので、 -u 拡張を使用してロケール識別子に追加されます。つまり、照合種別は、ロケールのコンストラクターに渡される初期のロケール識別子文字列に追加することができます。照合種別を追加するには、まず文字列に -u 拡張を追加します。次に、照合順序の型を追加することを示すために -co 拡張を追加します。最後に、照合順序を文字列に追加します。

+ +
let stringColl = new Intl.Locale("en-Latn-US-u-co-emoji");
+console.log(stringColl.collation); // "emoji" と表示
+
+ +

構成オブジェクト引数による照合種別の追加

+ +

{{jsxref("Locale/Locale", "Intl.Locale")}} コンストラクターには、オプションで構成オブジェクトの引数があり、これには照合種別を含む任意の拡張の種類をいくつか含めることができます。構成オブジェクトの collation プロパティを任意の照合種別に設定し、コンストラクターに渡します。

+ +
let configColl = new Intl.Locale("en-Latn-US", {collation: "emoji"});
+console.log(configColl.collation); // "emoji" と表示
+ +

仕様書

+ + + + + + + + + + + + +
仕様書
{{SpecName('ES Int Draft', '#sec-Intl.Locale.prototype.collation')}}
+ +

ブラウザーの互換性

+ + + +

{{Compat("javascript.builtins.Intl.Locale.collation")}}

+ +

関連情報

+ + diff --git a/files/ja/web/javascript/reference/global_objects/intl/locale/hourcycle/index.html b/files/ja/web/javascript/reference/global_objects/intl/locale/hourcycle/index.html new file mode 100644 index 0000000000..1d68f033ed --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/intl/locale/hourcycle/index.html @@ -0,0 +1,96 @@ +--- +title: Intl.Locale.prototype.hourCycle +slug: Web/JavaScript/Reference/Global_Objects/Intl/Locale/hourCycle +tags: + - Internationalization + - Intl + - JavaScript + - Property + - Prototype + - Reference + - プロパティ + - 国際化 +translation_of: Web/JavaScript/Reference/Global_Objects/Intl/Locale/hourCycle +--- +
{{JSRef}}
+ +

Intl.Locale.prototype.hourCycle プロパティは、ロケールで使用される時刻保持書式の規則を返すアクセサープロパティです。

+ +

解説

+ +

世界中で使用されている時刻保持規則 (時制) には、主に12時制と24時制の2つの種類があります。 hourCycle プロパティを使用すると、 JavaScript のプログラマーが特定のロケールで使用されている時制に簡単にアクセスできるようになります。他の追加ロケールデータと同様に、時制種別は拡張サブタグであり、ロケール文字列に含まれるデータを拡張したものです。時制種別には、以下の表にある通り、いくつかの異なる値を設定することができます。

+ +

有効な時制種別

+ + + + + + + + + + + + + + + + + + + + + + + + + + +
時制種別説明
h121–12を使用する時制で、パターンの 'h' に対応します。12時制で、正子は午前12:00から始まります。
h230–23を使用する時制で、パターンの 'H' に対応します。24時制で、正子は0:00から始まります。
h110–11を使用する時制で、パターンの 'K' に対応します。12時制で、正子は午前0:00から始まります。
h241–24を使用する時制で、パターンの 'k' に対応します。24時制で、正子は24:00から始まります。
+ +

例

+ +

これらの例は、時制データを {{jsxref("Locale", "Locale")}} オブジェクトに追加する方法を示しています。

+ +

ロケール文字列による時制の追加

+ +

Unicode ロケール文字列仕様書では、時制はロケール文字列の「拡張サブタグ」です。これらのサブタグはロケールについての追加データであり、拡張キー -u を使用してロケール識別子に追加されます。このようして、 numeric の値を {{jsxref("Locale/Locale", "Locale")}} コンストラクターに渡される初期のロケール識別子文字列に追加することができます。時制種別の値を設定するには、まず文字列に -u 拡張キーを追加します。次に、 -hc 拡張キーを追加して、時制種別の値を追加していることを示します。最後に、時制種別の値を文字列に追加します。

+ +
let ja24hour = new Intl.Locale("ja-JP-u-hc-h23");
+console.log(ja24hour.hourCycle); // "h23" と表示
+ +

構成オブジェクト引数から時制を追加

+ +

{{jsxref("Locale/Locale", "Intl.Locale")}} コンストラクターには、オプションで構成オブジェクトの引数があり、これには時制種別を含む任意の拡張の種類をいくつか含めることができます。構成オブジェクトの hourCycle プロパティを任意の時制種別に設定し、コンストラクターに渡します。

+ +
let us12hour = new Intl.Locale("en-US", {hourCycle: "h12"});
+console.log(us12hour.hourCycle); // "h12" と表示
+ +

仕様書

+ + + + + + + + + + + + +
仕様書
{{SpecName('ES Int Draft', '#sec-Intl.Locale.prototype.hourCycle')}}
+ +

ブラウザーの互換性

+ + + +
{{Compat("javascript.builtins.Intl.Locale.hourCycle")}}
+ +

関連情報

+ + diff --git a/files/ja/web/javascript/reference/global_objects/intl/locale/index.html b/files/ja/web/javascript/reference/global_objects/intl/locale/index.html new file mode 100644 index 0000000000..d11507595d --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/intl/locale/index.html @@ -0,0 +1,104 @@ +--- +title: Intl.Locale +slug: Web/JavaScript/Reference/Global_Objects/Intl/Locale +tags: + - Class + - Internationalization + - Intl + - JavaScript + - Reference + - クラス + - 国際化 +translation_of: Web/JavaScript/Reference/Global_Objects/Intl/Locale +--- +
{{JSRef}}
+ +

Intl.Locale オブジェクトは、 Unicode ロケール識別子を表す Intl オブジェクトの標準組み込みプロパティです。

+ +
{{EmbedInteractiveExample("pages/js/intl-locale.html")}}
+ +

解説

+ +

Intl.Locale オブジェクトは、 Unicode ロケールをより簡単に操作できるようにするために作成されました。 Unicode は、ロケールをロケール識別子と呼ばれる文字列で表します。ロケール識別子は、言語識別子と拡張タグから構成されます。言語識別子はロケールの中核となるもので、言語、文字体系、地域サブタグから構成されます。ロケールに関する追加情報は、オプションの拡張タグに格納されます。拡張タグには、暦の種類や時計の種類、数値表記法の種類などのロケールに関する情報が格納されています。

+ +

従来、 Intl API は Unicode と同様に文字列を使用してロケールを表していました。これはシンプルで軽量な解決策であり、うまく機能します。しかし、 Locale クラスを追加することで、言語、文字体系、地域、拡張タグの解析や操作が容易になります。

+ +

コンストラクター

+ +
+
{{jsxref("Locale/Locale", "Intl.Locale()")}}
+
新しい Locale オブジェクトを生成します。
+
+ +

プロパティ

+ +
+
Intl.Locale.prototype
+
Locale コンストラクターのプロトタイプオブジェクトです。
+
+ +

インスタンスプロパティ

+ +
+
{{jsxref("Locale/baseName", "Intl.Locale.prototype.baseName")}}
+
この Locale に関する基本的な情報を、完全なデータ文字列の部分文字列の形で返します。
+
{{jsxref("Locale/calendar", "Intl.Locale.prototype.calendar")}}
+
このロケールの暦年を示す Locale の部分を返します。
+
{{jsxref("Locale/caseFirst", "Intl.Locale.prototype.caseFirst")}}
+
ロケールの照合規則に大文字・小文字を考慮しているかどうかを返します。
+
{{jsxref("Locale/collation", "Intl.Locale.prototype.collation")}}
+
この Locale の照合の種類を返します。これは、ロケールの規則に従って文字列を並べ替えるために使用します。
+
{{jsxref("Locale/hourCycle", "Intl.Locale.prototype.hourCycle")}}
+
このロケールが使用している時刻保持書式の規約を返します。
+
{{jsxref("Locale/language", "Intl.Locale.prototype.language")}}
+
このロケールに関連づけられた言語を返します。
+
{{jsxref("Locale/numberingSystem", "Intl.Locale.prototype.numberingSystem")}}
+
このロケールが使用している数値表記法を返します。
+
{{jsxref("Locale/numeric", "Intl.Locale.prototype.numeric")}}
+
このロケールが数字に対して特殊な照合順序を持っているかどうかを返します。
+
{{jsxref("Locale/region", "Intl.Locale.prototype.region")}}
+
このロケールに関連付けられた世界の地域 (通常は国) を返します。
+
{{jsxref("Locale/script", "Intl.Locale.prototype.script")}}
+
このロケールで使われている特定の言語を書く際に使用する文字体系を返します。
+
+ +

インスタンスメソッド

+ +
+
{{jsxref("Locale/minimize", "Intl.Locale.prototype.minimize()")}}
+
既存の値に基づいて、ロケールの言語、表記法、地域の最も可能性の高い値を取得します。
+
{{jsxref("Locale/maximize", "Intl.Locale.prototype.maximize()")}}
+
既存の値に基づいて、ロケールの言語、表記法、地域の最も可能性の高い値を取得します。
+
{{jsxref("Locale/toString", "Intl.Locale.prototype.toString()")}}
+
このロケールの完全なロケール識別子文字列を返します。
+
+ +

仕様書

+ + + + + + + + + + + + +
仕様書
{{SpecName('ES Int Draft', '#locale-objects')}}
+ +

ブラウザーの互換性

+ +
+ + +

{{Compat("javascript.builtins.Intl.Locale")}}

+
+ +

関連情報

+ + diff --git a/files/ja/web/javascript/reference/global_objects/intl/locale/language/index.html b/files/ja/web/javascript/reference/global_objects/intl/locale/language/index.html new file mode 100644 index 0000000000..7996d348df --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/intl/locale/language/index.html @@ -0,0 +1,67 @@ +--- +title: Intl.Locale.prototype.language +slug: Web/JavaScript/Reference/Global_Objects/Intl/Locale/language +tags: + - Internationalization + - Intl + - JavaScript + - Property + - Prototype + - Reference + - プロパティ + - 国際化 +translation_of: Web/JavaScript/Reference/Global_Objects/Intl/Locale/language +--- +
{{JSRef}}
+ +

Intl.Locale.prototype.language プロパティは、ロケールに関連付けられた言語を返すアクセサープロパティです。

+ +

解説

+ +

言語はロケールの中核的な特徴の一つです。 Unicode 仕様書では、ロケールの言語識別子を言語と地域を合わせたものとして扱います (イギリス英語とアメリカ英語などの方言や変化形を区別するためです)。 {{jsxref("Locale", "Locale")}} の language プロパティは、ロケールの言語サブタグを厳密に返します。

+ +

例

+ +

ロケール識別子の文字列引数で言語を設定

+ +

有効な Unicode 言語識別子となるためには、文字列は言語サブタグで始めなければなりません。 {{jsxref("Locale/Locale", "Locale")}} コンストラクターの主要な引数には、有効な Unicode ロケール識別子がなければならないので、コンストラクターを使用する際には必ず言語サブタグを持つ識別子を渡さなければなりません。

+ +
let langStr = new Intl.Locale("en-Latn-US");
+
+console.log(langStr.language); // "en" と表示
+ +

構成オブジェクトにより言語を上書き

+ +

言語サブタグは指定する必要がありますが、 {{jsxref("Locale/Locale", "Locale")}} コンストラクターは構成オブジェクトを取り、これを用いて言語サブタグを上書きすることができます。

+ +
let langObj = new Intl.Locale("en-Latn-US", {language: "es"});
+
+console.log(langObj.language); // "es" と表示
+ +

仕様書

+ + + + + + + + + + + + +
仕様書
{{SpecName('ES Int Draft', '#sec-Intl.Locale.prototype.language')}}
+ +

ブラウザーの互換性

+ + + +
{{Compat("javascript.builtins.Intl.Locale.language")}}
+ +

関連情報

+ + diff --git a/files/ja/web/javascript/reference/global_objects/intl/locale/locale/index.html b/files/ja/web/javascript/reference/global_objects/intl/locale/locale/index.html new file mode 100644 index 0000000000..8624c2d4ff --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/intl/locale/locale/index.html @@ -0,0 +1,61 @@ +--- +title: Intl.Locale() コンストラクター +slug: Web/JavaScript/Reference/Global_Objects/Intl/Locale/Locale +tags: + - Constructor + - Intl + - JavaScript + - Locale + - Reference + - コンストラクター + - ロケール +translation_of: Web/JavaScript/Reference/Global_Objects/Intl/Locale/Locale +--- +
{{JSRef}}
+ +

Intl.Locale コンストラクターは、 Intl オブジェクトの標準組み込みプロパティで、 Unicode ロケール識別子を表します。

+ +
{{EmbedInteractiveExample("pages/js/intl-locale.html")}}
+ +

構文

+ +
new Intl.Locale(tag [, options])
+ +

引数

+ +
+
tag
+
Unicode ロケール識別子の文字列です。
+
options
+
ロケールの構成を含むオブジェクトです。キーは Unicode ロケールタグで、値は有効な Unicode タグ値です。
+
+ +

仕様書

+ + + + + + + + + + + + +
仕様書
{{SpecName('ES Int Draft', '#sec-intl-locale-constructor')}}
+ +

ブラウザーの互換性

+ +
+ + +

{{Compat("javascript.builtins.Intl.Locale.Locale")}}

+
+ +

関連情報

+ + diff --git a/files/ja/web/javascript/reference/global_objects/intl/locale/maximize/index.html b/files/ja/web/javascript/reference/global_objects/intl/locale/maximize/index.html new file mode 100644 index 0000000000..1e2848c7e3 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/intl/locale/maximize/index.html @@ -0,0 +1,79 @@ +--- +title: Intl.Locale.prototype.maximize() +slug: Web/JavaScript/Reference/Global_Objects/Intl/Locale/maximize +tags: + - Internationaliztion + - Intl + - JavaScript + - Method + - Prototype + - Reference + - メソッド + - 国際化 +translation_of: Web/JavaScript/Reference/Global_Objects/Intl/Locale/maximize +--- +
{{JSRef}}
+ +

Intl.Locale.prototype.maximize() メソッドは、既存の値に基づいてロケールの言語、表記法、地域の最も可能性の近い値を取得します。

+ +
{{EmbedInteractiveExample("pages/js/intl-locale-prototype-maximize.html")}}
+ + + +

構文

+ +
locale.maximize()
+ +

返値

+ +

{{jsxref("Locale", "Locale")}} インスタンスで、 baseName プロパティが、 Add Likely Subtags アルゴリズムが {{jsxref("Locale/baseName", "locale.baseName")}} に対して実行された結果になったものを返します。

+ +

解説

+ +

不完全な言語識別子をもとに、最も可能性の高いロケール言語識別子サブタグを識別できると便利な場合があります。 Add Likely Subtags アルゴリズムはこの機能を提供してくれます。例えば、言語識別子 "en" が与えられた場合、アルゴリズムは "en-Latn-US" を返すことになります。英語はラテン文字でしか書けませんし、世界最大の英語圏の国であるアメリカで使われている可能性が高いからです。この機能は、 maximize() メソッドを介して JavaScript プログラマーに提供されています。 maximize() は、言語識別子を構成する主要なサブタグのうち言語サブ、表記法、地域の各サブタグにのみ影響を与えます。ロケール識別子の "-u" の後にあるその他のサブタグは拡張サブタグと呼ばれ、 maximize() メソッドの影響を受けません。これらのサブタグの例としては、 {{jsxref("Locale/hourCycle", "Locale.hourCycle")}}, {{jsxref("Locale/calendar", "Locale.calendar")}}, {{jsxref("Locale/numeric", "Locale.numeric")}} などがあります。

+ +

例

+ +
let myLocale = new Intl.Locale("ja", {hourCycle: "h24", calendar: "gregory"});
+console.log(myLocale.baseName); // "ja" と表示
+console.log(myLocale.toString()); // "ja-u-ca-gregory-hc-h24" と表示
+let myLocMaximized = myLocale.maximize();
+
+// "ja-Jpan-JP"。 "Jpan" と "JP" タグが追加されます。
+// これは、日本語が主に漢字かな交じり文 (Jpan) で書かれ、また主に日本 (JP) で話されているためです。
+console.log(myLocMaximized.baseName);
+
+// "ja-Jpan-JP-u-ca-gregory-hc-h24" と表示します。
+// なお、拡張タグ ("-u" 以降) はそのまま残ります。
+console.log(myLocMaximized.toString());
+ +

仕様書

+ + + + + + + + + + + + +
仕様書
{{SpecName('ES Int Draft', '#sec-Intl.Locale.prototype.maximize')}}
+ +

ブラウザーの互換性

+ +
+ + +

{{Compat("javascript.builtins.Intl.Locale.maximize")}}

+
+ +

関連情報

+ + diff --git a/files/ja/web/javascript/reference/global_objects/intl/locale/minimize/index.html b/files/ja/web/javascript/reference/global_objects/intl/locale/minimize/index.html new file mode 100644 index 0000000000..51c26a0498 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/intl/locale/minimize/index.html @@ -0,0 +1,78 @@ +--- +title: Intl.Locale.prototype.minimize() +slug: Web/JavaScript/Reference/Global_Objects/Intl/Locale/minimize +tags: + - Internationalization + - Intl + - JavaScript + - Method + - Prototype + - Reference + - 国際化 +translation_of: Web/JavaScript/Reference/Global_Objects/Intl/Locale/minimize +--- +
{{JSRef}}
+ +

Intl.Locale.prototype.minimize() メソッドは、 {{jsxref("Locale/maximize", "Locale.maximize()")}} を呼び出したことで追加されるロケールに関する情報を削除しようとします。

+ +
{{EmbedInteractiveExample("pages/js/intl-locale-prototype-minimize.html", "taller")}}
+ + + +

構文

+ +
locale.minimize()
+ +

返値

+ +

{{jsxref("Locale", "Locale")}} インスタンスで、 baseName プロパティが、 Remove Likely Subtags アルゴリズムが locale.baseName に対して実行された結果になったものを返します。

+ +

解説

+ +

このメソッドは {{jsxref("Locale/maximize", "maximize()")}} の逆の処理を行い、ロケールの言語識別子 (基本的には baseName の内容) から言語、文字体系、地域のサブタグをすべて削除します。これは、言語識別子の中に余分なサブタグがある場合に便利です。例えば "en-Latn" は "en" に簡略化できます。英語では "Latn" が書き言葉に使われる唯一の文字体系だからです。 minimize() が影響を与えるのは、言語識別子を構成する主要なサブタグである言語、文字体系、地域の各サブタグのみです。ロケール識別子の "-u" の後にあるその他のサブタグは拡張サブタグと呼ばれ、 minimize() メソッドの影響を受けません。これらのサブタグの例としては、 {{jsxref("Locale/hourCycle", "Locale.hourCycle")}}, {{jsxref("Locale/calendar", "Locale.calendar")}}, {{jsxref("Locale/numeric", "Locale.numeric")}} などがあります。

+ +

例

+ +
let myLocale = new Intl.Locale("ja-Jpan-JP", {hourCycle: "h24", calendar: "gregory"});
+console.log(myLocale.baseName); // "ja-Jpan-JP" と表示
+console.log(myLocale.toString()); // "ja-Jpan-JP-u-ca-gregory-hc-h24" と表示
+
+let myLocMinimized = myLocale.minimize();
+
+// "ja" のみを表示します。日本語は主に漢字かな交じり文 (Jpan) で
+// 表記され、またほとんど日本で話されているためです。
+console.log(myLocMinimized.baseName);
+
+// "ja-u-ca-gregory-hc-h24" と表示します。
+// なお、拡張タグ ("-u" 以降) はそのまま残ります。
+console.log(myLocMinimized.toString());
+ +

仕様書

+ + + + + + + + + + + + +
仕様書
{{SpecName('ES Int Draft', '#sec-Intl.Locale.prototype.minimize')}}
+ +

ブラウザーの互換性

+ +
+ + +

{{Compat("javascript.builtins.Intl.Locale.minimize")}}

+
+ +

関連情報

+ + diff --git a/files/ja/web/javascript/reference/global_objects/intl/locale/numberingsystem/index.html b/files/ja/web/javascript/reference/global_objects/intl/locale/numberingsystem/index.html new file mode 100644 index 0000000000..02d82c108e --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/intl/locale/numberingsystem/index.html @@ -0,0 +1,419 @@ +--- +title: Intl.Locale.prototype.numberingSystem +slug: Web/JavaScript/Reference/Global_Objects/Intl/Locale/numberingSystem +tags: + - Internationalization + - Intl + - JavaScript + - Property + - Prototype + - Reference + - プロパティ + - 国際化 +translation_of: Web/JavaScript/Reference/Global_Objects/Intl/Locale/numberingSystem +--- +
{{JSRef}}
+ +

Intl.Locale.prototype.numberingSystem プロパティは、ロケールが使用する命数法を返すアクセサープロパティです。

+ +

解説

+ +

命数法とは、数値を表現するための体系のことです。 numberingSystem プロパティは、世界中のさまざまな国、地域、文化で使用されているさまざまな命数法を表現する支援をします。ほとんどの国際化スキーマと同様に、 Locale オブジェクトで numberingSystem によって表現できる命数法は、 Unicode で標準化されています。標準的な Unicode の命数法の表を以下に示します。

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
値説明
adlmAdlam digits
ahomAhom digits
arabアラビア・インド数字
arabext拡張アラビア・インド数字
armn大文字のアルメニア数字 — アルゴリズム
armnlow小文字のアルメニア数字 — アルゴリズム
baliBalinese digits
bengBengali digits
bhksBhaiksuki digits
brahBrahmi digits
cakmChakma digits
chamCham digits
cyrlキリル数字 — アルゴリズム
devaDevanagari digits
ethiエチオピア数字 — アルゴリズム
finance金融数字 — アルゴリズムの場合あり
fullwide全角数字
georジョージア数字 — アルゴリズム
gongGunjala Gondi digits
gonmMasaram Gondi digits
grek大文字のギリシャ数字 — アルゴリズム
greklow小文字のギリシャ数字 — アルゴリズム
gujrGujarati digits
guruGurmukhi digits
hanidays太陰暦またはその他の旧暦向けの漢字による日付の数字
hanidec漢字を数字として使用した命数法
hans簡体字の漢数字 — アルゴリズム
hansfin簡体字の金融用漢数字 — アルゴリズム
hant繁体字の漢数字 — アルゴリズム
hantfin繁体字の金融用漢数字 — アルゴリズム
hebrヘブライ数字 — アルゴリズム
hmngPahawh Hmong digits
hmnpNyiakeng Puachue Hmong digits
javaJavanese digits
jpan日本語の漢数字 — アルゴリズム
jpanfin日本語の金融用漢数字 — アルゴリズム
jpanyear日本語の元号用漢数字 (元年表記に対応)
kaliKayah Li digits
khmrKhmer digits
kndaKannada digits
lanaTai Tham Hora (secular) digits
lanathamTai Tham Tham (ecclesiastical) digits
laooLao digits
latnラテン数字
lepcLepcha digits
limbLimbu digits
mathbold数学的太数字
mathdbl数学的黒板太数字
mathmono数学的等幅数字
mathsanb数学的サンセリフ太数字
mathsans数学的サンセリフ数字
mlymMalayalam digits
modiModi digits
mongMongolian digits
mrooMro digits
mteiMeetei Mayek digits
mymrMyanmar digits
mymrshanMyanmar Shan digits
mymrtlngMyanmar Tai Laing digits
nativeネイティブの数字
newaNewa digits
nkooN'Ko digits
olckOl Chiki digits
oryaOriya digits
osmaOsmanya digits
rohgHanifi Rohingya digits
roman大文字のローマ数字 — アルゴリズム
romanlow小文字のローマ数字 — アルゴリズム
saurSaurashtra digits
shrdSharada digits
sindKhudawadi digits
sinhSinhala Lith digits
soraSora_Sompeng digits
sundSundanese digits
takrTakri digits
taluNew Tai Lue digits
tamlタミル数字 — アルゴリズム
tamldecModern Tamil decimal digits
teluTelugu digits
thaiThai digits
tirhTirhuta digits
tibtTibetan digits
traditio伝統的な数字 — アルゴリズムの場合あり
vaiiVai digits
waraWarang Citi digits
wchoWancho digits
+ +

例

+ +

ロケール文字列から numberingSystem の値を設定

+ +

Unicode ロケール文字列仕様書では、 numberingSystem が表す値はキー nu に対応しています。 nu はロケール文字列の「拡張サブタグ」とみなされます。これらのサブタグは、ロケールに関する追加データを追加するもので、拡張キー -u を使用してロケール識別子に追加されます。このようして、 numberingSystem の値を {{jsxref("Locale/Locale", "Locale")}} コンストラクターに渡される初期のロケール識別子文字列に追加することができます。 numeric の値を設定するには、まず文字列に -u 拡張キーを追加します。次に、 -nu 拡張キーを追加して、 numberingSystem の値を追加していることを示します。最後に、文字列に numberingSystem の値を追加します。

+ +
let numberingSystemViaStr = new Intl.Locale("fr-Latn-FR-u-nu-mong");
+console.log(numberingSystemStr.numberingSystem); // "mong" と表示
+ +

構成オブジェクト引数から numberingSystem の値を設定

+ +

{{jsxref("Locale/Locale", "Intl.Locale")}} コンストラクターには、オプションで構成オブジェクトの引数があり、これを使用して拡張の種類を渡すことができます。構成オブジェクトの numberingSystem プロパティを任意の numberingSystem に設定し、コンストラクターに渡します。

+ +
let numberingSystemViaObj= new Intl.Locale("en-Latn-US", {numberingSystem: "latn"});
+console.log(us12hour.numberingSystem); // "latn" と表示
+
+ +

仕様書

+ + + + + + + + + + + + +
仕様書
{{SpecName('ES Int Draft', '#sec-Intl.Locale.prototype.numberingSystem')}}
+ +

ブラウザーの互換性

+ + + +
{{Compat("javascript.builtins.Intl.Locale.numberingSystem")}}
+ +

関連情報

+ + diff --git a/files/ja/web/javascript/reference/global_objects/intl/locale/numeric/index.html b/files/ja/web/javascript/reference/global_objects/intl/locale/numeric/index.html new file mode 100644 index 0000000000..f60bc08e48 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/intl/locale/numeric/index.html @@ -0,0 +1,65 @@ +--- +title: Intl.Locale.prototype.numeric +slug: Web/JavaScript/Reference/Global_Objects/Intl/Locale/numeric +tags: + - Internationalization + - Intl + - JavaScript + - Property + - Prototype + - Reference + - プロパティ + - 国際化 +translation_of: Web/JavaScript/Reference/Global_Objects/Intl/Locale/numeric +--- +
{{JSRef}}
+ +

Intl.Locale.prototype.numeric プロパティは、ロケールが特別な数字の照合処理を行うかどうかを返すアクセサプロパティです。

+ +

解説

+ +

{{jsxref("Locale.caseFirst", "Intl.Locale.caseFirst")}} と同様、 numeric はロケールが使用する照合規則を変更するものです。 numeric は {{jsxref("boolean", "Boolean")}} 値で、 true か false のどちらかになります。 numeric を false に設定した場合は、文字列内の数値を特別に扱うことはありません。 numeric を true に設定した場合は、ロケールは文字列を照合する際に数値を考慮します。この数値の特別な扱いとは、数字の並びを数値として比較するということです。例えば、 "A-21" という文字列は "A-123" よりも小さいとみなされます。

+ +

例

+ +

ロケール文字列から numeric の値を設定

+ +

Unicode ロケール文字列仕様書では、 numeric が表す値はキー kn に対応しています。 kn はロケール文字列の「拡張サブタグ」とみなされます。これらのサブタグは、ロケールに関する追加データを追加するもので、拡張キー -u を使用してロケール識別子に追加されます。このようして、 numeric の値を {{jsxref("Locale/Locale", "Locale")}} コンストラクターに渡される初期のロケール識別子文字列に追加することができます。 numeric の値を設定するには、まず文字列に -u 拡張キーを追加します。次に、 -kn 拡張キーを追加して、 numeric の値を追加していることを示します。最後に、文字列に numeric の値を追加します。 numeric を true に設定したい場合は、単に kn キーを追加するだけで十分です。値を false にするには、 kn キーの後に "false" を指定する必要があります。

+ +
let numericViaStr = new Intl.Locale("fr-Latn-FR-u-kn-false");
+console.log(numericStr.numeric); // "false" と表示
+ +

構成オブジェクト引数から numeric の値を設定

+ +

{{jsxref("Locale/Locale", "Intl.Locale")}} コンストラクターには、オプションで構成オブジェクトの引数があり、これを使用して拡張の種類を渡すことができます。構成オブジェクトの numeric プロパティを任意の numeric に設定し、コンストラクターに渡します。

+ +
let numericViaObj= new Intl.Locale("en-Latn-US", {numeric: true});
+console.log(us12hour.numeric); // "true" と表示
+
+ +

仕様書

+ + + + + + + + + + + + +
仕様書
{{SpecName('ES Int Draft', '#sec-Intl.Locale.prototype.numeric')}}
+ +

ブラウザーの互換性

+ + + +
{{Compat("javascript.builtins.Intl.Locale.numeric")}}
+ +

関連情報

+ + diff --git a/files/ja/web/javascript/reference/global_objects/intl/locale/region/index.html b/files/ja/web/javascript/reference/global_objects/intl/locale/region/index.html new file mode 100644 index 0000000000..d547e24b15 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/intl/locale/region/index.html @@ -0,0 +1,67 @@ +--- +title: Intl.Locale.prototype.region +slug: Web/JavaScript/Reference/Global_Objects/Intl/Locale/region +tags: + - Internationalization + - Intl + - JavaScript + - Property + - Prototype + - Reference + - プロパティ + - 国際化 +translation_of: Web/JavaScript/Reference/Global_Objects/Intl/Locale/region +--- +
{{JSRef}}
+ +

Intl.Locale.prototype.region プロパティは、ロケールに関連付けられた世界の地域 (ふつうは国) 返すアクセサープロパティです。

+ +

解説

+ +

地域は、ロケールを世界の特定の地域に位置づけるための、ロケール識別子の重要な要素となります。ロケールの地域を知ることは、ロケール間の違いを識別する上で非常に重要です。たとえば、イギリスとアメリカ合衆国では英語が使われていますが、両国間では綴りやその他の言語の慣習に違いがあります。ロケールの地域を知ることで、 JavaScript プログラマーがサイトやアプリケーションのコンテンツを世界の様々な地域から見たときに正しく表示されるようにするのに役立ちます。

+ +

例

+ +

ロケール識別子の文字列引数で地域を設定

+ +

地域は、有効な Unicode 言語識別子文字列の３番目の部分であり、これを {{jsxref("Locale/Locale", "Locale")}} コンストラクターに渡すロケール識別子文字列に追加することで設定することができます。なお、地域はロケール識別子の必須項目ではありません。

+ +
let regionStr = new Intl.Locale("en-Latn-US");
+
+console.log(regionStr.region); // "US" と表示
+ +

構成オブジェクトから地域を設定

+ +

{{jsxref("Locale/Locale", "Locale")}} コンストラクターは構成オブジェクトを取り、これを用いて地域のサブタグとプロパティを設定することができます。

+ +
let regionObj = new Intl.Locale("ja-Jpan", {region: "JP"});
+
+console.log(scriptObj.script); // "JP" と表示
+ +

仕様書

+ + + + + + + + + + + + +
仕様書
{{SpecName('ES Int Draft', '#sec-Intl.Locale.prototype.region')}}
+ +

ブラウザーの互換性

+ + + +
{{Compat("javascript.builtins.Intl.Locale.region")}}
+ +

関連情報

+ + diff --git a/files/ja/web/javascript/reference/global_objects/intl/locale/script/index.html b/files/ja/web/javascript/reference/global_objects/intl/locale/script/index.html new file mode 100644 index 0000000000..10452b6342 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/intl/locale/script/index.html @@ -0,0 +1,67 @@ +--- +title: Intl.Locale.prototype.script +slug: Web/JavaScript/Reference/Global_Objects/Intl/Locale/script +tags: + - Internationalization + - Intl + - JavaScript + - Property + - Prototype + - Reference + - プロパティ + - 国際化 +translation_of: Web/JavaScript/Reference/Global_Objects/Intl/Locale/script +--- +
{{JSRef}}
+ +

Intl.Locale.prototype.script プロパティは、ロケールで使われている特定の言語を書くための文字体系を返すアクセサープロパティです。

+ +

解説

+ +

文字体系は、用字系と呼ばれることもありますが、ロケールの核となる属性の一つです。これは、特定の言語を書くために使用される記号やグリフの集合を示しています。例えば、英語の文字はラテン文字ですが、韓国語の文字はハングルです。多くの場合、言語 (これは必須) は単一の文字体系でしか書かれないので、文字体系を記述することは厳密には必要ありません。この規則には例外があり、完全な Unicode 言語識別子を持つためには、可能な限りスクリプトを示すことが重要です。

+ +

例

+ +

ロケール識別子の文字列引数で文字体系を設定

+ +

文字体系は、有効な Unicode 言語識別子文字列の２番目の部分であり、これを {{jsxref("Locale/Locale", "Locale")}} コンストラクターに渡すロケール識別子文字列に追加することで設定することができます。なお、文字体系はロケール識別子の必須項目ではありません。

+ +
let scriptStr = new Intl.Locale("en-Latn-US");
+
+console.log(scriptStr.script); // "Latn" と表示
+ +

構成オブジェクトから文字体系を設定

+ +

{{jsxref("Locale/Locale", "Locale")}} コンストラクターは構成オブジェクトを取り、これを用いて文字体系のサブタグとプロパティを設定することができます。

+ +
let scriptObj = new Intl.Locale("ja-JP", {script: "Jpan"});
+
+console.log(scriptObj.script); // "Jpan" と表示
+ +

仕様書

+ + + + + + + + + + + + +
仕様書
{{SpecName('ES Int Draft', '#sec-Intl.Locale.prototype.script')}}
+ +

ブラウザーの互換性

+ + + +
{{Compat("javascript.builtins.Intl.Locale.script")}}
+ +

関連情報

+ + diff --git a/files/ja/web/javascript/reference/global_objects/intl/locale/tostring/index.html b/files/ja/web/javascript/reference/global_objects/intl/locale/tostring/index.html new file mode 100644 index 0000000000..104a328f21 --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/intl/locale/tostring/index.html @@ -0,0 +1,67 @@ +--- +title: Intl.Locale.prototype.toString() +slug: Web/JavaScript/Reference/Global_Objects/Intl/Locale/toString +tags: + - Intl + - JavaScript + - Method + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Intl/Locale/toString +--- +
{{JSRef}}
+ +

Intl.Locale.prototype.toString() は、このロケールの完全なロケール識別子文字列を返します。

+ +
{{EmbedInteractiveExample("pages/js/intl-locale-prototype-tostring.html")}}
+ + + +

構文

+ +
locale.toString()
+ +

返値

+ +

このロケールの Unicode ロケール識別子文字列です。

+ +

解説

+ +

Locale オブジェクトは、概念的な Unicode ロケール識別子を JavaScript で表現したものです。特定のロケールに関する情報 (言語、文字体系、カレンダーの種類など) を、ロケール識別子文字列で符号化することができます。これらのロケール識別子をより簡単に扱えるようにするために、 Locale オブジェクトが JavaScript に導入されました。 Locale オブジェクトの toString メソッドをコールすると、そのロケールの識別子文字列を返します。 toString メソッドを使用すると、 Locale のインスタンスが既存の Intl のコンストラクターへの引数ととして JSON におけるシリアライズにおいて、またはその他のコンテキストで正確な文字列表現が有用な場合に提供することができます。

+ +

例

+ +
let myLocale = new Intl.Locale("ja-Jpan-JP", {hourCycle: "h24", calendar: "gregory"});
+console.log(myLocale.baseName); // "ja-Jpan-JP" と表示
+console.log(myLocale.toString()); // "ja-Jpan-JP-u-ca-gregory-hc-h24" と表示
+
+ +

仕様書

+ + + + + + + + + + + + +
仕様書
{{SpecName('ES Int Draft', '#sec-Intl.Locale.prototype.toString')}}
+ +

ブラウザーの互換性

+ +
+ + +

{{Compat("javascript.builtins.Intl.Locale.toString")}}

+
+ +

関連情報

+ + -- cgit v1.2.3-54-g00ecf