EXTRACT_YEAR_FROM_DATE

Obtém o ano de um valor do tipo DATE, que suporta apenas datas iguais ou superiores a 1 de janeiro de 2000. É uma função.

Biblioteca: HI_STD · Namespace: HILS · Tipo: função

Função

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

Atenção

O tipo DATE suporta apenas valores de data iguais 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.

Parâmetros

Nome	Direção	Tipo	Padrão	Faixa / Unidade	Descrição
IN	IN	DATE	D#2000:01:01	>= 2000	Data da qual se extrai o ano.

Retorno / Saídas

Retorna um UINT com o ano do valor DATE especificado.

Ver também

SPLIT_DATE

Exemplo

Clique aqui para baixar a tabela de variáveis

Código ST

VAR
    cur_data : DATE; (* Data a ser obtido o ano *)
    cur_ano  : UINT; (* Ano obtido da data especificada *)
END_VAR

(* 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 cur_ano = 2019 *)

(* 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 cur_ano = 2019 *)

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