Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Date.UTC: componentes UTC para marca temporal

Date.UTC interpreta componentes numéricos como UTC, normaliza-os e devolve milissegundos desde a época sem criar um Date.

Versão: ECMAScript 1 onward; example target: Node.js 24.22.2

Sintaxe

Date.UTC(year, monthIndex?, date?, hours?, minutes?, seconds?, milliseconds?)

Date.UTC(year, monthIndex?, date?, hours?, minutes?, seconds?, ms?) devolve um Number de milissegundos desde a época. monthIndex começa em zero; por omissão mês 0, dia 1 e campos de hora 0. Anos 0–99 são especialmente mapeados para 1900–1999. Cria um objeto com new Date(Date.UTC(...)).

Valores fora dos intervalos naturais são normalizados: mês 12 passa para janeiro seguinte e dia 0 para o fim do mês anterior. Após ToNumber e TimeClip, valor não finito, ano obrigatório omitido ou resultado fora de ±8.64e15 produz NaN. BigInt e Symbol lançam TypeError.

Como método estático, Date.UTC não usa o fuso local. Argumentos adicionais são ignorados e a função não é construtor. Existe desde ECMAScript 1.

Exemplos

const timestamp = Date.UTC(2024, 1, 29, 12, 30);
console.log(timestamp, new Date(timestamp).toISOString());
console.log(Date.UTC(2024, 12, 1) === Date.UTC(2025, 0, 1));
console.log(new Date(Date.UTC(99, 0, 1)).toISOString());
console.log(Number.isNaN(Date.UTC()));

Resultado

1709209800000 2024-02-29T12:30:00.000Z
true
1999-01-01T00:00:00.000Z
true

Fontes