このプラグインは、情報を取得し、ユーザーのロケール、言語、およびタイム ゾーンに固有の操作を実行します。 ロケールと言語の違いに注意してください: ロケール コントロール番号、日付、および時刻の表示方法、地域の言語で決まりますがどのような言語のテキストの間のように、ロケールの設定とは無関係です。 多くの開発者を使用してロケール設定両方、しかしユーザーは「英語」彼女言語を設定できませんでした理由はない“フランス語”ロケールので英語が日付時刻等でテキストが表示されますが表示されるフランスでは。 残念ながら、ほとんどのモバイルプラット フォーム現在行いませんこれらの設定の間の区別。
cordova plugin add org.apache.cordova.globalization
クライアントの現在の言語の BCP 47 言語タグを取得します。
navigator.globalization.getPreferredLanguage(successCallback, errorCallback);
BCP 47 準拠の言語識別子タグを返します、 successCallback と、 properties オブジェクトをパラメーターとして。 そのオブジェクトが必要な value を持つプロパティ、 String 値。
言語を取得中にエラーがある場合、 errorCallback で実行する、 GlobalizationError オブジェクトをパラメーターとして。 予想されるエラーコードです。GlobalizationError.UNKNOWN_ERROR.
ブラウザーに設定すると、 en-US 言語、これで、テキストとポップアップ ダイアログを表示 language: en-US ：
navigator.globalization.getPreferredLanguage(
function (language) {alert('language: ' + language.value + '\n');},
function () {alert('Error getting language\n');}
);
クライアントの現在のロケール設定 BCP 47 準拠タグを返します。
navigator.globalization.getLocaleName(successCallback, errorCallback);
BCP 47 準拠ロケール識別子文字列を返します、 successCallback と、 properties オブジェクトをパラメーターとして。 そのオブジェクトが必要な value を持つプロパティ、 String 値。 ロケール タグは 2 文字の小文字の言語コード、大文字 2 文字の国コード、ハイフンで区切られた (不特定) のバリアント型コードで構成されます。
ロケールを取得中にエラーがある場合、 errorCallback で実行する、 GlobalizationError オブジェクトをパラメーターとして。 予想されるエラーコードです。GlobalizationError.UNKNOWN_ERROR.
ブラウザーに設定すると、 en-US ロケール、テキストとポップアップ ダイアログが表示されますlocale: en-US.
navigator.globalization.getLocaleName(
function (locale) {alert('locale: ' + locale.value + '\n');},
function () {alert('Error getting locale\n');}
);
navigator.globalizatin.getPreferredLanguage().日付を返します、クライアントのロケールおよびタイムゾーンに従って文字列として書式設定されます。
navigator.globalization.dateToString(date, successCallback, errorCallback, options);
書式設定された日付を返します String を介して、 value にパラメーターとして渡されたオブジェクトからアクセス可能なプロパティ、successCallback.
受信 date パラメーター型である必要がありますDate.
場合は、日付の書式設定エラーがあるし、 errorCallback で実行する、 GlobalizationError オブジェクトをパラメーターとして。 予想されるエラーコードです。GlobalizationError.FORMATTING_ERROR.
optionsパラメーターはオプションであり、既定値は。
{formatLength: 'ショート' セレクター： '日付と時刻'}
options.formatLengthすることができます short 、 medium 、 long 、またはfull.
options.selectorすることができます date 、 time またはdate and time.
ブラウザー設定されている場合、 en_US のロケールのようなテキストとポップアップ ダイアログが表示されます date: 9/25/2012 4:21PM 既定のオプションを使用して。
navigator.globalization.dateToString(
new Date(),
function (date) { alert('date: ' + date.value + '\n'); },
function () { alert('Error getting dateString\n'); },
{ formatLength: 'short', selector: 'date and time' }
);
formatLengthオプションをサポートするだけ short と full の値。formatLength識別されない long とfulllong または full バージョン）書式設定および通貨の値によると、クライアントのユーザーの基本設定と ISO 4217 通貨コードを解析するパターン文字列を返します。
navigator.globalization.getCurrencyPattern(currencyCode, successCallback, errorCallback);
パターンを返します、 successCallback と、 properties オブジェクトをパラメーターとして。そのオブジェクトは、次のプロパティを含める必要があります。
パターン: 通貨パターンを書式設定および通貨の値を解析します。 パターンは、 Unicode 技術標準 #35に従ってください。 (文字列)
コード: パターンの ISO 4217 通貨コード。(文字列)
分数: 解析および通貨を書式設定するときに使用する小数部の桁の数。(数)
丸め: 解析および書式設定するときに使用するインクリメントに丸め。(数)
10 進数: 解析および書式設定を使用する小数点の記号。(文字列)
グループ: 解析および書式設定を使用する区切り記号。(文字列)
受信した currencyCode パラメーターをする必要があります、 String 、ISO 4217 通貨コードは、たとえば ‘USD’ のいずれかの。
パターンを取得時にエラーがある場合、 errorCallback で実行する、 GlobalizationError オブジェクトをパラメーターとして。 予想されるエラーコードです。GlobalizationError.FORMATTING_ERROR.
ブラウザーに設定すると、 en_US ロケールと、選択した通貨は米国ドルで、この例は次の結果のようなテキストとポップアップ ダイアログを表示します。
navigator.globalization.getCurrencyPattern(
'USD',
function (pattern) {
alert('pattern: ' + pattern.pattern + '\n' +
'code: ' + pattern.code + '\n' +
'fraction: ' + pattern.fraction + '\n' +
'rounding: ' + pattern.rounding + '\n' +
'decimal: ' + pattern.decimal + '\n' +
'grouping: ' + pattern.grouping);
},
function () { alert('Error getting pattern\n'); }
);
期待される結果:
pattern: $#,##0.##;($#,##0.##) code: USD fraction: 2 rounding: 0 decimal: . grouping: ,
月の名前またはクライアントのユーザーの好みやカレンダーに応じて曜日の配列を返します。
navigator.globalization.getDateNames(successCallback, errorCallback, options);
名前の配列を返します、 successCallback と、 properties オブジェクトをパラメーターとして。 そのオブジェクトが含まれています、 value プロパティ、 Array の String の値。 年または選択したオプションに応じて、週の最初の日の最初の月のいずれかから始まってアレイ機能の名前。
名前の取得エラーがある場合、 errorCallback で実行する、 GlobalizationError オブジェクトをパラメーターとして。 予想されるエラーコードです。GlobalizationError.UNKNOWN_ERROR.
optionsパラメーターはオプションであり、既定値は。
{type:'wide', item:'months'}
値 options.type することができます narrow またはwide.
値 options.item することができます months またはdays.
ブラウザーに設定すると、 en_US ロケール、この例の表示 12 ポップアップ ダイアログ ボックスのようなテキストで、毎月のシリーズ month: January :
navigator.globalization.getDateNames(
function (names) {
for (var i = 0; i < names.value.length; i++) {
alert('month: ' + names.value[i] + '\n');
}
},
function () { alert('Error getting names\n'); },
{ type: 'wide', item: 'months' }
);
options.typeサポートしている、 genitive のいくつかの言語の重要な値クライアントのユーザーの設定に従った日付を解析するパターン文字列を返します。
navigator.globalization.getDatePattern(successCallback, errorCallback, options);
パターンを返します、 successCallback 。パラメーターとして渡されたオブジェクトには、次のプロパティが含まれています。
パターン: 書式し、日付を解析する日付と時刻のパターン。 パターンは、 Unicode 技術標準 #35に従ってください。 (文字列)
タイムゾーン: クライアントのタイム ゾーンの省略名。(文字列)
とおりです。: クライアントのタイム ゾーンと世界協定時刻間の秒で現在の差異。(数)
dst_offset： クライアントの非夏時間 (秒単位) は、現在の夏時間オフセットのタイムゾーンとクライアントの夏時間保存のタイム ゾーン。(数)
パターンを取得時にエラーがある場合、 errorCallback で実行する、 GlobalizationError オブジェクトをパラメーターとして。 予想されるエラーコードです。GlobalizationError.PATTERN_ERROR.
optionsパラメーターはオプションであり、次の値を既定値します。
{formatLength: 'ショート' セレクター： '日付と時刻'}
options.formatLengthすることができます short 、 medium 、 long 、または full 。 options.selectorすることができます date 、 time またはdate and time.
ブラウザーに設定すると、 en_US ロケール、例など、テキストとポップアップ ダイアログを表示します pattern: M/d/yyyy h:mm a :
function checkDatePattern() {
navigator.globalization.getDatePattern(
function (date) { alert('pattern: ' + date.pattern + '\n'); },
function () { alert('Error getting pattern\n'); },
{ formatLength: 'short', selector: 'date and time' }
);
}
formatLengthのみをサポートしています short と full の値。
patternの date and time パターンは完全な datetime 形式のみを返します。
timezone完全なタイム ゾーン名を返します。
dst_offsetプロパティはサポートされていませんし、常に 0 を返します。
よると、クライアントのユーザー設定カレンダー週の最初の曜日を返します。
navigator.globalization.getFirstDayOfWeek(successCallback, errorCallback);
週の日 1 日曜日であると見なされます、1 から始まる番号が付けられます。 曜日を返します、 successCallback と、 properties オブジェクトをパラメーターとして。 そのオブジェクトが必要な value を持つプロパティ、 Number 値。
パターンを取得時にエラーがある場合、 errorCallback で実行する、 GlobalizationError オブジェクトをパラメーターとして。 予想されるエラーコードです。GlobalizationError.UNKNOWN_ERROR.
ブラウザーに設定すると、 en_US のロケールのようなテキストとポップアップ ダイアログが表示されますday: 1.
navigator.globalization.getFirstDayOfWeek(
function (day) {alert('day: ' + day.value + '\n');},
function () {alert('Error getting day\n');}
);
クライアントのユーザーの設定に従って数値を解析するパターン文字列を返します。
navigator.globalization.getNumberPattern(successCallback, errorCallback, options);
パターンを返します、 successCallback と、 properties オブジェクトをパラメーターとして。そのオブジェクトには、次のプロパティが含まれています。
パターン: 番号のパターンを書式設定および解析の数字。 パターンは、 Unicode 技術標準 #35に従ってください。 (文字列)
記号: 書式設定と解析、パーセントや通貨記号などのときに使用するシンボル。(文字列)
分数: 解析および数値を書式設定するときに使用する小数部の桁の数。(数)
丸め: 解析および書式設定するときに使用するインクリメントに丸め。(数)
正： 正の数の解析および書式設定するときに使用する記号。(文字列)
負: 負の数の解析および書式設定するときに使用する記号。(文字列)
10 進数: 解析および書式設定を使用する小数点の記号。(文字列)
グループ: 解析および書式設定を使用する区切り記号。(文字列)
パターンを取得時にエラーがある場合、 errorCallback で実行する、 GlobalizationError オブジェクトをパラメーターとして。 予想されるエラーコードです。GlobalizationError.PATTERN_ERROR.
optionsパラメーターが省略可能であり、既定値。
{0} 型: 'decimal'}
options.typeすることができます decimal 、 percent 、またはcurrency.
ブラウザーに設定すると、 en_US のロケールに従って結果のようなテキストとポップアップ ダイアログが表示されます。
navigator.globalization.getNumberPattern(
function (pattern) {alert('pattern: ' + pattern.pattern + '\n' +
'symbol: ' + pattern.symbol + '\n' +
'fraction: ' + pattern.fraction + '\n' +
'rounding: ' + pattern.rounding + '\n' +
'positive: ' + pattern.positive + '\n' +
'negative: ' + pattern.negative + '\n' +
'decimal: ' + pattern.decimal + '\n' +
'grouping: ' + pattern.grouping);},
function () {alert('Error getting pattern\n');},
{type:'decimal'}
);
結果:
pattern: #,##0.### symbol: . fraction: 0 rounding: 0 positive: negative: - decimal: . grouping: ,
patternプロパティはサポートされていませんと retuens、空の文字列。
fractionプロパティはサポートされていません、0 を返します。
夏時間の時間が、クライアントのタイム ゾーンとカレンダーを使用して特定の日付に対して有効かどうかを示します。
navigator.globalization.isDayLightSavingsTime(date, successCallback, errorCallback);
夏時間が有効にするかどうかを示します、 successCallback と、 properties オブジェクトをパラメーターとして。 そのオブジェクトが必要な dst を持つプロパティ、 Boolean 値。 A true 値は、夏時間の時間が指定した日付のために有効であることを示しますと false がないことを示します。
受信パラメーター date 型である必要がありますDate.
日付を読み取り中にエラーがある場合、 errorCallback を実行します。予想されるエラーコードです。GlobalizationError.UNKNOWN_ERROR.
夏の間、これでのようなテキストとポップアップ ダイアログを表示するブラウザーは、DST が有効なタイム ゾーンに設定されている場合と dst: true ：
navigator.globalization.isDayLightSavingsTime(
new Date(),
function (date) {alert('dst: ' + date.dst + '\n');},
function () {alert('Error getting names\n');}
);
クライアントのユーザーの設定に従って文字列として書式設定された数を返します。
navigator.globalization.numberToString(number, successCallback, errorCallback, options);
番号の書式設定された文字列を返します、 successCallback と、 properties オブジェクトをパラメーターとして。 そのオブジェクトが必要な value を持つプロパティ、 String 値。
番号、書式設定エラーがある場合、 errorCallback で実行する、 GlobalizationError オブジェクトをパラメーターとして。 予想されるエラーコードです。GlobalizationError.FORMATTING_ERROR.
optionsパラメーターはオプションであり、既定値は。
{0} 型: 'decimal'}
options.type‘Decimal’、‘%’ または ‘通貨’ にすることができます。
ブラウザーに設定すると、 en_US のロケールのようなテキストとポップアップ ダイアログが表示されます number: 3.142 ：
navigator.globalization.numberToString(
3.1415926,
function (number) {alert('number: ' + number.value + '\n');},
function () {alert('Error getting number\n');},
{type:'decimal'}
);
クライアントのユーザーの基本設定や、クライアントのタイム ゾーンを使用して予定表によると、文字列として書式設定された日付を解析し、対応する日付オブジェクトを返します。
navigator.globalization.stringToDate(dateString, successCallback, errorCallback, options);
日付の成功時のコールバックを返します、 properties オブジェクトをパラメーターとして。そのオブジェクトは、次のプロパティが必要です。
年： 4 桁の年。(数)
月: (0-11) から 1 カ月。(数)
日: 日 (1 から 31)。(数)
時間: 時間 (0-23) から。(数)
分: (0-59） から分です。(数)
2 番目: (0-59） から 2 番目。(数)
ミリ秒： 時間をミリ秒単位 (0 ～ 999) まですべてのプラットフォームでは利用できません。(数)
受信 dateString パラメーター型である必要がありますString.
optionsパラメーターはオプションであり、次の値を既定値します。
{formatLength: 'ショート' セレクター： '日付と時刻'}
options.formatLengthすることができます short 、 medium 、 long 、または full 。 options.selectorすることができます date 、 time またはdate and time.
日付文字列の解析エラーがある場合、 errorCallback で実行する、 GlobalizationError オブジェクトをパラメーターとして。 予想されるエラーコードです。GlobalizationError.PARSING_ERROR.
ブラウザーに設定すると、 en_US のロケールのようなテキストとポップアップ ダイアログが表示されます month:8 day:25 year:2012 。 注意： 整数は 1 ヶ月未満の文字列、月整数として配列のインデックスを表します。
navigator.globalization.stringToDate(
'9/25/2012',
function (date) {alert('month:' + date.month +
' day:' + date.day +
' year:' + date.year + '\n');},
function () {alert('Error getting date\n');},
{selector: 'date'}
);
formatLengthオプションをサポートするだけ short と full の値。クライアントのユーザーの設定に従って文字列として書式設定された数を解析し、対応する番号を返します。
navigator.globalization.stringToNumber(string, successCallback, errorCallback, options);
番号を返します、 successCallback と、 properties オブジェクトをパラメーターとして。そのオブジェクトが必要な value を持つプロパティ、 Number 値。
数値文字列の解析エラーがある場合、 errorCallback で実行する、 GlobalizationError オブジェクトをパラメーターとして。 予想されるエラーコードです。GlobalizationError.PARSING_ERROR.
optionsパラメーターはオプションであり、次の値を既定値します。
{0} 型: 'decimal'}
options.typeすることができます decimal 、 percent 、またはcurrency.
ブラウザーに設定すると、 en_US ロケール、これのようなテキストとポップアップ ダイアログを表示する必要があります number: 1234.56 ：
navigator.globalization.stringToNumber(
'1234.56',
function (number) {alert('number: ' + number.value + '\n');},
function () {alert('Error getting number\n');},
{type:'decimal'}
);
グローバリゼーション API からエラーを表すオブジェクト。
このオブジェクトが作成され、コルドバ、によって移入エラーの場合のコールバックに返されます。
次のエラー コールバックを実行するのようなテキストとポップアップ ダイアログが表示されます code: 3 とmessage:
function errorCallback(error) {
alert('code: ' + error.code + '\n' +
'message: ' + error.message + '\n');
};