YEAR()
 Converte um valor data para ano na forma de um valor numérico
------------------------------------------------------------------------------

 Sintaxe

     YEAR(<dData>) --> nAno

 Argumentos

     <dData> é o valor data a ser convertido.

 Retorno

     YEAR() retorna o ano do valor data especificado, inclusive dígitos
     indicativos de século, na forma de um valor numérico de quatro
     dígitos.  O valor retornado nao é influenciado pelo formato de DATE ou
     CENTURY corrente.  A especificaçao de uma data nula (CTOD("")) retorna
     zero.

 Descriçao

     YEAR() é uma funçao de conversao de datas utilizada para converter um
     valor data para um valor numérico indicativo do ano.  Pode ser
     utilizada em cálculos de, por exemplo, relatórios periódicos, ou para
     formataçao de exibiçoes de data.

     YEAR() é membro de um grupo de funçoes que retornam componentes de um
     valor data na forma de valores numéricos.  Este grupo inclui DAY() e
     MONTH(), que retornam valores de dia e mês na forma de valores
     numéricos.

 Exemplos

       Os exemplos a seguir ilustram YEAR() usando a data do
        sistema:

        ? DATE()                         // Resulta: 09/01/90
        ? YEAR(DATE())                   // Resulta: 1990
        ? YEAR(DATE()) + 11              // Resulta: 2001

       Este exemplo cria uma funçao definida pelo usuário usando
        YEAR() para formatar um valor data na forma : mês dia, ano:

        ? Mdy(DATE())                    // Resulta: September 20, 1990

        FUNCTION Mdy( dDate )
           RETURN CMONTH(dDate) + " " + LTRIM(STR(DAY(dDate)));
              + "," + STR(YEAR(dDate))

 Arquivos:  Biblioteca CLIPPER.LIB.
 To download this example - click here.

See Also: DAY() MONTH()