Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte.
Traduction
Source

Intl.DateTimeFormat, objet (JavaScript)

Fournit la mise en forme spécifique aux paramètres régionaux de date et d'heure.

dateTimeFormatObj = new Intl.DateTimeFormat([locales][, options])

dateTimeFormatObj

Requis. Nom de variable à attribuer à l'objet DateTimeFormat.

locales

Optionnel. Tableau de chaînes de paramètres régionaux qui contiennent une ou plusieurs balises de langue ou de paramètres régionaux. Si vous incluez plusieurs chaînes de paramètres régionaux, répertoriez-les dans l'ordre de priorité décroissant afin que la première entrée soit la valeur par défaut. Si vous omettez ce paramètre, les paramètres régionaux par défaut du runtime JavaScript sont utilisés. Pour plus d'informations, consultez la section Notes.

options

Optionnel. Objet qui contient une ou plusieurs propriétés spécifiant les options de mise en forme de date et d'heure. Pour plus d'informations, consultez la section Notes.

Le paramètre locales doit respecter les balises de langue ou de paramètres régionaux BCP 47 telles que « en-US » et « zh-CN ». La balise peut inclure la langue, la région, le pays et la variante. Pour obtenir des exemples de balises de langue, consultez l'Annexe A de BCP 47. Pour DateTimeFormat, vous pouvez ajouter la sous-balise -u dans la chaîne de paramètres régionaux afin d'inclure l'une ou les deux extensions Unicode suivantes :

  • -nu pour spécifier une extension du système de numérotation : language-region-u-nu-numberingsystem

    numberingsystem peut avoir l'une des valeurs suivantes : arab, arabext, bali, beng, deva, fullwide, gujr, guru, hanidec, khmr, knda, laoo, latn, limb, mylm, mong, mymr, orya, tamldec, telu, thai, tibt.

  • –ca pour spécifier un calendrier : language-region-u-ca-calendar

    calendar peut avoir l'une des valeurs suivantes : bouddhiste, chinois, grégorien, islamique, japonais.

Le paramètre options peut inclure les propriétés suivantes :

Propriété

Description

Valeurs possibles 

Valeur par défaut

localeMatcher

Spécifie l'algorithme de correspondance avec les paramètres régionaux à utiliser.

« rechercher », « ajustement optimal »

« ajustement optimal »

formatMatcher

Spécifie l'algorithme de correspondance avec le format à utiliser.

« basique », « ajustement optimal »

« ajustement optimal »

hour12

Spécifie s'il faut utiliser un format de 12 heures pour les heures.

true (pour le format 12 heures), false (pour le format 24 heures)

timeZone

Spécifie le fuseau horaire. Au minimum, « UTC » est toujours pris en charge.

Valeur de fuseau horaire telle que « UTC ».

« UTC » (temps universel coordonné)

weekday

Spécifie la mise en forme du jour de la semaine.

« étroit », « court », « long ».

non défini

era

Spécifie la mise en forme de l'ère.

« étroit », « court », « long »

non défini

year

Spécifie la mise en forme de l'année.

« 2 chiffres », « numérique »

non défini ou « numérique »

month

Spécifie la mise en forme du mois.

« 2 chiffres », « numérique », « étroit », « court », « long »

non défini ou « numérique »

day

Spécifie la mise en forme du jour.

« 2 chiffres », « numérique »

non défini ou « numérique »

hour

Spécifie la mise en forme de l'heure.

« 2 chiffres », « numérique »

non défini

minute

Spécifie la mise en forme de la minute.

« 2 chiffres », « numérique »

non défini

second

Spécifie la mise en forme de la seconde.

« 2 chiffres », « numérique »

non défini

timeZoneName

Spécifie la mise en forme du fuseau horaire. Cette propriété n'est pas prise en charge actuellement.

« court », « long ».

Cette propriété n'est pas prise en charge actuellement.

Les valeurs par défaut pour weekday, era, year, month, day, hour, minute et second sont undefined. Si vous ne définissez pas ces propriétés, la mise en forme « numérique » est utilisée pour year, month et day.

Chaque paramètre régional doit prendre en charge, au minimum, les formats suivants :

  • jour de la semaine, année, mois, jour, heure, minute, seconde

  • jour de la semaine, année, mois, jour

  • année, mois, jour

  • année, mois

  • mois, jour

  • heure, minute, seconde

  • heure, minute

Le tableau suivant répertorie les propriétés de l'objet DateTimeFormat.

Propriété

Description

constructeur

Spécifie la fonction qui crée un formateur de date/heure.

format

Retourne une fonction qui met en forme une date spécifique aux paramètres régionaux à l'aide des paramètres du formateur de date/heure.

prototype

Retourne une référence au prototype pour un formateur de date/heure.

Le tableau suivant répertorie les méthodes de l'objet DateTimeFormat.

Méthode

Description

resolvedOptions

Retourne un objet qui contient les propriétés et les valeurs de l'objet formateur de date/heure.

L'exemple suivant affiche le résultat du passage d'un objet date à DateTimeFormat en utilisant différents paramètres régionaux.

var date = new Date(Date.UTC(2013, 1, 1, 14, 0, 0));
var options = { weekday: "long", year: "numeric", month: "short",
    day: "numeric" };

if (console && console.log) {
    console.log(new Intl.DateTimeFormat("en-US").format(date));
    // Returns ‎2‎/‎1‎/‎2013
    console.log(new Intl.DateTimeFormat("ja-JP").format(date));
    // Returns ‎2013‎年‎2‎月‎1‎日
    console.log(new Intl.DateTimeFormat("ar-SA", options).format(date));
    // Returns ‏الجمعة‏, ‏٢٠‏ ‏ربيع الأول‏, ‏١٤٣٤
    console.log(new Intl.DateTimeFormat("hi-IN", options).format(date));
    // Returns ‎शुक्रवार‎, ‎01‎ ‎फरवरी‎ ‎2013
}

L'exemple suivant crée un objet DateTimeFormat qui spécifie le jour de la semaine actuel au format long en utilisant les paramètres régionaux arabes (Arabie Saoudite), le calendrier islamique et le système de numérotation latin.

var dtf = new Intl.DateTimeFormat(["ar-SA-u-ca-islamic-nu-latn"], {
    weekday: "long",
    year: "numeric",
    day: "numeric",
    month: "long"
}); 

If (console && console.log) {
    console.log(dtf.format(new Date()));
    // Returns ‏الجمعة‏, ‏19‏ ‏رمضان‏, ‏1434
}

Pris en charge dans le mode de document Internet Explorer 11 (mode normes). Également pris en charge dans les applications du Store (Windows 8.1 et Windows Phone 8.1). Voir Informations de version.

Non pris en charge dans les modes de document suivants : Quirks, Internet Explorer 6 (mode normes), Internet Explorer 7 (mode normes), Internet Explorer 8 (mode normes), Internet Explorer 9 (mode normes), Internet Explorer 10 (mode normes). Non pris en charge dans Windows 8.

Ajouts de la communauté

AJOUTER
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Afficher:
© 2014 Microsoft