Tempo/Números
Analisador de duração ISO 8601
Analise uma string como "P3Y6M4DT12H30M5S" em um formato legível, ou monte uma string dessas a partir de anos/meses/dias/horas/minutos/segundos.
Um campo vazio = 0; campos zerados não entram na string. O componente de semanas (P4W) só é suportado ao analisar — para montar, use dias.
An ISO 8601 duration (e.g. P3Y6M4DT12H30M5S) is a compact, unambiguous way to write a time span, used by many APIs and data formats, but hard to read without parsing it. This tool translates such a string into plain language and lets you build one from separate fields.
How to use it
- Parse: paste an ISO duration string to get years, months, days, hours, minutes, and seconds broken out separately, in a readable form.
- Build: enter the duration components you need and the tool assembles a valid ISO 8601 string.
- The letter T before the time part (hours/minutes/seconds) is required and gets added automatically when needed.
Common uses
- Reading a duration field from an API response (a subscription, a rental period, a timeout) given in this format.
- Building a correctly formatted ISO 8601 string for a request that expects a duration in exactly this format.
- Debugging why a third-party API's parser rejects a hand-built duration — checking it against the standard's exact syntax.
Things to keep in mind
The leading P stands for "period" and is required, just like the T that separates days from hours in the time part.
The base standard doesn't define a sign for durations — negative durations (to mean "ago") are only supported by specific implementations as an unofficial extension.
Artigo sobre esta ferramenta: ISO 8601 Duration: como escrever uma duração em formato padrão
Perguntas frequentes
O que significa uma string como P3Y6M4DT12H30M5S?
Este é o formato padrão de duração ISO 8601: P significa "period" (período), seguido de anos/meses/dias até a letra T, após a qual vêm horas/minutos/segundos. Neste exemplo, são 3 anos, 6 meses, 4 dias, 12 horas, 30 minutos e 5 segundos.
Como uma duração ISO difere de uma duração simples em horas?
Ao contrário de unidades fixas (como na calculadora de duração), os componentes "anos" e "meses" aqui são baseados em calendário e não têm um número fixo de segundos — sua duração exata depende das datas específicas às quais são aplicados.
O formato semanal P4W é suportado?
Sim, mas apenas ao analisar uma string existente. Ao construir sua própria string, semanas precisam ser expressas em dias, já que o ISO 8601 não permite combinar semanas com outros componentes em uma única string.
Posso indicar segundos ou minutos fracionários?
Sim, o padrão permite uma parte fracionária apenas no último componente da string — por exemplo, PT1.5S (1,5 segundo) ou PT1H30.5M (1 hora 30,5 minutos) são válidos, mas uma parte fracionária em qualquer componente que não seja o último não é.
Existem durações ISO negativas?
O padrão ISO 8601 básico não define um sinal para durações, mas algumas implementações (incluindo esta ferramenta) suportam um sinal de menos inicial para indicar "atrás" ou uma duração invertida — uma extensão comum, embora não oficial.