Atualização editorial em : requisitos e conclusões revistos com fontes oficiais. A data da publicação original foi preservada.

Uma data de vencimento sem horário, um instante registrado em UTC e uma reunião em um fuso específico representam informações diferentes. Antes de escolher a operação de soma, é preciso decidir qual dessas informações a aplicação está modelando. Temporal torna essa distinção explícita, mas não escolhe a regra de negócio por você.

A documentação do TC39 distingue PlainDate, para uma data de calendário sem horário ou fuso, Instant, para um ponto na linha do tempo, e ZonedDateTime, que associa data e horário a um fuso. Objetos com prefixo Plain não carregam um fuso implícito. Fonte: tipos de Temporal.

As notas do Chrome 144 registram a chegada da API ao navegador. Isso não comprova suporte em todos os navegadores, WebViews ou ambientes Node.js usados por uma aplicação. Fonte: notas do Chrome 144.

Um dia de calendário não é sempre 24 horas

A documentação de ZonedDateTime diferencia aritmética de calendário da soma de unidades de tempo. Também oferece disambiguation para resolver ou rejeitar horários locais repetidos ou inexistentes nas transições de fuso. A opção reject permite tornar essas ambiguidades um erro explícito. Fonte: aritmética e desambiguação de ZonedDateTime.

O exemplo sintético abaixo compara as duas operações e rejeita horários ambíguos. Ele usa a implementação nativa do navegador; não implementa regras de fuso por conta própria.

'use strict';

function compararDatas(temporal = globalThis.Temporal) {
  if (!temporal?.PlainDate || !temporal?.ZonedDateTime) {
    throw new Error('Temporal indisponivel neste ambiente.');
  }
  const inicio = temporal.PlainDate.from('2026-02-13');
  const seteDiasDepois = inicio.add({ days: 7 });
  const partida = temporal.ZonedDateTime.from('2026-03-07T12:00[America/New_York]');
  const diaSeguinte = partida.add({ days: 1 });
  const rejeitaHorario = texto => {
    try {
      temporal.ZonedDateTime.from(texto, { disambiguation: 'reject' });
      return false;
    } catch (erro) {
      if (!(erro instanceof RangeError)) throw erro;
      return true;
    }
  };
  return {
    dataOriginal: inicio.toString(),
    seteDiasDepois: seteDiasDepois.toString(),
    partida: partida.toString(),
    diaSeguinte: diaSeguinte.toString(),
    horasTranscorridas: diaSeguinte.since(partida, { largestUnit: 'hours' }).hours,
    apos24Horas: partida.add({ hours: 24 }).toString(),
    horarioInexistenteRejeitado: rejeitaHorario('2026-03-08T02:30[America/New_York]'),
    horarioRepetidoRejeitado: rejeitaHorario('2026-11-01T01:30[America/New_York]')
  };
}

if (typeof module !== 'undefined') module.exports = { compararDatas };

Código completo de comparação. Carregado como script em um ambiente com Temporal, execute compararDatas(). Sem suporte à API, a função informa o erro; não converte silenciosamente os valores para Date.

Codex executou o código no Chrome 154.0.8037.99, sem requisições externas. O resultado foi:

{
  "dataOriginal": "2026-02-13",
  "seteDiasDepois": "2026-02-20",
  "partida": "2026-03-07T12:00:00-05:00[America/New_York]",
  "diaSeguinte": "2026-03-08T12:00:00-04:00[America/New_York]",
  "horasTranscorridas": 23,
  "apos24Horas": "2026-03-08T13:00:00-04:00[America/New_York]",
  "horarioInexistenteRejeitado": true,
  "horarioRepetidoRejeitado": true
}

O avanço de um dia manteve o horário local ao atravessar a transição representada pelas regras de Nova York e correspondeu a 23 horas transcorridas. A soma de 24 horas chegou às 13h. O valor original de PlainDate permaneceu inalterado depois da soma de sete dias. O ensaio também conferiu a rejeição de uma data inválida com overflow: 'reject' e a falha explícita quando Temporal está ausente.

Traduza o resultado para o contrato da aplicação

  • Se o campo é apenas uma data de vencimento, não acrescente um horário UTC só para caber no tipo escolhido.
  • Se a regra exige exatamente 24 horas transcorridas, teste esse intervalo. Se exige o mesmo horário local no dia seguinte, teste a operação de calendário e as transições relevantes.
  • Para uma entrada local sem offset que possa ser ambígua, defina como pedir esclarecimento ao usuário. Rejeitar a entrada é uma política possível, não uma resposta universal.
  • Documente o formato persistido e o significado dos campos. A adoção de um tipo no front-end não migra automaticamente contratos de API, banco de dados ou integrações.

Antes de adotar, confira suporte nos ambientes realmente atendidos. Detectar a existência de Temporal é uma verificação inicial, não uma suíte de compatibilidade. Uma alternativa de biblioteca ou polyfill exige decisão e testes próprios; nenhuma foi adicionada neste exemplo.

Limites do ensaio

São casos sintéticos executados por Codex, não relatos de Anderson em produção. O ensaio usa as regras de fuso disponíveis no navegador informado; não cobre todos os calendários, futuras alterações dessas regras, outros navegadores, recorrência de agenda ou migração de dados. Não houve benchmark. O texto anterior atribuía experiência pessoal ao autor e sugeria adoção em projetos novos como solução para compatibilidade; essas conclusões foram retiradas.