aboutsummaryrefslogtreecommitdiff
path: root/files/zh-cn/conflicting/web/javascript/reference/global_objects/date/index.html
blob: f43b83c11d5c7f0a7d6ed76849970193c8af5734 (plain)
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
---
title: Date.prototype
slug: conflicting/Web/JavaScript/Reference/Global_Objects/Date
tags:
  - Date
  - JavaScript
  - Property
translation_of: Web/JavaScript/Reference/Global_Objects/Date
translation_of_original: Web/JavaScript/Reference/Global_Objects/Date/prototype
original_slug: Web/JavaScript/Reference/Global_Objects/Date/prototype
---
<div>{{JSRef}}</div>

<p><strong><code>Date.prototype</code></strong> 属性表示{{jsxref("Date")}}构造函数的原型。</p>

<div>{{js_property_attributes(0,0,1)}}</div>

<h2 id="Description" name="Description">描述</h2>

<p>{{jsxref("Date")}}实例继承自<code>Date.prototype</code>。可以通过修改构造函数的原型对象来影响 {{jsxref("Date")}}实例继承的属性和方法。</p>

<p>为了兼容千禧年计算(也即考虑到 2000 年),应该总是指定完整的年份,例如,使用 1998,而不是 98。为了方便以完整的格式指定年份, JavaScript 包含了相应的方法{{jsxref("Global_Objects/Date/getFullYear", "getFullYear()")}}{{jsxref("Global_Objects/Date/setFullYear", "setFullYear()")}}{{jsxref("Global_Objects/Date/getUTCFullYear", "getUTCFullYear()")}}{{jsxref("Global_Objects/Date/setUTCFullYear", "setUTCFullYear()")}}</p>

<p>从 ECMAScript 6 开始,<code>Date.prototype</code>本身就是一个普通的对象。不是{{jsxref("Date")}}的实例。</p>

<h2 id="Properties" name="Properties">属性</h2>

<dl>
 <dt><code>Date.prototype.constructor</code></dt>
 <dd>返回创建该实例的函数。默认是<code>Date</code>构造函数。</dd>
</dl>

<h2 id="Methods" name="Methods">方法</h2>

<h3 id="Getter">Getter</h3>

<dl>
 <dt>{{jsxref("Date.prototype.getDate()")}}</dt>
 <dd>根据本地时间返回指定日期对象的月份中的第几天(1-31)。</dd>
 <dt>{{jsxref("Date.prototype.getDay()")}}</dt>
 <dd>根据本地时间返回指定日期对象的星期中的第几天(0-6)。</dd>
 <dt>{{jsxref("Date.prototype.getFullYear()")}}</dt>
 <dd>根据本地时间返回指定日期对象的年份(四位数年份时返回四位数字)。</dd>
 <dt>{{jsxref("Date.prototype.getHours()")}}</dt>
 <dd>根据本地时间返回指定日期对象的小时(0-23)。</dd>
 <dt>{{jsxref("Date.prototype.getMilliseconds()")}}</dt>
 <dd>根据本地时间返回指定日期对象的毫秒(0-999)。</dd>
 <dt>{{jsxref("Date.prototype.getMinutes()")}}</dt>
 <dd>根据本地时间返回指定日期对象的分钟(0-59)。</dd>
 <dt>{{jsxref("Date.prototype.getMonth()")}}</dt>
 <dd>根据本地时间返回指定日期对象的月份(0-11)。</dd>
 <dt>{{jsxref("Date.prototype.getSeconds()")}}</dt>
 <dd>根据本地时间返回指定日期对象的秒数(0-59)。</dd>
 <dt>{{jsxref("Date.prototype.getTime()")}}</dt>
 <dd>返回从1970-1-1 00:00:00 UTC(协调世界时)到该日期经过的毫秒数,对于1970-1-1 00:00:00 UTC之前的时间返回负值。</dd>
 <dt>{{jsxref("Date.prototype.getTimezoneOffset()")}}</dt>
 <dd>返回当前时区的时区偏移。</dd>
 <dt>{{jsxref("Date.prototype.getUTCDate()")}}</dt>
 <dd>根据世界时返回特定日期对象一个月的第几天(1-31).</dd>
 <dt>{{jsxref("Date.prototype.getUTCDay()")}}</dt>
 <dd>根据世界时返回特定日期对象一个星期的第几天(0-6).</dd>
 <dt>{{jsxref("Date.prototype.getUTCFullYear()")}}</dt>
 <dd>根据世界时返回特定日期对象所在的年份(4位数).</dd>
 <dt>{{jsxref("Date.prototype.getUTCHours()")}}</dt>
 <dd>根据世界时返回特定日期对象当前的小时(0-23).</dd>
 <dt>{{jsxref("Date.prototype.getUTCMilliseconds()")}}</dt>
 <dd>根据世界时返回特定日期对象的毫秒数(0-999).</dd>
 <dt>{{jsxref("Date.prototype.getUTCMinutes()")}}</dt>
 <dd>根据世界时返回特定日期对象的分钟数(0-59).</dd>
 <dt>{{jsxref("Date.prototype.getUTCMonth()")}}</dt>
 <dd>根据世界时返回特定日期对象的月份(0-11).</dd>
 <dt>{{jsxref("Date.prototype.getUTCSeconds()")}}</dt>
 <dd>根据世界时返回特定日期对象的秒数(0-59).</dd>
 <dt>{{jsxref("Date.prototype.getYear()")}}{{deprecated_inline}}</dt>
 <dd>根据特定日期返回年份 (通常 2-3 位数). 使用 {{jsxref("Global_Objects/Date/getFullYear", "getFullYear()")}} .</dd>
