Método setUTCFullYear

Define o valor de ano no Date objeto usando Tempo Universal Coordenado (UTC).

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

Argumentos

  • numYear
    Obrigatório.Um valor numérico igual ao ano.

  • numMonth
    Opcional.Um valor numérico igual a mês.

  • numDate
    Opcional.Um valor numérico igual à data de.

Comentários

All conjunto métodos de levando argumentos opcionais usam o valor retornado do correspondente de obter métodos, se você não especificar um argumento opcional.Por exemplo, se o numMonth argumento é opcional, mas não for especificado, o JScript usa o valor retornado das getUTCMonth método.

Além disso, se o valor de um argumento for maior do que o intervalo ou é um negativo número, os valores armazenados são modificada de acordo.

Para conjunto o ano usando a time local, use o setFullYear método.

O intervalo de anos de suporte para o Date objeto é aproximadamente 285,616 anos a partir de um dos lados de 1970.

Exemplo

O exemplo a seguir ilustra o uso do setUTCFullYear método.

function SetUTCFullYearDemo(newyear){
   var d, s;                   //Declare variables.
   d = new Date();             //Create Date object.
   d.setUTCFullYear(newyear);  //Set UTC full year.
   s = "Current setting is ";
   s += d.toUTCString(); 
   return(s);                  //Return new setting.
}

Requisitos

Versão 3

Aplica-se ao:

Objeto de data

Consulte também

Referência

Método getFullYear

Método getUTCFullYear

Método setFullYear