Temporal: a nova API de data e hora do JS

• A API de data/hora existente do JavaScript é difícil demais de usar, então uma nova API está sendo proposta: atualmente em Stage 3

• Pode ser acessada pela variável global Temporal

→ Todos os objetos são imutáveis

→ Suporte a fuso horário (baseado em IANA) e calendários não gregorianos (incluindo o calendário Dangi da Coreia)

→ Janeiro é o mês 1

→ Distingue entre hora Wall-Clock (local) e hora Exact (UTC)

→ Suporte a hora Plain sem fuso horário

• Exemplos

→ Hora UTC atual: Temporal.now.instant().toString()

→ Hora local atual: Temporal.now.zonedDateTimeISO('Asia/Seoul').toString()

→ Fuso horário atual: Temporal.now.timeZone().toString()

→ Temporal.Duration.from({hours: 3, minutes: 45})

→ Conversão com o Date antigo

const legacyDate = new Date('1970-01-01T00:00:01Z')

legacyDate.toTemporalInstant() ou Temporal.Instant.fromEpochMilliseconds(legacyDate.getTime())