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

---

Informações
icon false title Sintaxe
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 Added
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 Added
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):

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.

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

Nº	Versão
1	Oracle 12c
2	Oracle 11g
3	Oracle 10g
4	Oracle 9i
5	Oracle 8i

Exemplo:

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

Informações
icon false title Exemplo 1
TO_DATE('09/07/2003', 'dd/mm/yyyy') Resultado: valor de data referente à 9 de julho de 2003

Informações
icon false title Exemplo 2
TO_DATE('090703', 'DDMMYY') Resultado:valor de data referente à 9 de julho de 2003

Informações
icon false title Exemplo 3
TO_DATE('15032002', 'ddmmyyyy') Resultado:valor de data referente à 15 de março de 2002

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

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 Added

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