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.
| ![]() | ||||||
3 | nls_language | Linguagem utilizada na conversão da cadeia de caracteres em uma data válida | ![]() |
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 | ||||
---|---|---|---|---|
| ||||
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 | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||
|