Establece el valor del año del objeto Date utilizando la hora local.

objetoFecha.setFullYear(numAño[, numMes[, numFecha]])

Argumentos

objetoFecha

Requerido. Cualquier objeto Date.

numAño

Requerido. Un valor numérico igual al año.

numMes

Opcional. Un valor numérico igual al mes. Se debe proporcionar si se proporciona numFecha.

numFecha

Opcional. Un valor numérico igual a la fecha.

Comentarios

Todos los métodos set que obtienen argumentos opcionales, utilizan el valor devuelto de los métodos get correspondientes, si no se especifica el argumento opcional. Por ejemplo, si el argumento numMes es opcional, pero si no se especifica, JScript utiliza el valor devuelto por el método getMonth.

Además, si el valor de un argumento es mayor que su intervalo o si es un número negativo, los demás valores almacenados se modifican según sea el caso.

Para establecer el año utilizando el Horario Universal Coordinado (UTC), use el método setUTCFullYear.

El intervalo de años admitido en el objeto de fecha es, aproximadamente, 285616 años antes o después de 1970.

Ejemplo

El siguiente ejemplo muestra el uso del método setFullYear:

function EjemploDeSetFullYear(nuevoano)
   var d, s;                    //Declara las variables.
   d = new Date();            //Crea objeto Date.
   d.setFullYear(nuevoAno);   //Establece el año.
   s = "La configuración actual es ";
   s += d.toLocaleString();
   return(s);                 //Devuelve la fecha nueva establecida.
}

Requisitos

Versión 3

Consulte también

Método getFullYear | Método getUTCFullYear | Métodos del objeto Date | Método setUTCFullYear

Se aplica a: Objeto Date