Produto:

TOTVS Reports

Ocorrência:

Passo a passo:

Conteúdo

1 - 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.

2 - 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. 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.		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

2.1 - Se aplica a:

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

3 - 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.

4 - Exceções Mais Comuns

• ORA-01843 - Invalid month value
• ORA-01847 - Invalid day value
• ORA-01830 - date format picture ends before converting entire input string