Histórico da Página
Composition Setup |
---|
import.css=/download/attachments/6062824/tecnologia.css
|
Pagetitle | ||||
---|---|---|---|---|
|
Retorna o ano de correspondente a uma determinada data.
Sintaxe
Bloco de código | ||
---|---|---|
| ||
yearYear( < dDate dData>> ) |
Parâmetros
Nome | Tipo | Descrição | Obrigatório | Referência |
---|---|---|---|---|
dData dDate | Data data | Indica o valora data que será convertidoconvertida. | X |
|
Retorno
Nome | Tipo | Descrição |
---|---|---|
nRet nYear | numérico | Retorna o ano do valor correspondente a data especificadoinformada, inclusive os dígitos indicativos de referente ao 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
- 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
Bloco de código | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
Bloco de código | theme | Eclipse|||||||||
| ||||||||||
Useruser Functionfunction exemplo1exemplo() Year(DATE conOut(date()) // Resultado:2008 Return | ||||||||||
Bloco de código | ||||||||||
| ||||||||||
User Function exemplo2() conout( DATE() ) // ResultaResult: 0902/0126/90 conout( YEAR(DATE()) ) // Resulta: 1990 conout( YEAR(DATE16 conOut(year(date())) + 11 ) // ResultaResult: 2001 Return |
Bloco de código | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
//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
...
2016
conOut(year(date()) + 11) // Result: 2027
return
|
Veja também
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas