Date.prototype.toUTCString()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die toUTCString() Methode von Date Instanzen gibt eine Zeichenkette zurück, die dieses Datum im RFC 7231-Format darstellt, wobei negative Jahre erlaubt sind. Die Zeitzone ist immer UTC. toGMTString() ist ein Alias dieser Methode.

Probieren Sie es aus

Syntax

js
toUTCString()

Parameter

Keine.

Rückgabewert

Eine Zeichenkette, die 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 ist.

Beschreibung

Der von toUTCString() zurückgegebene Wert ist eine Zeichenkette in der Form Www, dd Mmm yyyy HH:mm:ss GMT, wobei:

Formatzeichenfolge Beschreibung
Www Wochentag, in drei Buchstaben (z.B. Sun, Mon)
dd Tag des Monats, in zwei Ziffern mit führender Null falls erforderlich
Mmm Monat, in drei Buchstaben (z.B. Jan, Feb)
yyyy Jahr, in vier oder mehr Ziffern mit führenden Nullen falls erforderlich
HH Stunde, in zwei Ziffern mit führender Null falls erforderlich
mm Minute, in zwei Ziffern mit führender Null falls erforderlich
ss Sekunden, in zwei Ziffern mit führender Null falls erforderlich

Aliasing

Die Date API von JavaScript wurde von der java.util.Date Bibliothek von Java inspiriert (wobei letztere ab Java 1.1 im Jahr 1997 de facto veraltet war). Insbesondere hatte die Java Date Klasse eine Methode namens toGMTString – die schlecht benannt war, da die Greenwich Mean Time nicht gleichbedeutend mit der koordinierten Weltzeit ist, während JavaScript-Daten immer nach UTC-Zeit arbeiten. Aus Gründen der Web-Kompatibilität bleibt toGMTString als Alias für toUTCString, und sie beziehen sich 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

Specification
ECMAScript Language Specification
# sec-date.prototype.toutcstring

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch