Histórico da Página

import.css=/download/attachments/6062824/tecnologia.css

Retorna o ano de correspondente a uma determinada data.

Sintaxe

yearYear( < dDate dData>> )

Parâmetros

Retorno

Observações

• O valor retornado não é influenciado pelo formato dos comandos Set Date ou Set Century corrente.
• Year() faz parte de um grupo de funções que retornam componentes de um valor data na forma de valores numéricos. Esse grupo inclui Day() e Year(), que retornam os valores dia e ano na forma de valores numéricos.

• Essa função pode ser utilizada em cálculos de, por exemplo, relatórios periódicos ou para formatação de exibições de data.

Exemplos

• A função retorna o valor numérico, com quatro dígitos, correspondente a data informada e seu comportamento não é alterado por comandos como SET DATE e SET CENTURY.
• Quando informado uma data nula (ctod("")), o retorno será zero.

Exemplos

Useruser Functionfunction exemplo1exemplo()
	Year(DATE  conOut(date())   // Resultado:2008
Return

User Function exemplo2()
	conout( DATE() )    // ResultaResult: 0902/0126/90
	conout( YEAR(DATE()) )    // Resulta: 1990
	conout( YEAR(DATE16
  conOut(year(date())) + 11 )   // ResultaResult: 2001
Return

//Este exemplo cria uma função definida pelo usuário usando YEAR() para formatar um valor data no formato mês dia, ano:
 
User Function exemplo3()
	conout( U_Mdy(DATE()) )   // Resulta: September 20, 1990
Return
 
User Function Mdy( dDate )
Return CMONTH(dDate) + " " + LTRIM(STR(DAY(dDate)))	+ "," + STR(YEAR(dDate))

Abrangência

Advanced Protheus 6.09 , Advanced Protheus 7.10 , Microsiga Protheus 8.11 , Protheus 10 , TOTVS Application Server 10 , ByYou Application Server

Veja também

Day

...

2016
  conOut(year(date()) + 11) // Result: 2027

return

Veja também

• Day
• Month