EXTRACT_MONTH_FROM_DATE

Extrai o mês de um valor do tipo DATE (que suporta apenas datas iguais ou posteriores a 1 de janeiro de 2000). É uma função.

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

Função

           EXTRACT_MONTH_FROM_DATE
         +-------------------------+
DATE ----|IN                       |---- UINT
         +-------------------------+

A função recebe uma data em IN e devolve o número do mês correspondente (1 a 12).

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-01-01	Data da qual se deseja extrair o mês.

Retorno / Saídas

Retorna um UINT com o mês (1 a 12) do valor DATE especificado.

Pré-condições

• O valor de IN deve ser igual ou posterior a 1 de janeiro de 2000 (limite inferior suportado pelo tipo DATE).

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 mês *)
    cur_mes  : UINT; (* Mês obtido da data especificada *)
END_VAR

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

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

(* ... *)
(* Exemplo 3 de chamada da função na POU *)
cur_mes  := HILS.EXTRACT_MONTH_FROM_DATE(DATE#2019-01-15);
           (* retorna valor cur_mes = 1 *)