</dl>

<h3 id="Setter">Setter</h3>

<dl>
 <dt>{{jsxref("Date.prototype.setDate()")}}</dt>
 <dd>根据本地时间为指定的日期对象设置月份中的第几天。</dd>
 <dt>{{jsxref("Date.prototype.setFullYear()")}}</dt>
 <dd>根据本地时间为指定日期对象设置完整年份(四位数年份是四个数字)。</dd>
 <dt>{{jsxref("Date.prototype.setHours()")}}</dt>
 <dd>根据本地时间为指定日期对象设置小时数。</dd>
 <dt>{{jsxref("Date.prototype.setMilliseconds()")}}</dt>
 <dd>根据本地时间为指定日期对象设置毫秒数。</dd>
 <dt>{{jsxref("Date.prototype.setMinutes()")}}</dt>
 <dd>根据本地时间为指定日期对象设置分钟数。</dd>
 <dt>{{jsxref("Date.prototype.setMonth()")}}</dt>
 <dd>根据本地时间为指定日期对象设置月份。</dd>
 <dt>{{jsxref("Date.prototype.setSeconds()")}}</dt>
 <dd>根据本地时间为指定日期对象设置秒数。</dd>
 <dt>{{jsxref("Date.prototype.setTime()")}}</dt>
 <dd>通过指定从 1970-1-1 00:00:00 UTC 开始经过的毫秒数来设置日期对象的时间,对于早于 1970-1-1 00:00:00 UTC的时间可使用负值。</dd>
 <dt>{{jsxref("Date.prototype.setUTCDate()")}}</dt>
 <dd>根据世界时设置 Date 对象中月份的一天 (1 ~ 31)。</dd>
 <dt>{{jsxref("Date.prototype.setUTCFullYear()")}}</dt>
 <dd>根据世界时设置 Date 对象中的年份(四位数字)。</dd>
 <dt>{{jsxref("Date.prototype.setUTCHours()")}}</dt>
 <dd>根据世界时设置 Date 对象中的小时 (0 ~ 23)。</dd>
 <dt>{{jsxref("Date.prototype.setUTCMilliseconds()")}}</dt>
 <dd>根据世界时设置 Date 对象中的毫秒 (0 ~ 999)。</dd>
 <dt>{{jsxref("Date.prototype.setUTCMinutes()")}}</dt>
 <dd>根据世界时设置 Date 对象中的分钟 (0 ~ 59)。</dd>
 <dt>{{jsxref("Date.prototype.setUTCMonth()")}}</dt>
 <dd>根据世界时设置 Date 对象中的月份 (0 ~ 11)。</dd>
 <dt>{{jsxref("Date.prototype.setUTCSeconds()")}}</dt>
 <dd>根据世界时设置 Date 对象中的秒钟 (0 ~ 59)。</dd>
 <dt>{{jsxref("Date.prototype.setYear()")}} {{deprecated_inline}}</dt>
 <dd>setYear() 方法用于设置年份。请使用 {{jsxref("Global_Objects/Date/setFullYear", "setFullYear()")}} 方法代替。</dd>
