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'optionshort
etfull
valeurs.