Total de horas trabalhadas menos intervalos

Cada data e hora ISO precisa incluir Z ou um deslocamento explícito, permitindo comparar em uma única linha do tempo UTC registros de escritórios diferentes, períodos de horário de verão ou jornadas noturnas. O resultado também apresenta as horas brutas, o total de minutos de intervalo e a quantidade de turnos incluídos, facilitando a conferência ou a automação do cálculo.

Informe registros de turno completos e sem ambiguidade

Forneça uma linha para cada período contínuo de trabalho. Cada linha exige uma data e hora clock_in e outra clock_out no padrão ISO 8601, com os segundos e Z ou um deslocamento UTC numérico, como -04:00. O deslocamento é indispensável, pois um horário local isolado não identifica um único instante durante mudanças de fuso. Adicione break_minutes quando o turno tiver um intervalo não remunerado; omita esse campo quando não houver desconto. Minutos de intervalo decimais são aceitos, o que ajuda quando o sistema de origem registra frações de minuto. A saída pode ocorrer no dia seguinte, portanto o trabalho noturno não requer um modo especial. A calculadora recusa datas impossíveis, deslocamentos ausentes, saídas que não sejam posteriores às entradas, intervalos negativos e intervalos maiores que o próprio turno. Ela também rejeita turnos sobrepostos após a normalização em UTC, porque contabilizar ambos aumentaria o total silenciosamente. Manter todas as linhas explícitas torna os dados auditáveis e evita suposições sobre políticas de almoço, regras de arredondamento ou quais lacunas entre turnos devem ser tratadas como intervalo.

Entenda como o cálculo em UTC é feito

Cada marca de tempo é interpretada como um valor do calendário gregoriano e convertida em uma posição de milissegundos UTC conforme o deslocamento escrito. O cálculo não consulta o fuso horário do computador, bancos de dados de fusos, a data atual nem serviços externos. Em cada linha válida, a duração bruta corresponde ao instante UTC de saída menos o instante UTC de entrada. O intervalo informado é convertido de minutos para milissegundos e subtraído da duração bruta dessa linha. Em seguida, as durações brutas e os intervalos são somados separadamente antes da geração do total líquido final. Essa ordem mantém resultados estáveis para equipes cujos registros usam deslocamentos diferentes e para turnos que atravessam a meia-noite. A saída inclui total_hours para o valor líquido trabalhado, total_minutes para sistemas que preferem minutos, gross_hours antes dos descontos, break_minutes como desconto combinado e shift_count para conferência. Os valores de horas e minutos são arredondados para seis casas decimais somente na saída; internamente, a soma permanece em milissegundos inteiros. Assim, as mesmas entradas geram o mesmo JSON, independentemente do idioma do navegador ou da localização do servidor.

Aplique o resultado em folhas de pagamento e relatórios

Os campos retornados separam a atividade de origem da duração final remunerável, permitindo que a pessoa responsável reproduza a aritmética. Compare shift_count com o número de linhas importadas, gross_hours com o período bruto registrado e break_minutes com os descontos não remunerados esperados antes de aceitar total_hours. A capacidade não aplica faixas de horas extras, regras de intervalos pagos, valores salariais, tolerâncias de jornada ou arredondamentos específicos da empresa. Essas políticas variam conforme o contrato e a jurisdição e devem ser aplicadas em uma etapa posterior bem documentada. Ela também não deduz intervalos com base em lacunas entre linhas diferentes: somente os valores break_minutes fornecidos por você são descontados. Dessa forma, a função serve como componente determinístico para preparar folhas de pagamento, faturas de prestadores, relatórios de horas por projeto e conciliações de presença sem inserir políticas ocultas. Você pode executá-la gratuitamente no navegador para uma conferência individual, enquanto a automação via API custa US$ 0,002 por solicitação. Em importações repetíveis, preserve as strings ISO e os deslocamentos originais junto ao resumo retornado, para que qualquer total contestado possa ser rastreado até os instantes e descontos exatos utilizados.