Temporal.PlainDate.prototype.monthsInYear

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Die Zugriffs-Eigenschaft monthsInYear von Temporal.PlainDate Instanzen gibt eine positive ganze Zahl zurück, die die Anzahl der Monate im Jahr dieses Datums darstellt. Sie ist kalenderabhängig (calendar).

Für den ISO 8601-Kalender sind es immer 12 Monate, aber in anderen Kalendersystemen kann diese Zahl variieren. Beispielsweise haben Kalender mit Schaltmonaten in Schaltjahren einen Monat mehr als in gewöhnlichen Jahren.

Der Set-Accessor von monthsInYear ist undefined. Sie können diese Eigenschaft nicht direkt ändern.

Beispiele

Verwendung von monthsInYear

js
const date = Temporal.PlainDate.from("2021-07-01");
console.log(date.monthsInYear); // 12

const date2 = Temporal.PlainDate.from("2021-07-01[u-ca=chinese]");
console.log(date2.monthsInYear); // 12

const date3 = Temporal.PlainDate.from("2023-07-01[u-ca=chinese]");
console.log(date3.monthsInYear); // 13; 2023 is a Chinese leap year

Wechsel zum vorletzten Monat des Jahres

Sie können monthsInYear verwenden, um zum vorletzten Tag des Monats zu wechseln:

js
const date = Temporal.PlainDate.from("2021-07-01");
const secondLastMonth = date.with({ month: date.monthsInYear - 1 });
console.log(secondLastMonth.toString()); // 2021-11-01

Spezifikationen

Specification
Temporal proposal
# sec-get-temporal.plaindate.prototype.monthsinyear

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch