No Carbon 3, diffInSeconds tem sinal e casas decimais, e a duração negativa foi parar no banco

[!NOTE] Resumo Executivo (DEV-2026-112): Uma tela mostrava pausa de -34,10325 segundos, o que parecia erro de exibição. A causa era a mudança do Carbon 3, e o mesmo cálculo gravava duração negativa ao encerrar pausa, chamada e chat.


🚨 O Desafio Técnico / Contexto

O código fazia now()->diffInSeconds($inicio), que no Carbon 2 devolvia um inteiro positivo. No Carbon 3, que vem com o Laravel 12, o intervalo tem sinal e é decimal: do presente para o passado, o resultado é negativo.


💡 Principais Lições Aprendidas & Descobertas

  • 💡 O sentido passou a importar. Escreva sempre do mais antigo para o mais novo: $inicio->diffInSeconds(now()).
  • 💡 O retorno é float. Se a coluna ou a tela espera inteiro, faça o cast com (int).
  • 💡 Uma atualização de framework pode não dar erro nenhum e ainda assim gravar dado errado. Depois de atualizar, procure todos os diffIn no código, e não só o que apareceu na tela.
  • 💡 A busca achou o mesmo erro em cinco pontos, três deles gravando no banco. Corrigir o cálculo não conserta o que já foi gravado, e esses dados precisam de conferência à parte.

🛠️ Especificação Técnica & Código-Chave

// Carbon 3: negativo e decimal
now()->diffInSeconds($pause->started_at);   // -34.10325

// Do passado para o presente, como inteiro
(int) $pause->started_at->diffInSeconds(now());   // 34

📈 Impacto no Ecossistema & Valor Prático

As durações passaram a ser positivas e inteiras, e os registros antigos ficaram marcados para conferência.

  • Projetos Relacionados: sistema-de-atendimento
  • Registro de Origem: _data/daily.dev-19.yml

Publicado originalmente como parte do Diário de Desenvolvimento 2026 do ecossistema Artes do Sul & Araguaci.