From 42d1f2065f07b49c194c1ca77b5c38f30719cf36 Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Tue, 17 Aug 2021 23:43:48 +0900 Subject: Web/JavaScript/Reference/Global_Objects/Intl/Locale (#1996) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Markdown に変換 - 2021/07/21 時点の英語版に同期 --- .../global_objects/intl/locale/index.html | 102 --------------------- .../reference/global_objects/intl/locale/index.md | 98 ++++++++++++++++++++ 2 files changed, 98 insertions(+), 102 deletions(-) delete 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/index.md (limited to 'files') 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 deleted file mode 100644 index 58744e2b26..0000000000 --- a/files/ja/web/javascript/reference/global_objects/intl/locale/index.html +++ /dev/null @@ -1,102 +0,0 @@ ---- -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/index.md b/files/ja/web/javascript/reference/global_objects/intl/locale/index.md new file mode 100644 index 0000000000..2889af2f7c --- /dev/null +++ b/files/ja/web/javascript/reference/global_objects/intl/locale/index.md @@ -0,0 +1,98 @@ +--- +title: Intl.Locale +slug: Web/JavaScript/Reference/Global_Objects/Intl/Locale +tags: + - Class + - Internationalization + - Intl + - JavaScript + - Locale + - Reference + - クラス + - 国際化 +browser-compat: javascript.builtins.Intl.Locale +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("Intl/Locale/Locale", "Intl.Locale()")}} + - : 新しい `Locale` オブジェクトを生成します。 + +## インスタンスプロパティ + +- {{jsxref("Intl/Locale/baseName", "Intl.Locale.prototype.baseName")}} + - : この `Locale` に関する基本的な情報を、完全なデータ文字列の部分文字列の形で返します。 +- {{jsxref("Intl/Locale/calendar", "Intl.Locale.prototype.calendar")}} + - : このロケールの暦年を示す `Locale` の部分を返します。 +- {{jsxref("Intl/Locale/caseFirst", "Intl.Locale.prototype.caseFirst")}} + - : ロケールの照合規則に大文字・小文字を考慮しているかどうかを返します。 +- {{jsxref("Intl/Locale/collation", "Intl.Locale.prototype.collation")}} + - : この `Locale` の照合の種類を返します。これは、ロケールの規則に従って文字列を並べ替えるために使用します。 +- {{jsxref("Intl/Locale/hourCycle", "Intl.Locale.prototype.hourCycle")}} + - : このロケールが使用している時刻保持書式の規則を返します。 +- {{jsxref("Intl/Locale/language", "Intl.Locale.prototype.language")}} + - : このロケールに関連づけられた言語を返します。 +- {{jsxref("Intl/Locale/numberingSystem", "Intl.Locale.prototype.numberingSystem")}} + - : このロケールが使用している数値表記法を返します。 +- {{jsxref("Intl/Locale/numeric", "Intl.Locale.prototype.numeric")}} + - : このロケールが数字に対して特殊な照合順序を持っているかどうかを返します。 +- {{jsxref("Intl/Locale/region", "Intl.Locale.prototype.region")}} + - : このロケールに関連付けられた世界の地域 (通常は国) を返します。 +- {{jsxref("Intl/Locale/script", "Intl.Locale.prototype.script")}} + - : このロケールで使われている特定の言語を書く際に使用する文字体系を返します。 + +## インスタンスメソッド + +- {{jsxref("Intl/Locale/maximize", "Intl.Locale.prototype.maximize()")}} + - : 既存の値に基づいて、ロケールの言語、表記法、地域の最も可能性の高い値を取得します。 +- {{jsxref("Intl/Locale/minimize", "Intl.Locale.prototype.minimize()")}} + - : {{jsxref("Intl/Locale/maximize", "Locale.maximize()")}} を呼び出すことで追加されるロケールに関する情報を削除しようとします。 +- {{jsxref("Intl/Locale/toString", "Intl.Locale.prototype.toString()")}} + - : このロケールの完全なロケール識別子文字列を返します。 + +## 例 + +### 基本的な使用 + +{{jsxref("Intl/Locale/Locale", "Intl.Locale")}} のコンストラクターは、もっとも簡単なものでは、ロケール識別子の文字列を引数に取ります。 + +```js +let us = new Intl.Locale('en-US'); +``` + +### Locale コンストラクターの options オブジェクト付きでの使用 + +このコンストラクターは、オプションで構成オブジェクトの引数を取ることができます。たとえば、構成オブジェクトの {{jsxref("Intl/Locale/hourCycle", "hourCycle")}} プロパティに任意の時間サイクル種別を設定し、それをコンストラクターに渡します。 + +```js +let us12hour = new Intl.Locale("en-US", {hourCycle: "h12"}); +console.log(us12hour.hourCycle); // Prints "h12" +``` + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- {{jsxref("Intl")}} +- [Intl.Locale のポリフィル](https://formatjs.io/docs/polyfills/intl-locale) +- [Unicode ロケール識別子の仕様書](https://www.unicode.org/reports/tr35/#Canonical_Unicode_Locale_Identifiers) -- cgit v1.2.3-54-g00ecf