Tempo entre datas

O tempo entre duas marcas é o intervalo de relógio que fica entre duas datas ou horas explícitas, informado como dias inteiros, horas restantes e minutos restantes. Quem pesquisa tempo entre datas precisa desse detalhamento misto para um turno, um voo, uma internação ou uma janela de projeto, não uma idade civil em anos-meses-dias nem uma contagem regressiva ao vivo com segundos sobrando. Esta ferramenta nunca inventa o agora com o relógio do hospedeiro.

O que o tempo decorrido entre duas marcas realmente conta

O tempo decorrido entre duas marcas é uma duração de relógio, não uma idade civil nem uma contagem regressiva ao vivo. O motor pega dois instantes validados, subtrai as contagens absolutas de segundos, toma o valor absoluto para que qualquer ordem seja legal e então trunca o intervalo em dias inteiros de oitenta e seis mil e quatrocentos segundos, horas restantes de três mil e seiscentos segundos e minutos restantes de sessenta segundos.

Um resto de cinquenta e nove segundos não vira um minuto: os minutos são minutos inteiros depois de remover dias e horas, de modo que o triplo é sempre inteiros não negativos, com horas de zero a vinte e três e minutos de zero a cinquenta e nove. Valores só de data são meia-noite daquele dia civil, então do primeiro de janeiro ao terceiro de janeiro há dois dias, zero horas e zero minutos.

Um datetime como o primeiro de janeiro às nove até o segundo de janeiro às dez e meia é um dia, uma hora e trinta minutos. Valores só de relógio, como nove e quinze e dezessete e quarenta e cinco, ficam num mesmo dia anônimo e devolvem zero dias mais as horas e minutos daquela jornada. Instantes iguais devolvem zero em cada componente e marcam direction como zero.

Se o fim chega antes do início, dias, horas e minutos continuam sendo o comprimento decorrido absoluto e direction é backward, então um par invertido não falha e não inventa uma duração negativa. A string formatted une os três componentes numa linha legível, como dois dias, duas horas, trinta minutos, para rótulos e recibos.

Use um auxiliar vizinho de anos-meses-dias quando a busca for data a data como meses civis, um auxiliar de minutos com sinal quando o produto só guarda um inteiro, e um auxiliar de contagem regressiva quando segundos restantes precisarem aparecer; use esta página quando a consulta for o tempo entre duas marcas e a resposta tiver de ser dias, horas e minutos.

Contrato de entrada, validação de datas e forma da resposta

Cada valor pode ser um dia civil no formato YYYY-MM-DD, um datetime ISO-8601 completo com separador T ou espaço opcional, segundos opcionais, fração de segundo que é truncada e um Z final ou um deslocamento numérico opcionais, ou uma hora só de relógio como HH:mm ou HH:mm:ss. Os anos vão de um a nove mil novecentos e noventa e nove, os meses de um a doze, e o dia deve existir naquele mês sob regras de bissexto gregorianas, incluindo 29 de fevereiro só em anos bissextos.

As horas vão de zero a vinte e três e os minutos e segundos de zero a cinquenta e nove. Uma hora só de relógio não pode ser misturada com uma data ou datetime de calendário: os dois extremos devem ser só de relógio ou ambos devem carregar data; caso contrário o pedido falha nomeando o par inconsistente.

Ambos os extremos são obrigatórios de propósito: uma calculadora de tempo entre marcas que substitui em silêncio o relógio do hospedeiro produz respostas diferentes na integração contínua, num notebook que cruza um meridiano e num worker em Coordinated Universal Time, o que quebra auditorias e exportações reproduzíveis.

Onde uma calculadora de tempo entre duas marcas justifica o lugar

Balcões de turno e rascunhos de folha de pagamento precisam de dias, horas e minutos restantes entre um carimbo de entrada e um de saída, não um único inteiro de minutos nem uma idade civil em anos e meses. Balcões de viagem imprimem o mesmo triplo num itinerário para que uma partida na sexta de manhã e uma chegada no domingo à tarde seja descrita como dois dias, algumas horas e minutos restantes, em vez de uma média flutuante que desvia ao cruzar um fuso.

Prontuários de hospital e hotel guardam o intervalo misto contra dois carimbos explícitos para que um revisor possa repetir o mesmo par meses depois e obter o mesmo detalhamento. Painéis pessoais usam a calculadora gratuita de tempo entre marcas no navegador para quanto um show, uma aula ou uma viagem de carro de fato durou, sem instalar uma biblioteca de datas nem enviar um banco de fusos a cada cliente.

Mantenha expectativas honestas: esta capacidade mede tempo de relógio decorrido entre duas datas ou horas explícitas; não pula fins de semana como duração comercial, não carrega calendários de feriados, não inventa o hoje quando um campo falta, não converte meses lunares nem guarda segundos restantes no triplo principal. Combine-a com uma ferramenta de anos-meses-dias quando o formulário pedir uma idade civil, e com um auxiliar de dias inteiros quando o texto do produto nunca mencionar horas.

Como a implementação é parse pura tier A, cada chamada bem-sucedida permanece barata, determinística e sem tokens de modelo ou rede de saída, exatamente o que suítes de regressão precisam ao fixar pares de dia bissexto e de virada da noite ao longo de décadas de carimbos de início e de fim.