Date.prototype.setFullYear()

Esta traducción está incompleta. Por favor, ayuda a traducir este artículo del inglés.

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 valorMesvalorDia, 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)
The definition of 'Date.prototype.setFullYear' in that specification.
Standard  
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of 'Date.prototype.setFullYear' in that specification.
Standard  
ECMAScript 2017 Draft (ECMA-262)
The definition of 'Date.prototype.setFullYear' in that specification.
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)

Ver también

Etiquetas y colaboradores del documento

 Colaboradores en esta página: e.g.m.g.
 Última actualización por: e.g.m.g.,