Usina BRGuía AdvPL
Ingresar
← Todos los temas
FUNCIóNEn revisión

Year

Year(dDate) -> nYear

Extrae año numérico de fecha.

YearAdvPL
01 · DESCRIPCIÓN GENERAL

Descripción general

Year recibe fecha y retorna año de cuatro dígitos independientemente de SET DATE/SET CENTURY. Fecha vacía retorna cero. Convertir string inválido no garantiza año válido: valide tipo y origen. Ejemplo comunitario usa Date(); adaptación fija fecha para expectativa independiente del reloj. (Fuentes: refs. 1–2.)

02 · SINTAXIS

Sintaxis

Year(dDate) -> nYear

Parámetros

dDate
FechaObligatorio

Fecha de referencia.

Retorno

Numérico; año o cero con fecha vacía.

03 · EJEMPLO PRÁCTICO

Ejemplo comentado

#Include "Protheus.ch"

User Function Ed734()
    Local dReferencia := StoD("20261028")
    // AAAAMMDD evita depender de presentación regional.
    ConOut(Year(dReferencia))
Return Nil
Resultado esperado

Resultado numérico esperado: 2026. En revisión: ejemplo editorial no compilado ni ejecutado en Protheus. Comprobar includes, release, RDD y contexto antes de probar.

BUENAS PRÁCTICAS
  • Year no formatea fechas ni valida período fiscal. Trate fechas vacías explícitamente.
  • En revisión: ejemplo editorial no compilado ni ejecutado en Protheus. Comprobar includes, release, RDD y contexto antes de probar.

Contenido relacionado

REFERENCIAS
  1. TOTVS. Year. Consulta el 2026-10-28.
  2. Atilio. dan-atilio/AdvPL. Maratona de Exemplos/Exemplo_548_Funcao_Year.prw. Arquivo completo analisado; adaptação editorial. Consulta el 2026-10-28.
Estado
En revisión
Página creada el
Última revisión el
Idioma original
Portugués
Revisión
Usina.BR
0 comentario(s) aprobado(s)

Comentarios

Todavía no hay comentarios aprobados.

Inicia sesión con Google o Microsoft para comentar.

Desarrollado con Usina Docs · Alpha