# Calculadora de tempo

> Aritmética exata de tempo: o intervalo entre dois instantes, ou um instante mais ou menos uma duração, em ISO 8601 ou notação simples. Meses e anos são recusados com honestidade: são unidades de calendário sem duração exata única.

- Tool: https://ronutz.com/pt-BR/tools/time-calculator
- Family: Codificação e dados

---

## O que faz

Dois modos de aritmética exata de tempo. Entre dois instantes: o intervalo com sinal, decomposto da maior unidade para a menor (semanas, dias, horas, minutos, segundos) e totalizado integralmente em cada unidade, com a duração ISO 8601 canônica. Instante mais ou menos uma duração: o timestamp resultante. Durações são lidas em ISO 8601 (P1DT2H30M, PT90M, P1W) ou notação simples (1d 2h 30m; 90min). Tudo é calculado na linha do tempo UTC, no seu navegador.

## O que ela recusa, e por quê

Somar "um mês" é aritmética de calendário: um mês tem de 28 a 31 dias e um ano 365 ou 366, então P1M não tem duração exata única. A ferramenta recusa meses e anos com essa explicação em vez de escolher uma convenção em silêncio. Dias aqui têm exatamente 24 horas e semanas exatamente 7 dias - tempo exato, declarado.

## Offsets

Um timestamp sem offset é lido como UTC e a suposição é anotada. Adicione Z ou um offset explícito (por exemplo -03:00) e a resposta nunca depende da máquina em que a ferramenta roda.

## Standards and references

- [RFC 3339 — Date and Time on the Internet: Timestamps](https://www.rfc-editor.org/rfc/rfc3339) - timestamp format and offsets
- [ISO 8601 — durations (PnDTnHnMnS)](https://www.iso.org/iso-8601-date-and-time-format.html) - duration syntax; why P1M is calendar arithmetic
- [POSIX.1-2017 — Seconds Since the Epoch](https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap04.html#tag_04_16) - the UTC timeline the arithmetic runs on

## Related reading

- [Aritmética de tempo e fusos horários: durações exatas, reuniões honestas](https://ronutz.com/pt-BR/learn/time-arithmetic-and-time-zones.md): Por que 'mais um mês' não tem resposta exata, o que as durações ISO 8601 realmente prometem e como um instante UTC vira quatro relógios de parede diferentes. A armadilha do horário de verão, a armadilha da mudança de data e o argumento para planejar reuniões com uma data real.