Histórico da Página

Sintaxe

DAY( <expressão data> )

Propósito

Retorna o dia do mês como um valor numérico.

Argumentos

<expressão data>

Define a data da qual se deseja obter o dia do mês.

Utilização

A expressão data pode ser uma variável, um campo tipo data de um arquivo de dados, uma expressão cujo resultado seja uma data ou a data corrente do sistema.

A função DAY() retorna um número inteiro entre 0 e 31, dependendo de quantos dias o mês possui.

Se a expressão data resultar numa data nula ou vazia, a função DAY() retornará zero.

Dicas

A função DAY() é útil quando se torna necessário realizar cálculos aritméticos com o dia de uma data.

A função DAY() está relacionada com as funções MONTH() e YEAR(), que fornecem, respectivamente, os valores numéricos do mês e do ano de uma data.

Exemplos

Suponhamos que a data corrente do sistema seja 28/05/12. Nesse caso, vejamos como os exemplos abaixo se comportam:

MSGALERT( DATE() )                  // Resulta: 28/05/12

MSGALERT( DAY(DATE()) )        // Resulta o valor numérico 28

nDia := DAY( DATE() )

MSGALERT( nDia )                      // Resulta o valor numérico 28

MSGALERT( DAY(CTOD(“”)) )     // Resulta zero

nDia := DAY( DATE() ) + 1           // Resulta o valor numérico 29

Este exemplo utiliza a função DAY() em conjunto com as funções CMONTH() e YEAR() para formatar um valor do tipo data:

cData := CMONTH(DATE()) + STR(DAY(DATE())) + "," + STR(YEAR(DATE())) // Resulta: Maio 28, 2012