Intl.DateTimeFormat.prototype.format

La propriété Intl.DateTimeFormat.prototype.format est un accesseur qui renvoie une fonction pour formater une date selon les options de locale et de format de l'objet Intl.DateTimeFormat.

Syntaxe

dateTimeFormat.format(date)

Paramètres

date
La date à formater.

Description

La fonction renvoyée par l'accesseur format permet de formater une date en une chaîne de caractères en fonction des options de locale et de format définies pour l'objet Intl.DateTimeFormat.

Exemples

Utiliser format

On peut utiliser la fonction renvoyée par format pour formater une date. Par exemple selon la locale serbe :

var options = {weekday: "long", year: "numeric", month: "long", day: "numeric"};
var dateTimeFormat = new Intl.DateTimeFormat("sr-RS", options);
console.log(dateTimeFormat.format(new Date()));
// → "недеља, 7. април 2013."

Utiliser format avec map()

On peut également utiliser la fonction renvoyée par format pour formater toutes les dates d'un tableau. On observe que la fonction est liée à l'objet DateTimeFormat dont elle provient, on peut donc la passer directement à Array.prototype.map().

var a = [new Date(2012, 08), new Date(2012, 11), new Date(2012, 03)];
var options = {year: "numeric", month: "long"};
var dateTimeFormat = new Intl.DateTimeFormat("pt-BR", options);
var formatted = a.map(dateTimeFormat.format);
console.log(formatted.join("; "));
// → "setembro de 2012; dezembro de 2012; abril de 2012"

Spécifications

Spécification Statut Commentaires
ECMAScript Internationalization API 1.0 (ECMA-402)
La définition de 'Intl.DateTimeFormat.format' dans cette spécification.
Standard Définition initiale.
ECMAScript Internationalization API 2.0 (ECMA-402)
La définition de 'Intl.DateTimeFormat.format' dans cette spécification.
Standard  
ECMAScript Internationalization API 3.0 (ECMA-402)
La définition de 'Intl.DateTimeFormat.format' dans cette spécification.
Projet  

Compatibilité des navigateurs

Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Support simple 24 29 (29) 11 15 Pas de support
Fonctionnalité Android Chrome pour Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Support simple Pas de support 26 Pas de support Pas de support Pas de support Pas de support

Voir aussi

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : SphinxKnight
 Dernière mise à jour par : SphinxKnight,