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