dDateDataObrigatório
Data de referência.
FUNçãOEm revisão
Year
Year(dDate) -> nYearExtrai o ano numérico de uma data.
Visão geral
Year recebe uma data e retorna o ano com quatro dígitos, independentemente de SET DATE e SET CENTURY. Data vazia retorna zero. Converter uma string inválida em data e assumir um ano válido são etapas diferentes: valide o tipo e a origem. O exemplo comunitário usa Date(); aqui a data fixa torna a expectativa reproduzível sem depender do relógio. (Fontes: refs. 1–2.)
Sintaxe
Year(dDate) -> nYearParâmetros
Retorno
Numérico; ano ou zero para data vazia.
Exemplo comentado
#Include "Protheus.ch"
User Function Ed734()
Local dReferencia := StoD("20261028")
// A ordem AAAAMMDD evita depender da apresentacao regional.
ConOut(Year(dReferencia))
Return NilResultado esperado
Resultado numérico esperado: 2026. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.
- Year não formata datas nem valida um período fiscal. Tratar explicitamente datas vazias.
- Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.
Comentários
Ainda não há comentários aprovados.
Entre com Google ou Microsoft para comentar.