このプラグインは、情報を取得し、ユーザーのロケール、言語、およびタイム ゾーンに固有の操作を実行します。 ロケールと言語の違いに注意してください: ロケール コントロール番号、日付、および時刻の表示方法、地域の言語で決まりますがどのような言語のテキストの間のように、ロケールの設定とは無関係です。 多くの開発者を使用してロケール設定両方、しかしユーザーは「英語」彼女言語を設定できませんでした理由はない“フランス語”ロケールので英語が日付時刻等でテキストが表示されますが表示されるフランスでは。 残念ながら、ほとんどのモバイルプラット フォーム現在行いませんこれらの設定の間の区別。
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
とfull
long
または 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'); };