Date.prototype.setFullYear()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 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()

js
var theBigDay = new Date();
theBigDay.setFullYear(1997);

Especificaciones

Specification
ECMAScript Language Specification
# sec-date.prototype.setfullyear

Compatibilidad con navegadores

BCD tables only load in the browser

Ver también