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
Specification | Status | Comment |
---|---|---|
ECMAScript 1st Edition (ECMA-262) | Standard | Definición inicial. Implementado en JavaScript 1.3. |
ECMAScript 5.1 (ECMA-262) La definición de 'Date.prototype.setFullYear' en esta especificación. |
Standard | |
ECMAScript 2015 (6th Edition, ECMA-262) La definición de 'Date.prototype.setFullYear' en esta especificación. |
Standard | |
ECMAScript Latest Draft (ECMA-262) La definición de 'Date.prototype.setFullYear' en esta especificación. |
Draft |
Compatibilidad con navegadores
Característica | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Soporte Básico | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
Característica | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Soporte Básico | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |