Versões comparadas
Chave
- Esta linha foi adicionada.
- Esta linha foi removida.
- A formatação mudou.
Índice:
Í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.
Informações | ||
---|---|---|
| ||
Para saber mais sobre:
|
Função TO_DATE()
Informações | ||||
---|---|---|---|---|
| ||||
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.
| ![]() | Alguns dos formatos disponíveis:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
3 | nls_language | Linguagem utilizada na conversão da cadeia de caracteres em uma data válida | ![]() |
kiioi
2.1 - Se aplica a:
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 |
2.2 - Exemplo:
Vamos observar alguns exemplos do uso da função TO_DATE():
Informações | ||||
---|---|---|---|---|
| ||||
TO_DATE('09/07/2003', 'dd/mm/yyyy') Resultado: valor de data referente à 9 de julho de 2003 |
Informações | ||||
---|---|---|---|---|
| ||||
TO_DATE('090703', 'DDMMYY') Resultado:valor de data referente à 9 de julho de 2003 |
Informações | ||||
---|---|---|---|---|
| ||||
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().
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
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.
| Informar uma máscara de data que condiz com o valor passado como parâmetro.
|
2 | ORA-01843 | Valor do mês inválido.
| Informar um mês válido.
|
3 | ORA-01847 | Valor do dia inválido.
| Informar um dia válido.
|
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')
Informações | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||
|
Informações | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||
|