Í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.
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.
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):

Image Removed

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

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

	Microsoft OLE DB Provider		Devart ADO .Net Provider
	Sim/Não	Descrição	Sim/Não	Descrição
Conversões Internas		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.		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		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.		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')