EXTRACT_DAY_FROM_DATE

Extrai o dia do mês de um valor do tipo DATE, retornando um UINT; o tipo DATE só admite datas iguais ou superiores a 1º de janeiro de 2000. É uma função.

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

Função

           EXTRACT_DAY_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	DATE#2000-01-01	`>= 2000-01-01`	Data da qual se extrai o dia do mês.

Retorno / Saídas

Retorna um UINT com o dia do mês (1 .. 31) da data informada em IN.

Pré-condições

IN deve conter uma data igual ou superior a 1 de janeiro de 2000.

Observações

Função obsoleta; prefira SPLIT_DATE em novos projetos.

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 dia *)
    cur_dia  : UINT; (* Dia obtido da data especificada *)
END_VAR

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

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

(* ... *)
(* Exemplo 3 de chamada da função na POU *)
cur_dia  := HILS.EXTRACT_DAY_FROM_DATE(DATE#2019-05-15);
           (* retorna valor cur_dia = 15 *)