Date.prototype.setDate()

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 setDate()-Methode von Date-Instanzen ändert den Tag des Monats für dieses Datum gemäß der lokalen Zeit.

Probieren Sie es aus

const event = new Date("August 19, 1975 23:15:30");

event.setDate(24);

console.log(event.getDate());
// Expected output: 24

event.setDate(32);
// Only 31 days in August!

console.log(event.getDate());
// Expected output: 1

Syntax

js
setDate(dateValue)

Parameter

dateValue

Ein ganzzahliger Wert, der den Tag des Monats darstellt.

Rückgabewert

Ändert das Date-Objekt direkt und gibt dessen neuen Zeitstempel zurück. Wenn dateValue NaN ist (oder andere Werte, die zu NaN umgewandelt werden, wie z. B. undefined), wird das Datum auf Ungültiges Datum gesetzt, und es wird NaN zurückgegeben.

Beschreibung

Wenn Sie eine Zahl außerhalb des erwarteten Bereichs angeben, werden die Datumsinformationen im Date-Objekt entsprechend aktualisiert. Zum Beispiel, wenn das Date-Objekt den 1. Juni enthält, ändert ein dateValue von 40 das Datum auf den 10. Juli, während ein dateValue von 0 das Datum auf den letzten Tag des vorherigen Monats, den 31. Mai, ändert.

Beispiele

Verwendung von setDate()

js
const theBigDay = new Date(1962, 6, 7, 12); // noon of 1962-07-07 (7th of July 1962, month is 0-indexed)
const theBigDay2 = new Date(theBigDay).setDate(24); // 1962-07-24 (24th of July 1962)
const theBigDay3 = new Date(theBigDay).setDate(32); // 1962-08-01 (1st of August 1962)
const theBigDay4 = new Date(theBigDay).setDate(22); // 1962-07-22 (22nd of July 1962)
const theBigDay5 = new Date(theBigDay).setDate(0); // 1962-06-30 (30th of June 1962)
const theBigDay6 = new Date(theBigDay).setDate(98); // 1962-10-06 (6th of October 1962)
const theBigDay7 = new Date(theBigDay).setDate(-50); // 1962-05-11 (11th of May 1962)

Spezifikationen

Specification
ECMAScript® 2025 Language Specification
# sec-date.prototype.setdate

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
setDate

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch