0

CSV de durações: exporte minutos inteiros antes de formatar

Uma coluna com 08:48 pode ser interpretada por uma planilha como horário do dia. Se o seu contrato é duração, preserve esse significado também no arquivo exportado.

Um formato pequeno e explícito pode ter três colunas:

  • minutes: unidade inteira usada como referência;
  • duration: representação legível, por exemplo 08:48;
  • hours_decimal: representação decimal com regra de arredondamento declarada.

08:48 = 528 minutos = 8,80 horas. Não é 8,48 horas. Neste exemplo de CSV, o separador é ponto e vírgula e a vírgula é decimal; esses parâmetros precisam ser selecionados na importação da planilha.

function durationMinutes(text) {
  if (!/^\d{1,3}:[0-5]\d$/.test(text)) throw new Error('Use HHH:MM');
  const [hours, minutes] = text.split(':').map(Number);
  return hours * 60 + minutes;
}
function csvDuration(text) {
  const minutes = durationMinutes(text);
  const decimal = (minutes / 60).toFixed(2).replace('.', ',');
  return `minutes;duration;hours_decimal\n${minutes};${text};${decimal}\n`;
}

Para csvDuration('08:48'), o arquivo gerado é:

minutes;duration;hours_decimal
528;08:48;8,80

O contrato aqui é duração no formato de uma a três casas para horas e exatamente duas para minutos. 125:30 é aceito como duração; isso não seria um horário de relógio válido. 08:60, 8.48 e valores negativos são rejeitados. 00:00 é uma duração válida; a regra de produto decide se deve aceitá-la em cada campo.

Executei oito verificações: quatro conversões, três rejeições e o CSV exato acima. O decimal é arredondado para duas casas apenas para apresentação; os minutos inteiros continuam como referência. Não use o decimal já arredondado como base para recalcular uma folha ou acumular durações.

Depois de importar, confira se minutes continua numérico e se a representação legível não foi convertida em data. O exemplo executa JavaScript e compara o texto do CSV; não afirma ter passado em todas as versões de Excel ou LibreOffice. Campos livres como nomes exigem outros cuidados de escape e segurança, que não são implementados neste recorte.

Transparência: mantenho o ContaCLT, que possui uma calculadora gratuita de horários e apresenta duração e decimal. O exemplo técnico acima é independente da interface do produto. Não calcula remuneração nem valida direitos trabalhistas. Não publique nomes, salários ou registros de empregados nos comentários. Texto preparado com auxílio de IA; os oito casos foram executados.

Carregando publicação patrocinada...