1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
|
---
title: Date.prototype
slug: conflicting/Web/JavaScript/Reference/Global_Objects/Date
tags:
- Date
- JavaScript
- Propriété
- Prototype
- Reference
translation_of: Web/JavaScript/Reference/Global_Objects/Date
translation_of_original: Web/JavaScript/Reference/Global_Objects/Date/prototype
original_slug: Web/JavaScript/Reference/Objets_globaux/Date/prototype
---
<div>{{JSRef}}</div>
<p>La propriété <code><strong>Date.prototype</strong></code> représente le prototype du constructeur {{jsxref("Date")}}.</p>
<div>{{js_property_attributes(0,0,1)}}</div>
<h2 id="Description">Description</h2>
<p>Les instances de {{jsxref("Date")}} JavaScript héritent de <code>Date.prototype</code>. Le prototype du constructeur peut être modifié afin d'altérer l'ensemble des instances de <code>Date</code> pour y ajouter des propriétés et/ou des méthodes.</p>
<p>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 {{jsxref("Date/getFullYear", "getFullYear()")}}, {{jsxref("Date/setFullYear", "setFullYear()")}}, {{jsxref("Date/getUTCFullYear", "getUTCFullYear()")}} et {{jsxref("Date/setUTCFullYear", "setUTCFullYear()")}}.</p>
<p>Avec ECMAScript 6, l'objet <code>Date.prototype</code> n'est plus une instance de {{jsxref("Date")}}, c'est un objet « ordinaire ».</p>
<h2 id="Propriétés">Propriétés</h2>
<dl>
<dt>Date.prototype.constructor</dt>
<dd>Renvoie la fonction qui crée une instance de <code>Date</code>. Par défaut, ce sera le constructeur {{jsxref("Date", "Date")}}.</dd>
</dl>
<h2 id="Méthodes">Méthodes</h2>
<h3 id="Lecture_(getters)">Lecture (<em>getters</em>)</h3>
<dl>
<dt>{{jsxref("Date.prototype.getDate()")}}</dt>
<dd>Renvoie le jour du mois (1-31) pour la date spécifiée selon l'heure locale.</dd>
<dt>{{jsxref("Date.prototype.getDay()")}}</dt>
<dd>Renvoie le jour de la semaine (0-6) pour la date spécifiée selon l'heure locale.</dd>
<dt>{{jsxref("Date.prototype.getFullYear()")}}</dt>
<dd>Renvoie l'année (avec 4 chiffres pour une année à 4 chiffres) pour la date spécifiée selon l'heure locale.</dd>
<dt>{{jsxref("Date.prototype.getHours()")}}</dt>
<dd>Renvoie l'heure (0-23) pour la date spécifiée selon l'heure locale.</dd>
<dt>{{jsxref("Date.prototype.getMilliseconds()")}}</dt>
<dd>Renvoie les millièmes de secondes (0-999) pour la date spécifiée selon l'heure locale.</dd>
<dt>{{jsxref("Date.prototype.getMinutes()")}}</dt>
<dd>Renvoie les minutes (0-59) pour la date spécifiée selon l'heure locale.</dd>
<dt>{{jsxref("Date.prototype.getMonth()")}}</dt>
<dd>Renvoie le mois (0-11) pour la date spécifiée selon l'heure locale.</dd>
<dt>{{jsxref("Date.prototype.getSeconds()")}}</dt>
<dd>Renvoie les secondes (0-59) pour la date spécifiée selon l'heure locale.</dd>
<dt>{{jsxref("Date.prototype.getTime()")}}</dt>
<dd>Renvoie la valeur numérique de la date spécifiée sous la forme du nombre de millisecondes depuis le 1<sup>er</sup> janvier 1970, 00:00:00 UTC (les valeurs renvoyées pour les dates antérieures seront négatives).</dd>
<dt>{{jsxref("Date.prototype.getTimezoneOffset()")}}</dt>
<dd>Renvoie le décalage de fuseau horaire en minutes pour l'heure locale courante.</dd>
<dt>{{jsxref("Date.prototype.getUTCDate()")}}</dt>
<dd>Renvoie le jour (date) du mois (1-31) pour la date spécifiée selon le temps universel.</dd>
<dt>{{jsxref("Date.prototype.getUTCDay()")}}</dt>
<dd>Renvoie le jour de la semaine (0-6) pour la date spécifiée selon le temps universel.</dd>
<dt>{{jsxref("Date.prototype.getUTCFullYear()")}}</dt>
<dd>Renvoie l'année (avec 4 chiffres pour une année à 4 chiffres) pour la date spécifiée selon le temps universel.</dd>
<dt>{{jsxref("Date.prototype.getUTCHours()")}}</dt>
<dd>Renvoie les heures (0-23) pour la date spécifiée selon le temps universel.</dd>
<dt>{{jsxref("Date.prototype.getUTCMilliseconds()")}}</dt>
<dd>Renvoie les millièmes de seconde (0-999) pour la date spécifiée selon le temps universel.</dd>
<dt>{{jsxref("Date.prototype.getUTCMinutes()")}}</dt>
<dd>Renvoie les minutes (0-59) pour la date spécifiée selon le temps universel.</dd>
<dt>{{jsxref("Date.prototype.getUTCMonth()")}}</dt>
<dd>Renvoie le mois (0-11) pour la date spécifiée selon le temps universel.</dd>
<dt>{{jsxref("Date.prototype.getUTCSeconds()")}}</dt>
<dd>Renvoie les secondes (0-59) pour la date spécifiée selon le temps universel</dd>
<dt>{{jsxref("Date.prototype.getYear()")}} {{ Deprecated_inline() }}</dt>
<dd>Renvoie l'année (habituellement avec 2 ou 3 chiffres) pour la date spécifiée selon l'heure locale. Utilisez plutôt {{jsxref("Date/getFullYear", "getFullYear()")}}.</dd>
</dl>
<h3 id="Écriture_(setters)">Écriture (<em>setters</em>)</h3>
<dl>
<dt>{{jsxref("Date.prototype.setDate()")}}</dt>
<dd>Définit le jour du mois pour la date spécifiée selon l'heure locale.</dd>
<dt>{{jsxref("Date.prototype.setFullYear()")}}</dt>
<dd>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.</dd>
<dt>{{jsxref("Date.prototype.setHours()")}}</dt>
<dd>Définit les heures pour la date spécifiée selon l'heure locale.</dd>
<dt>{{jsxref("Date.prototype.setMilliseconds()")}}</dt>
<dd>Définit les millièmes de seconde pour la date spécifiée selon l'heure locale.</dd>
<dt>{{jsxref("Date.prototype.setMinutes()")}}</dt>
<dd>Définit les minutes pour la date spécifiée selon l'heure locale.</dd>
<dt>{{jsxref("Date.prototype.setMonth()")}}</dt>
<dd>Définit le mois pour la date spécifiée selon l'heure locale.</dd>
<dt>{{jsxref("Date.prototype.setSeconds()")}}</dt>
<dd>Définit les secondes pour la date spécifiée selon l'heure locale.</dd>
<dt>{{jsxref("Date.prototype.setTime()")}}</dt>
<dd>Règle l'objet <code>Date</code> sur le temps représenté par un nombre de millisecondes depuis le 1<sup>er</sup> janvier 1970, 00:00:00 UTC.</dd>
<dt>{{jsxref("Date.prototype.setUTCDate()")}}</dt>
<dd>Définit le jour du mois pour la date spécifiée selon le temps universel.</dd>
<dt>{{jsxref("Date.prototype.setUTCFullYear()")}}</dt>
<dd>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.</dd>
<dt>{{jsxref("Date.prototype.setUTCHours()")}}</dt>
<dd>Définit les heures pour la date spécifiée selon le temps universel.</dd>
<dt>{{jsxref("Date.prototype.setUTCMilliseconds()")}}</dt>
<dd>Définit les millièmes de seconde pour la date spécifiée selon le temps universel.</dd>
<dt>{{jsxref("Date.prototype.setUTCMinutes()")}}</dt>
<dd>Définit les minutes pour la date spécifiée selon le temps universel.</dd>
<dt>{{jsxref("Date.prototype.setUTCMonth()")}}</dt>
<dd>Définit le mois pour la date spécifiée selon le temps universel.</dd>
<dt>{{jsxref("Date.prototype.setUTCSeconds()")}}</dt>
<dd>Définit les secondes pour la date spécifiée selon le temps universel.</dd>
<dt>{{jsxref("Date.prototype.setYear()")}} {{ Deprecated_inline() }}</dt>
<dd>Définit l'année (habituellement avec 2 ou 3 chiffres) pour une date spécifiée selon le temps universel. Utilisez plutôt {{jsxref("Date/setFullYear", "setFullYear()")}}.</dd>
</dl>
<h3 id="Lecture_avec_conversion">Lecture avec conversion</h3>
<dl>
<dt>{{jsxref("Date.prototype.toDateString()")}}</dt>
<dd>Renvoie la partie « date » de l'objet <code>Date</code> sous la forme d'une chaîne de caractères lisible par un humain (autrement dit quelque chose comme "Thu Apr 12 2018").</dd>
<dt>{{jsxref("Date.prototype.toISOString()")}}</dt>
<dd>Convertit une date en chaîne de caractère respectant la norme ISO 8601 Format Étendu.</dd>
<dt>{{jsxref("Date.prototype.toJSON()")}}</dt>
<dd>Renvoie une chaîne de caractère représentant la date en utilisant {{jsxref("Date/toISOString", "toISOString()")}}. Pour une utilisation avec {{jsxref("JSON.stringify()")}}.</dd>
<dt>{{jsxref("Date.prototype.toGMTString()")}} {{ Deprecated_inline() }}</dt>
<dd>Convertit une date en une chaîne de caractères, en utilisant les conventions GMT. Utilisez plutôt {{jsxref("Date/toUTCString", "toUTCString()")}}.</dd>
<dt>{{jsxref("Date.prototype.toLocaleDateString()")}}</dt>
<dd>Renvoie la partie « date » de l'objet <code>Date</code> 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.</dd>
<dt>{{jsxref("Date.prototype.toLocaleFormat()")}} {{ Non-standard_inline() }}</dt>
<dd>Convertit une date en une chaîne de caractères, en utilisant une chaîne de formatage.</dd>
<dt>{{jsxref("Date.prototype.toLocaleString()")}}</dt>
<dd>Convertit une date en une chaîne de caractères, en utilisant les conventions locales courantes. Remplace la méthode {{jsxref("Object/toLocaleString", "Object.prototype.toLocaleString()")}}.</dd>
<dt>{{jsxref("Date.prototype.toLocaleTimeString()")}}</dt>
<dd>Renvoie la partie « heure » de l'objet <code>Date</code> sous la forme d'une chaîne, en utilisant les conventions locales courantes.</dd>
<dt>{{jsxref("Date.prototype.toSource()")}} {{ Non-standard_inline() }}</dt>
<dd>Renvoie une chaîne de caractères représentant le code source pour un objet <code>Date</code> équivalent ; cette valeur peut être utilisée pour créer un nouvel objet. Remplace la méthode {{jsxref("Object.prototype.toSource()")}}.</dd>
<dt>{{jsxref("Date.prototype.toString()")}}</dt>
<dd>Renvoie une chaîne de caractères représentant l'objet <code>Date</code> spécifié. Remplace la méthode {{jsxref("Object.prototype.toString()")}}.</dd>
<dt>{{jsxref("Date.prototype.toTimeString()")}}</dt>
<dd>Renvoie la partie « heure » de l'objet <code>Date</code> sous la forme d'une chaîne de caractères lisible par humain.</dd>
<dt>{{jsxref("Date.prototype.toUTCString()")}}</dt>
<dd>Convertit une date en une chaîne de caractères, en utilisant le fuseau horaire UTC.</dd>
<dt>{{jsxref("Date.prototype.valueOf()")}}</dt>
<dd>Renvoie la valeur primitive d'un objet <code>Date</code>. Remplace la méthode {{jsxref("Object.prototype.valueOf()")}}.</dd>
</dl>
<h2 id="Spécifications">Spécifications</h2>
<table class="standard-table">
<tbody>
<tr>
<th scope="col">Spécification</th>
<th scope="col">Statut</th>
<th scope="col">Commentaires</th>
</tr>
<tr>
<td>{{SpecName('ES1')}}</td>
<td>{{Spec2('ES1')}}</td>
<td>Définition initiale. Implémentée avec JavaScript 1.1.</td>
</tr>
<tr>
<td>{{SpecName('ES5.1', '#sec-15.9.5', 'Date.prototype')}}</td>
<td>{{Spec2('ES5.1')}}</td>
<td> </td>
</tr>
<tr>
<td>{{SpecName('ES6', '#sec-properties-of-the-date-prototype-object', 'Date.prototype')}}</td>
<td>{{Spec2('ES6')}}</td>
<td> </td>
</tr>
<tr>
<td>{{SpecName('ESDraft', '#sec-properties-of-the-date-prototype-object', 'Date.prototype')}}</td>
<td>{{Spec2('ESDraft')}}</td>
<td> </td>
</tr>
</tbody>
</table>
<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2>
<p>{{Compat("javascript.builtins.Date.prototype")}}</p>
|
