Índice:

Introdução

---

Na versão 11.80, o provedor de dados é o Microsoft OLE DB Provider for Oracle, disponibilizado pela própria Microsoft, enquanto que na versão 12

o provedor de dados é o Devart ADO .Net Provider, disponibilizado pela empresa Devart.

Função TO_DATE()

TO_DATE( string1 [, format_mask] [, nls_language] )

Descrição dos Parâmetros:

Nº	Nome	Descrição	Obrigatoriedade	Outras Informações
1	string1	Cadeia de caracteres que será convertida em uma data válida.	Image Modified

2	format_mask	Máscara que será utilizada para a correta formatação da data. Informações title !Importante! O formato (segundo parâmetro) sempre deve corresponder ao formato da string (primeiro parâmetro), assim o interpretador vai identificar qual formato esta entrando para poder converter a string em data.	Image Modified
3	nls_language	Linguagem utilizada na conversão da cadeia de caracteres em uma data válida	Image Added

Alguns dos formatos disponíveis (format_mask):

A função TO_DATE() pode ser usada nas seguintes versões do Oracle/PLSQL:

Exemplo:

Vamos observar alguns exemplos do uso da função TO_DATE():

Microsoft Provider x Devart Provider - TO_DATE()

Existem diversas diferenças entre esses dois provedores de dados, mas vamos focar apenas na função TO_DATE().

Exceções Mais Comuns

---

N°	Código Exceção	Descrição	Solução
1	ORA-01830	A imagem do formato da data termina antes de converter a string de entrada inteira. Formato utilizado (2 parâmetro) não se encaixa de forma precisa ao valor passado no primeiro parâmetro da função. Ex: TO_DATE('02022000', 'dd/mm/yyyy')	Informar uma máscara de data que condiz com o valor passado como parâmetro. Ex: TO_DATE('02022000', 'ddmmyyyy')
2	ORA-01843	Valor do mês inválido. Valores negativos (x < 0); 0 (x = 0); Maiores que os valores já convencionados para mês (x > 12)	Informar um mês válido. Valores positivos maiores que 0 e menores ou iguais a 12 (x > 0 e x <= 12)
3	ORA-01847	Valor do dia inválido. Valores negativos (x < 0); 0 (x = 0); Maiores que os valores já convencionados para dia: Jan, Mar, Mai, Jul, Ago, Out, Dez (x > 31) Fev (x > 28 ou X > 29 se bissexto), Abr, Jun, Set, Nov (x > 30)

RM, Consultas SQL, Oracle e ORA-01830

A Solução geral dada acima, para a exceção de código ORA-01830, logicamente serve também para o produto RM, porém existem algumas peculiaridades que devem ser tratadas de forma isolada.

A principal peculiaridade que trataremos aqui são os parâmetros da Consulta SQL.

Para que a exceção de código ORA-01830 não aconteça, devemos ter certeza de que os parâmetros da consulta SQL utilizados na função TO_DATE():

• Não referenciem campos da base, parâmetros do relatório, campos do relatório, que sejam nativamente do tipo datetime.
  
  

  Informações
  title OBSERVACAO
  Caso referenciem, devem estar acompanhados do sufixo _S; é de extrema importância que esse sufixo esteja presente nesses parâmetros, pois como definimos um tipo prévio para o parâmetro, o processo de execução da Consulta SQL não tem que detectar o tipo, fazendo com que o retorno da consulta seja mais rápido, além disso, como o tipo do parâmetro foi definido como string (cadeia de caracteres), a exceção não deverá ocorrer, lembrando que a máscara do formato deverá ser idêntica ao valor do parâmetro.

Substituindo TO_DATE para TO_CHAR

Uma ótima alternativa é substituir o TO_DATE para TO_CHAR, quando os campos utilizados na Consulta SQL sejam nativamente datetime.

O uso do TO_CHAR é mais simples, já que não é necessário que a máscara do formato seja idêntica ao valor passado como primeiro parâmetro (teoricamente data ou number) dessa função.

Ex: TO_CHAR('2003-01-01','dd/MM/yyyy')