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® 2025 Language Specification
# sec-date.prototype.setfullyear

Compatibilidad con navegadores

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
setFullYear

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Ver también