グローバリゼーション

グローバリゼーション

情報を取得し、ユーザーのロケールとタイムゾーンに固有の操作を実行します。

オブジェクト

メソッド

変数のスコープ

globalizationオブジェクトの子である、 navigator オブジェクト、およびしたがってはグローバル スコープを持ちます。

// The global globalization object
var globalization = navigator.globalization;

機能へのアクセス

バージョン 3.0 は、コルドバのプラグインとしてデバイス レベルの Api を実装します。 CLI の使用 plugin のコマンドライン ・ インタ フェースを追加または削除、プロジェクトに対してこの機能を記載されているコマンド。

    $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-globalization.git
    $ cordova plugin rm org.apache.cordova.core.globalization

これらのコマンドすべてのターゲット プラットフォームに適用されますが、以下のプラットフォームに固有の構成設定を変更します。

いくつかのプラットフォームは特別な構成を必要とせずにこの機能をサポート可能性があります。概要については、プラットフォームのサポートを参照してください。


globalization.getPreferredLanguage

クライアントの現在の言語の文字列識別子を取得します。

navigator.globalization.getPreferredLanguage(successCallback, errorCallback);

説明

言語識別子の文字列を返します、 successCallback と、 properties オブジェクトをパラメーターとして。 そのオブジェクトが必要な value を持つプロパティ、 String 値。

言語を取得中にエラーがある場合、 errorCallback で実行する、 GlobalizationError オブジェクトをパラメーターとして。 予想されるエラーコードです。GlobalizationError.UNKNOWN\_ERROR.

サポートされているプラットフォーム

簡単な例

ブラウザーに設定すると、 en\_US ロケール、これで、テキストとポップアップ ダイアログを表示 language: English :

navigator.globalization.getPreferredLanguage(
    function (language) {alert('language: ' + language.value + '\n');},
    function () {alert('Error getting language\n');}
);

完全な例

<!DOCTYPE HTML>
<html>
  <head>
    <title>getPreferredLanguage Example</title>
    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    function checkLanguage() {
      navigator.globalization.getPreferredLanguage(
        function (language) {alert('language: ' + language.value + '\n');},
        function () {alert('Error getting language\n');}
      );
    }
    </script>
  </head>
  <body>
    <button onclick="checkLanguage()">Click for language</button>
  </body>
</html>

Windows Phone 8 癖


globalization.getLocaleName

クライアントの現在のロケール設定の文字列識別子を取得します。

navigator.globalization.getLocaleName(successCallback, errorCallback);

説明

ロケール識別子の文字列を返します、 successCallback と、 properties オブジェクトをパラメーターとして。 そのオブジェクトが必要な value を持つプロパティ、 String 値。

ロケールを取得中にエラーがある場合、 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');}
);

完全な例

<!DOCTYPE HTML>
<html>
  <head>
    <title>getLocaleName Example</title>
    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    function checkLocale() {
      navigator.globalization.getLocaleName(
        function (locale) {alert('locale: ' + locale.value + '\n');},
        function () {alert('Error getting locale\n');}
      );
    }
    </script>
  </head>
  <body>
    <button onclick="checkLocale()">Click for locale</button>
  </body>
</html>

Windows Phone 8 癖


globalization.dateToString

日付を返します、クライアントのロケールおよびタイムゾーンに従って文字列として書式設定されます。

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' }
);

完全な例

<!DOCTYPE HTML>
<html>
  <head>
    <title>dateToString Example</title>
    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    function checkDateString() {
      navigator.globalization.dateToString(
        new Date(),
        function (date) {alert('date: ' + date.value + '\n');},
        function () {alert('Error getting dateString\n');,
        {formatLength:'short', selector:'date and time'}}
      );
    }
    </script>
  </head>
  <body>
    <button onclick="checkDateString()">Click for date string</button>
  </body>
</html>

Windows Phone 8 癖


globalization.stringToDate

