La propriété Date.prototype
représente le prototype du constructeur Date
.
Attributs de Date.prototype |
|
---|---|
Écrivable | Non |
Énumérable | Non |
Configurable | Oui |
Description
Les instances de Date
JavaScript héritent de Date.prototype
. Le prototype du constructeur peut être modifié afin d'altérer l'ensemble des instances de Date
pour y ajouter des propriétés et/ou des méthodes.
Pour des questions de compatibilité avec le calcul des millénaires (en d'autres termes, pour prendre en compte l'année 2000), il faut toujours renseigner l'année entière ; par exemple, utilisez 1998, et non 98. Afin d'obtenir ces valeurs JavaScript possède les méthodes getFullYear()
, setFullYear()
, getUTCFullYear()
et setUTCFullYear()
.
Avec ECMAScript 6, l'objet Date.prototype
n'est plus une instance de Date
, c'est un objet « ordinaire ».
Propriétés
- Date.prototype.constructor
- Renvoie la fonction qui crée une instance de
Date
. Par défaut, ce sera le constructeurDate
.
Méthodes
Lecture (getters)
Date.prototype.getDate()
- Renvoie le jour du mois (1-31) pour la date spécifiée selon l'heure locale.
Date.prototype.getDay()
- Renvoie le jour de la semaine (0-6) pour la date spécifiée selon l'heure locale.
Date.prototype.getFullYear()
- Renvoie l'année (avec 4 chiffres pour une année à 4 chiffres) pour la date spécifiée selon l'heure locale.
Date.prototype.getHours()
- Renvoie l'heure (0-23) pour la date spécifiée selon l'heure locale.
Date.prototype.getMilliseconds()
- Renvoie les millièmes de secondes (0-999) pour la date spécifiée selon l'heure locale.
Date.prototype.getMinutes()
- Renvoie les minutes (0-59) pour la date spécifiée selon l'heure locale.
Date.prototype.getMonth()
- Renvoie le mois (0-11) pour la date spécifiée selon l'heure locale.
Date.prototype.getSeconds()
- Renvoie les secondes (0-59) pour la date spécifiée selon l'heure locale.
Date.prototype.getTime()
- Renvoie la valeur numérique de la date spécifiée sous la forme du nombre de millisecondes depuis le 1er janvier 1970, 00:00:00 UTC (les valeurs renvoyées pour les dates antérieures seront négatives).
Date.prototype.getTimezoneOffset()
- Renvoie le décalage de fuseau horaire en minutes pour l'heure locale courante.
Date.prototype.getUTCDate()
- Renvoie le jour (date) du mois (1-31) pour la date spécifiée selon le temps universel.
Date.prototype.getUTCDay()
- Renvoie le jour de la semaine (0-6) pour la date spécifiée selon le temps universel.
Date.prototype.getUTCFullYear()
- Renvoie l'année (avec 4 chiffres pour une année à 4 chiffres) pour la date spécifiée selon le temps universel.
Date.prototype.getUTCHours()
- Renvoie les heures (0-23) pour la date spécifiée selon le temps universel.
Date.prototype.getUTCMilliseconds()
- Renvoie les millièmes de seconde (0-999) pour la date spécifiée selon le temps universel.
Date.prototype.getUTCMinutes()
- Renvoie les minutes (0-59) pour la date spécifiée selon le temps universel.
Date.prototype.getUTCMonth()
- Renvoie le mois (0-11) pour la date spécifiée selon le temps universel.
Date.prototype.getUTCSeconds()
- Renvoie les secondes (0-59) pour la date spécifiée selon le temps universel
Date.prototype.getYear()
- Renvoie l'année (habituellement avec 2 ou 3 chiffres) pour la date spécifiée selon l'heure locale. Utilisez plutôt
getFullYear()
.
Écriture (setters)
Date.prototype.setDate()
- Définit le jour du mois pour la date spécifiée selon l'heure locale.
Date.prototype.setFullYear()
- Définit l'année complète (4 chiffres pour une année à 4 chiffres) pour la date spécifiée selon l'heure locale.
Date.prototype.setHours()
- Définit les heures pour la date spécifiée selon l'heure locale.
Date.prototype.setMilliseconds()
- Définit les millièmes de seconde pour la date spécifiée selon l'heure locale.
Date.prototype.setMinutes()
- Définit les minutes pour la date spécifiée selon l'heure locale.
Date.prototype.setMonth()
- Définit le mois pour la date spécifiée selon l'heure locale.
Date.prototype.setSeconds()
- Définit les secondes pour la date spécifiée selon l'heure locale.
Date.prototype.setTime()
- Règle l'objet
Date
sur le temps représenté par un nombre de millisecondes depuis le 1er janvier 1970, 00:00:00 UTC. Date.prototype.setUTCDate()
- Définit le jour du mois pour la date spécifiée selon le temps universel.
Date.prototype.setUTCFullYear()
- Définit l'année complète (4 chiffres pour une année à 4 chiffres) pour la date spécifiée selon le temps universel.
Date.prototype.setUTCHours()
- Définit les heures pour la date spécifiée selon le temps universel.
Date.prototype.setUTCMilliseconds()
- Définit les millièmes de seconde pour la date spécifiée selon le temps universel.
Date.prototype.setUTCMinutes()
- Définit les minutes pour la date spécifiée selon le temps universel.
Date.prototype.setUTCMonth()
- Définit le mois pour la date spécifiée selon le temps universel.
Date.prototype.setUTCSeconds()
- Définit les secondes pour la date spécifiée selon le temps universel.
Date.prototype.setYear()
- Définit l'année (habituellement avec 2 ou 3 chiffres) pour une date spécifiée selon le temps universel. Utilisez plutôt
setFullYear()
.
Lecture avec conversion
Date.prototype.toDateString()
- Renvoie la partie « date » de l'objet
Date
sous la forme d'une chaîne de caractères lisible par un humain. Date.prototype.toISOString()
- Convertit une date en chaîne de caractère respectant la norme ISO 8601 Format Étendu.
Date.prototype.toJSON()
- Renvoie une chaîne de caractère représentant la date en utilisant
toISOString()
. Pour une utilisation avecJSON.stringify()
. Date.prototype.toGMTString()
- Convertit une date en une chaîne de caractères, en utilisant les conventions GMT. Utilisez plutôt
toUTCString()
. Date.prototype.toLocaleDateString()
- Renvoie la partie « date » de l'objet
Date
sous la forme d'une chaîne de caractères adaptée selon la locale en utilisant les réglages du système pour déterminer la locale à utiliser. Date.prototype.toLocaleFormat()
- Convertit une date en une chaîne de caractères, en utilisant une chaîne de formatage.
Date.prototype.toLocaleString()
- Convertit une date en une chaîne de caractères, en utilisant les conventions locales courantes. Remplace la méthode
Object.prototype.toLocaleString()
. Date.prototype.toLocaleTimeString()
- Renvoie la partie « heure » de l'objet
Date
sous la forme d'une chaîne, en utilisant les conventions locales courantes. Date.prototype.toSource()
- Renvoie une chaîne de caractères représentant le code source pour un objet
Date
équivalent ; cette valeur peut être utilisée pour créer un nouvel objet. Remplace la méthodeObject.prototype.toSource()
. Date.prototype.toString()
- Renvoie une chaîne de caractères représentant l'objet
Date
spécifié. Remplace la méthodeObject.prototype.toString()
. Date.prototype.toTimeString()
- Renvoie la partie « heure » de l'objet
Date
sous la forme d'une chaîne de caractères lisible par humain. Date.prototype.toUTCString()
- Convertit une date en une chaîne de caractères, en utilisant le fuseau horaire UTC.
Date.prototype.valueOf()
- Renvoie la valeur primitive d'un objet
Date
. Remplace la méthodeObject.prototype.valueOf()
.
Spécifications
Spécification | Statut | Commentaires |
---|---|---|
ECMAScript 1st Edition (ECMA-262) | Standard | Définition initiale. Implémentée avec JavaScript 1.1. |
ECMAScript 5.1 (ECMA-262) La définition de 'Date.prototype' dans cette spécification. |
Standard | |
ECMAScript 2015 (6th Edition, ECMA-262) La définition de 'Date.prototype' dans cette spécification. |
Standard | |
ECMAScript 2016 Draft (7th Edition, ECMA-262) La définition de 'Date.prototype' dans cette spécification. |
Projet |
Compatibilité des navigateurs
Fonctionnalité | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Support simple | (Oui) | (Oui) | (Oui) | (Oui) | (Oui) |
Objet ordinaire | ? | 41 (41) | ? | ? | ? |
Fonctionnalité | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Support simple | (Oui) | (Oui) | (Oui) | (Oui) | (Oui) | (Oui) |
Objet ordinaire | ? | ? | 41.0 (41) | ? | ? | ? |