EXTRACT_YEAR_FROM_DATE

Obtém o ano de um valor do tipo DATE.

Atenção

O tipo DATE suporta apenas valores de data igual ou superiores a 1 de janeiro de 2000

Nota

Esta função foi classificada como obsoleta e é mantida na biblioteca apenas para compatibilidade com aplicações legadas.

Para novos projetos utilize a função SPLIT_DATE

Bloco

           EXTRACT_YEAR_FROM_DATE
         +------------------------+
DATE ----|IN                      |---- UINT
         +------------------------+

Nome	Parâmetro	Tipo Dado	V. Ini.	Descrição
IN	Entrada	DATE	D#2000:01:01	Data do ano

Retorno

Tipo	Descrição
UINT	Ano do valor DATE especificado

Exemplo

Declaração de Variáveis

Nome	Tipo	Descrição
cur_data	DATE	Data a ser obtido o ano
cur_ano	UINT	Ano obtido da data especificada

Clique aqui para baixar a tabela de variáveis

Código ST

(* ... *)
(* Exemplo 1 de chamada da função na POU *)
cur_data := DATE#2019-05-20;
cur_ano  := HILS.EXTRACT_YEAR_FROM_DATE(IN := cur_data);
           (* retorna valor cur_ano = 2010 *)

(* ... *)
(* Exemplo 2 de chamada da função na POU *)
cur_data := DATE#2019-11-25;
cur_ano  := HILS.EXTRACT_YEAR_FROM_DATE(cur_data);
           (* retorna valor cur_ano = 2019 *)

(* ... *)
(* Exemplo 3 de chamada da função na POU *)
cur_ano  := HILS.EXTRACT_YEAR_FROM_DATE(DATE#2011-01-15);
           (* retorna valor cur_ano = 2011 *)

(* ... *)