Í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	Alguns dos formatos disponíveis: N° Nome Descrição 1 YEAR Ano, soletrado 2 YYYY Ano (4 dígitos) 3 YYY YY Y Últimos 3, 2, ou 1 digito(s) do ano. 4 IYY IY I Últimos 3, 2, ou 1 digito(s) do ano (Padrão ISO). 5 IYYY Ano (4 dígitos baseados no padrão ISO) 6 RRRR Recebe um ano (2 dígitos) e retorna um ano (4 dígitos) Um valor entre 0-49 irá retornar um ano (20xx). Um valor entre 50-99 irá retornar um ano (19xx). 7 Q 1/4 de um ano (1, 2, 3, 4; JAN-MAR = 1). 8 MM Mês (01-12; JAN = 01). 9 MON Nome abreviado do mês. 10 MONTH Nome do mês preenchido com espaços em branco para completar 9 caracteres. 11 RM Numeral romano referente ao mês (I-XII; JAN = I). 12 WW Semana do ano (1-53) onde a semana 1 começa no primeiro dia do ano e continua ao sétimo dia do ano. 13 W Semana do mês (1-5) onde a semana 1 começa no primeiro dia do mês e termina ao sétimo. 14 IW Semana do ano (1-52 ou 1-53) baseado no padrão ISO. 15 D Dia da semana (1-7). 16 DAY Nome do dia. 17 DD Dia do mês (1-31). 18 DDD Dia do ano (1-366). 19 DY Nome abreviado do dia. 20 J Dia juliano; O número de dias desde 1 de janeiro de 4712 A.C. 21 HH Hora do dia (1-12). 22 HH12 Hora do dia (1-12). 23 HH24 Hora do dia (0-23). 24 MI Minutos (0-59). 25 SS Segundos (0-59). 26 SSSSS Segundos após a meia-noite (0-86399). 27 AM, A.M., PM, ou P.M. Indicador Meridiano. 28 AD ou A.D Indicador AD. 29 BC ou B.C. Indicador BC. 30 TZD Informações do Horário de Verão. 31 TZH Hora do fuso horário. 32 TZM Minutos do fuso horário. 33 TZR Região do fuso horário.
3	nls_language	Linguagem utilizada na conversão da cadeia de caracteres em uma data válida	Image Modified

2.1 - Se aplica a:

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

2.2 - 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().

	Microsoft OLE DB Provider		Devart ADO .Net Provider
	Sim/Não	Descrição	Sim/Não	Descrição
Conversões Internas	Image Modified	O padrão da função TO_DATE() é receber um campo do tipo string comoparâmetro, porém com as conversões internas do provedor, mesmo passando um campo do tipo datetime comoparâmetro, a função será executada sem levantar exceções.	Image Modified	Funciona conforme o driver nativo do oracle, ou seja, suporta apenas um campo do tipo string como parâmetro, qualquer outro tipo, uma exceção é levantada.
Formatações Internas	Image Modified	O padrão da função TO_DATE() é receber uma máscara de formato idêntica ao valor passado como parâmetro, porém com as formatações internas, mesmo passando uma máscara diferente do valor passado como parâmetro, a função será executada sem levantar exceções.	Image Modified	Funciona conforme o driver nativo do oracle, ou seja, a máscara do formato têm que ser idêntica ao valor passado como parâmetro.

Exceções Mais Comuns

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')