TOTVSTEC

Árvore de páginas

Você está vendo a versão antiga da página. Ver a versão atual.

Comparar com o atual Ver Histórico da Página

Versão 1 Atual »

Retorna o ano de uma determinada data.

Sintaxe

Year( < dData> )

Parâmetros

NomeTipoDescriçãoObrigatórioReferência
dDataDataIndica o valor data que será convertido.X 

Retorno

NomeTipoDescrição
nRetnumérico

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. Caso a data seja nula, o retorno será 0 (zero).

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

Exemplo 1 
User Function exemplo1()
	Year(DATE()) // Resultado:2008
Return
Exemplo 2 
User Function exemplo2()
	conout( DATE() )    // Resulta: 09/01/90
	conout( YEAR(DATE()) )    // Resulta: 1990
	conout( YEAR(DATE()) + 11 )   // Resulta: 2001
Return
Exemplo 3 
//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

 

  • Sem rótulos