Temporal.PlainDate.prototype.dayOfYear

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 dayOfYear Zugriffs-Eigenschaft von Temporal.PlainDate Instanzen gibt eine positive ganze Zahl zurück, die den 1-basierten Tag im Jahr dieses Datums darstellt. Der erste Tag des Jahres ist 1, und der letzte Tag ist der daysInYear. Dies ist vom Kalender abhängig.

Der Set-Accessor von dayOfYear ist undefined. Sie können diese Eigenschaft nicht direkt ändern. Um ein neues Temporal.PlainDate-Objekt mit dem gewünschten neuen Wert für dayOfYear zu erstellen, verwenden Sie die Methode add() oder subtract() mit der passenden Anzahl von days.

Beispiele

Verwenden von dayOfYear

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

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

const date3 = Temporal.PlainDate.from("2020-07-01");
console.log(date3.dayOfYear); // 183; 2020 is a leap year

Ändern von dayOfYear

PlainDate unterstützt das direkte Ändern von dayOfYear nicht. Um den Tag des Jahres zu ändern, müssen Sie zunächst den Unterschied in Tagen zu Ihrem gewünschten Tag des Jahres ermitteln, dann add oder subtract verwenden, um das Datum entsprechend anzupassen. Um beispielsweise auf den 100. Tag dieses Jahres zu wechseln (egal ob davor oder danach):

js
function getDayInSameYear(date, destDayOfYear) {
  return date.add({ days: destDayOfYear - date.dayOfYear });
}

console.log(
  getDayInSameYear(Temporal.PlainDate.from("2021-07-01"), 100).toString(),
); // 2021-04-10
console.log(
  getDayInSameYear(Temporal.PlainDate.from("2021-01-01"), 100).toString(),
); // 2021-04-10
console.log(
  getDayInSameYear(Temporal.PlainDate.from("2020-01-01"), 100).toString(),
); // 2020-04-09

Standardmäßig beschränkt with() den Tag auf den Bereich der gültigen Werte. Sie können also immer { month: 1, day: 1 } verwenden, um den Tag auf den ersten Tag des Jahres zu setzen, selbst wenn der erste Tag nicht die Nummer 1 hat. Ebenso wird das Folgende den Tag auf den letzten Tag des Jahres setzen, unabhängig davon, wie viele Tage im letzten Monat oder Jahr sind:

js
const date = Temporal.PlainDate.from("2021-07-01");
const lastDay = date.with({ month: Number.MAX_VALUE, day: Number.MAX_VALUE }); // 2021-12-31

Spezifikationen

Specification
Temporal
# sec-get-temporal.plaindate.prototype.dayofyear

Browser-Kompatibilität

Siehe auch