Temporal.Duration.prototype.months

Аксессорная собственность months экземпляров Temporal.Duration возвращает целое число, представляющее количество месяцев в продолжительности.

Если продолжительность не сбалансирована, вы не можете предполагать диапазон этого значения, но вы можете знать его знак, проверив свойство sign продолжительности. Если она сбалансирована до единицы выше месяцев, абсолютное значение months зависит от календаря (сколько месяцев в году).

Аксессор установки months является undefined. Вы не можете изменить это свойство напрямую. Используйте метод with() для создания нового объекта Temporal.Duration с желаемым новым значением.

Примеры

Использование месяцев

const d1 = Temporal.Duration.from({ years: 1, months: 1 });
const d2 = Temporal.Duration.from({ years: -1, months: -1 });
const d3 = Temporal.Duration.from({ years: 1 });
const d4 = Temporal.Duration.from({ months: 12 });

console.log(d1.months); // 1
console.log(d2.months); // -1
console.log(d3.months); // 0
console.log(d4.months); // 12

// Balance d4
const d4Balanced = d4.round({
  largestUnit: "years",
  relativeTo: Temporal.PlainDate.from("2021-01-01"), // ISO 8601 calendar
});
console.log(d4Balanced.months); // 0
console.log(d4Balanced.years); // 1

Спецификации

Совместимость с браузерами

См. также

• Temporal.Duration
• Temporal.Duration.prototype.years
• Temporal.Duration.prototype.weeks
• Temporal.Duration.prototype.days
• Temporal.Duration.prototype.hours
• Temporal.Duration.prototype.minutes
• Temporal.Duration.prototype.seconds
• Temporal.Duration.prototype.milliseconds
• Temporal.Duration.prototype.microseconds
• Temporal.Duration.prototype.nanoseconds