Histórico da Página

Sintaxe

CTOD( <expressão caracter> )

Propósito

Converte uma cadeia de caracteres em uma data.

Argumentos

< expressão caracter >

Define uma cadeia de caracteres formada por números representando uma data, geralmente no formato “99/99/99”, que significam respectivamente mês/dia/ano, no formato americano, ou dia/mês/ano no formato brasileiro.

Utilização

A função CTOD() é muito importante, pois somente através dela pode-se gerar dados do tipo data. Existe apenas outra forma de se obter valores do tipo data: através de arquivos de dados que contenham campos do tipo data em sua estrutura.

Para especificar uma data nula ou vazia utilizam-se as seguintes sintaxes: CTOD(SPACE(8)), CTOD(“”) ou CTOD(“  /  /  “).

Dicas

A função CTOD() deve ser utilizada sempre que for necessário gerar um valor ou dado do tipo data.

A função DTOC() é o inverso da função CTOD(), pois converte um dado do tipo data em uma cadeia de caracteres no formato de data.

A função DTOS() converte um dado do tipo data para uma cadeia de caracteres no formato aaaammdd. Esse formato é próprio para a utilização em chaves de índices compostas por datas e outros tipos de dados. Neste caso, a classificação se manterá em ordem cronológica.

Exemplos

O exemplo abaixo inicia uma variável com a data base do sistema. Ou seja, com a data atual. Suponhamos que esta seja 28/05/2012.

dDataIni := CTOD(“28/05/12”)

Vejamos a importância dessa função para viabilizar o cálculo entre datas:

dDataVen := dDataIni + 15       // Resulta: 12/06/12

dDataMax := CTOD(“30/06/12)

dDifVenc := dDataMax – dDataVen      // Resulta: 18.

Neste exemplo, dDifVenc representa 8 dias entre a data de vencimento e a data máxima de pagamento