クライアントのユーザーの基本設定や、クライアントのタイム ゾーンを使用して予定表によると、文字列として書式設定された日付を解析し、対応する日付オブジェクトを返します。

navigator.globalization.stringToDate(dateString, successCallback, errorCallback, options);

説明

日付の成功時のコールバックを返します、 properties オブジェクトをパラメーターとして。そのオブジェクトは、次のプロパティが必要です。

受信 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'}
);

完全な例

<!DOCTYPE HTML>
<html>
  <head>
    <title>stringToDate Example</title>
    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    function checkStringDate() {
      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'}
      );
    }

    </script>
  </head>
  <body>
    <button onclick="checkStringDate()">Click for parsed date</button>
  </body>
</html>

Windows Phone 8 癖


globalization.getDatePattern

クライアントのユーザーの設定に従った日付を解析するパターン文字列を返します。

navigator.globalization.getDatePattern(successCallback, errorCallback, options);

説明

パターンを返します、 successCallback 。パラメーターとして渡されたオブジェクトには、次のプロパティが含まれています。

パターンを取得時にエラーがある場合、 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' }
    );
}

完全な例

<!DOCTYPE HTML>
<html>
  <head>
    <title>getDatePattern Example</title>
    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    function checkDatePattern() {
      navigator.globalization.getDatePattern(
        function (date) {alert('pattern: ' + date.pattern + '\n');},
        function () {alert('Error getting pattern\n');},
        {formatLength:'short', selector:'date and time'}
      );
    }

    </script>
  </head>
  <body>
    <button onclick="checkDatePattern()">Click for pattern</button>
  </body>
</html>

Windows Phone 8 癖


globalization.getDateNames

月の名前またはクライアントのユーザーの好みやカレンダーに応じて曜日の配列を返します。

navigator.globalization.getDateNames(successCallback, errorCallback, options);

説明

名前の配列を返します、 successCallback と、 properties オブジェクトをパラメーターとして。 そのオブジェクトが含まれています、 value プロパティ、 Array の String の値。 年または選択したオプションに応じて、週の最初の日の最初の月のいずれかから始まってアレイ機能の名前。

名前の取得エラーがある場合、 errorCallback で実行する、 GlobalizationError オブジェクトをパラメーターとして。 予想されるエラーコードです。GlobalizationError.UNKNOWN\_ERROR.

optionsパラメーターはオプションであり、既定値は。

{0} 型: '幅'、項目: '月'}

値 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' }
);

完全な例

<!DOCTYPE HTML>
<html>
  <head>
    <title>getDateNames Example</title>
    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    function checkDateNames() {
      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'}
      );
    }

    </script>
  </head>
  <body>
    <button onclick="checkDateNames()">Click for date names</button>
  </body>
</html>

globalization.isDayLightSavingsTime

夏時間の時間が、クライアントのタイム ゾーンとカレンダーを使用して特定の日付に対して有効かどうかを示します。

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');}
);

完全な例

<!DOCTYPE HTML>
<html>
  <head>
    <title>isDayLightSavingsTime Example</title>
    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    function checkDayLightSavings() {
      navigator.globalization.isDayLightSavingsTime(
        new Date(),
        function (date) {alert('dst: ' + date.dst + '\n');},
        function () {alert('Error getting names\n');}
      );
    }

    </script>
  </head>
  <body>
    <button onclick="checkDayLightSavings()">Click for daylight savings</button>
  </body>
</html>

globalization.getFirstDayOfWeek

よると、クライアントのユーザー設定カレンダー週の最初の曜日を返します。

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');}
);

完全な例

<!DOCTYPE HTML>
<html>
  <head>
    <title>getFirstDayOfWeek Example</title>
    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    function checkFirstDay() {
      navigator.globalization.getFirstDayOfWeek(
        function (day) {alert('day: ' + day.value + '\n');},
        function () {alert('Error getting day\n');}
      );
    }

    </script>
  </head>
  <body>
    <button onclick="checkFirstDay()">Click for first day of week</button>
  </body>
