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](GlobalizationError/globalizationerror.html) oggetto come parametro. Previsto codice dell'errore è[GlobalizationError](GlobalizationError/globalizationerror.html).UNKNOWN\_ERROR.

Il options parametro è facoltativo e valori predefiniti sono:

{tipo: 'largo', voce: 'mesi'}

Il valore di options.type può essere narrow owide.

Il valore di options.item può essere months odays.

Piattaforme supportate

  • Android
  • BlackBerry WebWorks (OS 5.0 e superiori)
  • iOS
  • Windows Phone 8

Esempio rapido

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

Esempio completo

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

    function checkDateNames() {
      navigator.globalization.getDateNames(
        function (names) {
          for (var i=0; i<names.value.length; i++) {
            alert('month: ' + names.value[i] + '\n');
          }
        },
        function () {alert('Error getting names\n');},
        {type:'wide', item:'months'}
      );
    }

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