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
|
---
title: Date.prototype.getYear()
slug: Web/JavaScript/Reference/Global_Objects/Date/getYear
translation_of: Web/JavaScript/Reference/Global_Objects/Date/getYear
---
<div>{{JSRef("Global_Objects", "Date")}} {{Deprecated_header("")}}</div>
<p>getYear() 方法返回指定的本地日期的年份。因为 <code>getYear</code> 不返回千禧年[full years] ("year 2000 problem")，所以这个方法不再被使用，现在替换为 {{jsxref("Date.getFullYear", "getFullYear")}} .</p>
<h2 id="Syntax" name="Syntax">Syntax</h2>
<pre class="syntaxbox"><code>dateObj.getYear() </code></pre>
<h3 id="Parameters" name="Parameters">Parameters</h3>
<p>None.</p>
<h3 id="Description" name="Description">Returns</h3>
<p>The <code>getYear</code> method returns the year minus 1900; thus:</p>
<ul>
<li>For years greater than or equal to 2000, the value returned by <code>getYear</code> is 100 or greater. For example, if the year is 2026, <code>getYear</code> returns 126.</li>
<li>For years between and including 1900 and 1999, the value returned by <code>getYear</code> is between 0 and 99. For example, if the year is 1976, <code>getYear</code> returns 76.</li>
<li>For years less than 1900, the value returned by <code>getYear</code> is less than 0. For example, if the year is 1800, <code>getYear</code> returns -100.</li>
</ul>
<p>To take into account years before and after 2000, you should use {{jsxref("Date.getFullYear", "getFullYear()")}} instead of <code>getYear</code> so that the year is specified in full.</p>
<h2 id="Backward_Compatibility" name="Backward_Compatibility">Backward Compatibility</h2>
<h3 id="JavaScript_1.2_and_earlier" name="JavaScript_1.2_and_earlier">Behaviour in JavaScript 1.2 and earlier</h3>
<p>The <code>getYear</code> method returns either a 2-digit or 4-digit year:</p>
<ul>
<li>For years between and including 1900 and 1999, the value returned by <code>getYear</code> is the year minus 1900. For example, if the year is 1976, the value returned is 76.</li>
<li>For years less than 1900 or greater than 1999, the value returned by <code>getYear</code> is the four-digit year. For example, if the year is 1856, the value returned is 1856. If the year is 2026, the value returned is 2026.</li>
</ul>
<h2 id="Examples" name="Examples">Examples</h2>
<h3 id="Example:_Years_between_1900_and_1999" name="Example:_Years_between_1900_and_1999">Example: Years between 1900 and 1999</h3>
<p>The second statement assigns the value 95 to the variable <code>year</code>.</p>
<pre class="brush:js">var Xmas = new Date("December 25, 1995 23:15:00");
var year = Xmas.getYear(); // returns 95
</pre>
<h3 id="Example:_Years_above_1999" name="Example:_Years_above_1999">Example: Years above 1999</h3>
<p>The second statement assigns the value 100 to the variable <code>year</code>.</p>
<pre class="brush:js">var Xmas = new Date("December 25, 2000 23:15:00");
var year = Xmas.getYear(); // returns 100
</pre>
<h3 id="Example:_Years_below_1900" name="Example:_Years_below_1900">Example: Years below 1900</h3>
<p>The second statement assigns the value -100 to the variable <code>year</code>.</p>
<pre class="brush:js">var Xmas = new Date("December 25, 1800 23:15:00");
var year = Xmas.getYear(); // returns -100
</pre>
<h3 id="Example:_Setting_and_getting_a_year_between_1900_and_1999" name="Example:_Setting_and_getting_a_year_between_1900_and_1999">Example: Setting and getting a year between 1900 and 1999</h3>
<p>The second statement assigns the value 95 to the variable <code>year</code>, representing the year 1995.</p>
<pre class="brush:js">var Xmas.setYear(95);
var year = Xmas.getYear(); // returns 95
</pre>
<h2 id="Specifications">Specifications</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>ECMAScript 1st Edition. Implemented in JavaScript 1.0</td>
<td>Standard</td>
<td>Initial definition.</td>
</tr>
<tr>
<td>{{SpecName('ES5.1', '#sec-B.2.4', 'Date.prototype.getYear')}}</td>
<td>{{Spec2('ES5.1')}}</td>
<td>Defined in the (informative) compatibility annex.</td>
</tr>
<tr>
<td>{{SpecName('ES6', '#sec-date.prototype.getyear', 'Date.prototype.getYear')}}</td>
<td>{{Spec2('ES6')}}</td>
<td>Defined in the (normative) annex for additional features for web browsers.</td>
</tr>
</tbody>
</table>
<h2 id="Browser_compatibility">Browser compatibility</h2>
<p>{{Compat("javascript.builtins.Date.getYear")}}</p>
<h2 id="See_Also" name="See_Also">See also</h2>
<ul>
<li>{{jsxref("Date.prototype.getFullYear()")}}</li>
<li>{{jsxref("Date.prototype.getUTCFullYear()")}}</li>
<li>{{jsxref("Date.prototype.setYear()")}}</li>
</ul>
|
