Date.prototype.setFullYear()
Baseline
Ampliamente disponible
Esta característica está consolidada y funciona en muchos dispositivos y versiones de navegador. Está disponible en todos los navegadores desde julio de 2015.
El método setFullYear() fija el año completo para una fecha específica de acuerdo a la zona horaria local. Devuelve un nuevo valor de tipo timestamp.
Sintaxis
dateObj.setFullYear(valorAño[, valorMes[, valorDia]])
Parámetros
valorAño-
Valor de tipo entero que contiene el valor numérico del año, por ejemplo, 1995.
valorMes-
Opcional. Valor entero entre 0 y 11 que representa el mes de Enero a Diciembre.
valorDia-
Opcional. Valor entero entre 1 y 31 que representa el día del mes. Si se especifica este parámetro debe incluirse también el parámetro
valorMes.
Valor devuelto
El número de milisegundos entre 1 Enero 1970 00:00:00 UTC y a la fecha actualizada con el valor del año.
Descripción
Si en la invocación al método no se especifican los parámetros valorMes y valorDia, se emplean en su lugar los valores devueltos por getMonth() y getDate().
Si se especifica un parámetro con un valor fuera del rango esperado, setFullYear() intenta actualizar el resto de parámetros y la informacion de fecha en el objeto Date de manera consistente. Por ejemplo, si se especifica el valor 15 para el parametro valorMes, el parámetro año se incrementa en 1 (valorAño+ 1), y se emplea 3 como valor para el parámetro mes.
Ejemplos
Uso de setFullYear()
var theBigDay = new Date();
theBigDay.setFullYear(1997);
Especificaciones
| Especificación |
|---|
| ECMAScript® 2027 Language Specification # sec-date.prototype.setfullyear |