</html>

globalization.numberToString

クライアントのユーザーの設定に従って文字列として書式設定された数を返します。

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'}
);

完全な例

<!DOCTYPE HTML>
<html>
  <head>
    <title>numberToString Example</title>
    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    function checkNumber() {
      navigator.globalization.numberToString(
        3.1415926,
        function (number) {alert('number: ' + number.value + '\n');},
        function () {alert('Error getting number\n');},
        {type:'decimal'}
      );
    }

    </script>
  </head>
  <body>
    <button onclick="checkNumber()">Click for number</button>
  </body>
</html>

globalization.stringToNumber

クライアントのユーザーの設定に従って文字列として書式設定された数を解析し、対応する番号を返します。

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'}
);

完全な例

<!DOCTYPE HTML>
<html>
  <head>
    <title>stringToNumber Example</title>
    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    function checkNumber() {
      navigator.globalization.stringToNumber(
        '1234.56',
        function (number) {alert('number: ' + number.value + '\n');},
        function () {alert('Error getting number\n');},
        {type:'decimal'}
      );
    }

    </script>
  </head>
  <body>
    <button onclick="checkNumber()">Click for parsed number</button>
  </body>
</html>

globalization.getNumberPattern

クライアントのユーザーの設定に従って数値を解析するパターン文字列を返します。

navigator.globalization.getNumberPattern(successCallback, errorCallback, options);

説明

パターンを返します、 successCallback と、 properties オブジェクトをパラメーターとして。そのオブジェクトには、次のプロパティが含まれています。

パターンを取得時にエラーがある場合、 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'}
);

結果:

パターン: # # # 0。 ### シンボル: です。分数: 0 丸め: 0 正: 負: - 10 進:。グループ:

完全な例

<!DOCTYPE HTML>
<html>
  <head>
    <title>getNumberPattern Example</title>
    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    function checkPattern() {
      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'}
      );
    }

    </script>
  </head>
  <body>
    <button onclick="checkPattern()">Click for pattern</button>
  </body>
</html>

Windows Phone 8 癖


globalization.getCurrencyPattern

書式設定および通貨の値によると、クライアントのユーザーの基本設定と ISO 4217 通貨コードを解析するパターン文字列を返します。

 navigator.globalization.getCurrencyPattern(currencyCode, successCallback, errorCallback);

説明

パターンを返します、 successCallback と、 properties オブジェクトをパラメーターとして。そのオブジェクトは、次のプロパティを含める必要があります。

受信した 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: ,

完全な例

<!DOCTYPE HTML>
<html>
  <head>
    <title>getCurrencyPattern Example</title>
    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    function checkPattern() {
      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');}
      );
    }

    </script>
  </head>
  <body>
    <button onclick="checkPattern()">Click for pattern</button>
  </body>
</html>

GlobalizationError

グローバリゼーション API からエラーを表すオブジェクト。

プロパティ

説明

このオブジェクトが作成され、コルドバ、によって移入エラーの場合のコールバックに返されます。

サポートされているプラットフォーム

簡単な例

次のエラー コールバックを実行するのようなテキストとポップアップ ダイアログが表示されます code: 3 とmessage:

function errorCallback(error) {
    alert('code: ' + error.code + '\n' +
          'message: ' + error.message + '\n');
};

完全な例

<!DOCTYPE HTML>
<html>
  <head>
    <title>GlobalizationError Example</title>
    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    function successCallback(date) {
      alert('month:' + date.month +
            ' day:' + date.day +
            ' year:' + date.year + '\n');
    }

    function errorCallback(error) {
      alert('code: ' + error.code + '\n' +
            'message: ' + error.message + '\n');
    };

    function checkError() {
      navigator.globalization.stringToDate(
        'notADate',
        successCallback,
        errorCallback,
        {selector:'foobar'}
      );
    }

    </script>
  </head>
  <body>
    <button onclick="checkError()">Click for error</button>
  </body>
</html>