Date.prototype.setUTCFullYear()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
O método setUTCFullYear()
atribui o ano completo na data especificada de acordo com o horário universal.
Experimente
Sintaxe
dateObj.setUTCFullYear(yearValue[, monthValue[, dayValue]])
Parâmetros
yearValue
-
Um inteiro especificando o valor numérico do ano, por exemplo, 1995.
monthValue
-
Opcional. Um inteiro entre 0 e 11 representando os meses Janeiro até Dezembro.
dayValue
-
Opcional. Um inteiro entre 1 e 31 representando o dia do mês. Se você especificar o parâmetro
dayValue
, vocẽ deve especificarmonthValue
também.
Valor de retorno
O número de milissegundos entre 1 de Janeiro de 1970 00:00:00 UTC e a data atualizada.
Descrição
Se você não especificar os parâmetros monthValue
e dayValue
, os valores retornados dos métodos getUTCMonth()
e getUTCDate()
serão utilizados.
Se um parâmetro que você especificou está fora do alcance esperado, setUTCFullYear()
tentará atualizar os outros parâmetros e a informação da data no objeto Date
. Por exemplo, se você especificar 15 para o monthValue
, o ano será incrementado em 1 (yearValue + 1
), e 3 será usado para o mês.
Exemplos
Usando setUTCFullYear()
var theBigDay = new Date();
theBigDay.setUTCFullYear(1997);
Especificações
Specification |
---|
ECMAScript Language Specification # sec-date.prototype.setutcfullyear |
Compatibilidade com navegadores
BCD tables only load in the browser