Córdoba - Globalización

Este complemento se utiliza para obtener información sobre el idioma local de los usuarios, la fecha y la zona horaria, la moneda, etc.

Paso 1: instalación del complemento de globalización

Abierto command prompt e instale el complemento escribiendo el siguiente código

C:\Users\username\Desktop\CordovaProject>cordova plugin add cordova-plugin-globalization

Paso 2: agregar botones

Agregaremos varios botones a index.html para poder llamar a diferentes métodos que crearemos más adelante.

<button id = "getLanguage">LANGUAGE</button>
<button id = "getLocaleName">LOCALE NAME</button>
<button id = "getDate">DATE</button>
<button id = "getCurrency">CURRENCY</button>

Paso 3: agregar oyentes de eventos

Los oyentes de eventos se agregarán dentro getDeviceReady funcionar en index.js para asegurarnos de que nuestra aplicación y Cordova se carguen antes de comenzar a usarla.

document.getElementById("getLanguage").addEventListener("click", getLanguage);
document.getElementById("getLocaleName").addEventListener("click", getLocaleName);
document.getElementById("getDate").addEventListener("click", getDate);
document.getElementById("getCurrency").addEventListener("click", getCurrency);

Paso 4A - Función de idioma

La primera función que estamos usando devuelve la etiqueta de idioma BCP 47 del dispositivo del cliente. UsaremosgetPreferredLanguagemétodo. La función tiene dos parámetros onSuccess yonError. Estamos agregando esta función enindex.js.

function getLanguage() {
   navigator.globalization.getPreferredLanguage(onSuccess, onError);

   function onSuccess(language) {
      alert('language: ' + language.value + '\n');
   }

   function onError(){
      alert('Error getting language');
   }
}

Una vez que presionamos el LANGUAGE , la alerta se mostrará en la pantalla.

Paso 4B - Función de configuración regional

Esta función devuelve la etiqueta BCP 47 para la configuración local del cliente. Esta función es similar a la que creamos antes. La única diferencia es que estamos usandogetLocaleName método esta vez.

function getLocaleName() {
   navigator.globalization.getLocaleName(onSuccess, onError);

   function onSuccess(locale) {
      alert('locale: ' + locale.value);
   }

   function onError(){
      alert('Error getting locale');
   }
}

Cuando hacemos clic en el LOCALE , la alerta mostrará nuestra etiqueta de configuración regional.

Paso 4C - Función de fecha

Esta función se utiliza para devolver la fecha de acuerdo con la configuración regional y de zona horaria del cliente. date parámetro es la fecha actual y options el parámetro es opcional.

function getDate() {
   var date = new Date();

   var options = {
      formatLength:'short',
      selector:'date and time'
   }
   navigator.globalization.dateToString(date, onSuccess, onError, options);

   function onSuccess(date) {
      alert('date: ' + date.value);
   }

   function onError(){
      alert('Error getting dateString');
   }
}

Ahora podemos ejecutar la aplicación y presionar DATE para ver la fecha actual.

La última función que mostraremos es devolver valores de moneda de acuerdo con la configuración del dispositivo del cliente y el código de moneda ISO 4217. Puedes ver que el concepto es el mismo.

function getCurrency() {
   var currencyCode = 'EUR';
   navigator.globalization.getCurrencyPattern(currencyCode, onSuccess, onError);

   function onSuccess(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 onError(){
      alert('Error getting pattern');
   }
}

los CURRENCY El botón activará una alerta que mostrará el patrón de moneda de los usuarios.

Este complemento ofrece otros métodos. Puede verlo todo en la siguiente tabla.

método	parámetros	detalles
getPreferredLanguage	onSuccess, onError	Devuelve el idioma actual del cliente.
getLocaleName	onSuccess, onError	Devuelve la configuración regional actual del cliente.
dateToString	fecha, onSuccess, onError, opciones	Devuelve la fecha de acuerdo con la configuración regional y la zona horaria del cliente.
stringToDate	dateString, onSuccess, onError, opciones	Analiza una fecha según la configuración del cliente.
getCurrencyPattern	currencyCode, onSuccess, onError	Devuelve el patrón de moneda del cliente.
getDatePattern	onSuccess, onError, opciones	Devuelve el patrón de fecha del cliente.
getDateNames	onSuccess, onError, opciones	Devuelve una serie de nombres de meses, semanas o días según la configuración del cliente.
isDayLightSavingsTime	fecha, SuccessCallback, errorCallback	Se utiliza para determinar si el horario de verano está activo según la zona horaria y el calendario del cliente.
getFirstDayOfWeek	onSuccess, onError	Devuelve el primer día de la semana según la configuración del cliente.
numberToString	number, onSuccess, onError, opciones	Devuelve el número según la configuración del cliente.
stringToNumber	cadena, onSuccess, onError, opciones	Analiza un número según la configuración del cliente.
getNumberPattern	onSuccess, onError, opciones	Devuelve el patrón numérico de acuerdo con la configuración del cliente.