Share via


Método setFullYear

Define o valor de ano no Date objeto usando a time local.

function setFullYear(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.Deve ser fornecido se numDate é fornecido.

  • 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 o argumento opcional.Por exemplo, se o numMonth argumento é opcional, mas não for especificado, o JScript usa o valor retornado das getMonth método.

Além disso, se o valor de um argumento for maior do que o intervalo ou é um número negativo, outros valores armazenados são modificados da mesma forma.

Para conjunto o ano usando o horário de universal coordenado (UTC), use o setUTCFullYear método.

O intervalo de anos tem suportada no objeto data é aproximadamente 285,616 anos a partir de um dos lados de 1970.

Exemplo

O exemplo a seguir ilustra o uso do setFullYear método:

function SetFullYearDemo(newyear){
   var d, s;                 //Declare variables.
   d = new Date();           //Create Date object.
   d.setFullYear(newyear);   //Set year.
   s = "Current setting is ";
   s += d.toLocaleString(); 
   return(s);                //Return new date setting.
}

Requisitos

Versão 3

Aplica-se ao:

Objeto de data

Consulte também

Referência

Método getFullYear

Método getUTCFullYear

Método setUTCFullYear