diff options
author | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:40:17 -0500 |
---|---|---|
committer | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:40:17 -0500 |
commit | 33058f2b292b3a581333bdfb21b8f671898c5060 (patch) | |
tree | 51c3e392513ec574331b2d3f85c394445ea803c6 /files/ja/web/javascript/reference/global_objects/intl/locale | |
parent | 8b66d724f7caf0157093fb09cfec8fbd0c6ad50a (diff) | |
download | translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.tar.gz translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.tar.bz2 translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.zip |
initial commit
Diffstat (limited to 'files/ja/web/javascript/reference/global_objects/intl/locale')
15 files changed, 1662 insertions, 0 deletions
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 +--- +<div>{{JSRef}}</div> + +<p><strong><code>Intl.Locale.prototype.baseName</code></strong> プロパティは、 <code>Locale</code> の文字列表現の部分文字列を返し、そこには <code>Locale</code> についての中核情報が含まれています。</p> + +<h2 id="Description" name="Description">解説</h2> + +<p>{{jsxref("Locale", "Intl.Locale")}} オブジェクトは、解析されたロケールとそのロケールのオプションを表します。 <code>baseName</code> プロパティは、ロケールに関する基本的な情報を、完全なデータ文字列の部分文字列の形で返します。具体的には、このプロパティは言語を含む部分文字列を返し、文字体系や地域があればそれも返します。</p> + +<p><code>baseName</code> は <code>言語 ["-" 文字体系] ["-" 地域] *("-" variant)</code> の形で <a href="https://www.unicode.org/reports/tr35/#Identifiers">unicode_language_id grammar</a> の部分文字列を返します。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Basic_Example" name="Basic_Example">基本的な例</h3> + +<pre class="brush: js">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" と表示</pre> + +<h3 id="入力文字列のオプション付きの例">入力文字列のオプション付きの例</h3> + +<pre class="brush: js">// 言語を日本語、地域を日本に設定する。 + +// カレンダーをグレゴリオ暦、時制を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" と表示</pre> + +<h3 id="入力文字列を上書きするオプション付きの例">入力文字列を上書きするオプション付きの例</h3> + +<pre class="brush: js">// 入力文字列は言語がオランダ語、地域がベルギーであることを示していますが、 + +// ただし、オプションオブジェクトで地域を上書きしており、オランダに設定しています +let dutch = new Intl.Locale("nl-Latn-BE", {region: "NL"}); + +console.log(dutch.baseName); // "nl-Latn-NL" と表示</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ES Int Draft', '#sec-Intl.Locale.prototype.baseName')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<div>{{Compat("javascript.builtins.Intl.Locale.baseName")}}</div> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Locale", "Intl.Locale")}}</li> +</ul> 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 +--- +<div>{{JSRef}}</div> + +<p><strong><code>Intl.Locale.prototype.calendar</code></strong> プロパティは、 <code>Locale</code> で使用される暦の種類を返すアクセサープロパティです。</p> + +<h2 id="Description" name="Description">解説</h2> + +<p><code>calendar</code> プロパティは <code>Locale</code> の一部、 <code>Locale</code> の暦を示す部分を返します。世界の大部分はグレゴリオ暦を使用していますが、世界各地で使用されている地域暦もいくつかあります。以下の表に、有効な Unicode 暦キー文字列をすべて示します。</p> + +<h3 id="Unicode_calendar_keys" name="Unicode_calendar_keys">Unicode 暦キー</h3> + +<table class="standard-table"> + <caption>Unicode 暦キー</caption> + <thead> + <tr> + <th scope="col">Calendar key (name)</th> + <th scope="col">説明</th> + </tr> + </thead> + <tbody> + <tr> + <td><code>buddhist</code></td> + <td>タイの仏教暦</td> + </tr> + <tr> + <td><code>chinese</code></td> + <td>古来の中国の暦</td> + </tr> + <tr> + <td><code>coptic</code></td> + <td>コプト暦</td> + </tr> + <tr> + <td><code>dangi</code></td> + <td>古来の韓国の暦</td> + </tr> + <tr> + <td><code>ethioaa</code></td> + <td>Ethiopic calendar, Amete Alem (epoch approx. 5493 B.C.E)</td> + </tr> + <tr> + <td><code>ethiopic</code></td> + <td>Ethiopic calendar, Amete Mihret (epoch approx, 8 C.E.)</td> + </tr> + <tr> + <td><code>gregory</code></td> + <td>グレゴリオ暦</td> + </tr> + <tr> + <td><code>hebrew</code></td> + <td>古来のヘブライ暦</td> + </tr> + <tr> + <td><code>indian</code></td> + <td>インド暦</td> + </tr> + <tr> + <td><code>islamic</code></td> + <td>イスラム暦</td> + </tr> + <tr> + <td><code>islamic-umalqura</code></td> + <td>Islamic calendar, Umm al-Qura</td> + </tr> + <tr> + <td><code>islamic-tbla</code></td> + <td>Islamic calendar, tabular (intercalary years [2,5,7,10,13,16,18,21,24,26,29] - astronomical epoch)</td> + </tr> + <tr> + <td><code>islamic-civil</code></td> + <td>Islamic calendar, tabular (intercalary years [2,5,7,10,13,16,18,21,24,26,29] - civil epoch)</td> + </tr> + <tr> + <td><code>islamic-rgsa</code></td> + <td>Islamic calendar, Saudi Arabia sighting</td> + </tr> + <tr> + <td><code>iso8601</code></td> + <td>ISO カレンダー (ISO 8601 カレンダーの曜日規則を使用したグレゴリオ暦)</td> + </tr> + <tr> + <td><code>japanese</code></td> + <td>日本の皇紀</td> + </tr> + <tr> + <td><code>persian</code></td> + <td>ペルシャ暦</td> + </tr> + <tr> + <td><code>roc</code></td> + <td>中華民国暦</td> + </tr> + <tr> + <td> + <div class="blockIndicator warning"><code>islamicc</code> 暦は非推奨です。 <code>islamic-civil</code> を使用してください。</div> + + <p><code>islamicc</code></p> + </td> + <td>Civil (algorithmic) Arabic calendar</td> + </tr> + </tbody> +</table> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Adding_a_calendar_in_the_Locale_string" name="Adding_a_calendar_in_the_Locale_string">ロケール文字列へのカレンダーの追加</h3> + +<p>暦は、ロケールキーの「拡張キー」に該当します。これらのキーは、ロケールに関するデータを追加するもので、拡張子 <code>-u</code> を使用してロケール識別子に追加します。したがって、 {{jsxref("Locale/Locale", "Intl.Locale")}} コンストラクターに渡される初期のロケール識別子文字列に暦の種類を追加することができます。暦の種類を追加するには、まず文字列に <code>-u</code> 拡張を追加します。次に、暦の種類を追加することを示すために <code>-ca</code> 拡張を追加します。最後に、暦を文字列に追加します。</p> + +<pre class="brush: js">let frBuddhist = new Intl.Locale("fr-FR-u-ca-buddhist"); +console.log(frBuddhist.calendar); // "buddhist" と表示</pre> + +<h3 id="Adding_a_calendar_with_a_configuration_object" name="Adding_a_calendar_with_a_configuration_object">構成オブジェクトによる暦の追加</h3> + +<p>{{jsxref("Locale/Locale", "Intl.Locale")}} コンストラクターには、オプションで構成オブジェクトの引数があり、カレンダーを含めた拡張の種類を渡すために使用することができます。構成オブジェクトの <code>calendar</code> プロパティを望みの暦の値に設定し、コンストラクターに渡します。</p> + +<pre class="brush: js">let frBuddhist = new Intl.Locale("fr-FR", {calendar: "buddhist"}); +console.log(frBuddhist.calendar); // "buddhist" と表示 +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ES Int Draft', '#sec-Intl.Locale.prototype.calendar')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<div>{{Compat("javascript.builtins.Intl.Locale.calendar")}}</div> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Locale", "Intl.Locale")}}</li> + <li><a href="https://www.unicode.org/reports/tr35/#UnicodeCalendarIdentifier">Unicode 暦識別子</a></li> +</ul> 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 +--- +<div>{{JSRef}}</div> + +<p><span class="seoSummary"><strong><code>Intl.Locale.prototype.caseFirst</code></strong> プロパティは、ロケールの照合規則に大文字・小文字を考慮するかどうかを返すアクセサプロパティです。</span></p> + +<h2 id="Description" name="Description">解説</h2> + +<p>ロケールの照合規則は、そのロケールでの文字列の並び順を決定するために用いられます。ロケールによっては、照合処理で文字の大文字・小文字を使用する場合があります。この追加ルールは、 {{jsxref("Locale", "Locale")}} の <code>caseFirst</code> プロパティで表現することができます。</p> + +<p><code>caseFirst</code> プロパティには下記の表にある通り、3種類の値を指定することができます。</p> + +<h3 id="caseFirst_values" name="caseFirst_values"><code>caseFirst</code> の値</h3> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">値</th> + <th scope="col">説明</th> + </tr> + </thead> + <tbody> + <tr> + <td><code>upper</code></td> + <td>大文字は小文字よりも前に並べられます。</td> + </tr> + <tr> + <td><code>lower</code></td> + <td>小文字は大文字よりも前に並べられます。</td> + </tr> + <tr> + <td><code>false</code></td> + <td>大文字・小文字で特別な並べ替えはしません。</td> + </tr> + </tbody> +</table> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Setting_the_caseFirst_value_via_the_locale_string" name="Setting_the_caseFirst_value_via_the_locale_string">ロケール文字列による <code>caseFirst</code> 値の設定</h3> + +<p><a href="https://www.unicode.org/reports/tr35/" rel="noopener">Unicode ロケール文字列仕様書</a>では、 <code>caseFirst</code> が表す値は <code>kf</code> キーに対応します。 <code>kf</code> はロケール文字列の「拡張子サブタグ」として扱われます。これらのサブタグは、ロケールに関するデータを追加するもので、 <code>-u</code> 拡張を使用してロケール識別子に追加されます。つまり、 <code>caseFirst</code> の値は、 <code>Locale</code> コンストラクターに渡される初期のロケール識別子文字列に追加することができます。 <code>caseFirst</code> の値を追加するには、まず文字列に <code>-u</code> 拡張キーを追加します。次に、照合順序の型を追加することを示すために <code>-kf</code> 拡張キーを追加します。最後に、 <code>caseFirst</code> の値を文字列に追加します。</p> + +<pre class="brush: js">let caseFirstStr = new Intl.Locale("fr-Latn-FR-u-kf-upper"); +console.log(caseFirstStr.caseFirst); // "upper" と表示</pre> + +<h3 id="Setting_the_caseFirst_value_via_the_configuration_object_argument" name="Setting_the_caseFirst_value_via_the_configuration_object_argument">構成オブジェクト引数による caseFirst の値の設定</h3> + +<p>{{jsxref("Locale/Locale", "Intl.Locale")}} コンストラクターには、オプションで構成オブジェクトの引数があり、拡張の種類を渡すために使用することができます。構成オブジェクトの <code>caseFirst</code> プロパティを望みの <code>caseFirst</code> の値に設定し、コンストラクターに渡します。</p> + +<pre class="brush: js">let caseFirstObj= new Intl.Locale("en-Latn-US", {caseFirst: "lower"}); +console.log(us12hour.caseFirst); // "lower" と表示</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ES Int Draft', '#sec-Intl.Locale.prototype.caseFirst')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<div>{{Compat("javascript.builtins.Intl.Locale.caseFirst")}}</div> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Locale", "Intl.Locale")}}</li> + <li><a href="https://github.com/unicode-org/cldr/blob/master/common/bcp47/collation.xml#L49">Unicode case first collation spec</a></li> +</ul> 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 +--- +<div>{{JSRef}}</div> + +<p><span class="seoSummary"><strong><code>Intl.Locale.prototype.collation</code></strong> プロパティは、 <code>Locale</code> の<a href="https://www.unicode.org/reports/tr35/tr35-collation.html#CLDR_Collation">照合種別</a>を返すアクセサープロパティです。</span></p> + +<h2 id="Description" name="Description">解説</h2> + +<p>照合とは、文字列を並べ替える処理のことです。検索クエリの結果からデータベース内のレコードの順序付けまで、文字列を特定の順序に並べ替えて配置しなければならない場合に使用されます。文字列を順番に配置するという考えは些細なことのように思えるかもしれませんが、順序の考え方は地域や言語によって異なることがあります。 <code>collation</code> プロパティは、 JavaScript プログラマーが特定のロケールで使用される照合種別に簡単にアクセスできるようにすることを助けます。</p> + +<p>利用可能な照合種別は下記の表にあります。 <a href="https://github.com/unicode-org/cldr/blob/2dd06669d833823e26872f249aa304bc9d9d2a90/common/bcp47/collation.xml">Unicode 照合仕様書</a> から引用したものです。</p> + +<h3 id="Valid_collation_types" name="Valid_collation_types">有効な照合種別</h3> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">照合種別</th> + <th scope="col">説明</th> + </tr> + </thead> + <tbody> + <tr> + <td>big5han</td> + <td>ラテン文字はピンイン順、漢字は big5 文字セット順 (中国語で使用)</td> + </tr> + <tr> + <td>compat</td> + <td>前の版の順序で、互換性のため</td> + </tr> + <tr> + <td>dict</td> + <td>辞書形式の順序 (シンハラ語など)</td> + </tr> + <tr> + <td> + <div class="blockIndicator warning"> + <p><code>direct</code> 照合順は非推奨です。使用しないでください。</p> + </div> + + <p>direct</p> + </td> + <td>バイナリコードポイント順 (ヒンズー語で使用)</td> + </tr> + <tr> + <td>ducet</td> + <td>既定の Unicode 照合順で、要素表順</td> + </tr> + <tr> + <td>emoji</td> + <td>絵文字に推奨の順序</td> + </tr> + <tr> + <td>eor</td> + <td>ヨーロッパ語の順序の規則</td> + </tr> + <tr> + <td>gb2312</td> + <td>ラテン文字はピンイン順、漢字は gb2312han 順 (中国語で使用)</td> + </tr> + <tr> + <td>phonebk</td> + <td>電話帳形式の順序 (ドイツ語など)</td> + </tr> + <tr> + <td>phonetic</td> + <td>発音順 (発音に基づく順序)</td> + </tr> + <tr> + <td>pinyin</td> + <td>ラテン文字と漢字はピンイン順 (中国語で使用)</td> + </tr> + <tr> + <td>reformed</td> + <td>リフォーム順 (スウェーデン語など)</td> + </tr> + <tr> + <td>search</td> + <td>文字列検索のための特殊な照合種別</td> + </tr> + <tr> + <td>searchjl</td> + <td>韓国語の頭文字子音検索用の特殊な照合種別</td> + </tr> + <tr> + <td>standard</td> + <td>各言語の既定の照合順</td> + </tr> + <tr> + <td>stroke</td> + <td>ラテン文字はピンイン順、漢字は画数順 (中国語で使用)</td> + </tr> + <tr> + <td>trad</td> + <td>歴史的な形の順序 (スペイン語など)</td> + </tr> + <tr> + <td>unihan</td> + <td>ラテン文字はピンイン順、漢字は Unihan 部首画数順 (中国語で使用)</td> + </tr> + <tr> + <td>zhuyin</td> + <td> + <p>ラテン文字はピンイン順、漢字とパパラモフォは注音順 (中国語で使用)</p> + </td> + </tr> + </tbody> +</table> + +<h2 id="Examples" name="Examples">例</h2> + +<p>他のロケールのサブタグと同様、照合種別はロケール文字列やコンストラクターの構成オブジェクトの引数で {{jsxref("Locale", "Intl.Locale")}} オブジェクトに追加することができます。</p> + +<h3 id="Adding_a_collation_type_via_the_locale_string" name="Adding_a_collation_type_via_the_locale_string">ロケール文字列による照合種別の追加</h3> + +<p><a href="https://www.unicode.org/reports/tr35/">Unicode ロケール文字列仕様書</a>では、照合種別はロケールキーの「拡張子サブタグ」となります。これらのサブタグは、ロケールに関するデータを追加するもので、 <code>-u</code> 拡張を使用してロケール識別子に追加されます。つまり、照合種別は、ロケールのコンストラクターに渡される初期のロケール識別子文字列に追加することができます。照合種別を追加するには、まず文字列に <code>-u</code> 拡張を追加します。次に、照合順序の型を追加することを示すために <code>-co</code> 拡張を追加します。最後に、照合順序を文字列に追加します。</p> + +<pre class="brush: js">let stringColl = new Intl.Locale("en-Latn-US-u-co-emoji"); +console.log(stringColl.collation); // "emoji" と表示 +</pre> + +<h3 id="Adding_a_collation_type_via_the_configuration_object_argument" name="Adding_a_collation_type_via_the_configuration_object_argument">構成オブジェクト引数による照合種別の追加</h3> + +<p>{{jsxref("Locale/Locale", "Intl.Locale")}} コンストラクターには、オプションで構成オブジェクトの引数があり、これには照合種別を含む任意の拡張の種類をいくつか含めることができます。構成オブジェクトの <code>collation</code> プロパティを任意の照合種別に設定し、コンストラクターに渡します。</p> + +<pre class="brush: js">let configColl = new Intl.Locale("en-Latn-US", {collation: "emoji"}); +console.log(configColl.collation); // "emoji" と表示</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ES Int Draft', '#sec-Intl.Locale.prototype.collation')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Intl.Locale.collation")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Locale", "Intl.Locale")}}</li> +</ul> 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 +--- +<div>{{JSRef}}</div> + +<p><span class="seoSummary"><strong><code>Intl.Locale.prototype.hourCycle</code></strong> プロパティは、ロケールで使用される時刻保持書式の規則を返すアクセサープロパティです。</span></p> + +<h2 id="Description" name="Description">解説</h2> + +<p>世界中で使用されている時刻保持規則 (時制) には、主に12時制と24時制の2つの種類があります。 <code>hourCycle</code> プロパティを使用すると、 JavaScript のプログラマーが特定のロケールで使用されている時制に簡単にアクセスできるようになります。他の追加ロケールデータと同様に、時制種別は<a href="https://www.unicode.org/reports/tr35/#u_Extension">拡張サブタグ</a>であり、ロケール文字列に含まれるデータを拡張したものです。時制種別には、以下の表にある通り、いくつかの異なる値を設定することができます。</p> + +<h3 id="有効な時制種別">有効な時制種別</h3> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">時制種別</th> + <th scope="col">説明</th> + </tr> + </thead> + <tbody> + <tr> + <td><code>h12</code></td> + <td>1–12を使用する時制で、パターンの 'h' に対応します。12時制で、正子は午前12:00から始まります。</td> + </tr> + <tr> + <td><code>h23</code></td> + <td>0–23を使用する時制で、パターンの 'H' に対応します。24時制で、正子は0:00から始まります。</td> + </tr> + <tr> + <td><code>h11</code></td> + <td>0–11を使用する時制で、パターンの 'K' に対応します。12時制で、正子は午前0:00から始まります。</td> + </tr> + <tr> + <td><code>h24</code></td> + <td>1–24を使用する時制で、パターンの 'k' に対応します。24時制で、正子は24:00から始まります。</td> + </tr> + </tbody> +</table> + +<h2 id="Examples" name="Examples">例</h2> + +<p>これらの例は、時制データを {{jsxref("Locale", "Locale")}} オブジェクトに追加する方法を示しています。</p> + +<h3 id="Setting_the_numeric_value_via_the_locale_string" name="Setting_the_numeric_value_via_the_locale_string">ロケール文字列による時制の追加</h3> + +<p><a href="https://www.unicode.org/reports/tr35/" rel="noopener">Unicode ロケール文字列仕様書</a>では、時制はロケール文字列の「拡張サブタグ」です。これらのサブタグはロケールについての追加データであり、拡張キー <code>-u</code> を使用してロケール識別子に追加されます。このようして、 <code>numeric</code> の値を {{jsxref("Locale/Locale", "Locale")}} コンストラクターに渡される初期のロケール識別子文字列に追加することができます。時制種別の値を設定するには、まず文字列に <code>-u</code> 拡張キーを追加します。次に、 <code>-hc</code> 拡張キーを追加して、時制種別の値を追加していることを示します。最後に、時制種別の値を文字列に追加します。</p> + +<pre class="brush: js">let ja24hour = new Intl.Locale("ja-JP-u-hc-h23"); +console.log(ja24hour.hourCycle); // "h23" と表示</pre> + +<h3 id="Adding_an_hour_cycle_via_the_configuration_object_argument" name="Adding_an_hour_cycle_via_the_configuration_object_argument">構成オブジェクト引数から時制を追加</h3> + +<p>{{jsxref("Locale/Locale", "Intl.Locale")}} コンストラクターには、オプションで構成オブジェクトの引数があり、これには時制種別を含む任意の拡張の種類をいくつか含めることができます。構成オブジェクトの <code>hourCycle</code> プロパティを任意の時制種別に設定し、コンストラクターに渡します。</p> + +<pre class="brush: js">let us12hour = new Intl.Locale("en-US", {hourCycle: "h12"}); +console.log(us12hour.hourCycle); // "h12" と表示</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ES Int Draft', '#sec-Intl.Locale.prototype.hourCycle')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<div>{{Compat("javascript.builtins.Intl.Locale.hourCycle")}}</div> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Locale", "Intl.Locale")}}</li> + <li><a href="https://www.unicode.org/reports/tr35/#UnicodeHourCycleIdentifier">Unicode 時間周期拡張キー仕様書</a></li> +</ul> 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 +--- +<div>{{JSRef}}</div> + +<p><span class="seoSummary"><strong><code>Intl.Locale</code></strong> オブジェクトは、 Unicode ロケール識別子を表す Intl オブジェクトの標準組み込みプロパティです。</span></p> + +<div>{{EmbedInteractiveExample("pages/js/intl-locale.html")}}</div> + +<h2 id="Description" name="Description">解説</h2> + +<p><code><strong>Intl.Locale</strong></code> オブジェクトは、 Unicode ロケールをより簡単に操作できるようにするために作成されました。 Unicode は、ロケールを<em>ロケール識別子</em>と呼ばれる文字列で表します。ロケール識別子は、<em>言語識別子</em>と<em>拡張タグ</em>から構成されます。言語識別子はロケールの中核となるもので、<em>言語</em>、<em>文字体系</em>、<em>地域サブタグ</em>から構成されます。ロケールに関する追加情報は、オプションの拡張タグに格納されます。<em>拡張タグ</em>には、暦の種類や時計の種類、数値表記法の種類などのロケールに関する情報が格納されています。</p> + +<p>従来、 Intl API は Unicode と同様に文字列を使用してロケールを表していました。これはシンプルで軽量な解決策であり、うまく機能します。しかし、 Locale クラスを追加することで、言語、文字体系、地域、拡張タグの解析や操作が容易になります。</p> + +<h2 id="Constructor" name="Constructor">コンストラクター</h2> + +<dl> + <dt>{{jsxref("Locale/Locale", "Intl.Locale()")}}</dt> + <dd>新しい <code>Locale</code> オブジェクトを生成します。</dd> +</dl> + +<h2 id="Properties" name="Properties">プロパティ</h2> + +<dl> + <dt><code>Intl.Locale.prototype</code></dt> + <dd><code>Locale</code> コンストラクターのプロトタイプオブジェクトです。</dd> +</dl> + +<h2 id="Instance_properties" name="Instance_properties">インスタンスプロパティ</h2> + +<dl> + <dt>{{jsxref("Locale/baseName", "Intl.Locale.prototype.baseName")}}</dt> + <dd>この <code>Locale</code> に関する基本的な情報を、完全なデータ文字列の部分文字列の形で返します。</dd> + <dt>{{jsxref("Locale/calendar", "Intl.Locale.prototype.calendar")}}</dt> + <dd>このロケールの暦年を示す <code>Locale</code> の部分を返します。</dd> + <dt>{{jsxref("Locale/caseFirst", "Intl.Locale.prototype.caseFirst")}}</dt> + <dd>ロケールの照合規則に大文字・小文字を考慮しているかどうかを返します。</dd> + <dt>{{jsxref("Locale/collation", "Intl.Locale.prototype.collation")}}</dt> + <dd>この <code>Locale</code> の照合の種類を返します。これは、ロケールの規則に従って文字列を並べ替えるために使用します。</dd> + <dt>{{jsxref("Locale/hourCycle", "Intl.Locale.prototype.hourCycle")}}</dt> + <dd>このロケールが使用している時刻保持書式の規約を返します。</dd> + <dt>{{jsxref("Locale/language", "Intl.Locale.prototype.language")}}</dt> + <dd>このロケールに関連づけられた言語を返します。</dd> + <dt>{{jsxref("Locale/numberingSystem", "Intl.Locale.prototype.numberingSystem")}}</dt> + <dd>このロケールが使用している数値表記法を返します。</dd> + <dt>{{jsxref("Locale/numeric", "Intl.Locale.prototype.numeric")}}</dt> + <dd>このロケールが数字に対して特殊な照合順序を持っているかどうかを返します。</dd> + <dt>{{jsxref("Locale/region", "Intl.Locale.prototype.region")}}</dt> + <dd>このロケールに関連付けられた世界の地域 (通常は国) を返します。</dd> + <dt>{{jsxref("Locale/script", "Intl.Locale.prototype.script")}}</dt> + <dd>このロケールで使われている特定の言語を書く際に使用する文字体系を返します。</dd> +</dl> + +<h2 id="Instance_methods" name="Instance_methods">インスタンスメソッド</h2> + +<dl> + <dt>{{jsxref("Locale/minimize", "Intl.Locale.prototype.minimize()")}}</dt> + <dd>既存の値に基づいて、ロケールの言語、表記法、地域の最も可能性の高い値を取得します。</dd> + <dt>{{jsxref("Locale/maximize", "Intl.Locale.prototype.maximize()")}}</dt> + <dd>既存の値に基づいて、ロケールの言語、表記法、地域の最も可能性の高い値を取得します。</dd> + <dt>{{jsxref("Locale/toString", "Intl.Locale.prototype.toString()")}}</dt> + <dd>このロケールの完全なロケール識別子文字列を返します。</dd> +</dl> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ES Int Draft', '#locale-objects')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div> +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Intl.Locale")}}</p> +</div> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li><a href="https://github.com/zbraniecki/Intl.js/tree/intllocale">The Intl.Locale Polyfill</a></li> + <li><a href="https://www.unicode.org/reports/tr35/#Canonical_Unicode_Locale_Identifiers">Unicode locale identifiers spec</a></li> +</ul> 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 +--- +<div>{{JSRef}}</div> + +<p><span class="seoSummary"><strong><code>Intl.Locale.prototype.language</code></strong> プロパティは、ロケールに関連付けられた言語を返すアクセサープロパティです。</span></p> + +<h2 id="Description" name="Description">解説</h2> + +<p>言語はロケールの中核的な特徴の一つです。 Unicode 仕様書では、ロケールの言語識別子を言語と地域を合わせたものとして扱います (イギリス英語とアメリカ英語などの方言や変化形を区別するためです)。 {{jsxref("Locale", "Locale")}} の <code>language</code> プロパティは、ロケールの言語サブタグを厳密に返します。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Setting_the_script_in_the_locale_identifer_string_argument" name="Setting_the_script_in_the_locale_identifer_string_argument">ロケール識別子の文字列引数で言語を設定</h3> + +<p>有効な Unicode 言語識別子となるためには、文字列は言語サブタグで始めなければなりません。 {{jsxref("Locale/Locale", "Locale")}} コンストラクターの主要な引数には、有効な Unicode ロケール識別子がなければならないので、コンストラクターを使用する際には必ず言語サブタグを持つ識別子を渡さなければなりません。</p> + +<pre class="brush: js">let langStr = new Intl.Locale("en-Latn-US"); + +console.log(langStr.language); // "en" と表示</pre> + +<h3 id="Setting_the_script_via_the_configuration_object" name="Setting_the_script_via_the_configuration_object">構成オブジェクトにより言語を上書き</h3> + +<p>言語サブタグは指定する必要がありますが、 {{jsxref("Locale/Locale", "Locale")}} コンストラクターは構成オブジェクトを取り、これを用いて言語サブタグを上書きすることができます。</p> + +<pre class="brush: js">let langObj = new Intl.Locale("en-Latn-US", {language: "es"}); + +console.log(langObj.language); // "es" と表示</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ES Int Draft', '#sec-Intl.Locale.prototype.language')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<div>{{Compat("javascript.builtins.Intl.Locale.language")}}</div> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Locale", "Locale")}}</li> + <li><a href="https://www.unicode.org/reports/tr35/#unicode_language_subtag_validity">Unicode 言語サブタグ仕様書</a></li> +</ul> 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 +--- +<div>{{JSRef}}</div> + +<p><span class="seoSummary"><strong><code>Intl.Locale</code></strong> コンストラクターは、 Intl オブジェクトの標準組み込みプロパティで、 Unicode ロケール識別子を表します。</span></p> + +<div>{{EmbedInteractiveExample("pages/js/intl-locale.html")}}</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox">new Intl.Locale(<var>tag</var> [, <var>options</var>])</pre> + +<h3 id="Parameters" name="Parameters">引数</h3> + +<dl> + <dt><code><var>tag</var></code></dt> + <dd>Unicode ロケール識別子の文字列です。</dd> + <dt><code><var>options</var></code></dt> + <dd>ロケールの構成を含むオブジェクトです。キーは Unicode ロケールタグで、値は有効な Unicode タグ値です。</dd> +</dl> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ES Int Draft', '#sec-intl-locale-constructor')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div> +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Intl.Locale.Locale")}}</p> +</div> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li><a href="https://github.com/zbraniecki/Intl.js/tree/intllocale">The Intl.Locale Polyfill</a></li> + <li><a href="https://www.unicode.org/reports/tr35/#Canonical_Unicode_Locale_Identifiers">Unicode locale identifiers spec</a></li> +</ul> 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 +--- +<div>{{JSRef}}</div> + +<p><span class="seoSummary"><strong><code>Intl.Locale.prototype.maximize()</code></strong> メソッドは、既存の値に基づいてロケールの言語、表記法、地域の最も可能性の近い値を取得します。</span></p> + +<div>{{EmbedInteractiveExample("pages/js/intl-locale-prototype-maximize.html")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力していただける場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox"><code><em>locale</em>.maximize()</code></pre> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>{{jsxref("Locale", "Locale")}} インスタンスで、 <code>baseName</code> プロパティが、 <a href="https://www.unicode.org/reports/tr35/#Likely_Subtags">Add Likely Subtags</a> アルゴリズムが <em>{{jsxref("Locale/baseName", "locale.baseName")}}</em> に対して実行された結果になったものを返します。</p> + +<h2 id="Description" name="Description">解説</h2> + +<p>不完全な言語識別子をもとに、最も可能性の高いロケール言語識別子サブタグを識別できると便利な場合があります。 Add Likely Subtags アルゴリズムはこの機能を提供してくれます。例えば、言語識別子 "en" が与えられた場合、アルゴリズムは "en-Latn-US" を返すことになります。英語はラテン文字でしか書けませんし、世界最大の英語圏の国であるアメリカで使われている可能性が高いからです。この機能は、 <code>maximize()</code> メソッドを介して JavaScript プログラマーに提供されています。 <code>maximize()</code> は、<a href="https://www.unicode.org/reports/tr35/#Language_Locale_Field_Definitions" rel="noopener">言語識別子</a>を構成する主要なサブタグのうち言語サブ、表記法、地域の各サブタグにのみ影響を与えます。ロケール識別子の "-u" の後にあるその他のサブタグは拡張サブタグと呼ばれ、 <code>maximize()</code> メソッドの影響を受けません。これらのサブタグの例としては、 {{jsxref("Locale/hourCycle", "Locale.hourCycle")}}, {{jsxref("Locale/calendar", "Locale.calendar")}}, {{jsxref("Locale/numeric", "Locale.numeric")}} などがあります。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<pre class="brush: js">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()); </pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ES Int Draft', '#sec-Intl.Locale.prototype.maximize')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div> +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Intl.Locale.maximize")}}</p> +</div> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Locale", "Intl.Locale")}}</li> + <li>{{jsxref("Locale/baseName", "Locale.baseName")}}</li> + <li><a href="https://www.unicode.org/reports/tr35/#Likely_Subtags">Unicode's Likely Subtags spec</a></li> +</ul> 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 +--- +<div>{{JSRef}}</div> + +<p><span class="seoSummary"><strong><code>Intl.Locale.prototype.minimize()</code></strong> メソッドは、 {{jsxref("Locale/maximize", "Locale.maximize()")}} を呼び出したことで追加されるロケールに関する情報を削除しようとします。</span></p> + +<div>{{EmbedInteractiveExample("pages/js/intl-locale-prototype-minimize.html", "taller")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力していただける場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox"><code><em>locale</em>.minimize()</code></pre> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>{{jsxref("Locale", "Locale")}} インスタンスで、 <code>baseName</code> プロパティが、 <a href="https://www.unicode.org/reports/tr35/#Likely_Subtags">Remove Likely Subtags</a> アルゴリズムが <code><em>locale.baseName</em></code> に対して実行された結果になったものを返します。</p> + +<h2 id="Description" name="Description">解説</h2> + +<p>このメソッドは {{jsxref("Locale/maximize", "maximize()")}} の逆の処理を行い、ロケールの言語識別子 (基本的には <code>baseName</code> の内容) から言語、文字体系、地域のサブタグをすべて削除します。これは、言語識別子の中に余分なサブタグがある場合に便利です。例えば "en-Latn" は "en" に簡略化できます。英語では "Latn" が書き言葉に使われる唯一の文字体系だからです。 <code>minimize()</code> が影響を与えるのは、<a href="https://www.unicode.org/reports/tr35/#Language_Locale_Field_Definitions">言語識別子</a>を構成する主要なサブタグである言語、文字体系、地域の各サブタグのみです。ロケール識別子の "-u" の後にあるその他のサブタグは拡張サブタグと呼ばれ、 <code>minimize()</code> メソッドの影響を受けません。これらのサブタグの例としては、 {{jsxref("Locale/hourCycle", "Locale.hourCycle")}}, {{jsxref("Locale/calendar", "Locale.calendar")}}, {{jsxref("Locale/numeric", "Locale.numeric")}} などがあります。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<pre class="brush: js">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());</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ES Int Draft', '#sec-Intl.Locale.prototype.minimize')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div> +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Intl.Locale.minimize")}}</p> +</div> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Locale", "Intl.Locale")}}</li> + <li>{{jsxref("Locale/baseName", "Intl.Locale.baseName")}}</li> +</ul> 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 +--- +<div>{{JSRef}}</div> + +<p><span class="seoSummary"><strong><code>Intl.Locale.prototype.numberingSystem</code></strong> プロパティは、ロケールが使用する<a href="https://ja.wikipedia.org/wiki/%E5%91%BD%E6%95%B0%E6%B3%95">命数法</a>を返すアクセサープロパティです。</span></p> + +<h2 id="Description" name="Description">解説</h2> + +<p>命数法とは、数値を表現するための体系のことです。 <code>numberingSystem</code> プロパティは、世界中のさまざまな国、地域、文化で使用されているさまざまな命数法を表現する支援をします。ほとんどの国際化スキーマと同様に、 <code>Locale</code> オブジェクトで <code>numberingSystem</code> によって表現できる命数法は、 Unicode で標準化されています。標準的な Unicode の命数法の表を以下に示します。</p> + +<table class="standard-table"> + <tbody> + <tr> + <th>値</th> + <th>説明</th> + </tr> + <tr> + <td>adlm</td> + <td>Adlam digits</td> + </tr> + <tr> + <td>ahom</td> + <td>Ahom digits</td> + </tr> + <tr> + <td>arab</td> + <td>アラビア・インド数字</td> + </tr> + <tr> + <td>arabext</td> + <td>拡張アラビア・インド数字</td> + </tr> + <tr> + <td>armn</td> + <td>大文字のアルメニア数字 — アルゴリズム</td> + </tr> + <tr> + <td>armnlow</td> + <td>小文字のアルメニア数字 — アルゴリズム</td> + </tr> + <tr> + <td>bali</td> + <td>Balinese digits</td> + </tr> + <tr> + <td>beng</td> + <td>Bengali digits</td> + </tr> + <tr> + <td>bhks</td> + <td>Bhaiksuki digits</td> + </tr> + <tr> + <td>brah</td> + <td>Brahmi digits</td> + </tr> + <tr> + <td>cakm</td> + <td>Chakma digits</td> + </tr> + <tr> + <td>cham</td> + <td>Cham digits</td> + </tr> + <tr> + <td>cyrl</td> + <td>キリル数字 — アルゴリズム</td> + </tr> + <tr> + <td>deva</td> + <td>Devanagari digits</td> + </tr> + <tr> + <td>ethi</td> + <td>エチオピア数字 — アルゴリズム</td> + </tr> + <tr> + <td>finance</td> + <td>金融数字 — アルゴリズムの場合あり</td> + </tr> + <tr> + <td>fullwide</td> + <td>全角数字</td> + </tr> + <tr> + <td>geor</td> + <td>ジョージア数字 — アルゴリズム</td> + </tr> + <tr> + <td>gong</td> + <td>Gunjala Gondi digits</td> + </tr> + <tr> + <td>gonm</td> + <td>Masaram Gondi digits</td> + </tr> + <tr> + <td>grek</td> + <td>大文字のギリシャ数字 — アルゴリズム</td> + </tr> + <tr> + <td>greklow</td> + <td>小文字のギリシャ数字 — アルゴリズム</td> + </tr> + <tr> + <td>gujr</td> + <td>Gujarati digits</td> + </tr> + <tr> + <td>guru</td> + <td>Gurmukhi digits</td> + </tr> + <tr> + <td>hanidays</td> + <td>太陰暦またはその他の旧暦向けの漢字による日付の数字</td> + </tr> + <tr> + <td>hanidec</td> + <td>漢字を数字として使用した命数法</td> + </tr> + <tr> + <td>hans</td> + <td>簡体字の漢数字 — アルゴリズム</td> + </tr> + <tr> + <td>hansfin</td> + <td>簡体字の金融用漢数字 — アルゴリズム</td> + </tr> + <tr> + <td>hant</td> + <td>繁体字の漢数字 — アルゴリズム</td> + </tr> + <tr> + <td>hantfin</td> + <td>繁体字の金融用漢数字 — アルゴリズム</td> + </tr> + <tr> + <td>hebr</td> + <td>ヘブライ数字 — アルゴリズム</td> + </tr> + <tr> + <td>hmng</td> + <td>Pahawh Hmong digits</td> + </tr> + <tr> + <td>hmnp</td> + <td>Nyiakeng Puachue Hmong digits</td> + </tr> + <tr> + <td>java</td> + <td>Javanese digits</td> + </tr> + <tr> + <td>jpan</td> + <td>日本語の漢数字 — アルゴリズム</td> + </tr> + <tr> + <td>jpanfin</td> + <td>日本語の金融用漢数字 — アルゴリズム</td> + </tr> + <tr> + <td>jpanyear</td> + <td>日本語の元号用漢数字 (元年表記に対応)</td> + </tr> + <tr> + <td>kali</td> + <td>Kayah Li digits</td> + </tr> + <tr> + <td>khmr</td> + <td>Khmer digits</td> + </tr> + <tr> + <td>knda</td> + <td>Kannada digits</td> + </tr> + <tr> + <td>lana</td> + <td>Tai Tham Hora (secular) digits</td> + </tr> + <tr> + <td>lanatham</td> + <td>Tai Tham Tham (ecclesiastical) digits</td> + </tr> + <tr> + <td>laoo</td> + <td>Lao digits</td> + </tr> + <tr> + <td>latn</td> + <td>ラテン数字</td> + </tr> + <tr> + <td>lepc</td> + <td>Lepcha digits</td> + </tr> + <tr> + <td>limb</td> + <td>Limbu digits</td> + </tr> + <tr> + <td>mathbold</td> + <td>数学的太数字</td> + </tr> + <tr> + <td>mathdbl</td> + <td>数学的黒板太数字</td> + </tr> + <tr> + <td>mathmono</td> + <td>数学的等幅数字</td> + </tr> + <tr> + <td>mathsanb</td> + <td>数学的サンセリフ太数字</td> + </tr> + <tr> + <td>mathsans</td> + <td>数学的サンセリフ数字</td> + </tr> + <tr> + <td>mlym</td> + <td>Malayalam digits</td> + </tr> + <tr> + <td>modi</td> + <td>Modi digits</td> + </tr> + <tr> + <td>mong</td> + <td>Mongolian digits</td> + </tr> + <tr> + <td>mroo</td> + <td>Mro digits</td> + </tr> + <tr> + <td>mtei</td> + <td>Meetei Mayek digits</td> + </tr> + <tr> + <td>mymr</td> + <td>Myanmar digits</td> + </tr> + <tr> + <td>mymrshan</td> + <td>Myanmar Shan digits</td> + </tr> + <tr> + <td>mymrtlng</td> + <td>Myanmar Tai Laing digits</td> + </tr> + <tr> + <td>native</td> + <td>ネイティブの数字</td> + </tr> + <tr> + <td>newa</td> + <td>Newa digits</td> + </tr> + <tr> + <td>nkoo</td> + <td>N'Ko digits</td> + </tr> + <tr> + <td>olck</td> + <td>Ol Chiki digits</td> + </tr> + <tr> + <td>orya</td> + <td>Oriya digits</td> + </tr> + <tr> + <td>osma</td> + <td>Osmanya digits</td> + </tr> + <tr> + <td>rohg</td> + <td>Hanifi Rohingya digits</td> + </tr> + <tr> + <td>roman</td> + <td>大文字のローマ数字 — アルゴリズム</td> + </tr> + <tr> + <td>romanlow</td> + <td>小文字のローマ数字 — アルゴリズム</td> + </tr> + <tr> + <td>saur</td> + <td>Saurashtra digits</td> + </tr> + <tr> + <td>shrd</td> + <td>Sharada digits</td> + </tr> + <tr> + <td>sind</td> + <td>Khudawadi digits</td> + </tr> + <tr> + <td>sinh</td> + <td>Sinhala Lith digits</td> + </tr> + <tr> + <td>sora</td> + <td>Sora_Sompeng digits</td> + </tr> + <tr> + <td>sund</td> + <td>Sundanese digits</td> + </tr> + <tr> + <td>takr</td> + <td>Takri digits</td> + </tr> + <tr> + <td>talu</td> + <td>New Tai Lue digits</td> + </tr> + <tr> + <td>taml</td> + <td>タミル数字 — アルゴリズム</td> + </tr> + <tr> + <td>tamldec</td> + <td>Modern Tamil decimal digits</td> + </tr> + <tr> + <td>telu</td> + <td>Telugu digits</td> + </tr> + <tr> + <td>thai</td> + <td>Thai digits</td> + </tr> + <tr> + <td>tirh</td> + <td>Tirhuta digits</td> + </tr> + <tr> + <td>tibt</td> + <td>Tibetan digits</td> + </tr> + <tr> + <td>traditio</td> + <td>伝統的な数字 — アルゴリズムの場合あり</td> + </tr> + <tr> + <td>vaii</td> + <td>Vai digits</td> + </tr> + <tr> + <td>wara</td> + <td>Warang Citi digits</td> + </tr> + <tr> + <td>wcho</td> + <td>Wancho digits</td> + </tr> + </tbody> +</table> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Setting_the_numberingSystem_value_via_the_locale_string" name="Setting_the_numberingSystem_value_via_the_locale_string">ロケール文字列から <code>numberingSystem</code> の値を設定</h3> + +<p><a href="https://www.unicode.org/reports/tr35/" rel="noopener">Unicode ロケール文字列仕様書</a>では、 <code>numberingSystem</code> が表す値はキー <code>nu</code> に対応しています。 <code>nu</code> はロケール文字列の「拡張サブタグ」とみなされます。これらのサブタグは、ロケールに関する追加データを追加するもので、拡張キー <code>-u</code> を使用してロケール識別子に追加されます。このようして、 <code>numberingSystem</code> の値を {{jsxref("Locale/Locale", "Locale")}} コンストラクターに渡される初期のロケール識別子文字列に追加することができます。 <code>numeric</code> の値を設定するには、まず文字列に <code>-u</code> 拡張キーを追加します。次に、 <code>-nu</code> 拡張キーを追加して、 <code>numberingSystem</code> の値を追加していることを示します。最後に、文字列に <code>numberingSystem</code> の値を追加します。</p> + +<pre class="brush: js">let numberingSystemViaStr = new Intl.Locale("fr-Latn-FR-u-nu-mong"); +console.log(numberingSystemStr.numberingSystem); // "mong" と表示</pre> + +<h3 id="Setting_the_numberingSystem_value_via_the_configuration_object_argument" name="Setting_the_numberingSystem_value_via_the_configuration_object_argument">構成オブジェクト引数から <code>numberingSystem</code> の値を設定</h3> + +<p>{{jsxref("Locale/Locale", "Intl.Locale")}} コンストラクターには、オプションで構成オブジェクトの引数があり、これを使用して拡張の種類を渡すことができます。構成オブジェクトの <code>numberingSystem</code> プロパティを任意の <code>numberingSystem</code> に設定し、コンストラクターに渡します。</p> + +<pre class="brush: js">let numberingSystemViaObj= new Intl.Locale("en-Latn-US", {numberingSystem: "latn"}); +console.log(us12hour.numberingSystem); // "latn" と表示 +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ES Int Draft', '#sec-Intl.Locale.prototype.numberingSystem')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<div>{{Compat("javascript.builtins.Intl.Locale.numberingSystem")}}</div> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Locale", "Intl.Locale")}}</li> + <li><a href="https://github.com/unicode-org/cldr/blob/master/common/supplemental/numberingSystems.xml">標準 Unicode 数値体系の詳細</a></li> +</ul> 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 +--- +<div>{{JSRef}}</div> + +<p><span class="seoSummary"><strong><code>Intl.Locale.prototype.numeric</code></strong> プロパティは、ロケールが特別な数字の照合処理を行うかどうかを返すアクセサプロパティです。</span></p> + +<h2 id="Description" name="Description">解説</h2> + +<p>{{jsxref("Locale.caseFirst", "Intl.Locale.caseFirst")}} と同様、 <code>numeric</code> はロケールが使用する照合規則を変更するものです。 <code>numeric</code> は {{jsxref("boolean", "Boolean")}} 値で、 <code>true</code> か <code>false</code> のどちらかになります。 <code>numeric</code> を <code>false</code> に設定した場合は、文字列内の数値を特別に扱うことはありません。 <code>numeric</code> を <code>true</code> に設定した場合は、ロケールは文字列を照合する際に数値を考慮します。この数値の特別な扱いとは、数字の並びを数値として比較するということです。例えば、 "A-21" という文字列は "A-123" よりも小さいとみなされます。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Setting_the_numeric_value_via_the_locale_string" name="Setting_the_numeric_value_via_the_locale_string">ロケール文字列から <code>numeric</code> の値を設定</h3> + +<p><a href="https://www.unicode.org/reports/tr35/" rel="noopener">Unicode ロケール文字列仕様書</a>では、 <code>numeric</code> が表す値はキー <code>kn</code> に対応しています。 <code>kn</code> はロケール文字列の「拡張サブタグ」とみなされます。これらのサブタグは、ロケールに関する追加データを追加するもので、拡張キー <code>-u</code> を使用してロケール識別子に追加されます。このようして、 <code>numeric</code> の値を {{jsxref("Locale/Locale", "Locale")}} コンストラクターに渡される初期のロケール識別子文字列に追加することができます。 <code>numeric</code> の値を設定するには、まず文字列に <code>-u</code> 拡張キーを追加します。次に、 <code>-kn</code> 拡張キーを追加して、 <code>numeric</code> の値を追加していることを示します。最後に、文字列に <code>numeric</code> の値を追加します。 <code>numeric</code> を <code>true</code> に設定したい場合は、単に <code>kn</code> キーを追加するだけで十分です。値を <code>false</code> にするには、 <code>kn</code> キーの後に "<code>false</code>" を指定する必要があります。</p> + +<pre class="brush: js">let numericViaStr = new Intl.Locale("fr-Latn-FR-u-kn-false"); +console.log(numericStr.numeric); // "false" と表示</pre> + +<h3 id="Setting_the_numeric_value_via_the_configuration_object_argument" name="Setting_the_numeric_value_via_the_configuration_object_argument">構成オブジェクト引数から <code>numeric</code> の値を設定</h3> + +<p>{{jsxref("Locale/Locale", "Intl.Locale")}} コンストラクターには、オプションで構成オブジェクトの引数があり、これを使用して拡張の種類を渡すことができます。構成オブジェクトの <code>numeric</code> プロパティを任意の <code>numeric</code> に設定し、コンストラクターに渡します。</p> + +<pre class="brush: js">let numericViaObj= new Intl.Locale("en-Latn-US", {numeric: true}); +console.log(us12hour.numeric); // "true" と表示 +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ES Int Draft', '#sec-Intl.Locale.prototype.numeric')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<div>{{Compat("javascript.builtins.Intl.Locale.numeric")}}</div> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Locale", "Intl.Locale")}}</li> +</ul> 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 +--- +<div>{{JSRef}}</div> + +<p><strong><code>Intl.Locale.prototype.region</code></strong> プロパティは、ロケールに関連付けられた世界の地域 (ふつうは国) 返すアクセサープロパティです。</p> + +<h2 id="Description" name="Description">解説</h2> + +<p>地域は、ロケールを世界の特定の地域に位置づけるための、ロケール識別子の重要な要素となります。ロケールの地域を知ることは、ロケール間の違いを識別する上で非常に重要です。たとえば、イギリスとアメリカ合衆国では英語が使われていますが、両国間では綴りやその他の言語の慣習に違いがあります。ロケールの地域を知ることで、 JavaScript プログラマーがサイトやアプリケーションのコンテンツを世界の様々な地域から見たときに正しく表示されるようにするのに役立ちます。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Setting_the_region_in_the_locale_identifer_string_argument" name="Setting_the_region_in_the_locale_identifer_string_argument">ロケール識別子の文字列引数で地域を設定</h3> + +<p>地域は、有効な Unicode 言語識別子文字列の3番目の部分であり、これを {{jsxref("Locale/Locale", "Locale")}} コンストラクターに渡すロケール識別子文字列に追加することで設定することができます。なお、地域はロケール識別子の必須項目ではありません。</p> + +<pre class="brush: js">let regionStr = new Intl.Locale("en-Latn-US"); + +console.log(regionStr.region); // "US" と表示</pre> + +<h3 id="Setting_the_region_via_the_configuration_object" name="Setting_the_region_via_the_configuration_object">構成オブジェクトから地域を設定</h3> + +<p>{{jsxref("Locale/Locale", "Locale")}} コンストラクターは構成オブジェクトを取り、これを用いて地域のサブタグとプロパティを設定することができます。</p> + +<pre class="brush: js">let regionObj = new Intl.Locale("ja-Jpan", {region: "JP"}); + +console.log(scriptObj.script); // "JP" と表示</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ES Int Draft', '#sec-Intl.Locale.prototype.region')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<div>{{Compat("javascript.builtins.Intl.Locale.region")}}</div> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Locale", "Intl.Locale")}}</li> + <li><a href="https://www.unicode.org/cldr/charts/latest/supplemental/territory_containment_un_m_49.html">Unicode region chart</a></li> +</ul> 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 +--- +<div>{{JSRef}}</div> + +<p><span class="seoSummary"><strong><code>Intl.Locale.prototype.script</code></strong> プロパティは、ロケールで使われている特定の言語を書くための文字体系を返すアクセサープロパティです。</span></p> + +<h2 id="Description" name="Description">解説</h2> + +<p>文字体系は、用字系と呼ばれることもありますが、ロケールの核となる属性の一つです。これは、特定の言語を書くために使用される記号やグリフの集合を示しています。例えば、英語の文字はラテン文字ですが、韓国語の文字はハングルです。多くの場合、言語 (これは必須) は単一の文字体系でしか書かれないので、文字体系を記述することは厳密には必要ありません。この規則には例外があり、完全な Unicode 言語識別子を持つためには、可能な限りスクリプトを示すことが重要です。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<h3 id="Setting_the_script_in_the_locale_identifer_string_argument" name="Setting_the_script_in_the_locale_identifer_string_argument">ロケール識別子の文字列引数で文字体系を設定</h3> + +<p>文字体系は、有効な Unicode 言語識別子文字列の2番目の部分であり、これを {{jsxref("Locale/Locale", "Locale")}} コンストラクターに渡すロケール識別子文字列に追加することで設定することができます。なお、文字体系はロケール識別子の必須項目ではありません。</p> + +<pre class="brush: js">let scriptStr = new Intl.Locale("en-Latn-US"); + +console.log(scriptStr.script); // "Latn" と表示</pre> + +<h3 id="Setting_the_script_via_the_configuration_object" name="Setting_the_script_via_the_configuration_object">構成オブジェクトから文字体系を設定</h3> + +<p>{{jsxref("Locale/Locale", "Locale")}} コンストラクターは構成オブジェクトを取り、これを用いて文字体系のサブタグとプロパティを設定することができます。</p> + +<pre class="brush: js">let scriptObj = new Intl.Locale("ja-JP", {script: "Jpan"}); + +console.log(scriptObj.script); // "Jpan" と表示</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ES Int Draft', '#sec-Intl.Locale.prototype.script')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<div>{{Compat("javascript.builtins.Intl.Locale.script")}}</div> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Locale", "Intl.Locale")}}</li> + <li><a href="https://www.unicode.org/reports/tr35/#unicode_script_subtag_validity">Unicode's script subtag specification</a></li> +</ul> 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 +--- +<div>{{JSRef}}</div> + +<p><span class="seoSummary"><strong><code>Intl.Locale.prototype.toString()</code></strong> は、このロケールの完全な<a href="https://www.unicode.org/reports/tr35/#Unicode_locale_identifier">ロケール識別子文字列</a>を返します。</span></p> + +<div>{{EmbedInteractiveExample("pages/js/intl-locale-prototype-tostring.html")}}</div> + +<div class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力していただける場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</div> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox"><code><em>locale</em>.toString()</code></pre> + +<h3 id="Return_value" name="Return_value">返値</h3> + +<p>この<em>ロケール</em>の Unicode ロケール識別子文字列です。</p> + +<h2 id="Description" name="Description">解説</h2> + +<p><code>Locale</code> オブジェクトは、概念的な Unicode ロケール識別子を JavaScript で表現したものです。特定のロケールに関する情報 (言語、文字体系、カレンダーの種類など) を、ロケール識別子文字列で符号化することができます。これらのロケール識別子をより簡単に扱えるようにするために、 <code>Locale</code> オブジェクトが JavaScript に導入されました。 Locale オブジェクトの <code>toString</code> メソッドをコールすると、そのロケールの識別子文字列を返します。 <code>toString</code> メソッドを使用すると、 <code>Locale</code> のインスタンスが既存の <code>Intl</code> のコンストラクターへの引数ととして JSON におけるシリアライズにおいて、またはその他のコンテキストで正確な文字列表現が有用な場合に提供することができます。</p> + +<h2 id="Examples" name="Examples">例</h2> + +<pre class="brush: js">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" と表示 +</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ES Int Draft', '#sec-Intl.Locale.prototype.toString')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div> +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("javascript.builtins.Intl.Locale.toString")}}</p> +</div> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li>{{jsxref("Locale", "Intl.Locale")}}</li> + <li>{{jsxref("Locale/baseName", "Intl.Locale.baseName")}}</li> +</ul> |