Compartilhar via


Método de setFullYear

Define o valor de ano a Date usando o objeto hora 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. O valor de janeiro é 0 e outros valores de mês siga consecutivamente. Deve ser fornecido se numDate é fornecido.

  • numDate
    Opcional. Um valor numérico que é igual ao dia do mês.

Comentários

Todos os set o valor retornado do correspondente de usar métodos levando os argumentos opcionais obter métodos, se você não especificar o argumento opcional. Por exemplo, se a numMonth argumento é opcional, mas não for especificado, o JScript usa o valor retornado da getMonth método.

Além disso, se o valor de um argumento é maior do que o seu intervalo ou um número negativo, outros valores armazenados forem modificados de acordo.

Para definir o ano usando o tempo Universal Coordenado (UTC), use o setUTCFullYear método.

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

Exemplo

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

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

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

Requisitos

Versão 3

Se aplica A:

Objeto Date

Consulte também

Referência

Método de getFullYear

Método de getUTCFullYear

Método de setUTCFullYear