Date.prototype.setMonth()

El método setMonth() establece el mes para una fecha específica de acuerdo con el año establecido actualmente.

Sintaxis

dateObj.setMonth(monthValue[,dayValue])

Versiones anteriores a JavaScript 1.3

dateObj.setMonth(monthValue)

Parámetros

monthValue
Un entero entre 0 y 11, representando los meses de Enero a Diciembre.
dayValue
Opcional. Un entero de 1 a 31, representando el dia del mes.

Resultado

El valor retornado es el número de milisegundos entre el 1 de Enero de 1970 00:00:00 UTC y la fecha actualizada.

Descripción

Si no especificas el parámetro dayValue, el valor retornado del metodo getDate() es usado.

Si un parámetro especificado esta fuera del rango esperado, setMonth() intenta actualizar la información de la fecha en el objeto Date en consecuencia. Por ejemplo, si usted usa 15 para monthValue, usa 12 para incrementar el año en 1, y los 3 restantes para calcular el mes.

El día actual del mes tendrá un impacto en el comportamiento de este método. Conceptualmente agregará el número de días dados por el día actual del mes al primer día del nuevo mes especificado como parámetro, para devolver la nueva fecha. Por ejemplo, si el valor actual es el 31 de agosto de 2016, llamar a setMonth con un valor de 1 devolverá el 2 de marzo de 2016. Esto se debe a que en febrero de 2016 tuvo 29 días.

Ejemplos

Usando setMonth()

var theBigDay = new Date();
theBigDay.setMonth(6);

//Cuidado con las transiciones de fin de mes
var endOfMonth = new Date(2016, 7, 31);
endOfMonth.setMonth(1);
console.log(endOfMonth); //Wed Mar 02 2016 00:00:00

Especificaciones

Especificación
ECMAScript (ECMA-262)
La definición de 'Date.prototype.setMonth' en esta especificación.

Compatibilidad del navegador

BCD tables only load in the browser

Ver también