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
|
---
title: Date.UTC()
slug: Web/JavaScript/Reference/Global_Objects/Date/UTC
tags:
- Date
- JavaScript
- Method
- Reference
translation_of: Web/JavaScript/Reference/Global_Objects/Date/UTC
---
<div>{{JSRef}}</div>
<p>Die <strong><code>Date.UTC()</code></strong> Methode akzeptiert die gleichen Parameter, wie der längste Konstruktor von {{jsxref("Date")}} und gibt die Anzahl der Millisekunden seit dem 1. Januar 1970 00:00:00 UTC zurück.</p>
<div>{{EmbedInteractiveExample("pages/js/date-utc.html")}}</div>
<h2 id="Syntax">Syntax</h2>
<pre class="syntaxbox"><code>Date.UTC(<var>year</var>, <var>month</var>[, <var>day</var>[, <var>hour</var>[, <var>minute</var>[, <var>second</var>[, <var>millisecond</var>]]]]])</code></pre>
<h3 id="Parameter">Parameter</h3>
<dl>
<dt><code>year</code></dt>
<dd>Ein volles Jahr</dd>
<dt><code>month</code></dt>
<dd>Eine ganze Zahl zwischen 0 und 11, die den Monat repräsentiert.</dd>
<dt><code>day</code></dt>
<dd>Optional. Eine ganze Zahl zwischen 1 und 31 den Tag des Monats repräsentiert.</dd>
<dt><code>hour</code></dt>
<dd>Optional. Eine ganze Zahl zwischen 0 und 23, die die Stunde des Tages repräsentiert.</dd>
<dt><code>minute</code></dt>
<dd>Optional. Eine ganze Zahl zwischen 0 und 59, die die Minute der Stunde repräsentiert.</dd>
<dt><code>second</code></dt>
<dd>Optional. Eine ganze Zahl zwischen 0 und 59, die die Sekunden der Minute repräsentiert.</dd>
<dt><code>millisecond</code></dt>
<dd>Optional. Eine ganze Zahl zwischen 0 und 999, die die Millisekunden einer Sekunde repräsentiert.</dd>
</dl>
<h3 id="Rückgabewert">Rückgabewert</h3>
<p>Eine Zahl, die die Anzahl der Millisekunden des gegebenen {{jsxref("Date")}} Objektes, die seit dem 1. Januar 1970 00:00:00 Weltzeit (UTC) vergangen sind, repräsentiert.</p>
<h2 id="Beschreibung">Beschreibung</h2>
<p>Die <code>UTC()</code> Methode bekommt mit Komma getrennte Parameter des Datums / der Zeit und gibt die Anzahl der Millisekunden seit dem 1. Januar 1970 in Weltzeit zurück.</p>
<p>Es muss ein volles Jahr für <code>year</code> spezifiziert werden (z. B. 1998). Wenn ein Jahr zwischen 0 und 99 ist, wird die Methode das Jahr zu einem Jahr im zwanzigsten Jahrhundert konvertieren (<code>1900 + year</code>). Zum Beispiel wird 95 zu 1995 konvertiert.</p>
<p>Die <code>UTC()</code> Methode unterscheidet sich in zwei Punkten von dem {{jsxref("Date")}} Konstruktor:</p>
<ul>
<li><code>Date.UTC()</code> benutzt die Weltzeit anstatt der Ortszeit.</li>
<li><code>Date.UTC()</code> gibt die Zeit als Ganzzahl zurück anstatt ein {{jsxref("Date")}} Objekt zu erzeugen.</li>
</ul>
<p>Wenn ein Parameter außerhalb seiner spezifizierten Grenzen ist, wird die <code>UTC()</code> Methode andere Parameter verändern, um den Wert zu realisieren. Wird zum Beispiel 15 als Monat angegeben, so wird das Jahr um 1 inkrementiert (<code>year + 1</code>) und der Monat wird auf 3 gesetzt.</p>
<p>Weil <code>UTC()</code> eine statische Methode von {{jsxref("Date")}} ist, wird sie immer als <code>Date.UTC()</code> genutzt und nicht als Methode einer {{jsxref("Date")}} Instanz.</p>
<h2 id="Beispiele">Beispiele</h2>
<h3 id="Einsatz_von_Date.UTC()">Einsatz von <code>Date.UTC()</code></h3>
<p>Im folgenden Beispiel wird ein {{jsxref("Date")}} Objekt mithilfe der UTC (nicht der Ortszeit) erstellt:</p>
<pre class="brush:js">var utcDate = new Date(Date.UTC(2018, 11, 1, 0, 0, 0));
</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('ESDraft', '#sec-date.utc', 'Date.UTC')}}</td>
<td>{{Spec2('ESDraft')}}</td>
<td> </td>
</tr>
<tr>
<td>{{SpecName('ES6', '#sec-date.utc', 'Date.UTC')}}</td>
<td>{{Spec2('ES6')}}</td>
<td> </td>
</tr>
<tr>
<td>{{SpecName('ES5.1', '#sec-15.9.4.3', 'Date.UTC')}}</td>
<td>{{Spec2('ES5.1')}}</td>
<td> </td>
</tr>
<tr>
<td>{{SpecName('ES1')}}</td>
<td>{{Spec2('ES1')}}</td>
<td>Initiale Definition. Implementiert in JavaScript 1.0.</td>
</tr>
</tbody>
</table>
<h2 id="Browserkompatibilität">Browserkompatibilität</h2>
<p class="hidden">The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> and send us a pull request.</p>
<p>{{Compat("javascript.builtins.Date.UTC")}}</p>
<h2 id="Anmerkungen_zur_Kompatibilität">Anmerkungen zur Kompatibilität</h2>
<h3 id="Date.UTC_mit_weniger_als_zwei_Argumenten"><code>Date.UTC</code> mit weniger als zwei Argumenten</h3>
<p>Wenn <code>Date.UTC</code> weniger als zwei Argumenten erhält, wird {{jsxref("NaN")}} zurückgegeben. Dieses Verhalten wurde in ECMAScript 2017 spezifiziert. Umgebungen, welche dieses Verhalten nicht unterstützen, werden aktualisiert (siehe {{bug(1050755)}}, <a href="https://github.com/tc39/ecma262/pull/642">ecma-262 #642</a>).</p>
<pre class="brush: js">Date.UTC();
Date.UTC(1);
// Safari: NaN
// Chrome/Opera/V8: NaN
// Firefox <54: nicht NaN
// Firefox 54+: NaN
// IE: nicht NaN
// Edge: NaN
</pre>
<h2 id="Siehe_auch">Siehe auch</h2>
<ul>
<li>{{jsxref("Date.parse()")}}</li>
</ul>
|
