
 navigator.globalization.getLocaleName
 
 Returns the BCP 47 compliant tag for the client's current locale setting.
-navigator.globalization.getLocaleName(successCallback, errorCallback);
+navigator.globalization.getLocaleName(successCallback, errorCallback);
 
 Description
 
-Returns the BCP 47 compliant locale identifier string to the successCallback
-with a properties object as a parameter. That object should have a value
-property with a String value. The locale tag will consist of a two-letter lower
+
Returns the BCP 47 compliant locale identifier string to the successCallback
+with a properties object as a parameter. That object should have a value
+property with a String value. The locale tag will consist of a two-letter lower
 case language code, two-letter upper case country code, and (unspecified) variant
 code, separated by a hyphen.
 
-If there is an error getting the locale, then the errorCallback
-executes with a GlobalizationError object as a parameter. The
-error's expected code is GlobalizationError.UNKNOWN_ERROR.
+If there is an error getting the locale, then the errorCallback
+executes with a GlobalizationError object as a parameter. The
+error's expected code is GlobalizationError.UNKNOWN_ERROR.
 
 Supported Platforms
 
@@ -2835,18 +2968,18 @@ error's expected code is Example
 
-When the browser is set to the en-US locale, this displays a popup
-dialog with the text locale: en-US.
-navigator.globalization.getLocaleName(
-    function (locale) {alert('locale: ' + locale.value + '\n');},
-    function () {alert('Error getting locale\n');}
+When the browser is set to the en-US locale, this displays a popup
+dialog with the text locale: en-US.
+navigator.globalization.getLocaleName(
+    function (locale) {alert('locale: ' + locale.value + '\n');},
+    function () {alert('Error getting locale\n');}
 );
 
 Android Quirks
 
 
 Java does not distinguish between a set "langauge" and set "locale," so this
-method is essentially the same as navigator.globalization.getPreferredLanguage().
+method is essentially the same as navigator.globalization.getPreferredLanguage().
 
 
 Windows Phone 8 Quirks
@@ -2874,25 +3007,25 @@ and in Settings -> Region -> Regio
 navigator.globalization.dateToString
 
 Returns a date formatted as a string according to the client's locale and timezone.
-navigator.globalization.dateToString(date, successCallback, errorCallback, options);
+navigator.globalization.dateToString(date, successCallback, errorCallback, options);
 
 Description
 
-Returns the formatted date String via a value property accessible
-from the object passed as a parameter to the successCallback.
+Returns the formatted date String via a value property accessible
+from the object passed as a parameter to the successCallback.
 
-The inbound date parameter should be of type Date.
+The inbound date parameter should be of type Date.
 
-If there is an error formatting the date, then the errorCallback
-executes with a GlobalizationError object as a parameter. The
-error's expected code is GlobalizationError.FORMATTING_ERROR.
+If there is an error formatting the date, then the errorCallback
+executes with a GlobalizationError object as a parameter. The
+error's expected code is GlobalizationError.FORMATTING_ERROR.
 
-The options parameter is optional, and its default values are:
-{formatLength:'short', selector:'date and time'}
-
-The options.formatLength can be short, medium, long, or full.
+The options parameter is optional, and its default values are:
+{formatLength:'short', selector:'date and time'}
+
+The options.formatLength can be short, medium, long, or full.
 
-The options.selector can be date, time or date and time.
+The options.selector can be date, time or date and time.
 
 Supported Platforms
 
@@ -2910,24 +3043,24 @@ error's expected code is Example
 
-If the browser is set to the en_US locale, this displays a popup
-dialog with text similar to date: 9/25/2012 4:21PM using the default
+
If the browser is set to the en_US locale, this displays a popup
+dialog with text similar to date: 9/25/2012 4:21PM using the default
 options:
-navigator.globalization.dateToString(
+navigator.globalization.dateToString(
     new Date(),
-    function (date) { alert('date: ' + date.value + '\n'); },
-    function () { alert('Error getting dateString\n'); },
-    { formatLength: 'short', selector: 'date and time' }
+    function (date) { alert('date: ' + date.value + '\n'); },
+    function () { alert('Error getting dateString\n'); },
+    { formatLength: 'short', selector: 'date and time' }
 );
 
 Android Quirks
 
 
-formatLength options are a subset of Unicode
+
formatLength options are a subset of Unicode
 UTS #35. The default option
-short depends on a user selected date format within
-Settings -> System -> Date & time -> Choose date format,
-which provide a year pattern only with 4 digits, not 2 digits.
+short depends on a user selected date format within
+Settings -> System -> Date & time -> Choose date format,
+which provide a year pattern only with 4 digits, not 2 digits.
 This means that it is not completely aligned with
 ICU.
 
@@ -2935,7 +3068,7 @@ This means that it is not completely ali
 Windows Phone 8 Quirks
 
 
-The formatLength option supports only short and full values.
+The formatLength option supports only short and full values.
 The pattern for 'date and time' selector is always a full datetime format.
 The returned value may be not completely aligned with ICU depending on a user locale.
 
@@ -2943,7 +3076,7 @@ This means that it is not completely ali
 Windows Quirks
 
 
-The formatLength option supports only short and full values.
+The formatLength option supports only short and full values.
 The pattern for 'date and time' selector is always a full datetime format.
 The returned value may be not completely aligned with ICU depending on a user locale.
 
@@ -2953,25 +3086,25 @@ This means that it is not completely ali
 
 Only 79 locales are supported because moment.js is used in this method.
 The returned value may be not completely aligned with ICU depending on a user locale.
-time selector supports full and short formatLength only.
+time selector supports full and short formatLength only.
 
 
 Firefox OS Quirks
 
 
-formatLength is not distinguishing long and full
-only one method of displaying date (no long or full version)
+formatLength is not distinguishing long and full
+only one method of displaying date (no long or full version)
 
 
 navigator.globalization.getCurrencyPattern
 
 Returns a pattern string to format and parse currency values according
 to the client's user preferences and ISO 4217 currency code.
- navigator.globalization.getCurrencyPattern(currencyCode, successCallback, errorCallback);
+ navigator.globalization.getCurrencyPattern(currencyCode, successCallback, errorCallback);
 
 Description
 
-Returns the pattern to the successCallback with a properties object
+
Returns the pattern to the successCallback with a properties object
 as a parameter. That object should contain the following properties:
 
 
@@ -2983,12 +3116,12 @@ as a parameter. That object should conta
 grouping: The grouping symbol to use for parsing and formatting. (String)
 
 
-The inbound currencyCode parameter should be a String of one of
+
The inbound currencyCode parameter should be a String of one of
 the ISO 4217 currency codes, for example 'USD'.
 
-If there is an error obtaining the pattern, then the errorCallback
-executes with a GlobalizationError object as a parameter. The
-error's expected code is GlobalizationError.FORMATTING_ERROR.
+If there is an error obtaining the pattern, then the errorCallback
+executes with a GlobalizationError object as a parameter. The
+error's expected code is GlobalizationError.FORMATTING_ERROR.
 
 Supported Platforms
 
@@ -3003,24 +3136,24 @@ error's expected code is Example
 
-When the browser is set to the en_US locale and the selected
+
When the browser is set to the en_US locale and the selected
 currency is United States Dollars, this example displays a popup
 dialog with text similar to the results that follow:
-navigator.globalization.getCurrencyPattern(
-    'USD',
+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);
+        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'); }
+    function () { alert('Error getting pattern\n'); }
 );
 
 Expected result:
-pattern: $#,##0.##;($#,##0.##)
+pattern: $#,##0.##;($#,##0.##)
 code: USD
 fraction: 2
 rounding: 0
@@ -3037,26 +3170,26 @@ grouping: ,
 
 Returns an array of the names of the months or days of the week,
 depending on the client's user preferences and calendar.
-navigator.globalization.getDateNames(successCallback, errorCallback, options);
+navigator.globalization.getDateNames(successCallback, errorCallback, options);
 
 Description
 
-Returns the array of names to the successCallback with a
-properties object as a parameter. That object contains a value
-property with an Array of String values. The array features names
+
Returns the array of names to the successCallback with a
+properties object as a parameter. That object contains a value
+property with an Array of String values. The array features names
 starting from either the first month in the year or the first day of
 the week, depending on the option selected.
 
-If there is an error obtaining the names, then the errorCallback
-executes with a GlobalizationError object as a parameter. The
-error's expected code is GlobalizationError.UNKNOWN_ERROR.
+If there is an error obtaining the names, then the errorCallback
+executes with a GlobalizationError object as a parameter. The
+error's expected code is GlobalizationError.UNKNOWN_ERROR.
+
+The options parameter is optional, and its default values are:
+{type:'wide', item:'months'}
+
+The value of options.type can be narrow or wide.
 
-The options parameter is optional, and its default values are:
-{type:'wide', item:'months'}
-
-The value of options.type can be narrow or wide.
-
-The value of options.item can be months or days.
+The value of options.item can be months or days.
 
 Supported Platforms
 
@@ -3074,23 +3207,23 @@ error's expected code is Example
 
-When the browser is set to the en_US locale, this example displays
+
When the browser is set to the en_US locale, this example displays
 a series of twelve popup dialogs, one per month, with text similar to
-month: January:
-navigator.globalization.getDateNames(
+month: January:
+navigator.globalization.getDateNames(
     function (names) {
         for (var i = 0; i < names.value.length; i++) {
-            alert('month: ' + names.value[i] + '\n');
+            alert('month: ' + names.value[i] + '\n');
         }
     },
-    function () { alert('Error getting names\n'); },
-    { type: 'wide', item: 'months' }
+    function () { alert('Error getting names\n'); },
+    { type: 'wide', item: 'months' }
 );
 
 Firefox OS Quirks
 
 
-options.type supports a genitive value, important for some languages
+options.type supports a genitive value, important for some languages
 
 
 Windows Phone 8 Quirks
@@ -3118,11 +3251,11 @@ a series of twelve popup dialogs, one pe
 
 Returns a pattern string to format and parse dates according to the
 client's user preferences.
-navigator.globalization.getDatePattern(successCallback, errorCallback, options);
+navigator.globalization.getDatePattern(successCallback, errorCallback, options);
 
 Description
 
-Returns the pattern to the successCallback. The object passed in as
+
Returns the pattern to the successCallback. The object passed in as
 a parameter contains the following properties:
 
 
@@ -3132,15 +3265,15 @@ a parameter contains the following prope
 dst_offset: The current daylight saving time offset in seconds between the client's non-daylight saving's time zone and the client's daylight saving's time zone. (Number)
 
 
-If there is an error obtaining the pattern, the errorCallback
-executes with a GlobalizationError object as a parameter. The
-error's expected code is GlobalizationError.PATTERN_ERROR.
-
-The options parameter is optional, and defaults to the following values:
-{formatLength:'short', selector:'date and time'}
-
-The options.formatLength can be short, medium, long, or
-full.  The options.selector can be date, time or date and
+
If there is an error obtaining the pattern, the errorCallback
+executes with a GlobalizationError object as a parameter. The
+error's expected code is GlobalizationError.PATTERN_ERROR.

+
+The options parameter is optional, and defaults to the following values:
+{formatLength:'short', selector:'date and time'}
+
+The options.formatLength can be short, medium, long, or
+full.  The options.selector can be date, time or date and
 time.
 
 Supported Platforms
@@ -3158,33 +3291,33 @@ time.
 
 Example
 
-When the browser is set to the en_US locale, this example displays
-a popup dialog with text such as pattern: M/d/yyyy h:mm a:
-function checkDatePattern() {
+When the browser is set to the en_US locale, this example displays
+a popup dialog with text such as 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' }
+        function (date) { alert('pattern: ' + date.pattern + '\n'); },
+        function () { alert('Error getting pattern\n'); },
+        { formatLength: 'short', selector: 'date and time' }
     );
 }
 
 Windows Phone 8 Quirks
 
 
-The formatLength supports only short and full values.
-The pattern for date and time pattern returns only full datetime format.
-The timezone returns the full time zone name.
-The dst_offset property is not supported, and always returns zero.
+The formatLength supports only short and full values.
+The pattern for date and time pattern returns only full datetime format.
+The timezone returns the full time zone name.
+The dst_offset property is not supported, and always returns zero.
 The pattern may be not completely aligned with ICU depending on a user locale.
 
 
 Windows Quirks
 
 
-The formatLength supports only short and full values.
-The pattern for date and time pattern returns only full datetime format.
-The timezone returns the full time zone name.
-The dst_offset property is not supported, and always returns zero.
+The formatLength supports only short and full values.
+The pattern for date and time pattern returns only full datetime format.
+The timezone returns the full time zone name.
+The dst_offset property is not supported, and always returns zero.
 The pattern may be not completely aligned with ICU depending on a user locale.
 
 
@@ -3200,18 +3333,18 @@ Other browsers return empty string.<
 
 Returns the first day of the week according to the client's user
 preferences and calendar.
-navigator.globalization.getFirstDayOfWeek(successCallback, errorCallback);
+navigator.globalization.getFirstDayOfWeek(successCallback, errorCallback);
 
 Description
 
 The days of the week are numbered starting from 1, where 1 is assumed
-to be Sunday.  Returns the day to the successCallback with a
-properties object as a parameter. That object should have a value
-property with a Number value.
-
-If there is an error obtaining the pattern, then the errorCallback
-executes with a GlobalizationError object as a parameter. The
-error's expected code is GlobalizationError.UNKNOWN_ERROR.
+to be Sunday.  Returns the day to the successCallback with a
+properties object as a parameter. That object should have a value
+property with a Number value.
+
+If there is an error obtaining the pattern, then the errorCallback
+executes with a GlobalizationError object as a parameter. The
+error's expected code is GlobalizationError.UNKNOWN_ERROR.
 
 Supported Platforms
 
@@ -3229,11 +3362,11 @@ error's expected code is Example
 
-When the browser is set to the en_US locale, this displays a
-popup dialog with text similar to day: 1.
-navigator.globalization.getFirstDayOfWeek(
-    function (day) {alert('day: ' + day.value + '\n');},
-    function () {alert('Error getting day\n');}
+When the browser is set to the en_US locale, this displays a
+popup dialog with text similar to day: 1.
+navigator.globalization.getFirstDayOfWeek(
+    function (day) {alert('day: ' + day.value + '\n');},
+    function () {alert('Error getting day\n');}
 );
 
 Windows Quirks
@@ -3252,11 +3385,11 @@ the value depends on current locale.navigator.globalization.getNumberPattern
 
 Returns a pattern string to format and parse numbers according to the client's user preferences.
-navigator.globalization.getNumberPattern(successCallback, errorCallback, options);
+navigator.globalization.getNumberPattern(successCallback, errorCallback, options);
 
 Description
 
-Returns the pattern to the successCallback with a properties object
+
Returns the pattern to the successCallback with a properties object
 as a parameter. That object contains the following properties:
 
 
@@ -3270,14 +3403,14 @@ as a parameter. That object contains the
 grouping: The grouping symbol to use for parsing and formatting. (String)
 
 
-If there is an error obtaining the pattern, then the errorCallback
-executes with a GlobalizationError object as a parameter. The
-error's expected code is GlobalizationError.PATTERN_ERROR.
-
-The options parameter is optional, and default values are:
-{type:'decimal'}
-
-The options.type can be decimal, percent, or currency.
+If there is an error obtaining the pattern, then the errorCallback
+executes with a GlobalizationError object as a parameter. The
+error's expected code is GlobalizationError.PATTERN_ERROR.
+
+The options parameter is optional, and default values are:
+{type:'decimal'}
+
+The options.type can be decimal, percent, or currency.
 
 Supported Platforms
 
@@ -3294,23 +3427,23 @@ error's expected code is Example
 
-When the browser is set to the en_US locale, this should display a
+
When the browser is set to the en_US locale, this should display a
 popup dialog with text similar to the results that follow:
-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'}
+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'}
 );
 
 Results:
-pattern: #,##0.###
+pattern: #,##0.###
 symbol: .
 fraction: 0
 rounding: 0
@@ -3322,40 +3455,40 @@ grouping: ,
 Windows Phone 8 Quirks
 
 
-The pattern property is not supported, and returns an empty string.
-The fraction property is not supported, and returns zero.
+The pattern property is not supported, and returns an empty string.
+The fraction property is not supported, and returns zero.
 
 
 Windows Quirks
 
 
-The pattern property is not supported, and returns an empty string.
+The pattern property is not supported, and returns an empty string.
 
 
 Browser Quirks
 
 
-getNumberPattern is supported in Chrome only; the only defined property is pattern.
+getNumberPattern is supported in Chrome only; the only defined property is pattern.
 
 
 navigator.globalization.isDayLightSavingsTime
 
 Indicates whether daylight savings time is in effect for a given date
 using the client's time zone and calendar.
-navigator.globalization.isDayLightSavingsTime(date, successCallback, errorCallback);
+navigator.globalization.isDayLightSavingsTime(date, successCallback, errorCallback);
 
 Description
 
 Indicates whether or not daylight savings time is in effect to the
-successCallback with a properties object as a parameter. That object
-should have a dst property with a Boolean value. A true value
+successCallback with a properties object as a parameter. That object
+should have a dst property with a Boolean value. A true value
 indicates that daylight savings time is in effect for the given date,
-and false indicates that it is not.
+and false indicates that it is not.
 
-The inbound parameter date should be of type Date.
+The inbound parameter date should be of type Date.
 
-If there is an error reading the date, then the errorCallback
-executes. The error's expected code is GlobalizationError.UNKNOWN_ERROR.
+If there is an error reading the date, then the errorCallback
+executes. The error's expected code is GlobalizationError.UNKNOWN_ERROR.
 
 Supported Platforms
 
@@ -3375,32 +3508,32 @@ executes. The error's expected code
 
 During the summer, and if the browser is set to a DST-enabled
 timezone, this should display a popup dialog with text similar to
-dst: true:
-navigator.globalization.isDayLightSavingsTime(
+dst: true:
+navigator.globalization.isDayLightSavingsTime(
     new Date(),
-    function (date) {alert('dst: ' + date.dst + '\n');},
-    function () {alert('Error getting names\n');}
+    function (date) {alert('dst: ' + date.dst + '\n');},
+    function () {alert('Error getting names\n');}
 );
 
 navigator.globalization.numberToString
 
 Returns a number formatted as a string according to the client's user preferences.
-navigator.globalization.numberToString(number, successCallback, errorCallback, options);
+navigator.globalization.numberToString(number, successCallback, errorCallback, options);
 
 Description
 
-Returns the formatted number string to the successCallback with a
-properties object as a parameter. That object should have a value
-property with a String value.
-
-If there is an error formatting the number, then the errorCallback
-executes with a GlobalizationError object as a parameter. The
-error's expected code is GlobalizationError.FORMATTING_ERROR.
-
-The options parameter is optional, and its default values are:
-{type:'decimal'}
-
-The options.type can be 'decimal', 'percent', or 'currency'.
+Returns the formatted number string to the successCallback with a
+properties object as a parameter. That object should have a value
+property with a String value.
+
+If there is an error formatting the number, then the errorCallback
+executes with a GlobalizationError object as a parameter. The
+error's expected code is GlobalizationError.FORMATTING_ERROR.
+
+The options parameter is optional, and its default values are:
+{type:'decimal'}
+
+The options.type can be 'decimal', 'percent', or 'currency'.
 
 Supported Platforms
 
@@ -3417,27 +3550,27 @@ error's expected code is Example
 
-When the browser is set to the en_US locale, this displays a popup
-dialog with text similar to number: 3.142:
-navigator.globalization.numberToString(
+When the browser is set to the en_US locale, this displays a popup
+dialog with text similar to number: 3.142:
+navigator.globalization.numberToString(
     3.1415926,
-    function (number) {alert('number: ' + number.value + '\n');},
-    function () {alert('Error getting number\n');},
-    {type:'decimal'}
+    function (number) {alert('number: ' + number.value + '\n');},
+    function () {alert('Error getting number\n');},
+    {type:'decimal'}
 );
 
 Windows Quirks
 
 
 Windows 8.0 does not support number rounding, therefore values will not be rounded automatically.
-On Windows 8.1 and Windows Phone 8.1 fractional part is being truncated instead of rounded in case of percent number type therefore fractional digits count is set to 0.
-percent numbers are not grouped as they can't be parsed in stringToNumber if grouped.
+On Windows 8.1 and Windows Phone 8.1 fractional part is being truncated instead of rounded in case of percent number type therefore fractional digits count is set to 0.
+percent numbers are not grouped as they can't be parsed in stringToNumber if grouped.
 
 
 Browser Quirks
 
 
-currency type is not supported.
+currency type is not supported.
 
 
 navigator.globalization.stringToDate
@@ -3445,11 +3578,11 @@ dialog with text similar to Parses a date formatted as a string, according to the client's user
 preferences and calendar using the time zone of the client, and
 returns the corresponding date object.
-navigator.globalization.stringToDate(dateString, successCallback, errorCallback, options);
+navigator.globalization.stringToDate(dateString, successCallback, errorCallback, options);
 
 Description
 
-Returns the date to the success callback with a properties object as

[... 187 lines stripped ...]



---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org
Installation

Objects

navigator.globalization.getPreferredLanguage

Description

Supported Platforms

Android Quirks

navigator.globalization.getLocaleName

Description

Supported Platforms

Android Quirks

Windows Phone 8 Quirks

navigator.globalization.dateToString

Description

Supported Platforms

Android Quirks

Windows Phone 8 Quirks

Windows Quirks

Firefox OS Quirks

navigator.globalization.getCurrencyPattern

Description

Supported Platforms

Description

Supported Platforms

Firefox OS Quirks

Windows Phone 8 Quirks

Description

Supported Platforms

Example

Windows Phone 8 Quirks

Windows Quirks

Description

Supported Platforms

Windows Quirks

Description

Supported Platforms

Windows Phone 8 Quirks

Windows Quirks

Browser Quirks

navigator.globalization.isDayLightSavingsTime

Description

Supported Platforms

navigator.globalization.numberToString

Description

Supported Platforms

Windows Quirks

Browser Quirks

navigator.globalization.stringToDate

Description
