ISO 8601 Parser
ISO 8601 Format Reference
Understand ISO 8601 Parser
Interpreta datas, datas e horas, durações e intervalos em ISO 8601, e informa o dia da semana, o número da semana, o dia do ano, o timestamp Unix e o tempo relativo.
How it works
A ISO 8601 ordena os campos do maior para o menor — 2024-06-15T10:30:00Z —, e é por isso que strings ISO se ordenam corretamente como texto puro, propriedade que nenhum outro formato comum tem. A letra `T` separa a data da hora e importa mais do que parece: `M` antes do `T` significa meses e `M` depois dele significa minutos, então P1M é um mês e PT1M é um minuto. O número da semana informado aqui segue a regra ISO de que uma semana pertence ao ano que contém a quinta-feira dela, que é como o dia 1º de janeiro pode legitimamente cair na semana 52 do ano anterior.
When to use it
- Conferir um timestamp de API que não é interpretado, normalmente por falta de deslocamento ou por um espaço no lugar do `T`
- Ler uma duração ISO 8601 de um arquivo de configuração, de um manifesto de vídeo ou de um campo do Kubernetes e transformá-la em algo concreto
- Descobrir o número ISO da semana para um relatório que agrupa dados por semana
- Confirmar para que uma data e hora com um deslocamento incomum, como `+05:45`, resolve em UTC
Watch out for
- A falta de deslocamento muda o significado conforme o formato. O JavaScript interpreta a forma só com data, `2024-06-15`, como meia-noite UTC, mas a forma com hora, `2024-06-15T10:30:00` sem `Z` e sem deslocamento, como horário local — a mesma "meia-noite" pode diferir em um dia.
- Durações em anos e meses não têm duração fixa, então qualquer conversão para segundos é uma aproximação. O total mostrado aqui supõe um ano de 365 dias e um mês de 30 dias; P1M não são 30 dias em fevereiro.
- O designador de semana `W` em durações (P2W) faz parte da norma, mas não pode ser combinado com outros componentes, e este parser lê a forma Y/M/D/H/M/S.
- `Z` e `+00:00` significam a mesma coisa, mas nenhum dos dois significa "sem fuso horário". Um timestamp sem designador nenhum é um horário local, que é um valor diferente.
Frequently Asked Questions
O que é o formato de data ISO 8601?
A ISO 8601 é a norma internacional para representar datas e horas. Data básica: 2024-01-15. Data e hora com fuso: 2024-01-15T14:30:00Z (UTC) ou 2024-01-15T14:30:00+05:30 (IST). Duração: P1Y2M3D. Usada em APIs JSON, timestamps de arquivos, campos de banco de dados e elementos <time> do HTML.
Qual é a diferença entre Z e +00:00 na ISO 8601?
Os dois representam UTC. O "Z" (Zulu) é abreviação de +00:00. Eles são intercambiáveis em todos os parsers conformes à norma. O "Z" é mais compacto e comum em APIs; "+00:00" às vezes é usado para deixar o deslocamento explícito e visível.
Como expressar uma duração em ISO 8601?
Prefixo P, depois anos (Y), meses (M), semanas (W), dias (D), depois T para a parte de tempo, e então horas (H), minutos (M) e segundos (S). Exemplo: P1Y6M = 1 ano e 6 meses. PT30M = 30 minutos. P2DT3H = 2 dias e 3 horas. Unidades zeradas podem ser omitidas.
How to Use ISO 8601 Parser
- Paste or type your input in the input area above.
- The tool processes your input automatically or click Run.
- Copy or download the result using the action buttons.
- Use Ctrl+Enter to run quickly from the keyboard.