You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by ld...@apache.org on 2014/07/07 19:51:07 UTC
[07/10] git commit: Lisa testing pulling in plugins for plugin:
cordova-plugin-globalization
Lisa testing pulling in plugins for plugin: cordova-plugin-globalization
Project: http://git-wip-us.apache.org/repos/asf/cordova-plugin-globalization/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-plugin-globalization/commit/cb3d6d0d
Tree: http://git-wip-us.apache.org/repos/asf/cordova-plugin-globalization/tree/cb3d6d0d
Diff: http://git-wip-us.apache.org/repos/asf/cordova-plugin-globalization/diff/cb3d6d0d
Branch: refs/heads/master
Commit: cb3d6d0d9fe02416e41b2ddd0ed97f460fd20461
Parents: b0943b5
Author: ldeluca <ld...@us.ibm.com>
Authored: Tue May 27 21:22:14 2014 -0400
Committer: ldeluca <ld...@us.ibm.com>
Committed: Tue May 27 21:22:14 2014 -0400
----------------------------------------------------------------------
doc/es/index.md | 187 ++++++++-------
doc/fr/index.md | 374 +++++++++++++++--------------
doc/it/index.md | 650 +++++++++++++++++++++++++++++++++++++++++++++++++++
doc/ko/index.md | 650 +++++++++++++++++++++++++++++++++++++++++++++++++++
doc/pl/index.md | 650 +++++++++++++++++++++++++++++++++++++++++++++++++++
doc/zh/index.md | 650 +++++++++++++++++++++++++++++++++++++++++++++++++++
6 files changed, 2892 insertions(+), 269 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-plugin-globalization/blob/cb3d6d0d/doc/es/index.md
----------------------------------------------------------------------
diff --git a/doc/es/index.md b/doc/es/index.md
index 95893bc..9f701c4 100644
--- a/doc/es/index.md
+++ b/doc/es/index.md
@@ -19,7 +19,7 @@
# org.apache.cordova.globalization
-Este plugin obtiene información y realiza operaciones específicas del usuario local y zona horaria.
+Este plugin obtiene información y realiza operaciones específicas de la configuración regional del usuario, idioma y zona horaria. Tenga en cuenta la diferencia entre la configuración regional e idioma: controles locale como números, fechas y tiempos se muestran para una región, mientras que el lenguaje determina qué texto aparece como, independientemente de la configuración local. A menudo los desarrolladores utilizan locale para fijar ambos ajustes, pero no hay razón que el usuario no pudo establecer su idioma a "Inglés" locale "Francés", para que se muestre el texto en inglés, pero las fechas, tiempos, etc., se muestran como son en Francia. Desafortunadamente, las plataformas móviles más actualmente no hacen una distinción entre estos ajustes.
## Instalación
@@ -45,6 +45,83 @@ Este plugin obtiene información y realiza operaciones específicas del usuario
* navigator.globalization.getNumberPattern
* navigator.globalization.getCurrencyPattern
+## navigator.globalization.getPreferredLanguage
+
+Busque la etiqueta de idioma BCP 47 el idioma actual del cliente.
+
+ navigator.globalization.getPreferredLanguage(successCallback, errorCallback);
+
+
+### Descripción
+
+Devuelve la etiqueta de identificador de idioma compatible con BCP-47 a la `successCallback` con un `properties` objeto como parámetro. Ese objeto debe tener un `value` propiedad con un `String` valor.
+
+Si hay un error al obtener el idioma, entonces el `errorCallback` se ejecuta con un `GlobalizationError` objeto como parámetro. Código esperado del error es`GlobalizationError.UNKNOWN_ERROR`.
+
+### Plataformas soportadas
+
+* Amazon fuego OS
+* Android
+* iOS
+* Windows Phone 8
+
+### Ejemplo
+
+Cuando el navegador está configurado la `en-US` lengua, ésta debe mostrar un cuadro de diálogo emergente con el texto `language: en-US` :
+
+ navigator.globalization.getPreferredLanguage(
+ function (language) {alert('language: ' + language.value + '\n');},
+ function () {alert('Error getting language\n');}
+ );
+
+
+### Rarezas Android
+
+* Devuelve el código de idioma de dos letras 639-1 ISO, mayúsculas código ISO 3166-1 y la variante separada por guiones. Ejemplos: "at", "en-US", "US"
+
+### Windows Phone 8 rarezas
+
+* Código de idioma devuelve el ISO 639-1 dos letras y código de la ISO 3166-1 de la variante regional correspondiente a la "lengua" ajuste, separados por un guión.
+* Tenga en cuenta que la variante regional es una característica de la configuración del "Idioma" y no determinado por el ajuste de "País o región" sin relación en Windows Phone.
+
+## navigator.globalization.getLocaleName
+
+Devuelve la etiqueta compatible con BCP 47 para la configuración regional actual del cliente.
+
+ navigator.globalization.getLocaleName(successCallback, errorCallback);
+
+
+### Descripción
+
+Devuelve el identificador BCP 47 local conforme a la `successCallback` con un `properties` objeto como parámetro. Ese objeto debe tener un `value` propiedad con un `String` valor. La etiqueta de configuración regional consistirá en un código de idioma de dos letras minúsculas, código de país de dos letras mayúsculas y códigos de la variante (no especificados), separados por un guión.
+
+Si hay un error al obtener la configuración regional, entonces el `errorCallback` se ejecuta con un `GlobalizationError` objeto como parámetro. Código esperado del error es`GlobalizationError.UNKNOWN_ERROR`.
+
+### Plataformas soportadas
+
+* Amazon fuego OS
+* Android
+* iOS
+* Windows Phone 8
+
+### Ejemplo
+
+Cuando el navegador se establece en el `en-US` local, muestra un cuadro de diálogo emergente con el texto`locale: en-US`.
+
+ navigator.globalization.getLocaleName(
+ function (locale) {alert('locale: ' + locale.value + '\n');},
+ function () {alert('Error getting locale\n');}
+ );
+
+
+### Rarezas Android
+
+* Java no distingue entre un conjunto "idioma" y establecer "locale", así que este método es esencialmente el mismo que`navigator.globalizatin.getPreferredLanguage()`.
+
+### Windows Phone 8 rarezas
+
+* Código de idioma devuelve el ISO 639-1 dos letras y código de la ISO 3166-1 de la variante regional correspondiente a la posición "Formato Regional", separada por un guión.
+
## navigator.globalization.dateToString
Devuelve una fecha con formato como una cadena según la configuración regional del cliente y zona horaria.
@@ -58,7 +135,7 @@ Devuelve la fecha con formato `String` vía un `value` propiedad accesible desde
Los entrantes `date` parámetro debe ser del tipo`Date`.
-Si hay un error de formato de la fecha, entonces el `errorCallback` se ejecuta con un `GlobalizationError` objeto como parámetro. Código esperado del error es`GlobalizationError.FORMATTING\_ERROR`.
+Si hay un error de formato de la fecha, entonces el `errorCallback` se ejecuta con un `GlobalizationError` objeto como parámetro. Código esperado del error es`GlobalizationError.FORMATTING_ERROR`.
El `options` parámetro es opcional, y sus valores por defecto son:
@@ -78,7 +155,7 @@ El `options.selector` puede ser `date` , `time` o`date and time`.
### Ejemplo
-Si el navegador está configurado la `en\_US` local, muestra un cuadro de diálogo emergente con texto similar a `date: 9/25/2012 4:21PM` utilizando las opciones predeterminadas:
+Si el navegador está configurado la `en_US` local, muestra un cuadro de diálogo emergente con texto similar a `date: 9/25/2012 4:21PM` utilizando las opciones predeterminadas:
navigator.globalization.dateToString(
new Date(),
@@ -119,7 +196,7 @@ Devuelve el patrón a la `successCallback` con un `properties` objeto como pará
Los entrantes `currencyCode` parámetro debe ser un `String` de uno de los códigos de moneda ISO 4217, por ejemplo 'USD'.
-Si hay un error obteniendo el patrón, entonces el `errorCallback` se ejecuta con un `GlobalizationError` objeto como parámetro. Código esperado del error es`GlobalizationError.FORMATTING\_ERROR`.
+Si hay un error obteniendo el patrón, entonces el `errorCallback` se ejecuta con un `GlobalizationError` objeto como parámetro. Código esperado del error es`GlobalizationError.FORMATTING_ERROR`.
### Plataformas soportadas
@@ -129,7 +206,7 @@ Si hay un error obteniendo el patrón, entonces el `errorCallback` se ejecuta co
### Ejemplo
-Cuando el navegador está configurado la `en\_US` local y la moneda seleccionada dólares de Estados Unidos, este ejemplo muestra un cuadro de diálogo emergente con texto similar a los resultados que siguen:
+Cuando el navegador está configurado la `en_US` local y la moneda seleccionada dólares de Estados Unidos, este ejemplo muestra un cuadro de diálogo emergente con texto similar a los resultados que siguen:
navigator.globalization.getCurrencyPattern(
'USD',
@@ -159,18 +236,18 @@ Resultado esperado:
Devuelve una matriz de los nombres de los meses o días de la semana, dependiendo de las preferencias del usuario y el calendario del cliente.
- navigator.globalization.getDateNames (successCallback, errorCallback, opciones);
+ navigator.globalization.getDateNames(successCallback, errorCallback, options);
### Descripción
Devuelve la matriz de nombres de la `successCallback` con un `properties` objeto como parámetro. Ese objeto contiene un `value` propiedad con un `Array` de `String` valores. Los nombres de funciones de matriz a partir desde el primer mes en el año o el primer día de la semana, dependiendo de la opción seleccionada.
-Si hay un error obteniendo los nombres, entonces el `errorCallback` se ejecuta con un `GlobalizationError` objeto como parámetro. Código esperado del error es`GlobalizationError.UNKNOWN\_ERROR`.
+Si hay un error obteniendo los nombres, entonces el `errorCallback` se ejecuta con un `GlobalizationError` objeto como parámetro. Código esperado del error es`GlobalizationError.UNKNOWN_ERROR`.
El `options` parámetro es opcional, y sus valores por defecto son:
- {tipo: 'amplia', tema: 'meses'}
+ {type:'wide', item:'months'}
El valor de `options.type` puede ser `narrow` o`wide`.
@@ -186,7 +263,7 @@ El valor de `options.item` puede ser `months` o`days`.
### Ejemplo
-Cuando el navegador se establece en el `en\_US` local, este ejemplo muestra una serie de doce diálogos emergente, uno por mes, con un texto similar a `month: January` :
+Cuando el navegador se establece en el `en_US` local, este ejemplo muestra una serie de doce diálogos emergente, uno por mes, con un texto similar a `month: January` :
navigator.globalization.getDateNames(
function (names) {
@@ -218,7 +295,7 @@ Devuelve el patrón a la `successCallback` . El objeto se pasa como parámetro c
* **dst_offset**: el desplazamiento horario actual en segundos entre no-horario del cliente de huso horario y día del cliente ahorro de zona horaria. *(Número)*
-Si hay un error obteniendo el patrón, el `errorCallback` se ejecuta con un `GlobalizationError` objeto como parámetro. Código esperado del error es`GlobalizationError.PATTERN\_ERROR`.
+Si hay un error obteniendo el patrón, el `errorCallback` se ejecuta con un `GlobalizationError` objeto como parámetro. Código esperado del error es`GlobalizationError.PATTERN_ERROR`.
El `options` parámetro es opcional y por defecto los siguientes valores:
@@ -237,7 +314,7 @@ time`.
### Ejemplo
-Cuando el navegador se establece en el `en\_US` local, este ejemplo muestra un cuadro de diálogo emergente con el texto como `pattern: M/d/yyyy h:mm a` :
+Cuando el navegador se establece en el `en_US` local, este ejemplo muestra un cuadro de diálogo emergente con el texto como `pattern: M/d/yyyy h:mm a` :
function checkDatePattern() {
navigator.globalization.getDatePattern(
@@ -269,7 +346,7 @@ Devuelve el primer día de la semana según las preferencias del usuario y el ca
Los días de la semana están contados a partir de la 1, donde 1 se supone que es el domingo. Devuelve el día de la `successCallback` con un `properties` objeto como parámetro. Ese objeto debe tener un `value` propiedad con un `Number` valor.
-Si hay un error obteniendo el patrón, entonces el `errorCallback` se ejecuta con un `GlobalizationError` objeto como parámetro. Código esperado del error es`GlobalizationError.UNKNOWN\_ERROR`.
+Si hay un error obteniendo el patrón, entonces el `errorCallback` se ejecuta con un `GlobalizationError` objeto como parámetro. Código esperado del error es`GlobalizationError.UNKNOWN_ERROR`.
### Plataformas soportadas
@@ -280,7 +357,7 @@ Si hay un error obteniendo el patrón, entonces el `errorCallback` se ejecuta co
### Ejemplo
-Cuando el navegador se establece en el `en\_US` local, muestra un cuadro de diálogo emergente con texto similar a`day: 1`.
+Cuando el navegador se establece en el `en_US` local, muestra un cuadro de diálogo emergente con texto similar a`day: 1`.
navigator.globalization.getFirstDayOfWeek(
function (day) {alert('day: ' + day.value + '\n');},
@@ -288,38 +365,6 @@ Cuando el navegador se establece en el `en\_US` local, muestra un cuadro de diá
);
-Obtener el identificador de cadena para la configuración regional actual del cliente.
-
- navigator.globalization.getLocaleName(successCallback, errorCallback);
-
-
-### Descripción
-
-Devuelve el identificador de configuración regional para el `successCallback` con un `properties` objeto como parámetro. Ese objeto debe tener un `value` propiedad con un `String` valor.
-
-Si hay un error al obtener la configuración regional, entonces el `errorCallback` se ejecuta con un `GlobalizationError` objeto como parámetro. Código esperado del error es`GlobalizationError.UNKNOWN\_ERROR`.
-
-### Plataformas soportadas
-
-* Amazon fuego OS
-* Android
-* iOS
-* Windows Phone 8
-
-### Ejemplo
-
-Cuando el navegador se establece en el `en\_US` local, muestra un cuadro de diálogo emergente con el texto`locale: en\_US`.
-
- navigator.globalization.getLocaleName(
- function (locale) {alert('locale: ' + locale.value + '\n');},
- function () {alert('Error getting locale\n');}
- );
-
-
-### Windows Phone 8 rarezas
-
-* Devuelve el código de dos letras definido en ISO 3166 para el actual país/región.
-
## navigator.globalization.getNumberPattern
Devuelve una cadena de patrón para analizar números según las preferencias del cliente usuario y el formato.
@@ -347,7 +392,7 @@ Devuelve el patrón a la `successCallback` con un `properties` objeto como pará
* **agrupación**: el símbolo de la agrupación para analizar y dar formato. *(String)*
-Si hay un error obteniendo el patrón, entonces el `errorCallback` se ejecuta con un `GlobalizationError` objeto como parámetro. Código esperado del error es`GlobalizationError.PATTERN\_ERROR`.
+Si hay un error obteniendo el patrón, entonces el `errorCallback` se ejecuta con un `GlobalizationError` objeto como parámetro. Código esperado del error es`GlobalizationError.PATTERN_ERROR`.
El `options` parámetro es opcional, y los valores por defecto son:
@@ -365,7 +410,7 @@ El `options.type` puede ser `decimal` , `percent` , o`currency`.
### Ejemplo
-Cuando el navegador está configurado el `en\_US` locale, esto debería mostrar un cuadro de diálogo emergente con texto similar a los resultados que siguen:
+Cuando el navegador está configurado el `en_US` locale, esto debería mostrar un cuadro de diálogo emergente con texto similar a los resultados que siguen:
navigator.globalization.getNumberPattern(
function (pattern) {alert('pattern: ' + pattern.pattern + '\n' +
@@ -399,40 +444,6 @@ Resultados:
* El `fraction` no se admite la propiedad, y devuelve cero.
-## navigator.globalization.getPreferredLanguage
-
-Obtener el identificador de cadena en idioma actual del cliente.
-
- navigator.globalization.getPreferredLanguage(successCallback, errorCallback);
-
-
-### Descripción
-
-Devuelve el identificador de idioma para el `successCallback` con un `properties` objeto como parámetro. Ese objeto debe tener un `value` propiedad con un `String` valor.
-
-Si hay un error al obtener el idioma, entonces el `errorCallback` se ejecuta con un `GlobalizationError` objeto como parámetro. Código esperado del error es`GlobalizationError.UNKNOWN\_ERROR`.
-
-### Plataformas soportadas
-
-* Amazon fuego OS
-* Android
-* iOS
-* Windows Phone 8
-
-### Ejemplo
-
-Cuando el navegador está configurado el `en\_US` locale, esto debería mostrar un cuadro de diálogo emergente con el texto `language: English` :
-
- navigator.globalization.getPreferredLanguage(
- function (language) {alert('language: ' + language.value + '\n');},
- function () {alert('Error getting language\n');}
- );
-
-
-### Windows Phone 8 rarezas
-
-* Devuelve el código de dos letras ISO 639-1 del idioma actual.
-
## navigator.globalization.isDayLightSavingsTime
Indica si el horario de verano es en efecto para una fecha determinada usando la zona horaria y el calendario del cliente.
@@ -446,7 +457,7 @@ Indica si es o no horario de verano en efecto a la `successCallback` con un `pro
El parámetro entrantes `date` debe ser de tipo`Date`.
-Si hay un error de lectura de la fecha, entonces el `errorCallback` se ejecuta. Código esperado del error es`GlobalizationError.UNKNOWN\_ERROR`.
+Si hay un error de lectura de la fecha, entonces el `errorCallback` se ejecuta. Código esperado del error es`GlobalizationError.UNKNOWN_ERROR`.
### Plataformas soportadas
@@ -477,7 +488,7 @@ Devuelve un número con formato como una cadena según las preferencias del clie
Devuelve la cadena con formato de número a la `successCallback` con un `properties` objeto como parámetro. Ese objeto debe tener un `value` propiedad con un `String` valor.
-Si hay un error de formato del número, entonces el `errorCallback` se ejecuta con un `GlobalizationError` objeto como parámetro. Código esperado del error es`GlobalizationError.FORMATTING\_ERROR`.
+Si hay un error de formato del número, entonces el `errorCallback` se ejecuta con un `GlobalizationError` objeto como parámetro. Código esperado del error es`GlobalizationError.FORMATTING_ERROR`.
El `options` parámetro es opcional, y sus valores por defecto son:
@@ -495,7 +506,7 @@ El `options.type` puede ser 'decimal', '%' o 'moneda'.
### Ejemplo
-Cuando el navegador se establece en el `en\_US` local, muestra un cuadro de diálogo emergente con texto similar a `number: 3.142` :
+Cuando el navegador se establece en el `en_US` local, muestra un cuadro de diálogo emergente con texto similar a `number: 3.142` :
navigator.globalization.numberToString(
3.1415926,
@@ -540,7 +551,7 @@ El `options` parámetro es opcional y por defecto los siguientes valores:
El `options.formatLength` puede ser `short` , `medium` , `long` , o `full` . El `options.selector` puede ser `date` , `time` o`date and
time`.
-Si hay un error al analizar la cadena de fecha, entonces el `errorCallback` se ejecuta con un `GlobalizationError` objeto como parámetro. Código esperado del error es`GlobalizationError.PARSING\_ERROR`.
+Si hay un error al analizar la cadena de fecha, entonces el `errorCallback` se ejecuta con un `GlobalizationError` objeto como parámetro. Código esperado del error es`GlobalizationError.PARSING_ERROR`.
### Plataformas soportadas
@@ -551,7 +562,7 @@ Si hay un error al analizar la cadena de fecha, entonces el `errorCallback` se e
### Ejemplo
-Cuando el navegador se establece en el `en\_US` local, muestra un cuadro de diálogo emergente con texto similar a `month:8 day:25 year:2012` . Tenga en cuenta que el mes entero es uno menos de la cadena, como el entero mes representa un índice de matriz.
+Cuando el navegador se establece en el `en_US` local, muestra un cuadro de diálogo emergente con texto similar a `month:8 day:25 year:2012` . Tenga en cuenta que el mes entero es uno menos de la cadena, como el entero mes representa un índice de matriz.
navigator.globalization.stringToDate(
'9/25/2012',
@@ -578,7 +589,7 @@ Analiza un número con formato como una cadena según las preferencias del clien
Devuelve el número de la `successCallback` con un `properties` objeto como parámetro. Ese objeto debe tener un `value` propiedad con un `Number` valor.
-Si hay un error al analizar la cadena de número, entonces el `errorCallback` se ejecuta con un `GlobalizationError` objeto como parámetro. Código esperado del error es`GlobalizationError.PARSING\_ERROR`.
+Si hay un error al analizar la cadena de número, entonces el `errorCallback` se ejecuta con un `GlobalizationError` objeto como parámetro. Código esperado del error es`GlobalizationError.PARSING_ERROR`.
El `options` parámetro es opcional y por defecto los siguientes valores:
@@ -596,7 +607,7 @@ El `options.type` puede ser `decimal` , `percent` , o`currency`.
### Ejemplo
-Cuando el navegador está configurado el `en\_US` locale, esto debería mostrar un cuadro de diálogo emergente con texto similar a `number: 1234.56` :
+Cuando el navegador está configurado el `en_US` locale, esto debería mostrar un cuadro de diálogo emergente con texto similar a `number: 1234.56` :
navigator.globalization.stringToNumber(
'1234.56',
http://git-wip-us.apache.org/repos/asf/cordova-plugin-globalization/blob/cb3d6d0d/doc/fr/index.md
----------------------------------------------------------------------
diff --git a/doc/fr/index.md b/doc/fr/index.md
index 888165f..1b86154 100644
--- a/doc/fr/index.md
+++ b/doc/fr/index.md
@@ -19,7 +19,7 @@
# org.apache.cordova.globalization
-Ce plugin obtienne des informations et effectue des opérations spécifiques aux paramètres régionaux et le fuseau horaire de l'utilisateur.
+Ce plugin obtienne des informations et effectue des opérations spécifiques aux paramètres régionaux de l'utilisateur, la langue et fuseau horaire. Notez la différence entre les paramètres régionaux et linguistiques : contrôles de paramètres régionaux comment nombres, les dates et les heures sont affichées pour une région, tandis que la langue détermine quel texte apparaît sous la forme, indépendamment des paramètres régionaux. Souvent les développeurs utilisent des paramètres régionaux pour définir ces deux paramètres, mais il n'y a aucune raison, qu'un utilisateur ne pouvait pas régler sa langue sur « English », mais en paramètres régionaux « Français », afin que le texte s'affiche en anglais mais dates, heures, etc., s'affichent comme ils sont en France. Malheureusement, les plateformes mobiles plus actuellement ne font pas une distinction entre ces paramètres.
## Installation
@@ -45,29 +45,106 @@ Ce plugin obtienne des informations et effectue des opérations spécifiques aux
* navigator.globalization.getNumberPattern
* navigator.globalization.getCurrencyPattern
+## navigator.globalization.getPreferredLanguage
+
+Obtenir la balise de langue BCP 47 pour la langue du client actuel.
+
+ navigator.globalization.getPreferredLanguage(successCallback, errorCallback);
+
+
+### Description
+
+Retourne la balise d'identificateur de langage compatible BCP-47 à la `successCallback` avec un `properties` objet comme paramètre. Cet objet doit avoir une `value` propriété avec une `String` valeur.
+
+S'il y a une erreur d'obtention de la langue, puis le `errorCallback` s'exécute avec un `GlobalizationError` objet comme paramètre. Code attendu de l'erreur est`GlobalizationError.UNKNOWN_ERROR`.
+
+### Plates-formes prises en charge
+
+* Amazon Fire OS
+* Android
+* iOS
+* Windows Phone 8
+
+### Exemple
+
+Lorsque le navigateur est configuré pour le `en-US` langue, cela devrait afficher une boîte de dialogue contextuelle avec le texte `language: en-US` :
+
+ navigator.globalization.getPreferredLanguage(
+ function (language) {alert('language: ' + language.value + '\n');},
+ function () {alert('Error getting language\n');}
+ );
+
+
+### Quirks Android
+
+* Retourne le code de langue à deux lettres 639-1 ISO, majuscules du code ISO 3166-1 country et variante séparés par des tirets. Exemples: « fr », « en-US », « US »
+
+### Windows Phone 8 Quirks
+
+* Code renvoie l'ISO 639-1 deux lettres de la langue et indicatif ISO 3166-1 de la variante régionale correspondant à la « langue » définissant, séparés par un tiret.
+* Notez que la variante régionale est une propriété du paramètre « Langue » et pas déterminé par le paramètre « Pays/région » sans rapport avec Windows Phone.
+
+## navigator.globalization.getLocaleName
+
+Retourne la balise conforme BCP 47 pour paramètre de langue actuel du client.
+
+ navigator.globalization.getLocaleName(successCallback, errorCallback);
+
+
+### Description
+
+Retourne la chaîne d'identificateur de paramètres régionaux compatibles BCP 47 à la `successCallback` avec un `properties` objet comme paramètre. Cet objet doit avoir une `value` propriété avec une `String` valeur. La balise locale comprendra un code de deux lettres minuscules langue, code de pays à deux lettres majuscules et code de variante (non précisé), séparés par un tiret.
+
+S'il y a une erreur d'obtenir les paramètres régionaux, puis le `errorCallback` s'exécute avec un `GlobalizationError` objet comme paramètre. Code attendu de l'erreur est`GlobalizationError.UNKNOWN_ERROR`.
+
+### Plates-formes prises en charge
+
+* Amazon Fire OS
+* Android
+* iOS
+* Windows Phone 8
+
+### Exemple
+
+Lorsque le navigateur est configuré pour la `en-US` locale, ceci pour afficher une fenêtre popup avec le texte`locale: en-US`.
+
+ navigator.globalization.getLocaleName(
+ function (locale) {alert('locale: ' + locale.value + '\n');},
+ function () {alert('Error getting locale\n');}
+ );
+
+
+### Quirks Android
+
+* Java ne distingue pas entre un set « langue » et le set « locale », donc cette méthode est essentiellement identique à`navigator.globalizatin.getPreferredLanguage()`.
+
+### Windows Phone 8 Quirks
+
+* Code renvoie l'ISO 639-1 deux lettres de la langue et indicatif ISO 3166-1 de la variante régionale correspondant au paramètre de Format « régional », séparé par un trait d'Union.
+
## navigator.globalization.dateToString
-Renvoie une date sous la forme d'une chaîne de caractères en tenant compte des réglages de langue et de fuseau horaire du client.
+Renvoie une date mise en forme comme une chaîne selon les paramètres régionaux du client et de fuseau horaire.
navigator.globalization.dateToString(date, successCallback, errorCallback, options);
### Description
-Retourne la date formatée (`String`) via la propriété `value` définie sur l'objet transmis en paramètre à la fonction `successCallback`.
+Retourne la date de mise en forme `String` par une `value` propriété accessible à partir de l'objet passé comme paramètre à la`successCallback`.
-La valeur du premier paramètre, nommé `date`, doit être de type `Date`.
+L'entrantes `date` paramètre doit être de type`Date`.
-Si une erreur survient lors du formatage de la date, la fonction `errorCallback` est exécutée et un objet `GlobalizationError` lui est passé en paramètre. Code attendu de l'erreur est`GlobalizationError.FORMATTING\_ERROR`.
+S'il y a une erreur de mise en forme la date, puis le `errorCallback` s'exécute avec un `GlobalizationError` objet comme paramètre. Code attendu de l'erreur est`GlobalizationError.FORMATTING_ERROR`.
-Le paramètre `options` est facultatif, sa valeur par défaut est :
+Le `options` paramètre est facultatif, et ses valeurs par défaut sont :
{formatLength: « court », sélecteur: « date et heure »}
-Les valeurs autorisées pour la propriété `options.formatLength` sont `short`, `medium`, `long` et `full`.
+Le `options.formatLength` peut être `short` , `medium` , `long` , ou`full`.
-Les valeurs autorisées pour la propriété `options.selector` sont `date`, `time` et `date and time`.
+Le `options.selector` peut être `date` , `time` ou`date and time`.
### Plates-formes prises en charge
@@ -78,48 +155,48 @@ Les valeurs autorisées pour la propriété `options.selector` sont `date`, `tim
### Exemple
-Si la langue du navigateur est réglée sur `fr_FR`, une fenêtre popup contenant un texte semblable à `date : 25/09/2012 16:21` est affichée (options par défaut) :
+Si le navigateur est configuré pour la `en_US` locale, cela permet d'afficher une boîte de dialogue contextuelle avec un texte semblable à `date: 9/25/2012 4:21PM` en utilisant les options par défaut :
navigator.globalization.dateToString(
new Date(),
- function (date) { alert('date : ' + date.value + '\n'); },
- function () { alert('Une erreur est survenue lors de l\'utilisation de dateToString\n'); },
+ function (date) { alert('date: ' + date.value + '\n'); },
+ function () { alert('Error getting dateString\n'); },
{ formatLength: 'short', selector: 'date and time' }
);
### Windows Phone 8 Quirks
-* Seules les valeurs `short` et `full` sont supportées pour l'option `formatLength`.
+* Le `formatLength` prend en charge uniquement l'option `short` et `full` valeurs.
## navigator.globalization.getCurrencyPattern
-Retourne une chaîne de caractères modèle, utile pour formater et parser des devises, en tenant compte des réglages du client et du code ISO 4217 associé.
+Retourne une chaîne de modèles pour formater et analyser les valeurs de monnaie selon les préférences de l'utilisateur et du code de devise ISO 4217 du client.
navigator.globalization.getCurrencyPattern(currencyCode, successCallback, errorCallback);
### Description
-Transmet le modèle demandé comme paramètre de la fonction `successCallback` sous la forme d'un objet `properties`. Cet objet contient normalement les propriétés suivantes :
+Retourne le modèle de la `successCallback` avec un `properties` objet comme paramètre. Cet objet doit contenir les propriétés suivantes :
-* **pattern** : le modèle permettant de formater et parser des valeurs monétaires. Les modèles suivent [Unicode Technical Standard #35][1]. *(String)*
+* **modèle**: le modèle de la monnaie de formater et d'analyser les valeurs de devise. Les modèles suivent [Unicode Technical Standard #35][1]. *(String)*
-* **code** : le code ISO 4217 de la devise liée au modèle. *(String)*
+* **code**: code de devise de l'ISO 4217 pour le modèle. *(String)*
-* **fraction** : le nombre de chiffres composant la partie décimale à utiliser lors de l'analyse et du formatage de la devise. *(Number)*
+* **fraction**: le nombre de chiffres fractionnaires à utiliser lors de l'analyse et de formatage de devises. *(Nombre)*
-* **rounding** : la valeur de l'incrément d'arrondi à utiliser pour l'analyse et le formatage. *(Number)*
+* **arrondissement**: l'arrondi incrémenter pour utiliser lors de l'analyse et de mise en forme. *(Nombre)*
-* **decimal** : le symbole séparant la partie entière de la partie décimale à utiliser pour l'analyse et la mise en forme. *(String)*
+* **décimal**: le symbole décimal à utiliser pour l'analyse et de mise en forme. *(String)*
-* **grouping** : le symbole séparant les groupes de chiffres à utiliser pour l'analyse et la mise en forme. *(String)*
+* **regroupement**: le symbole de groupe à utiliser pour l'analyse et de mise en forme. *(String)*
[1]: http://unicode.org/reports/tr35/tr35-4.html
-Le paramètre `currencyCode` doit être de type `String` et correspondre à l'un des codes de devise ISO 4217, "USD" par exemple.
+L'entrantes `currencyCode` paramètre doit être un `String` de l'un des codes de devise ISO 4217, par exemple « USD ».
-Si une erreur survient lors de l'obtention du modèle demandé, la fonction `errorCallback` est exécutée et un objet `GlobalizationError` lui est passé en paramètre. Code attendu de l'erreur est`GlobalizationError.FORMATTING\_ERROR`.
+S'il y a une erreur, obtenir le modèle, puis le `errorCallback` s'exécute avec un `GlobalizationError` objet comme paramètre. Code attendu de l'erreur est`GlobalizationError.FORMATTING_ERROR`.
### Plates-formes prises en charge
@@ -129,53 +206,53 @@ Si une erreur survient lors de l'obtention du modèle demandé, la fonction `err
### Exemple
-Si la langue du navigateur est réglée sur `fr_FR` et que la devise sélectionnée est le Dollar américain, cet exemple affiche une fenêtre popup contenant des résultats semblables à ceux qui suivent :
+Lorsque le navigateur est configuré pour la `en_US` locale et la devise sélectionnée est Dollars des États-Unis, cet exemple pour afficher une fenêtre popup avec un texte semblable aux résultats qui suivent :
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('Erreur lors de l\'obtention du modèle\n'); }
+ function () { alert('Error getting pattern\n'); }
);
-Résultats escomptés :
+Résultat escompté :
- pattern : #,##0.00 $
- code : USD
- fraction : 2
- rounding : 0
- decimal : ,
- grouping :
+ pattern: $#,##0.##;($#,##0.##)
+ code: USD
+ fraction: 2
+ rounding: 0
+ decimal: .
+ grouping: ,
## navigator.globalization.getDateNames
-Retourne un tableau contenant les noms des mois ou jours de la semaine, selon le calendrier et les préférences utilisateur du client.
+Retourne un tableau des noms des mois ou jours de la semaine, selon le calendrier et les préférences de l'utilisateur du client.
- navigator.globalization.getDateNames (successCallback, errorCallback, options) ;
+ navigator.globalization.getDateNames(successCallback, errorCallback, options);
### Description
-Transmet le tableau de noms comme paramètre de la fonction `successCallback` sous la forme d'un objet `properties`. Cet objet contient une propriété `value` contenant un tableau (`Array`) dont les valeurs sont des chaînes de caractères (`String`). Ces chaînes de caractères sont classées dans le tableau à partir du premier mois de l'année ou du premier jour de la semaine, selon l'option choisie.
+Retourne le tableau de noms à la `successCallback` avec un `properties` objet comme paramètre. Cet objet contient une `value` propriété avec un `Array` de `String` valeurs. Les noms de fonctionnalités de tableau à partir de soit le premier mois de l'année ou le premier jour de la semaine, selon l'option choisie.
-Si une erreur survient lors de l'obtention des noms, la fonction `errorCallback` est exécutée et un objet `GlobalizationError` lui est passé en paramètre. Le code d'erreur attendu dans ce cas est `GlobalizationError.UNKNOWN_ERROR`.
+S'il y a une erreur d'obtention des noms, puis les `errorCallback` s'exécute avec un `GlobalizationError` objet comme paramètre. Code attendu de l'erreur est`GlobalizationError.UNKNOWN_ERROR`.
Le `options` paramètre est facultatif, et ses valeurs par défaut sont :
- {type: « large », item: « mois »}
+ {type:'wide', item:'months'}
-Les valeurs autorisées pour la propriété `options.type` sont `narrow` et `wide`.
+La valeur de `options.type` peut être `narrow` ou`wide`.
-Les valeurs autorisées pour la propriété `options.item` sont `months` et `days`.
+La valeur de `options.item` peut être `months` ou`days`.
### Plates-formes prises en charge
@@ -186,46 +263,47 @@ Les valeurs autorisées pour la propriété `options.item` sont `months` et `day
### Exemple
-Si la langue du navigateur est réglée sur `fr_FR`, cet exemple affiche une série de douze fenêtres popup, une par mois, avec contenu ressemblant à `mois : janvier`.
+Lorsque le navigateur est configuré pour la `en_US` locale, cet exemple affiche une série de douze fenêtres popup, un par mois, avec un texte semblable à `month: January` :
navigator.globalization.getDateNames(
function (names) {
for (var i = 0; i < names.value.length; i++) {
- alert('mois : ' + names.value[i] + '\n');
+ alert('month: ' + names.value[i] + '\n');
}
},
- function () { alert('Erreur lors de l\'obtention des noms de mois\n'); },
+ function () { alert('Error getting names\n'); },
{ type: 'wide', item: 'months' }
);
## navigator.globalization.getDatePattern
-Retourne une chaîne de caractères modèle, utile pour formater et parser des dates, en tenant compte des préférences utilisateur du client.
+Retourne une chaîne de modèles pour formater et d'analyser les dates selon les préférences de l'utilisateur du client.
navigator.globalization.getDatePattern(successCallback, errorCallback, options);
### Description
-Transmet le modèle demandé à la fonction `successCallback`. Cet objet passé en paramètre contient les propriétés suivantes :
+Retourne le modèle de la `successCallback` . L'objet passé comme paramètre contient les propriétés suivantes :
-* **pattern** : le modèle de date et d'heure permettant de formater et parser des dates. Les modèles suivent [Unicode Technical Standard #35][1]. *(String)*
+* **modèle**: le modèle de date et d'heure pour formater et analyser des dates. Les modèles suivent [Unicode Technical Standard #35][1]. *(String)*
-* **timezone** : le nom abrégé du fuseau horaire du client. *(String)*
+* **fuseau horaire**: l'abréviation du fuseau horaire sur le client. *(String)*
-* **utc_offset** : la différence actuelle en secondes entre le fuseau horaire du client et le Temps universel coordonné. *(Number)*
+* **utc_offset**: la différence actuelle en secondes entre le temps universel coordonné et du fuseau horaire du client. *(Nombre)*
-* **dst_offset** : la différence en secondes entre l'heure d'hiver et l'heure d'été du client. *(Number)*
+* **DST_OFFSET**: l'offset d'heure actuel en secondes entre non-heure le client du fuseau horaire et l'heure du client sauver du fuseau horaire. *(Nombre)*
-Si une erreur survient lors de l'obtention du modèle demandé, la fonction `errorCallback` est exécutée et un objet `GlobalizationError` lui est passé en paramètre. Le code d'erreur attendu dans ce cas est`GlobalizationError.PATTERN_ERROR`.
+S'il y a une erreur, obtenir le modèle, le `errorCallback` s'exécute avec un `GlobalizationError` objet comme paramètre. Code attendu de l'erreur est`GlobalizationError.PATTERN_ERROR`.
-Le paramètre `options` est facultatif, sa valeur par défaut est la suivante :
+Le `options` paramètre est facultatif et par défaut les valeurs suivantes :
{formatLength: « court », sélecteur: « date et heure »}
-Les valeurs autorisées pour la propriété `options.formatLength` sont `short`, `medium`, `long` et `full`. Les valeurs autorisées pour la propriété `options.selector` sont `date`, `time` et `date and time`.
+Le `options.formatLength` peut être `short` , `medium` , `long` , ou `full` . Le `options.selector` peut être `date` , `time` ou`date and
+time`.
### Plates-formes prises en charge
@@ -236,12 +314,12 @@ Les valeurs autorisées pour la propriété `options.formatLength` sont `short`,
### Exemple
-Si la langue du navigateur est réglée sur `fr_FR`, cet exemple affiche une fenêtre popup contenant `pattern : dd/MM/yy HH:mm` :
+Lorsque le navigateur est configuré pour la `en_US` locale, cet exemple pour afficher une fenêtre popup avec texte comme `pattern: M/d/yyyy h:mm a` :
function checkDatePattern() {
navigator.globalization.getDatePattern(
- function (date) { alert('pattern : ' + date.pattern + '\n'); },
- function () { alert('Erreur lors de l\'obtention du modèle\n'); },
+ function (date) { alert('pattern: ' + date.pattern + '\n'); },
+ function () { alert('Error getting pattern\n'); },
{ formatLength: 'short', selector: 'date and time' }
);
}
@@ -249,26 +327,26 @@ Si la langue du navigateur est réglée sur `fr_FR`, cet exemple affiche une fen
### Windows Phone 8 Quirks
-* Seules les valeurs `short` et `full` sont supportés pour l'option `formatLength`.
+* Le `formatLength` prend uniquement en charge `short` et `full` valeurs.
-* La propriété `pattern` d'un modèle `date and time` retourne uniquement le plein format datetime.
+* Le `pattern` pour `date and time` modèle retourne uniquement datetime plein format.
-* La propriété `timezone` d'un modèle retourne le nom complet du fuseau horaire.
+* Le `timezone` retourne le nom de zone à temps plein.
-* La propriété `dst_offset` d'un modèle n'est pas prise en charge et retourne donc toujours zéro.
+* La `dst_offset` propriété n'est pas prise en charge, et toujours retourne zéro.
## navigator.globalization.getFirstDayOfWeek
-Retourne le premier jour de la semaine selon le calendrier et les préférences utilisateur du client.
+Retourne le premier jour de la semaine selon le calendrier et les préférences de l'utilisateur du client.
navigator.globalization.getFirstDayOfWeek(successCallback, errorCallback);
### Description
-Les jours de la semaine sont numérotés à partir de 1, où 1 correspond au dimanche. Le jour demandé est transmis en paramètre à la fonction `successCallback` sous la forme d'un objet `properties`. Cet objet contient une propriété `value` dont la valeur est de type `Number`.
+Les jours de la semaine sont numérotés à partir de 1, où 1 est supposé pour être le dimanche. Retourne le jour de la `successCallback` avec un `properties` objet comme paramètre. Cet objet doit avoir une `value` propriété avec une `Number` valeur.
-S'il y a une erreur, obtenir le modèle, puis le `errorCallback` s'exécute avec un `GlobalizationError` objet comme paramètre. Code attendu de l'erreur est`GlobalizationError.UNKNOWN\_ERROR`.
+S'il y a une erreur, obtenir le modèle, puis le `errorCallback` s'exécute avec un `GlobalizationError` objet comme paramètre. Code attendu de l'erreur est`GlobalizationError.UNKNOWN_ERROR`.
### Plates-formes prises en charge
@@ -279,81 +357,49 @@ S'il y a une erreur, obtenir le modèle, puis le `errorCallback` s'exécute avec
### Exemple
-Si la langue du navigateur est réglée sur `fr_FR`, une fenêtre popup contenant un texte semblable à `day : 2` est affichée.
+Lorsque le navigateur est configuré pour la `en_US` locale, cela permet d'afficher une boîte de dialogue contextuelle avec un texte semblable à`day: 1`.
navigator.globalization.getFirstDayOfWeek(
- function (day) {alert('day : ' + day.value + '\n');},
- function () {alert('Erreur lors de l\'obtention du jour\n');}
- );
-
-
-Retourne l'identifiant correspondant au réglage de langue actuel du client.
-
- navigator.globalization.getLocaleName(successCallback, errorCallback);
-
-
-### Description
-
-Transmet l'identifiant de langue en paramètre à la fonction `successCallback` sous la forme d'un objet `properties`. Cet objet contient une propriété `value` dont la valeur est de type `String`.
-
-Si une erreur survient lors de l'obtention de l'identifiant, la fonction `errorCallback` est exécutée et un objet `GlobalizationError` lui est passé en paramètre. Code attendu de l'erreur est`GlobalizationError.UNKNOWN\_ERROR`.
-
-### Plates-formes prises en charge
-
-* Amazon Fire OS
-* Android
-* iOS
-* Windows Phone 8
-
-### Exemple
-
-Si la langue du navigateur est réglée sur `fr_FR`, une fenêtre popup contenant le texte `locale : fr_FR` est affichée.
-
- navigator.globalization.getLocaleName(
- function (locale) {alert('locale : ' + locale.value + '\n');},
- function () {alert('Erreur lors de l\'obtention de l\'identifiant de langue\n');}
+ function (day) {alert('day: ' + day.value + '\n');},
+ function () {alert('Error getting day\n');}
);
-### Windows Phone 8 Quirks
-
-* Renvoie le code à deux lettres ISO 3166 correspondant au pays ou la région actuel(le).
-
## navigator.globalization.getNumberPattern
-Retourne une chaîne de caractères modèle, utile pour formater et parser des nombres, en tenant compte des préférences utilisateur du client.
+Retourne une chaîne de modèles pour formater et d'analyser les chiffres selon les préférences de l'utilisateur du client.
navigator.globalization.getNumberPattern(successCallback, errorCallback, options);
### Description
-Transmet le modèle demandé en paramètre à la fonction `successCallback` sous la forme d'un objet `properties`. Cet objet contient les propriétés suivantes :
+Retourne le modèle de la `successCallback` avec un `properties` objet comme paramètre. Cet objet contient les propriétés suivantes :
-* **pattern** : le modèle permettant de formater et parser des nombres. Les modèles suivent [Unicode Technical Standard #35][1]. *(String)*
+* **modèle**: le modèle de numéro de formater et d'analyser les chiffres. Les modèles suivent [Unicode Technical Standard #35][1]. *(String)*
-* **symbol** : le symbole à utiliser lors de la mise en forme et l'analyse, par exemple le symbole de pourcentage ou un symbole monétaire. *(String)*
+* **symbole**: le symbole à utiliser lors de la mise en forme et l'analyse, comme un symbole de pourcentage ou de la monnaie. *(String)*
-* **fraction** : le nombre de chiffres composant la partie décimale à utiliser lors de l'analyse et du formatage de nombres. *(Number)*
+* **fraction**: le nombre de chiffres fractionnaires à utiliser lors de l'analyse et de mise en forme des nombres. *(Nombre)*
* **arrondissement**: l'arrondi incrémenter pour utiliser lors de l'analyse et de mise en forme. *(Nombre)*
-* **positive** : le symbole à utiliser lors de l'analyse et du formatage des nombres positifs. *(String)*
+* **positif**: le symbole à utiliser pour les nombres positifs lors de l'analyse et de mise en forme. *(String)*
-* **negative** : le symbole à utiliser lors de l'analyse et du formatage des nombres négatifs. *(String)*
+* **négatif**: le symbole à utiliser pour les nombres négatifs lors de l'analyse et de mise en forme. *(String)*
* **décimal**: le symbole décimal à utiliser pour l'analyse et de mise en forme. *(String)*
* **regroupement**: le symbole de groupe à utiliser pour l'analyse et de mise en forme. *(String)*
-S'il y a une erreur, obtenir le modèle, puis le `errorCallback` s'exécute avec un `GlobalizationError` objet comme paramètre. Code attendu de l'erreur est`GlobalizationError.PATTERN\_ERROR`.
+S'il y a une erreur, obtenir le modèle, puis le `errorCallback` s'exécute avec un `GlobalizationError` objet comme paramètre. Code attendu de l'erreur est`GlobalizationError.PATTERN_ERROR`.
-Le paramètre `options` est facultatif, sa valeur par défaut est :
+Le `options` paramètre est facultatif, et les valeurs par défaut sont :
{type: « decimal »}
-Les valeurs autorisées pour la propriété `options.type` sont `decimal`, `percent` et `currency`.
+Le `options.type` peut être `decimal` , `percent` , ou`currency`.
### Plates-formes prises en charge
@@ -364,18 +410,18 @@ Les valeurs autorisées pour la propriété `options.type` sont `decimal`, `perc
### Exemple
-Si la langue du navigateur est réglée sur `fr_FR`, cet exemple affiche une fenêtre popup contenant des résultats semblables à ceux qui suivent :
+Lorsque le navigateur est configuré pour la `en_US` locale, cela doit afficher une boîte de dialogue contextuelle avec un texte semblable aux résultats qui suivent :
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('Erreur lors de l\'obtention du modèle\n');},
+ 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'}
);
@@ -383,54 +429,20 @@ Si la langue du navigateur est réglée sur `fr_FR`, cet exemple affiche une fen
Résultats :
pattern: #,##0.###
- symbol:
+ symbol: .
fraction: 0
rounding: 0
- positive: +
+ positive:
negative: -
- decimal: ,
- grouping:
+ decimal: .
+ grouping: ,
### Windows Phone 8 Quirks
-* La propriété `pattern` n'est pas prise en charge et retourne une chaîne vide.
-
-* La propriété `fraction` n'est pas prise en charge et retourne zéro.
-
-## navigator.globalization.getPreferredLanguage
-
-Retourne l'identifiant correspondant à la langue actuelle du client.
-
- navigator.globalization.getPreferredLanguage(successCallback, errorCallback);
-
-
-### Description
-
-Transmet l'identifiant de langue en paramètre à la fonction `successCallback` sous la forme d'un objet `properties`. Cet objet doit avoir une `value` propriété avec une `String` valeur.
-
-Si une erreur survient lors de l'obtention de l'identifiant, la fonction `errorCallback` est exécutée et un objet `GlobalizationError` lui est passé en paramètre. Code attendu de l'erreur est`GlobalizationError.UNKNOWN\_ERROR`.
-
-### Plates-formes prises en charge
-
-* Amazon Fire OS
-* Android
-* iOS
-* Windows Phone 8
-
-### Exemple
-
-Si la langue du navigateur est réglée sur `fr_FR`, une fenêtre popup contenant le texte `language : fr` est affichée :
-
- navigator.globalization.getPreferredLanguage(
- function (language) {alert('language : ' + language.value + '\n');},
- function () {alert('Erreur lors de l\'obtention de l\'identifiant du langage\n');}
- );
-
-
-### Windows Phone 8 Quirks
+* La `pattern` propriété n'est pas prise en charge et retuens une chaîne vide.
-* Retourne le code à deux lettres ISO 639-1 pour la langue actuelle.
+* La `fraction` propriété n'est pas prise en charge et retourne zéro.
## navigator.globalization.isDayLightSavingsTime
@@ -445,7 +457,7 @@ Indique si l'heure d'été est en vigueur ou non en transmettant un objet `prope
Le paramètre obligatoire `date` doit être de type `Date`.
-Si une erreur survient lors de la lecture de la date, la fonction `errorCallback` est exécutée. Le code d'erreur attendu dans ce cas est`GlobalizationError.UNKNOWN_ERROR`.
+S'il y a une erreur de lecture de la date, puis le `errorCallback` s'exécute. Code attendu de l'erreur est`GlobalizationError.UNKNOWN_ERROR`.
### Plates-formes prises en charge
@@ -476,7 +488,7 @@ Renvoie un nombre formaté dans une chaîne de caractères en tenant compte des
Transmet le nombre formaté en paramètre à la fonction `successCallback` sous la forme d'un objet `properties`. Cet objet doit avoir une `value` propriété avec une `String` valeur.
-Si une erreur survient lors du formatage du nombre, la fonction `errorCallback` est exécutée et un objet `GlobalizationError` lui est passé en paramètre. Code attendu de l'erreur est`GlobalizationError.FORMATTING\_ERROR`.
+Si une erreur survient lors du formatage du nombre, la fonction `errorCallback` est exécutée et un objet `GlobalizationError` lui est passé en paramètre. Code attendu de l'erreur est`GlobalizationError.FORMATTING_ERROR`.
Le `options` paramètre est facultatif, et ses valeurs par défaut sont :
@@ -494,7 +506,7 @@ Le `options.type` peut être « decimal », « % » ou « monnaie ».
### Exemple
-Si la langue du navigateur est réglée sur `fr_FR`, une fenêtre popup contenant `number : 3,142` est affichée :
+Lorsque le navigateur est configuré pour la `en_US` locale, cela permet d'afficher une boîte de dialogue contextuelle avec un texte semblable à `number: 3.142` :
navigator.globalization.numberToString(
3.1415926,
@@ -515,19 +527,19 @@ Retourne un objet date construit à partir d'une date contenue dans une chaîne
Transmet la date demandée en paramètre à la fonction successCallback sous la forme d'un objet `properties`. Cet objet contient les propriétés suivantes :
-* **year** : le nombre à quatre chiffres représentant l'année. *(Number)*
+* **année**: l'année à quatre chiffres. *(Nombre)*
-* **month** : le numéro du mois compris entre 0 et 11. *(Number)*
+* **mois**: le mois de (0-11). *(Nombre)*
-* **day** : le numéro du jour compris entre 1 et 31. *(Number)*
+* **jour**: le jour de (1-31). *(Nombre)*
-* **hour** : l'heure comprise entre 0 et 23. *(Number)*
+* **heure**: l'heure du (0-23). *(Nombre)*
-* **minute** : le nombre de minutes compris entre 0 et 59. *(Number)*
+* **minute**: la minute (0-59). *(Nombre)*
-* **second** : le nombre de secondes compris entre 0 et 59. *(Number)*
+* **deuxième**: la seconde de (0 à 59). *(Nombre)*
-* **millisecond** : le nombre de millisecondes compris entre 0 et 999, pas disponible pour toutes les plates-formes. *(Number)*
+* **milliseconde**: les millisecondes (entre 0 et 999), non disponibles sur toutes les plateformes. *(Nombre)*
Le paramètre `dateString` doit être de type `String`.
@@ -539,7 +551,7 @@ Le paramètre `options` est facultatif, sa valeur par défaut est :
Le `options.formatLength` peut être `short` , `medium` , `long` , ou `full` . Le `options.selector` peut être `date` , `time` ou`date and
time`.
-Si une erreur survient lors de l'analyse de la chaîne de caractères, la fonction `errorCallback` est exécutée et un objet `GlobalizationError` lui est passé en paramètre. Le code d'erreur prévu dans ce cas est `GlobalizationError.PARSING_ERROR`.
+Si une erreur survient lors de l'analyse de la chaîne de caractères, la fonction `errorCallback` est exécutée et un objet `GlobalizationError` lui est passé en paramètre. Code attendu de l'erreur est`GlobalizationError.PARSING_ERROR`.
### Plates-formes prises en charge
@@ -550,7 +562,7 @@ Si une erreur survient lors de l'analyse de la chaîne de caractères, la foncti
### Exemple
-Si la langue du navigateur est réglée sur `fr_FR`, une fenêtre popup contenant `month : 8, day : 25, year : 2012` est affichée. Notez que l'entier faisant référence au numéro du mois est différent de celui présent dans la chaîne parsée, ceci car il représente un index de tableau.
+Lorsque le navigateur est configuré pour la `en_US` locale, cela permet d'afficher une boîte de dialogue contextuelle avec un texte semblable à `month:8 day:25 year:2012` . Notez que l'entier faisant référence au numéro du mois est différent de celui présent dans la chaîne parsée, ceci car il représente un index de tableau.
navigator.globalization.stringToDate(
'25/09/2012',
@@ -577,7 +589,7 @@ Retourne un nombre à partir d'une chaîne de caractères contenant un nombre fo
Transmet le nombre demandé en paramètre à la fonction `successCallback` sous la forme d'un objet `properties`. Cet objet contient une propriété `value` dont la valeur est de type `Number`.
-Si une erreur survient lors de l'analyse de la chaîne de caractères, la fonction `errorCallback` est exécutée et un objet `GlobalizationError` lui est passé en paramètre. Le code d'erreur prévu dans ce cas est `GlobalizationError.PARSING_ERROR`.
+Si une erreur survient lors de l'analyse de la chaîne de caractères, la fonction `errorCallback` est exécutée et un objet `GlobalizationError` lui est passé en paramètre. Code attendu de l'erreur est`GlobalizationError.PARSING_ERROR`.
Le `options` paramètre est facultatif et par défaut les valeurs suivantes :
@@ -595,7 +607,7 @@ Le `options.type` peut être `decimal` , `percent` , ou`currency`.
### Exemple
-Si la langue du navigateur est réglée sur `fr_FR`, une fenêtre popup contenant `number : 1234.56` est affichée :
+Lorsque le navigateur est configuré pour la `en_US` locale, cela doit afficher une boîte de dialogue contextuelle avec un texte semblable à `number: 1234.56` :
navigator.globalization.stringToNumber(
'1234,56',
@@ -611,12 +623,12 @@ Un objet représentant une erreur de l'API Globalization.
### Propriétés
-* **code** : un des codes suivants décrivant le type d'erreur rencontrée *(Number)*
- * GlobalizationError.UNKNOWN_ERROR : 0
- * GlobalizationError.FORMATTING_ERROR : 1
- * GlobalizationError.PARSING_ERROR : 2
- * GlobalizationError.PATTERN_ERROR : 3
-* **message** : un message texte comprenant l'explication de l'erreur et/ou des détails à son sujet. *(String)*
+* **code**: Un des codes suivants qui représente le type d'erreur *(Nombre)*
+ * GlobalizationError.UNKNOWN_ERROR: 0
+ * GlobalizationError.FORMATTING_ERROR: 1
+ * GlobalizationError.PARSING_ERROR: 2
+ * GlobalizationError.PATTERN_ERROR: 3
+* **message**: un message texte qui comprend l'explication de l'erreur et/ou de détails *(String)*
### Description
http://git-wip-us.apache.org/repos/asf/cordova-plugin-globalization/blob/cb3d6d0d/doc/it/index.md
----------------------------------------------------------------------
diff --git a/doc/it/index.md b/doc/it/index.md
new file mode 100644
index 0000000..737e05a
--- /dev/null
+++ b/doc/it/index.md
@@ -0,0 +1,650 @@
+<!---
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+# org.apache.cordova.globalization
+
+Questo plugin ottiene informazioni ed esegue operazioni specifiche impostazioni locali dell'utente, lingua e fuso orario. Si noti la differenza tra lingua e impostazioni internazionali: controlli delle impostazioni internazionali, numeri, date e tempi di visualizzazione per una regione, mentre la lingua determina quale testo di lingua appare come, indipendentemente dalle impostazioni locali. Spesso gli sviluppatori utilizzano impostazioni locali per impostare entrambe le impostazioni, ma non non c'è alcun motivo per che un utente non poteva impostare la lingua "Inglese" ma locale alla "Francese", così che il testo viene visualizzato in inglese ma le date, tempi, ecc., vengono visualizzati come sono in Francia. Purtroppo, piattaforme mobili più attualmente non fanno una distinzione tra queste impostazioni.
+
+## Installazione
+
+ cordova plugin add org.apache.cordova.globalization
+
+
+## Oggetti
+
+* GlobalizationError
+
+## Metodi
+
+* navigator.globalization.getPreferredLanguage
+* navigator.globalization.getLocaleName
+* navigator.globalization.dateToString
+* navigator.globalization.stringToDate
+* navigator.globalization.getDatePattern
+* navigator.globalization.getDateNames
+* navigator.globalization.isDayLightSavingsTime
+* navigator.globalization.getFirstDayOfWeek
+* navigator.globalization.numberToString
+* navigator.globalization.stringToNumber
+* navigator.globalization.getNumberPattern
+* navigator.globalization.getCurrencyPattern
+
+## navigator.globalization.getPreferredLanguage
+
+Ottenere il tag di lingua BCP 47 per la lingua corrente del client.
+
+ navigator.globalization.getPreferredLanguage(successCallback, errorCallback);
+
+
+### Descrizione
+
+Restituisce l'etichetta di identificatore di linguaggio compatibile con BCP-47 per il `successCallback` con un `properties` oggetto come parametro. Tale oggetto dovrebbe avere una `value` proprietà con un `String` valore.
+
+Se c'è un errore nell'acquisizione della lingua, poi la `errorCallback` viene eseguita con un `GlobalizationError` oggetto come parametro. Previsto codice dell'errore è`GlobalizationError.UNKNOWN_ERROR`.
+
+### Piattaforme supportate
+
+* Amazon fuoco OS
+* Android
+* iOS
+* Windows Phone 8
+
+### Esempio
+
+Quando il browser è impostato per la `en-US` lingua, questo dovrebbe visualizzare una finestra di dialogo pop-up con il testo `language: en-US` :
+
+ navigator.globalization.getPreferredLanguage(
+ function (language) {alert('language: ' + language.value + '\n');},
+ function () {alert('Error getting language\n');}
+ );
+
+
+### Stranezze Android
+
+* Restituisce il codice di due lettere della lingua 639-1 ISO, maiuscolo ISO 3166-1 prefisso e variante separati da trattini. Esempi: "en", "en-US", "US"
+
+### Windows Phone 8 stranezze
+
+* Codice restituisce l'ISO 639-1 due lettere della lingua e il codice ISO 3166-1 paese della variante regionale corrispondente alla "Lingua" impostazione, separati da un trattino.
+* Si noti che la variante regionale è una proprietà di impostazione "Language" e non determinato dall'impostazione del "Paese" indipendente su Windows Phone.
+
+## navigator.globalization.getLocaleName
+
+Restituisce il tag compatibile con BCP 47 per impostazione locale corrente del client.
+
+ navigator.globalization.getLocaleName(successCallback, errorCallback);
+
+
+### Descrizione
+
+Restituisce la stringa dell'identificatore locale conforme BCP 47 per il `successCallback` con un `properties` oggetto come parametro. Tale oggetto dovrebbe avere una `value` proprietà con un `String` valore. L'etichetta locale sarà costituito da un codice di due lettere minuscole lingua, codice paese di due lettere maiuscole e codice variante (non specificato), separati da un trattino.
+
+Se c'è un errore di ottenere le impostazioni locali, poi il `errorCallback` viene eseguito con un `GlobalizationError` oggetto come parametro. Previsto codice dell'errore è`GlobalizationError.UNKNOWN_ERROR`.
+
+### Piattaforme supportate
+
+* Amazon fuoco OS
+* Android
+* iOS
+* Windows Phone 8
+
+### Esempio
+
+Quando il browser è impostato per la `en-US` locale, questa viene visualizzata una finestra popup con il testo`locale: en-US`.
+
+ navigator.globalization.getLocaleName(
+ function (locale) {alert('locale: ' + locale.value + '\n');},
+ function () {alert('Error getting locale\n');}
+ );
+
+
+### Stranezze Android
+
+* Java non fa distinzione tra un set "lingua" e impostare "impostazioni", quindi questo metodo è essenzialmente lo stesso`navigator.globalizatin.getPreferredLanguage()`.
+
+### Windows Phone 8 stranezze
+
+* Codice restituisce l'ISO 639-1 due lettere della lingua e il codice ISO 3166-1 paese della variante regionale corrispondente all'impostazione "Formato regionale", separato da un trattino.
+
+## navigator.globalization.dateToString
+
+Restituisce una data formattata come stringa secondo le impostazioni locali del client e fuso orario.
+
+ navigator.globalization.dateToString(date, successCallback, errorCallback, options);
+
+
+### Descrizione
+
+Restituisce la data formattata `String` tramite un `value` proprietà accessibile dall'oggetto passato come parametro per la`successCallback`.
+
+L'ingresso `date` parametro dovrebbe essere di tipo`Date`.
+
+Se c'è un errore di formattazione della data, allora il `errorCallback` viene eseguito con un `GlobalizationError` oggetto come parametro. Previsto codice dell'errore è`GlobalizationError.FORMATTING_ERROR`.
+
+Il `options` parametro è facoltativo e valori predefiniti sono:
+
+ {formatLength: 'breve', selettore: 'data e ora'}
+
+
+Il `options.formatLength` può essere `short` , `medium` , `long` , o`full`.
+
+Il `options.selector` può essere `date` , `time` o`date and time`.
+
+### Piattaforme supportate
+
+* Amazon fuoco OS
+* Android
+* iOS
+* Windows Phone 8
+
+### Esempio
+
+Se il browser è impostato per la `en_US` locale, questa viene visualizzata una finestra di popup con testo simile a `date: 9/25/2012 4:21PM` utilizzando le opzioni di default:
+
+ navigator.globalization.dateToString(
+ new Date(),
+ function (date) { alert('date: ' + date.value + '\n'); },
+ function () { alert('Error getting dateString\n'); },
+ { formatLength: 'short', selector: 'date and time' }
+ );
+
+
+### Windows Phone 8 stranezze
+
+* Il `formatLength` opzione supporta solo `short` e `full` i valori.
+
+## navigator.globalization.getCurrencyPattern
+
+Restituisce una stringa per formattare e analizzare i valori di valuta secondo le preferenze dell'utente e il codice ISO 4217 del client.
+
+ navigator.globalization.getCurrencyPattern(currencyCode, successCallback, errorCallback);
+
+
+### Descrizione
+
+Restituisce il modello per la `successCallback` con un `properties` oggetto come parametro. Tale oggetto deve contenere le seguenti proprietà:
+
+* **modello**: il modello valuta per formattare e analizzare i valori di valuta. I modelli seguono [Unicode Technical Standard #35][1]. *(String)*
+
+* **codice**: codice per il modello The ISO 4217. *(String)*
+
+* **frazione**: il numero di cifre da utilizzare durante l'analisi e la formattazione valuta. *(Numero)*
+
+* **arrotondamento**: l'arrotondamento incrementare per utilizzare quando l'analisi e la formattazione. *(Numero)*
+
+* **decimale**: il simbolo decimale da utilizzare per l'analisi e la formattazione. *(String)*
+
+* **raggruppamenti**: il raggruppamento simbolo da utilizzare per l'analisi e la formattazione. *(String)*
+
+ [1]: http://unicode.org/reports/tr35/tr35-4.html
+
+L'ingresso `currencyCode` parametro dovrebbe essere un `String` di uno dei codici valuta ISO 4217, ad esempio 'USD'.
+
+Se c'è un errore, ottenendo il pattern, allora il `errorCallback` viene eseguito con un `GlobalizationError` oggetto come parametro. Previsto codice dell'errore è`GlobalizationError.FORMATTING_ERROR`.
+
+### Piattaforme supportate
+
+* Amazon fuoco OS
+* Android
+* iOS
+
+### Esempio
+
+Quando il browser è impostato per la `en_US` locale e la valuta selezionata è dollari degli Stati Uniti, in questo esempio viene visualizzata una finestra di popup con testo simile ai risultati che seguono:
+
+ 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'); }
+ );
+
+
+Risultato atteso:
+
+ pattern: $#,##0.##;($#,##0.##)
+ code: USD
+ fraction: 2
+ rounding: 0
+ decimal: .
+ grouping: ,
+
+
+## navigator.globalization.getDateNames
+
+Restituisce una matrice di nomi di mesi o giorni della settimana, a seconda delle preferenze dell'utente del client e calendario.
+
+ navigator.globalization.getDateNames(successCallback, errorCallback, options);
+
+
+### Descrizione
+
+Restituisce la matrice di nomi per la `successCallback` con un `properties` oggetto come parametro. Tale oggetto contiene un `value` proprietà con un `Array` di `String` i valori. I nomi di funzioni matrice a partire da entrambi il primo mese dell'anno o il primo giorno della settimana, a seconda dell'opzione selezionata.
+
+Se c'è un errore ottenendo i nomi, poi il `errorCallback` viene eseguito con un `GlobalizationError` oggetto come parametro. Previsto codice dell'errore è`GlobalizationError.UNKNOWN_ERROR`.
+
+Il `options` parametro è facoltativo e valori predefiniti sono:
+
+ {type:'wide', item:'months'}
+
+
+Il valore di `options.type` può essere `narrow` o`wide`.
+
+Il valore di `options.item` può essere `months` o`days`.
+
+### Piattaforme supportate
+
+* Amazon fuoco OS
+* Android
+* iOS
+* Windows Phone 8
+
+### Esempio
+
+Quando il browser è impostato per la `en_US` locale, in questo esempio viene visualizzata una serie di dodici finestre pop-up, uno al mese, con un testo simile a `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' }
+ );
+
+
+## navigator.globalization.getDatePattern
+
+Restituisce una stringa per formattare e analizzare i dati secondo le preferenze dell'utente del client.
+
+ navigator.globalization.getDatePattern(successCallback, errorCallback, options);
+
+
+### Descrizione
+
+Restituisce il modello per la `successCallback` . L'oggetto passato come parametro contiene le seguenti proprietà:
+
+* **modello**: il modello di data e ora per formattare e analizzare i dati. I modelli seguono [Unicode Technical Standard #35][1]. *(String)*
+
+* **fuso orario**: il nome abbreviato del fuso orario sul client. *(String)*
+
+* **utc_offset**: l'attuale differenza in secondi tra del client fuso orario e tempo universale coordinato. *(Numero)*
+
+* **DST_OFFSET**: l'offset corrente ora legale in secondi tra non-legale del client di fuso orario e ora legale del cliente risparmio di fuso orario. *(Numero)*
+
+Se c'è un errore per ottenere il modello, il `errorCallback` viene eseguito con un `GlobalizationError` oggetto come parametro. Previsto codice dell'errore è`GlobalizationError.PATTERN_ERROR`.
+
+Il `options` parametro è facoltativo e verrà impostato i seguenti valori:
+
+ {formatLength: 'breve', selettore: 'data e ora'}
+
+
+Il `options.formatLength` può essere `short` , `medium` , `long` , o `full` . Il `options.selector` può essere `date` , `time` o`date and
+time`.
+
+### Piattaforme supportate
+
+* Amazon fuoco OS
+* Android
+* iOS
+* Windows Phone 8
+
+### Esempio
+
+Quando il browser è impostato per la `en_US` locale, in questo esempio viene visualizzata una finestra di popup con il testo come `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' }
+ );
+ }
+
+
+### Windows Phone 8 stranezze
+
+* Il `formatLength` supporta solo `short` e `full` i valori.
+
+* La `pattern` per `date and time` modello restituisce solo il formato datetime completo.
+
+* Il `timezone` restituisce il nome della zona a tempo pieno.
+
+* La `dst_offset` proprietà non è supportata, e sempre restituisce zero.
+
+## navigator.globalization.getFirstDayOfWeek
+
+Restituisce il primo giorno della settimana secondo le preferenze dell'utente del client e calendario.
+
+ navigator.globalization.getFirstDayOfWeek(successCallback, errorCallback);
+
+
+### Descrizione
+
+I giorni della settimana sono numerati a partire da 1, dove 1 è presupposto per essere domenica. Restituisce il giorno per la `successCallback` con un `properties` oggetto come parametro. Tale oggetto dovrebbe avere una `value` proprietà con un `Number` valore.
+
+Se c'è un errore, ottenendo il pattern, allora il `errorCallback` viene eseguito con un `GlobalizationError` oggetto come parametro. Previsto codice dell'errore è`GlobalizationError.UNKNOWN_ERROR`.
+
+### Piattaforme supportate
+
+* Amazon fuoco OS
+* Android
+* iOS
+* Windows Phone 8
+
+### Esempio
+
+Quando il browser è impostato per la `en_US` locale, questa viene visualizzata una finestra di popup con testo simile a`day: 1`.
+
+ navigator.globalization.getFirstDayOfWeek(
+ function (day) {alert('day: ' + day.value + '\n');},
+ function () {alert('Error getting day\n');}
+ );
+
+
+## navigator.globalization.getNumberPattern
+
+Restituisce una stringa per formattare e analizzare i numeri secondo le preferenze dell'utente del client.
+
+ navigator.globalization.getNumberPattern(successCallback, errorCallback, options);
+
+
+### Descrizione
+
+Restituisce il modello per la `successCallback` con un `properties` oggetto come parametro. Tale oggetto contiene le seguenti proprietà:
+
+* **modello**: il modello del numero per formattare e analizzare i numeri. I modelli seguono [Unicode Technical Standard #35][1]. *(String)*
+
+* **simbolo**: il simbolo da utilizzare durante la formattazione e l'analisi, come un simbolo di percentuale o valuta. *(String)*
+
+* **frazione**: il numero di cifre da utilizzare durante l'analisi e la formattazione dei numeri. *(Numero)*
+
+* **arrotondamento**: l'arrotondamento incrementare per utilizzare quando l'analisi e la formattazione. *(Numero)*
+
+* **positivo**: il simbolo da utilizzare per i numeri positivi quando l'analisi e la formattazione. *(String)*
+
+* **negativo**: il simbolo da utilizzare per i numeri negativi quando l'analisi e la formattazione. *(String)*
+
+* **decimale**: il simbolo decimale da utilizzare per l'analisi e la formattazione. *(String)*
+
+* **raggruppamenti**: il raggruppamento simbolo da utilizzare per l'analisi e la formattazione. *(String)*
+
+Se c'è un errore, ottenendo il pattern, allora il `errorCallback` viene eseguito con un `GlobalizationError` oggetto come parametro. Previsto codice dell'errore è`GlobalizationError.PATTERN_ERROR`.
+
+Il `options` parametro è facoltativo e i valori predefiniti sono:
+
+ {tipo: 'decimale'}
+
+
+Il `options.type` può essere `decimal` , `percent` , o`currency`.
+
+### Piattaforme supportate
+
+* Amazon fuoco OS
+* Android
+* iOS
+* Windows Phone 8
+
+### Esempio
+
+Quando il browser è impostato per la `en_US` locale, questo dovrebbe visualizzare una finestra di popup con testo simile ai risultati che seguono:
+
+ 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'}
+ );
+
+
+Risultati:
+
+ pattern: #,##0.###
+ symbol: .
+ fraction: 0
+ rounding: 0
+ positive:
+ negative: -
+ decimal: .
+ grouping: ,
+
+
+### Windows Phone 8 stranezze
+
+* La `pattern` proprietà non è supportata e retuens una stringa vuota.
+
+* La `fraction` proprietà non è supportata e restituisce zero.
+
+## navigator.globalization.isDayLightSavingsTime
+
+Indica se l'ora legale è in vigore per una data specifica utilizzando del client fuso orario e calendario.
+
+ navigator.globalization.isDayLightSavingsTime(date, successCallback, errorCallback);
+
+
+### Descrizione
+
+Indica se è o meno dell'ora legale in vigore alla `successCallback` con un `properties` oggetto come parametro. Tale oggetto dovrebbe avere una `dst` proprietà con un `Boolean` valore. A `true` il valore indica che l'ora legale è in vigore per la data specificata, e `false` indica che non è.
+
+Il parametro in ingresso `date` dovrebbe essere di tipo`Date`.
+
+Se c'è un errore di lettura della data, allora il `errorCallback` esegue. Previsto codice dell'errore è`GlobalizationError.UNKNOWN_ERROR`.
+
+### Piattaforme supportate
+
+* Amazon fuoco OS
+* Android
+* iOS
+* Windows Phone 8
+
+### Esempio
+
+Durante l'estate, e se il browser è impostato su un fuso orario abilitato DST, questo dovrebbe visualizzare una finestra di popup con testo simile a `dst: true` :
+
+ navigator.globalization.isDayLightSavingsTime(
+ new Date(),
+ function (date) {alert('dst: ' + date.dst + '\n');},
+ function () {alert('Error getting names\n');}
+ );
+
+
+## navigator.globalization.numberToString
+
+Restituisce un numero formattato come una stringa secondo le preferenze dell'utente del client.
+
+ navigator.globalization.numberToString(number, successCallback, errorCallback, options);
+
+
+### Descrizione
+
+Restituisce la stringa formattata numero per la `successCallback` con un `properties` oggetto come parametro. Tale oggetto dovrebbe avere una `value` proprietà con un `String` valore.
+
+Se c'è un errore di formattazione del numero, poi il `errorCallback` viene eseguito con un `GlobalizationError` oggetto come parametro. Previsto codice dell'errore è`GlobalizationError.FORMATTING_ERROR`.
+
+Il `options` parametro è facoltativo e valori predefiniti sono:
+
+ {tipo: 'decimale'}
+
+
+Il `options.type` può essere 'decimale', '%' o 'valuta'.
+
+### Piattaforme supportate
+
+* Amazon fuoco OS
+* Android
+* iOS
+* Windows Phone 8
+
+### Esempio
+
+Quando il browser è impostato per la `en_US` locale, questa viene visualizzata una finestra di popup con testo simile a `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
+
+Analizza una data formattata come stringa, secondo le preferenze dell'utente e calendario utilizzando il fuso orario del cliente, il cliente e restituisce l'oggetto data corrispondente.
+
+ navigator.globalization.stringToDate(dateString, successCallback, errorCallback, options);
+
+
+### Descrizione
+
+Restituisce la data al metodo di callback con successo un `properties` oggetto come parametro. Tale oggetto dovrebbe avere le seguenti proprietà:
+
+* **anno**: l'anno a quattro cifre. *(Numero)*
+
+* **mese**: mese da (0-11). *(Numero)*
+
+* **giorno**: il giorno da (1-31). *(Numero)*
+
+* **ora**: l'ora (0-23). *(Numero)*
+
+* **minuti**: il minuto da (0-59). *(Numero)*
+
+* **secondo**: il secondo da (0-59). *(Numero)*
+
+* **millisecondo**: I millisecondi (da 0-999), non disponibili su tutte le piattaforme. *(Numero)*
+
+L'ingresso `dateString` parametro dovrebbe essere di tipo`String`.
+
+Il `options` parametro è facoltativo e verrà impostato i seguenti valori:
+
+ {formatLength: 'breve', selettore: 'data e ora'}
+
+
+Il `options.formatLength` può essere `short` , `medium` , `long` , o `full` . Il `options.selector` può essere `date` , `time` o`date and
+time`.
+
+Se c'è un errore di parsing della stringa data, allora il `errorCallback` viene eseguito con un `GlobalizationError` oggetto come parametro. Previsto codice dell'errore è`GlobalizationError.PARSING_ERROR`.
+
+### Piattaforme supportate
+
+* Amazon fuoco OS
+* Android
+* iOS
+* Windows Phone 8
+
+### Esempio
+
+Quando il browser è impostato per la `en_US` locale, questa viene visualizzata una finestra di popup con testo simile a `month:8 day:25 year:2012` . Si noti che il mese intero è uno minore di stringa, come l'intero mese rappresenta un indice di matrice.
+
+ 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'}
+ );
+
+
+### Windows Phone 8 stranezze
+
+* Il `formatLength` opzione supporta solo `short` e `full` i valori.
+
+## navigator.globalization.stringToNumber
+
+Analizza un numero formattato come una stringa secondo le preferenze dell'utente del client e restituisce il numero corrispondente.
+
+ navigator.globalization.stringToNumber(string, successCallback, errorCallback, options);
+
+
+### Descrizione
+
+Restituisce il numero per il `successCallback` con un `properties` oggetto come parametro. Tale oggetto dovrebbe avere una `value` proprietà con un `Number` valore.
+
+Se c'è un errore di parsing della stringa di numeri, poi il `errorCallback` viene eseguito con un `GlobalizationError` oggetto come parametro. Previsto codice dell'errore è`GlobalizationError.PARSING_ERROR`.
+
+Il `options` parametro è facoltativo e verrà impostato i seguenti valori:
+
+ {tipo: 'decimale'}
+
+
+Il `options.type` può essere `decimal` , `percent` , o`currency`.
+
+### Piattaforme supportate
+
+* Amazon fuoco OS
+* Android
+* iOS
+* Windows Phone 8
+
+### Esempio
+
+Quando il browser è impostato per la `en_US` locale, questo dovrebbe visualizzare una finestra di popup con testo simile a `number: 1234.56` :
+
+ navigator.globalization.stringToNumber(
+ '1234.56',
+ function (number) {alert('number: ' + number.value + '\n');},
+ function () {alert('Error getting number\n');},
+ {type:'decimal'}
+ );
+
+
+## GlobalizationError
+
+Un oggetto che rappresenta un errore dall'API di globalizzazione.
+
+### Proprietà
+
+* **codice**: Uno dei seguenti codici che rappresenta il tipo di errore *(Numero)*
+ * GlobalizationError.UNKNOWN_ERROR: 0
+ * GlobalizationError.FORMATTING_ERROR: 1
+ * GlobalizationError.PARSING_ERROR: 2
+ * GlobalizationError.PATTERN_ERROR: 3
+* **messaggio**: un messaggio di testo che include la spiegazione dell'errore e/o dettagli *(String)*
+
+### Descrizione
+
+Questo oggetto è creato e popolato da Cordova e restituito una richiamata in caso di errore.
+
+### Piattaforme supportate
+
+* Amazon fuoco OS
+* Android
+* iOS
+
+### Esempio
+
+Quando si esegue il callback di errore seguenti, esso viene visualizzata una finestra popup con il testo simile a `code: 3` e`message:`
+
+ function errorCallback(error) {
+ alert('code: ' + error.code + '\n' +
+ 'message: ' + error.message + '\n');
+ };
\ No newline at end of file