Repository navigation
Expand file tree
/
Copy pathindex.md
More file actions
77 lines (52 loc) · 3.16 KB
/
Copy pathindex.md
File metadata and controls
77 lines (52 loc) · 3.16 KB
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
---
title: Date.prototype.toUTCString()
short-title: toUTCString()
slug: Web/JavaScript/Reference/Global_Objects/Date/toUTCString
l10n:
sourceCommit: 544b843570cb08d1474cfc5ec03ffb9f4edc0166
---
Die Methode **`toUTCString()`** von {{jsxref("Date")}} Instanzen gibt einen String zurück, der dieses Datum im [RFC 7231](https://datatracker.ietf.org/doc/html/rfc7231#section-7.1.1.1) Format darstellt, wobei negative Jahre erlaubt sind. Die Zeitzone ist immer UTC. `toGMTString()` ist ein Alias dieser Methode.
{{InteractiveExample("JavaScript Demo: Date.prototype.toUTCString()", "shorter")}}
```js interactive-example
const event = new Date("14 Jun 2017 00:00:00 PDT");
console.log(event.toUTCString());
// Expected output: "Wed, 14 Jun 2017 07:00:00 GMT"
```
## Syntax
```js-nolint
toUTCString()
```
### Parameter
Keine.
### Rückgabewert
Ein String, der das angegebene Datum unter Verwendung der UTC-Zeitzone darstellt (siehe Beschreibung für das Format). Gibt `"Invalid Date"` zurück, wenn das Datum [ungültig](/de/docs/Web/JavaScript/Reference/Global_Objects/Date#the_epoch_timestamps_and_invalid_date) ist.
## Beschreibung
Der von `toUTCString()` zurückgegebene Wert ist ein String in der Form `Www, dd Mmm yyyy HH:mm:ss GMT`, wobei:
| Format String | Beschreibung |
| ------------- | ------------------------------------------------------------------------- |
| `Www` | Wochentag, als drei Buchstaben (z. B. `Sun`, `Mon`) |
| `dd` | Tag des Monats, als zwei Ziffern mit führender Null, falls erforderlich |
| `Mmm` | Monat, als drei Buchstaben (z. B. `Jan`, `Feb`) |
| `yyyy` | Jahr, als vier oder mehr Ziffern mit führenden Nullen, falls erforderlich |
| `HH` | Stunde, als zwei Ziffern mit führender Null, falls erforderlich |
| `mm` | Minute, als zwei Ziffern mit führender Null, falls erforderlich |
| `ss` | Sekunden, als zwei Ziffern mit führender Null, falls erforderlich |
### Alias
Die `Date` API von JavaScript wurde von der `java.util.Date` Bibliothek von Java inspiriert (während letztere seit Java 1.1 im Jahr 1997 de facto veraltet war). Besonders die `Date` Klasse von Java hatte eine Methode namens `toGMTString` — die schlecht benannt war, weil die [Greenwich Mean Time](https://en.wikipedia.org/wiki/Greenwich_Mean_Time) nicht äquivalent zur [Coordinated Universal Time](https://en.wikipedia.org/wiki/Coordinated_Universal_Time) ist, während JavaScript-Daten immer mit der UTC-Zeit arbeiten. Aus Gründen der Webkompatibilität bleibt `toGMTString` als Alias zu `toUTCString`, und sie verweisen auf dasselbe Funktionsobjekt. Das bedeutet:
```js
Date.prototype.toGMTString.name === "toUTCString";
```
## Beispiele
### Verwendung von toUTCString()
```js
const d = new Date(0);
console.log(d.toUTCString()); // 'Thu, 01 Jan 1970 00:00:00 GMT'
```
## Spezifikationen
{{Specifications}}
## Browser-Kompatibilität
{{Compat}}
## Siehe auch
- {{jsxref("Date.prototype.toLocaleString()")}}
- {{jsxref("Date.prototype.toString()")}}
- {{jsxref("Date.prototype.toISOString()")}}