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
|
---
title: Date.prototype.getYear()
slug: Web/JavaScript/Reference/Global_Objects/Date/getYear
tags:
- Date
- Deprecated
- JavaScript
- Method
- Prototype
- Reference
translation_of: Web/JavaScript/Reference/Global_Objects/Date/getYear
---
<div>{{JSRef}} {{deprecated_header}}</div>
<p>Die <strong><code>getYear()</code></strong> Methode gibt das Jahr eines Datums bezüglich der Ortszeit zurück. Weil <code>getYear()</code> nicht das ganze Jahr zurück gibt (das "Jahr 2000 Problem"), wird es nicht weiter eingesetzt und wird von der Methode {{jsxref("Date.prototype.getFullYear", "getFullYear()")}} ersetzt.</p>
<h2 id="Syntax">Syntax</h2>
<pre class="syntaxbox"><code><var>dateObj</var>.getYear()</code></pre>
<h3 id="Rückgabewert">Rückgabewert</h3>
<p>Eine Zahl, welche das Jahr minus 1900 des gegebenen Datums bezüglich der lokalen Zeit angibt.</p>
<h2 id="Beschreibung">Beschreibung</h2>
<ul>
<li>Für Jahre größer oder gleich 2000 ist der Rückgabewert von <code>getYear()</code> 100 oder größer. Zum Beispiel wird für das Jahr 2026 der Wert 126 zurück gegeben.</li>
<li>Für Jahre zwischen 1900 und 1999 ist der Rückgabewert von <code>getYear()</code> zwischen 0 und 99. Zum Beispiel wird für das Jahr 1976 der Wert 76 zurückgegeben.</li>
<li>Für Jahre kleiner als 1900 ist der Rückgabewert von <code>getYear()</code> kleiner 0. Zum Beispiel wird für das Jahr 1800 der Wert -100 zurück gegeben.</li>
</ul>
<p>Um mit Jahren vor und nach 2000 umgehen zu können, sollte stattdessen die Methode {{jsxref("Date.prototype.getFullYear", "getFullYear()")}} eingesetzt werden. Diese gibt das vollständige Jahr zurück.</p>
<h2 id="Rückwärtskompatibilität">Rückwärtskompatibilität</h2>
<h3 id="Verhalten_in_JavaScript_1.2_und_früher">Verhalten in JavaScript 1.2 und früher</h3>
<p>Die <code>getYear()</code> Methode gibt entweder ein 2-stelliges oder 4-stelliges Jahr zurück.</p>
<ul>
<li>Für Jahre zwischen 1900 (inklusiv) und 1999 (inklusiv) gibt <code>getYear()</code> das Jahr minus 1900 zurück. Zum Beispiel wird für das Jahr 1976 der Wert 76 zurückgegeben.</li>
<li>Für Jahre kleiner als 1900 oder größer als 1999 gibt die <code>getYear()</code> eine 4-stellige Jahreszahl zurück. Zum Beispiel wird für das Jahr 1856 der Wert 1856 zurückgegeben. Für das Jahr 2026 wird der Wert 2026 zurückgegeben.</li>
</ul>
<h2 id="Beispiele">Beispiele</h2>
<h3 id="Jahre_zwischen_1900_und_1999">Jahre zwischen 1900 und 1999</h3>
<p>Das zweite Statement initialisiert die Variable <code>year</code> mit dem Wert 95.</p>
<pre class="brush: js">var Xmas = new Date('December 25, 1995 23:15:00');
var year = Xmas.getYear(); // returns 95
</pre>
<h3 id="Jahre_nach_1999">Jahre nach 1999</h3>
<p>Das zweite Statement initialisiert die Variable <code>year</code> mit dem Wert 100.</p>
<pre class="brush: js">var Xmas = new Date('December 25, 2000 23:15:00');
var year = Xmas.getYear(); // returns 100
</pre>
<h3 id="Jahre_vor_1900">Jahre vor 1900</h3>
<p>Das zweite Statement initialisiert die Variable <code>year</code> mit dem Wert -100.</p>
<pre class="brush: js">var Xmas = new Date('December 25, 1800 23:15:00');
var year = Xmas.getYear(); // returns -100
</pre>
<h3 id="Setzen_und_bekommen_von_Jahren_zwischen_1900_und_1999">Setzen und bekommen von Jahren zwischen 1900 und 1999</h3>
<p>Das zweite Statement initialisiert die Variable <code>year</code> mit dem Wert 95, was für das Jahr 1995 steht.</p>
<pre class="brush: js">var Xmas = new Date('December 25, 2015 23:15:00');
Xmas.setYear(95);
var year = Xmas.getYear(); // returns 95
</pre>
<h2 id="Spezifikationen">Spezifikationen</h2>
<table class="standard-table">
<tbody>
<tr>
<th scope="col">Spezifikation</th>
<th scope="col">Status</th>
<th scope="col">Kommentar</th>
</tr>
<tr>
<td>{{SpecName('ES1')}}</td>
<td>{{Spec2('ES1')}}</td>
<td>Initiale Definition. Implementiert in JavaScript 1.3.</td>
</tr>
<tr>
<td>{{SpecName('ES5.1', '#sec-B.2.4', 'Date.prototype.getYear')}}</td>
<td>{{Spec2('ES5.1')}}</td>
<td>
<p>Definiert in dem (informativen) Kompatibilitäts-Anhang</p>
</td>
</tr>
<tr>
<td>{{SpecName('ES6', '#sec-date.prototype.getyear', 'Date.prototype.getYear')}}</td>
<td>{{Spec2('ES6')}}</td>
<td><span id="result_box" lang="de"><span>Definiert in</span> dem <span>(normativ)</span> <span>Anhang</span> <span>für</span> <span>zusätzliche Funktionen</span> <span>für Web-Browser</span><span>.</span></span></td>
</tr>
<tr>
<td>{{SpecName('ESDraft', '#sec-date.prototype.getyear', 'Date.prototype.getYear')}}</td>
<td>{{Spec2('ESDraft')}}</td>
<td> </td>
</tr>
</tbody>
</table>
<h2 id="Browserkompatibilität">Browserkompatibilität</h2>
<p>{{Compat("javascript.builtins.Date.getYear")}}</p>
<h2 id="Siehe_auch">Siehe auch</h2>
<ul>
<li>{{jsxref("Date.prototype.getFullYear()")}}</li>
<li>{{jsxref("Date.prototype.getUTCFullYear()")}}</li>
<li>{{jsxref("Date.prototype.setYear()")}}</li>
</ul>
|
