Converte o valor da data no valor numérico do ano.
Sintaxe
YEAR( dData ) –> nAno
Argumento | Obrigat. | Tipo | Descrição |
dData | Sim | D | É o valor da data a ser convertido. |
Retorno | Descrição |
nAno | Valor numérico do ano da data especificada em dData incluindo os dígitos do século. O valor retornado não é afetado pelos valores especificados pelos comandos SET DATE ou SET CENTURY. |
0 | Para uma data inválida ou nula. |
Descrição
YEAR() é uma função de conversão de data que extrai o valor numérico do ano. YEAR() é membro de um grupo de funções que retornam valores numéricos de uma data. O grupo inclui DAY() e MONTH() que retornam o dia e o mês como valores numéricos.
Exemplos
Estes exemplos mostram YEAR() usando a data do sistema:
dData := DATE() // Resultado: 09/20/01
dAno := YEAR(dData) // Resultado: 2001
dAno := YEAR(dData) + 11 // Resultado: 2012
Este exemplo cria uma função de usuário que usa a função YEAR() para formatar o valor da data:
cData := Mdy(DATE()) // Result: September 20, 1990
FUNCTION Mdy( dDate )
RETURN CMONTH(dDate) + ” ” + LTRIM(STR(DAY(dDate))) + “,” + STR(YEAR(dDate))