// Referência de erro do SQL Server

Erro do SQL Server 241: Falha na conversão para data e/ou hora

Uma string não pôde ser convertida em data ou hora: formato errado para o idioma e o DATEFORMAT da sessão, ou não é uma data real.

Número do erro
241
Gravidade
16
Categoria
Conversão e truncamento de dados
Mensagem de erro
Conversion failed when converting date and/or time from character string.

O que significa

O SQL Server analisa strings de data de acordo com o formato e a sessão DATEFORMAT e LANGUAGE configurações. Se o texto não for uma data válida nessa interpretação ('31/12/2025' com uma configuração em que o mês vem primeiro, '2025-02-30', 'yesterday'), conversão para date, datetime ou datetime2 falha com 241.

Causas comuns

  • Formatos ambíguos como '03/04/2025' ou '31/12/2025', lido de forma diferente dependendo de SET DATEFORMAT e o idioma de login.
  • Datas que não existem, como 30 de fevereiro.
  • Texto livre ou strings vazias em uma coluna que deveria conter datas.
  • Usando CONVERT com um número de estilo que não corresponde à string.

Como corrigir

  1. Use formatos ISO sem ambiguidade: '20251231' ou '2025-12-31T14:30:00'. Estes são analisados da mesma forma em todas as linguagens e configurações de DATEFORMAT (com datetime2 e date, '2025-12-31' também é seguro).

    SELECT CAST('20251231' AS date), CAST('2025-12-31T14:30:00' AS datetime2);
  2. Analise formatos conhecidos com um estilo explícito. O estilo 103 é dd/mm/yyyy, o 101 é mm/dd/yyyy.

    SELECT CONVERT(date, '31/12/2025', 103);
  3. Encontre os valores incorretos com TRY_CONVERT.

    SELECT RawDate FROM staging.Events WHERE TRY_CONVERT(date, RawDate, 103) IS NULL AND RawDate IS NOT NULL;
  4. Passe datas dos aplicativos como parâmetros tipados (date, datetime2), nunca como strings formatadas.

Reproduza com segurança

SET DATEFORMAT mdy;
SELECT CAST('31/12/2025' AS date);  -- Msg 241

Erros relacionados

Mais erros de conversão de dados e truncamento

O código e o texto da mensagem são de Referência de eventos e erros do Microsoft Database Engine. Veja toda a Lista de erros do SQL Server ou pesquise todos os erros do banco de dados.

// menos erros, correções mais rápidas

Trabalhe com SQL Server no SQLly

Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o SQL Server e os outros bancos de dados que você usa.