Método de setUTCFullYear

Define o valor de ano a Date de objeto usando a hora Universal Coordenada (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. 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 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 um argumento opcional. Por exemplo, se a numMonth argumento é opcional, mas não for especificado, o JScript usa o valor retornado da getUTCMonth método.

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

Para definir o ano usando o horário local, use o setFullYear método.

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

Exemplo

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

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

Versão 3

Se aplica A:

Objeto Date

Consulte também

Referência

Método de getFullYear

Método de getUTCFullYear

Método de setFullYear