</dl>

<h3 id="Conversion_getter">Conversion getter</h3>

<dl>
 <dt>{{jsxref("Date.prototype.toDateString()")}}</dt>
 <dd>以人类易读(human-readable)的形式返回该日期对象日期部分的字符串。</dd>
 <dt>{{jsxref("Date.prototype.toISOString()")}}</dt>
 <dd>把一个日期转换为符合 ISO 8601 扩展格式的字符串。</dd>
 <dt>{{jsxref("Date.prototype.toJSON()")}}</dt>
 <dd>使用 {{jsxref("Global_Objects/Date/toISOString", "toISOString()")}} 返回一个表示该日期的字符串。为了在 {{jsxref("JSON.stringify()")}} 方法中使用。</dd>
 <dt>{{jsxref("Date.prototype.toGMTString()")}} {{deprecated_inline}}</dt>
 <dd>返回一个基于 GMT (UT) 时区的字符串来表示该日期。请使用 {{jsxref("Global_Objects/Date/toUTCString", "toUTCString()")}} 方法代替。</dd>
 <dt>{{jsxref("Date.prototype.toLocaleDateString()")}}</dt>
 <dd>返回一个表示该日期对象日期部分的字符串,该字符串格式与系统设置的地区关联(locality sensitive)。</dd>
 <dt>{{jsxref("Date.prototype.toLocaleFormat()")}} {{non-standard_inline}}</dt>
 <dd>使用格式字符串将日期转换为字符串。</dd>
 <dt>{{jsxref("Date.prototype.toLocaleString()")}}</dt>
 <dd>返回一个表示该日期对象的字符串,该字符串与系统设置的地区关联(locality sensitive)。覆盖了 {{jsxref("Global_Objects/Object/toLocaleString", "Object.prototype.toLocaleString()")}} 方法。</dd>
 <dt>{{jsxref("Date.prototype.toLocaleTimeString()")}}</dt>
 <dd>返回一个表示该日期对象时间部分的字符串,该字符串格式与系统设置的地区关联(locality sensitive)。</dd>
 <dt>{{jsxref("Date.prototype.toSource()")}}{{non-standard_inline}}</dt>
 <dd>返回一个与{{jsxref("Date")}}等价的原始字符串对象,你可以使用这个值去生成一个新的对象。重写了 {{jsxref("Object.prototype.toSource()")}} 这个方法。</dd>
 <dt>{{jsxref("Date.prototype.toString()")}}</dt>
 <dd>返回一个表示该日期对象的字符串。覆盖了{{jsxref("Object.prototype.toString()")}} 方法。</dd>
 <dt>{{jsxref("Date.prototype.toTimeString()")}}</dt>
 <dd>以人类易读格式返回日期对象时间部分的字符串。</dd>
 <dt>{{jsxref("Date.prototype.toUTCString()")}}</dt>
 <dd>把一个日期对象转换为一个以UTC时区计时的字符串。</dd>
 <dt>{{jsxref("Date.prototype.valueOf()")}}</dt>
 <dd>返回一个日期对象的原始值。覆盖了 {{jsxref("Object.prototype.valueOf()")}} 方法。</dd>
</dl>

<h2 id="规范">规范</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
  <tr>
   <td>{{SpecName('ES1')}}</td>
   <td>{{Spec2('ES1')}}</td>
   <td>Initial definition. Implemented in 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="浏览器兼容性">浏览器兼容性</h2>

<p>{{Compat("javascript.builtins.Date.prototype")}}</p>