globalization.getDateNames
Retourne un tableau des noms des mois ou jours de la semaine, selon le calendrier et les préférences de l'utilisateur du client.
navigator.globalization.getDateNames(successCallback, errorCallback, options);
Description
Retourne le tableau de noms à la successCallback
avec un properties
objet comme paramètre. Cet objet contient une value
propriété avec un Array
de String
valeurs. Les noms de fonctionnalités de tableau à partir de soit le premier mois de l'année ou le premier jour de la semaine, selon l'option choisie.
S'il y a une erreur d'obtention des noms, puis les errorCallback
s'exécute avec un [GlobalizationError](GlobalizationError/globalizationerror.html)
objet comme paramètre. Code attendu de l'erreur est[GlobalizationError](GlobalizationError/globalizationerror.html).UNKNOWN\_ERROR
.
Le options
paramètre est facultatif, et ses valeurs par défaut sont :
{type: « large », item: « mois »}
La valeur de options.type
peut être narrow
ouwide
.
La valeur de options.item
peut être months
oudays
.
Plates-formes prises en charge
- Android
- BlackBerry WebWorks (OS 5.0 et plus)
- iOS
- Windows Phone 8
Petit exemple
Lorsque le navigateur est configuré pour la en\_US
locale, cet exemple affiche une série de douze fenêtres popup, un par mois, avec un texte semblable à 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' }
);
Exemple complet
<!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>