SPLIT_DATE

Recebe um valor do tipo DATE e retorna o dia, o mês e o ano correspondentes. É uma função pura (sem estado; os resultados são passados pelos parâmetros de saída).

Biblioteca: IEC_STD · Namespace: IEC · Tipo: função

Função

           SPLIT_DATE
         +-------------+
DATE ----|IN       YEAR|---- ANY_INT
         |             |
         |        MONTH|---- ANY_INT
         |             |
         |          DAY|---- ANY_INT
         +-------------+

Esta função separa um valor DATE em seus componentes de ano, mês e dia. Cada saída pode ser atribuída a qualquer tipo do grupo ANY_INT.

Nota

Se YEAR, MONTH ou DAY forem declarados como SINT ou USINT, a função retorna todos os parâmetros de saída iguais a zero, pois esses tipos não suportam a faixa de valores possíveis de serem atribuídos.

Parâmetros

Nome	Direção	Tipo	Faixa / Unidade	Descrição
IN	IN	DATE	—	Valor a ser separado.
YEAR	OUT	ANY_INT	2000 ..	Ano.
MONTH	OUT	ANY_INT	1 .. 12	Mês.
DAY	OUT	ANY_INT	1 .. 31	Dia.

Retorno / Saídas

Esta função não possui valor de retorno próprio; os resultados são passados pelos parâmetros de saída YEAR, MONTH e DAY (ver tabela de Parâmetros).

Exemplo

Clique aqui para baixar a tabela de variáveis

Código ST

VAR
    cur_date : DATE; (* Data a ser separada *)
    cur_day  : UINT; (* Dia *)
    cur_mon  : UINT; (* Mes *)
    cur_year : UINT; (* ano *)
END_VAR

(* ... *)
(* Exemplo 1 de chamada da função na POU *)
SPLIT_DATE(IN := cur_date, YEAR := cur_year, MONTH := cur_mon, DAY := cur_day);
(* recebe os valores de dia, mes e ano em cada parametro *)
(* ... *)