Date.prototype.setUTCMonth()

Метод setUTCMonth() экземпляров Date изменяет месяц и/или день месяца для этой даты в соответствии с универсальным временем (UTC).

Попробовать

const event = new Date("December 31, 1975 23:15:30 GMT-3:00");

console.log(event.toUTCString());
// Expected output: "Thu, 01 Jan 1976 02:15:30 GMT"

console.log(event.getUTCMonth());
// Expected output: 0

event.setUTCMonth(11);

console.log(event.toUTCString());
// Expected output: "Wed, 01 Dec 1976 02:15:30 GMT"

Синтаксис

setUTCMonth(monthValue)
setUTCMonth(monthValue, dateValue)

Параметры

monthValue

Целое число, представляющее месяц: 0 для января, 1 для февраля и так далее.

dateValue Необязательно

Целое число от 1 до 31, представляющее день месяца.

Возвращаемое значение

Изменяет объект Date на месте и возвращает его новую отметку времени. Если параметр имеет значение NaN (или другие значения, которые приводятся к NaN, такие как undefined), дата устанавливается как Invalid Date, и возвращается NaN.

Описание

Если вы не указываете параметр dateValue, используется значение, возвращаемое методом getUTCDate().

Если указанный вами параметр выходит за пределы ожидаемого диапазона, setUTCMonth() пытается соответствующим образом обновить информацию о дате в объекте Date. Например, если вы используете 15 для monthValue, год будет увеличен на 1, а в качестве месяца будет использовано значение 3.

Примеры

Использование setUTCMonth()

const theBigDay = new Date();
theBigDay.setUTCMonth(11);

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

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

См. также

• Date.prototype.getUTCMonth()
• Date.prototype.setMonth()