Temporal.PlainDate.prototype.monthCode

Wert

Das Grundformat von monthCode ist M plus einer zweistelligen Monatsnummer. Für Schaltmonate ist es der Code des vorherigen Monats, gefolgt von L (auch wenn es konzeptionell ein Derivat des folgenden Monats ist; zum Beispiel im hebräischen Kalender hat Adar I den Code M05L, aber Adar II den Code M06).

Alle Kalender haben mindestens 12 Monate mit Codes von "M01" bis "M12".

Alle spezifizierten Kalender haben im Standard vollständig definierte Monatscodes. Die meisten haben keine von iso8601 abweichenden Monatsregeln. Die koptischen, ethioaa und äthiopischen Kalender haben einen zusätzlichen M13 Monat. Die chinesischen und dangi Kalender haben 12 zusätzliche Schaltmonate, mit Codes von "M01L" bis "M12L". Der hebräische Kalender hat einen Schaltmonat, "M05L" (Adar I).

Der set-Zugriff von monthCode ist undefined. Sie können diese Eigenschaft nicht direkt ändern. Verwenden Sie die with()-Methode, um ein neues Temporal.PlainDate-Objekt mit dem gewünschten neuen Wert zu erstellen.

Wenn das Datum auf ein anderes Jahr gesetzt wird, bleibt der monthCode gleich, aber der month kann sich ändern, wenn das Zieljahr eine andere Schaltmonatsstruktur hat. Wenn der aktuelle monthCode im Zieljahr nicht existiert und die Methode nicht konfiguriert ist, um dies abzulehnen, wird bei den chinesischen und dangi Kalendern der vorherige Monat verwendet (z. B. von "M03L" zu "M03", was von 闰三月 zu 三月 ist). Für hebräisch wird stattdessen der nächste Monat verwendet (von "M05L" zu "M06", was von Adar I zu Adar II ist).

Beispiele

Verwendung von monthCode

const date = Temporal.PlainDate.from("2021-07-01"); // ISO 8601 calendar
console.log(date.monthCode); // "M07"
console.log(date.month); // 7

const date2 = Temporal.PlainDate.from("2021-05-01[u-ca=chinese]");
console.log(date2.monthCode); // "M03"
console.log(date2.month); // 3; it is March 20 in the Chinese calendar

const date3 = Temporal.PlainDate.from("2023-05-01[u-ca=chinese]");
console.log(date3.monthCode); // "M03"
console.log(date3.month); // 4, although it is also March (M03)!

const date4 = Temporal.PlainDate.from("2023-04-01[u-ca=chinese]");
console.log(date4.monthCode); // "M02L"
console.log(date4.month); // 3, this month is a leap month, i.e. a duplicate February

Änderung von monthCode

const date = Temporal.PlainDate.from("2021-07-01");
const newDate = date.with({ month: 2 });
console.log(newDate.toString()); // 2021-02-01

Sie können auch add() oder subtract() verwenden, um eine bestimmte Anzahl von Monaten vom aktuellen Datum aus zu verschieben.

const date = Temporal.PlainDate.from("2021-07-01");
const newDate = date.add({ months: 3 });
console.log(newDate.toString()); // 2021-10-01

Standardmäßig schränkt with() den Tag auf den Bereich gültiger Werte ein. Beide der folgenden Beispiele setzen den Monat auf den letzten Monat des Jahres:

const date = Temporal.PlainDate.from("2021-07-01");
const lastMonth = date.with({ month: date.monthsInYear }); // 2021-12-01
const lastMonth2 = date.with({ month: Number.MAX_VALUE }); // 2021-12-01

Formatierung von Monatsnamen

Machen Sie folgendes nicht:

const names = [
  "January", "February", "March", "April", "May", "June",
  "July", "August", "September", "October", "November", "December",
];

const date = Temporal.PlainDate.from("2021-07-01");
console.log(names[date.month - 1]); // July

Machen Sie auch folgendes nicht:

const names = {
  "M01": "January", "M02": "February", "M03": "March", "M04": "April",
  "M05": "May", "M06": "June", "M07": "July", "M08": "August",
  "M09": "September", "M10": "October", "M11": "November", "M12": "December",
};

const date = Temporal.PlainDate.from("2021-07-01");
console.log(names[date.monthCode]); // July

Stattdessen sollten Sie immer folgendes tun, da es benutzerfreundlicher und weniger fehleranfällig ist und sich leicht auf andere Kalender verallgemeinern lässt:

const date = Temporal.PlainDate.from("2021-07-01");
console.log(
  date.toLocaleString("en-US", { calendar: date.calendarId, month: "long" }),
); // July

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Temporal.PlainDate
• Temporal.PlainDate.prototype.with()
• Temporal.PlainDate.prototype.add()
• Temporal.PlainDate.prototype.subtract()
• Temporal.PlainDate.prototype.year
• Temporal.PlainDate.prototype.month
• Temporal.PlainDate.prototype.daysInMonth
• Temporal.PlainDate.prototype.monthsInYear