Globalización

Este plugin obtiene información y operaciones de representación específica al usuario local, idioma, y zona horaria. Nótese la diferencia entre local e idioma: local controla qué números, fechas, y horas aparecen en la región, mientras que el idioma determina que idioma de texto aparece, independientemente de los ajustes locales. Desafortunadamente, la mayoría de dispositivos móviles no hacen distinción entre estos ajustes.

Instalación

cordova plugin add org.apache.cordova.globalization

Métodos

navigator.globalization.getPreferredLanguage

Recoge la etiqueta de lenguaje BCP 47 del idioma actual. Devuelve un identificador al successCallback con un objeto properties como parámetro. Este objeto debería tener una propiedad value con un valor String. Si hay algún error al recoger el idioma, entonces el errorCallback se ejecuta con un objeto GlobalizationError como parámetro.

navigator.globalization.getPreferredLanguage(successCallback, errorCallback);

Supported Platforms

  • Amazon Fire OS
  • Android
  • iOS
  • Windows Phone 8

navigator.globalization.getLocaleName

Devuelve la etiqueta BCP 47 actual del ajuste local. Devuelve la cadena identificador successCallback con un objeto properties como parámetro. Este objeto debería tener una propiedad value con un valor String. La etiqueta local consistirá en dos letras minúsculas para el idioma, dos letras mayúsculas para el país, y un código variado, separado por guión. Si hubiera algún error al recoger el local, entonces se ejecuta errorCallback con un objeto GlobalizationError como parámetro.

navigator.globalization.getLocaleName(successCallback, errorCallback);

Plataformas soportadas

  • Amazon Fire OS
  • Android
  • iOS
  • Windows Phone 8

navigator.globalization.dateToString

Devuelve una fecha formateada como cadena dependiendo de la hora local del cliente. Devuelve la cadena fecha formateada por una propiedad value accesible desde el objeto pasado como parámetro al  successCallback.   

navigator.globalization.dateToString(date, successCallback, errorCallback, options);
  • El parámetro date de llegada debería ser del tipo Date.
  • Si hay algún error al formatear la fecha, entonces se ejecuta el errorCallback con un objeto GlobalizationError como parámetro.
  • El parámetro options es opcional, y por defecto toma los valores:

{formatLength:'short', selector:'date and time'}

  • El options.formatLength puede ser short, medium, long, o full.
  • El options.selector puede ser date, time o  date and time.

Plataformas soportadas

  • Amazon Fire OS
  • Android
  • iOS
  • Windows Phone 8

navigator.globalization.getCurrencyPattern

Devuelve una cadena patrón al formato y valores actuales dependiendo de las preferencias del cliente y del código ISO 4217. El objeto debería contener las siguientes propiedades:

  • pattern: El patrón actual para dar formato y analizar los valores actuales. Los patrones siguen el Unicode Technical Standard #35. (String)
  • code: El código ISO 4217 actual para el patrón. (String)
  • fraction: El número de dígitos fraccionables que se usan cuando se analiza y formatea. (Number)
  • rounding: El incremento redondeado que se usa cuando se analiza y formatea. (Number)
  • decimal: El símbolo decimal que se usa para analizar y formatear. (String)
  • grouping: El símbolo para millares que se usan para analizar y formatear. (String)
 navigator.globalization.getCurrencyPattern(currencyCode, successCallback, errorCallback);

El parámetro currencyCode de llegada debería ser una String de un solo código de divisa ISO 4217, por ejemplo 'USD'. Si hay un error al obtener el patrón. Entonces se ejecuta el errorCallback con un objeto GlobalizationError como parámetro.

Plataformas soportadas

  • Amazon Fire OS
  • Android
  • iOS

navigator.globalization.getDateNames

Devuelve un array con los nombres de los meses o días de la semana, dependiendo de las preferencias del calendario del usuario. Devuelve el array de nombre al successCallback con un objeto properties como parámetro. Este objeto contiene una propiedad value con un Array de valores String. El conjunto cuenta con nombres que comienzan, ya sea del primer mes del año o el primer día de la semana, dependiendo de la opción seleccionada.

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

Si hay un error al obtener los nombres, entonces se ejecuta el errorCallback con un objeto GlobalizationError como parámetro.

El parámetro options es opcional, y por defecto toma los valores:

{type:'wide', item:'months'}

  • El valor de options.type puede ser  narrow o wide.
  • El valor de options.item puede ser  months o days.

Plataformas soportadas

  • Amazon Fire OS
  • Android
  • iOS
  • Windows Phone 8

navigator.globalization.getDatePattern

Devuelve un patrón para formatear y analizar fechas dependiendo de las preferencias del usuario. Devuelve el patrón al successCallback. El objeto pasado como parámetro contiene las siguientes propiedades:

  • pattern: El patrón de fecha y hora al formato fecha. El patrón sigue el Unicode Technical Standard #35. (String)
  • timezone: El nombre abreviado de la zona horaria del cliente. (String)
  • utc_offset: La diferencia actual entre la zona horaria del cliente y las coordenadas horarias universales, en segundos. (Number)
  • dst_offset: La diferencia actual entre el cambio horario de invierno y verano. (Number)
navigator.globalization.getDatePattern(successCallback, errorCallback, options);

Si hay un error al obtener el patrón. Entonces se ejecuta el errorCallback con un objeto GlobalizationError como parámetro.

El parámetro options es opcional, y por defecto tiene los valores:

{formatLength:'short', selector:'date and time'}

El options.formatLength puede ser short, medium, long, o full. El options.selector puede ser date, time o date and time.

Plataformas soportadas

  • Amazon Fire OS
  • Android
  • iOS
  • Windows Phone 8

 

navigator.globalization.getFirstDayOfWeek

Devuelve el primer día de la semana dependiendo de las preferencias y el calendario del usuario. Los días de la semana están numerados desde el 1, donde 1 se asume que es Domingo. Se devuelve el día al successCallback con un objeto properties como parámetro. Este objeto debería tener una propiedad value con un valor Number.

navigator.globalization.getFirstDayOfWeek(successCallback, errorCallback);

Si hay un error al obtener el patrón. Entonces se ejecuta el errorCallback con un objeto GlobalizationError como parámetro.

Plataformas soportadas

  • Amazon Fire OS
  • Android
  • iOS
  • Windows Phone 8

navigator.globalization.getNumberPattern

Devuelve un patrón para formatear y analizar números dependiendo de las preferencias del cliente. El patrón devuelve al successCallback con un objeto properties. El objeto contiene las siguientes propiedades:

  • pattern: El patrón para formatear y analizar los números. Los patrones siguen el Unicode Technical Standard #35. (String)
  • symbol: El símbolo que usa cuando se formatea y analiza, así como un porcentaje o símbolo divisa. (String)
  • fraction: El número de dígitos fraccionados que utiliza al analizar y dar formato a los números. (Number)
  • rounding: El redondeo que utiliza al analizar y dar formato. (Number)
  • positive: El símbolo que usa para números positivos cuando se analiza y da formato. (String)
  • negative: El símbolo que se usa para números negativos cuando se analiza y da formato. (String)
  • decimal: El símbolo decimal que se usa al analizar y dar formato. (String)
  • grouping: El símbolo de millar que se usa al analizar y dar formato. (String)
navigator.globalization.getNumberPattern(successCallback, errorCallback, options);

Si hay un error al obtener el patrón. Entonces se ejecuta el errorCallback con un objeto GlobalizationError como parámetro.

El parámetro options es opcional, y por defecto tiene los valores:

{type:'decimal'}

El options.type puede ser decimal, percent, o currency.

Plataformas soportadas

  • Amazon Fire OS
  • Android
  • iOS
  • Windows Phone 8

navigator.globalization.isDayLightSavingsTime

Indica si el horario de verano está en vigor para una fecha determinada usando la zona horaria del cliente y el calendario. El objeto debería ser una propiedad dst con un valor Boolean. Un valor true indica que la fecha dada está en horario de verano, y false indica que no lo está.

navigator.globalization.isDayLightSavingsTime(date, successCallback, errorCallback);

El parámetro date de entrada debería ser de tipo Date.

Plataformas soportadas

  • Amazon Fire OS
  • Android
  • iOS
  • Windows Phone 8

navigator.globalization.numberToString

Devuelve un número formateado como una cadena dependiendo de las preferencias del usuario. El objeto debería tener una propiedad value con un valor String.

navigator.globalization.numberToString(number, successCallback, errorCallback, options);

El parámetro options es opcional, y los valores por defecto son:

{type:'decimal'}

El options.type puede ser 'decimal', 'percent', o 'currency'.

Plataformas soportadas

  • Amazon Fire OS
  • Android
  • iOS
  • Windows Phone 8

navigator.globalization.stringToDate

Analiza una fecha formateada como una cadena, dependiendo de las preferencias del usuario y el calendario usando la zona horaria del cliente, y devuelve el correspondiente objeto fecha.

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

Este objeto debería tener las siguientes propiedades:

  • year: Los cuatros dígitos del año. (Number)
  • month: Los meses desde 0-11. (Number)
  • day: Los días desde 1-31. (Number)
  • hour: La hora desde 0-23. (Number)
  • minute: Los minutos desde 0-59. (Number)
  • second: Los segundos desde 0-59. (Number)
  • millisecond: Los milisegundos (desde 0-999), no disponible para todas las plataformas. (Number)

El parámetro de entrada dateString debería ser del tipo String.

El parámetro options es opcional, y por defecto toma los siguientes valores:

{formatLength:'short', selector:'date and time'}

El options.formatLength puede ser short, medium, long, o full. El options.selector puede ser date, time o date and time.

Plataformas soportadas

  • Amazon Fire OS
  • Android
  • iOS
  • Windows Phone 8

navigator.globalization.stringToNumber

Analiza un número formateado como una cadena dependiendo de las preferencias del usuario y devuelve el número correspondiente.

navigator.globalization.stringToNumber(string, successCallback, errorCallback, options);

Devuelve el número al successCallback con un objeto properties como parámetro. Este objeto debería ser una propiedad value con un valor Number.

El parámetro options es opcional, y los valores por defecto son:

{type:'decimal'}

El options.type puede ser decimal, percent, o currency.

Plataformas soportadas

  • Amazon Fire OS
  • Android
  • iOS
  • Windows Phone 8

Objetos

GlobalizationError

Un objeto que representa un error de la API Globalization. Este objeto es creado y popularizado por Cordova, y devuelto por la función en caso de un error.

Propiedades

  • code: Uno de los siguientes códigos representa el tipo de error (Number)
    • GlobalizationError.UNKNOWN_ERROR: 0
    • GlobalizationError.FORMATTING_ERROR: 1
    • GlobalizationError.PARSING_ERROR: 2
    • GlobalizationError.PATTERN_ERROR: 3
  • message: Un mensaje de texto que incluye la explicación del error y/o los detalles (String)

Plataformas soportadas

  • Amazon Fire OS
  • Android
  • iOS