globalization.dateToString

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 de mise en forme String par une value propriété accessible à partir de l'objet passé comme paramètre à lasuccessCallback.

Les entrants date paramètre doit être de typeDate.

S'il y a une erreur de mise en forme la date, puis le errorCallback s'exécute avec un [GlobalizationError](GlobalizationError/globalizationerror.html) objet comme paramètre. Code attendu de l'erreur est[GlobalizationError](GlobalizationError/globalizationerror.html).FORMATTING\_ERROR.

Le options paramètre est facultatif, et ses valeurs par défaut sont :

{formatLength: « court », sélecteur: « date et heure »}

Le options.formatLength peut être short , medium , long , oufull.

Le options.selector peut être date , time oudate and time.

Plates-formes prises en charge

  • Android
  • BlackBerry WebWorks (OS 5.0 et plus)
  • iOS
  • Windows Phone 8

Petit exemple

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('Error getting dateString\n'); },
    { formatLength: 'short', selector: 'date and time' }
);

Exemple complet

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

    function checkDateString() {
      navigator.globalization.dateToString(
        new Date(),
        function (date) {alert('date: ' + date.value + '\n');},
        function () {alert('Error getting dateString\n');,
        {formatLength:'short', selector:'date and time'}}
      );
    }
    </script>
  </head>
  <body>
    <button onclick="checkDateString()">Click for date string</button>
  </body>
</html>

Windows Phone 8 Quirks

  • Le formatLength prend en charge uniquement l'option short et full valeurs.