Date.prototype.setFullYear()

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

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!
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

Temas relacionados
  1. Standard built-in objects
  2. Date
  3. Propiedades
    1. Date.prototype
  4. Métodos
    1. Date.UTC()
    2. Date.now()
    3. Date.parse()
    4. Date.prototype.getDate()
    5. Date.prototype.getDay()
    6. Date.prototype.getFullYear()
    7. Date.prototype.getHours()
    8. Date.prototype.getMilliseconds()
    9. Date.prototype.getMinutes()
    10. Date.prototype.getMonth()
    11. Date.prototype.getSeconds()
    12. Date.prototype.getTime()
    13. Date.prototype.getTimezoneOffset() [Traducir]
    14. Date.prototype.getUTCDate() [Traducir]
    15. Date.prototype.getUTCDay() [Traducir]
    16. Date.prototype.getUTCFullYear()
    17. Date.prototype.getUTCHours()
    18. Date.prototype.getUTCMilliseconds() [Traducir]
    19. Date.prototype.getUTCMinutes() [Traducir]
    20. Date.prototype.getUTCMonth() [Traducir]
    21. Date.prototype.getUTCSeconds() [Traducir]
    22. Date.prototype.getYear() [Traducir]
    23. Date.prototype.setDate() [Traducir]
    24. Date.prototype.setFullYear()
    25. Date.prototype.setHours() [Traducir]
    26. Date.prototype.setMilliseconds() [Traducir]
    27. Date.prototype.setMinutes() [Traducir]
    28. Date.prototype.setMonth() [Traducir]
    29. Date.prototype.setSeconds() [Traducir]
    30. Date.prototype.setTime() [Traducir]
    31. Date.prototype.setUTCDate() [Traducir]
    32. Date.prototype.setUTCFullYear() [Traducir]
    33. Date.prototype.setUTCHours() [Traducir]
    34. Date.prototype.setUTCMilliseconds() [Traducir]
    35. Date.prototype.setUTCMinutes() [Traducir]
    36. Date.prototype.setUTCMonth() [Traducir]
    37. Date.prototype.setUTCSeconds() [Traducir]
    38. Date.prototype.setYear() [Traducir]
    39. Date.prototype.toDateString()
    40. Date.prototype.toGMTString() [Traducir]
    41. Date.prototype.toISOString()
    42. Date.prototype.toJSON() [Traducir]
    43. Date.prototype.toLocaleDateString() [Traducir]
    44. Date.prototype.toLocaleFormat() [Traducir]
    45. Date.prototype.toLocaleString() [Traducir]
    46. Date.prototype.toLocaleTimeString() [Traducir]
    47. Date.prototype.toSource() [Traducir]
    48. Date.prototype.toString() [Traducir]
    49. Date.prototype.toTimeString() [Traducir]
    50. Date.prototype.toUTCString() [Traducir]
    51. Date.prototype.valueOf() [Traducir]
    52. Date.prototype[@@toPrimitive] [Traducir]
  5. Herencia
  6. Function
  7. Propiedades
    1. Function.arguments
    2. Function.arity
    3. Function.caller
    4. Function.displayName
    5. Function.length
    6. Function.prototype
    7. Function.name
  8. Métodos
    1. Function.prototype.apply()
    2. Function.prototype.bind()
    3. Function.prototype.call()
    4. Function.prototype.isGenerator()
    5. Function.prototype.toSource()
    6. Function.prototype.toString()
  9. Object
  10. Propiedades
    1. Object.prototype.__count__
    2. Object.prototype.__noSuchMethod__ [Traducir]
    3. Object.prototype.__parent__ [Traducir]
    4. Object.prototype.__proto__
    5. Object.prototype.constructor
  11. Métodos
    1. Object.prototype.__defineGetter__()
    2. Object.prototype.__defineSetter__() [Traducir]
    3. Object.prototype.__lookupGetter__()
    4. Object.prototype.__lookupSetter__() [Traducir]
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf()
    7. Object.prototype.propertyIsEnumerable()
    8. Object.prototype.toLocaleString() [Traducir]
    9. Object.prototype.toSource()
    10. Object.prototype.toString()
    11. Object.prototype.unwatch()
    12. Object.prototype.valueOf()
    13. Object.prototype.watch()
    14. Object.setPrototypeOf()