Establece el valor de año en el objeto Date utilizando el Horario Universal Coordinado (UTC).

objetoFecha.setUTCFullYear(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 un argumento opcional. Por ejemplo, si el argumento numMes es opcional, pero si no se especifica, JScript utiliza el valor devuelto por el método getUTCMonth.

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 la hora local, use el método setFullYear.

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

Ejemplo

El siguiente ejemplo muestra el uso del método setUTCFullYear.

function EjemploDeSetUTCFullYear(nuevoano)
   var d, s;                    //Declara las variables.
   d = new Date();            //Crea objeto Date.
   d.setUTCFullYear(nuevoAno);  //Establece el año UTC completo.
   s = "La configuración actual es ";
   s += d.toUTCString();
   return(s);                    //Devuelve la nueva cadena.
}

Requisitos

Versión 3

Consulte también

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

Se aplica a: Objeto Date