Compartir a través de


setUTCFullYear (Método)

Establece, utilizando el horario universal coordinado (UTC), el valor "año" (FullYear) del objeto Date.

function setUTCFullYear(numYear : Number [, numMonth : Number [, numDate : Number]])

Argumentos

  • numYear
    Obligatorio. Valor numérico igual al año.

  • numMonth
    Opcional. Valor numérico igual al mes. El valor correspondiente a enero es 0 y los valores de los demás meses son consecutivos. Se debe proporcionar si se proporciona numDate.

  • numDate
    Opcional. Es un valor numérico que equivale al día del mes.

Comentarios

Si no se especifica un argumento opcional, todos los métodos set que toman argumentos opcionales utilizan el valor devuelto por los métodos get correspondientes. Por ejemplo, si el argumento numMonth es opcional, pero 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 es un número negativo, los demás valores almacenados se modifican consecuentemente.

Para establecer el año mediante la hora local, utilice 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

En el siguiente ejemplo se muestra el uso del método setUTCFullYear.

var dtFirst = new Date();
dtFirst.setUTCFullYear(2007);

var dtSecond = new Date();
// 10 is the value for November. 
dtSecond.setUTCFullYear(2008, 10, 3); 

print (dtFirst.toUTCString());
print (dtSecond.toUTCString());

Requisitos

Versión 3

Se aplica a:

Date (Objeto)

Vea también

Referencia

getFullYear (Método)

getUTCFullYear (Método)

setFullYear (Método)