Método setUTCFullYear() do JavaScript Date

Definição e uso

setUTCFullYear() O método define o ano do objeto de data com base no tempo UTC (quatro dígitos de 1000 a 9999).

Dicas:O Tempo Universal Coordenado (UTC) é o tempo estabelecido pelo padrão de tempo mundial.

Notas:O tempo UTC é o mesmo que o GMT (Greenwich Mean Time).

Exemplo

Exemplo 1

Defina o ano para 1992:

var d = new Date();
d.setUTCFullYear(1992);

Experimente você mesmo

Exemplo 2

Defina a data para 3 de novembro de 2020:

var d = new Date();
d.setUTCFullYear(2020, 10, 3);

Experimente você mesmo

Exemplo 3

Defina a data para seis meses antes, UTC:

var d = new Date();
d.setUTCFullYear(d.getUTCFullYear(), d.getUTCMonth() - 6);

Experimente você mesmo

Sintaxe

Date.setUTCFullYear(ano, mês, dia)

Valor do parâmetro

Parâmetro Descrição
ano Obrigatório. Valor representando o ano, permitindo valores negativos.
mês

Opcional. Número inteiro representando o mês.

O valor esperado é de 0-11, mas são permitidos outros valores:

  • -1 levará ao último mês do ano anterior
  • 12 levará ao primeiro mês do próximo ano
  • 13 levará ao segundo mês do próximo ano
dia

Obrigatório. Número inteiro, representando um dia no mês.

O valor esperado é de 1-31, mas são permitidos outros valores:

  • 0 levará ao último dia do mês anterior
  • -1 levará ao dia anterior ao último dia do mês anterior

Se um mês tiver 31 dias：

  • 32 levará ao primeiro dia do próximo mês

Se um mês tiver 30 dias：

  • 32 levará ao dia seguinte do próximo mês

Detalhes técnicos

Retorno: Número, objeto de data e milissegundos desde meia-noite de 1 de janeiro de 1970.
Versão do JavaScript： ECMAScript 1

Suporte do navegador

Método Chrome IE Firefox Safari Opera
setUTCFullYear() Suporte Suporte Suporte Suporte Suporte

Páginas relacionadas

Tutorial:Data do JavaScript

Tutorial:Formato de data do JavaScript

Tutorial:Métodos de configuração de data do JavaScript