Calculadora de tempo sobreposto entre dois intervalos

Informe o início e o fim de cada intervalo no formato ISO 8601, com Z ou um deslocamento UTC numérico. O cálculo converte todos os limites para a mesma linha do tempo UTC, seleciona o início posterior e o fim anterior e retorna a duração compartilhada em milissegundos, segundos, minutos e horas. Intervalos separados ou que apenas se encostam retornam zero, facilitando o uso em agendas, faturamento, monitoramento e relatórios.

Defina os dois intervalos com limites inequívocos

Informe quatro valores: início e fim do primeiro intervalo, seguidos pelo início e fim do segundo. Cada valor deve ser uma data e hora ISO 8601 completa, com data civil, horário incluindo segundos e Z ou deslocamento explícito, como +02:00 ou -05:30. Exigir o deslocamento evita que um horário local seja interpretado de maneira diferente em outro computador. Cada início deve ser anterior ao respectivo fim. A calculadora considera intervalos semiabertos: o início pertence ao intervalo, enquanto o fim é o limite excluído. Essa convenção evita contar duas vezes o mesmo instante quando reservas, turnos ou janelas consecutivas se encontram. São aceitos de um a três dígitos fracionários nos segundos, normalizados para milissegundos. Datas e componentes de horário são validados diretamente; valores impossíveis produzem erro de entrada. Use sempre os mesmos quatro campos, mesmo quando você não espera uma interseção.

Entenda o cálculo determinístico em UTC

Antes da comparação, o cálculo posiciona os quatro limites em uma única linha do tempo UTC. Um valor terminado em Z já está em UTC. De um valor com deslocamento positivo, esse deslocamento é subtraído; a um valor com deslocamento negativo, ele é somado. Assim, duas datas escritas de formas diferentes podem representar o mesmo instante. A sobreposição começa no mais tardio dos dois inícios e termina no mais cedo dos dois finais. Se esse fim ocorrer depois do início calculado, a diferença será a duração compartilhada; caso contrário, ela será exatamente zero. A implementação usa aritmética do calendário gregoriano e milissegundos inteiros, sem consultar relógio, localidade, banco de fusos, rede, aleatoriedade ou Date do JavaScript. Entradas iguais sempre geram resultados iguais. A saída apresenta uma única duração em milissegundos, segundos, minutos e horas, permitindo que você escolha a unidade adequada ao seu fluxo.

Use o resultado com segurança em fluxos reais

Use a duração de sobreposição sempre que precisar comparar duas janelas conhecidas: um turno com uma licença aprovada, a operação de um equipamento com uma faixa tarifária, um incidente com o horário de atendimento ou uma reserva com um bloco disponível. Um valor positivo mostra quanto tempo existe em comum, não apenas se há interseção. Zero significa que os intervalos estão separados ou que um termina exatamente quando o outro começa; nos dois casos, não há tempo decorrido compartilhado pela convenção semiaberta. Para valores financeiros ou cotas, use overlap_milliseconds ou overlap_seconds como fonte e aplique seu arredondamento documentado apenas depois. Não arredonde os limites antes, salvo se isso fizer parte da sua política. O endpoint aceita somente deslocamentos explícitos; não aceita nomes como America/New_York nem deduz horário de verão. Resolva horários locais antes da chamada. A API custa US$ 0,002 por solicitação, e o navegador executa localmente a mesma lógica para verificações interativas.