SET_DT_FORMAT

Define o código do formato aplicado na conversão dos tipos DATE, TOD e DT para STRING (0 = formato default, 1 = padrão ISO 8601); é uma função.

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

Função

         SET_DT_FORMAT
        +---------------+
FMT ----|               |
        +---------------+

Recebe em FMT o número do formato a ser aplicado nas conversões de DATE, TOD e DT (data/hora) para STRING e retorna o código do formato efetivamente aplicado. Os formatos disponíveis são:

Formato	DATE	TOD	DATETIME	Observação
0	2023-08-25	15:52:17	2023-08-25-15:52:17	Formato default
1	2023-08-25T	15:52:17Z	2023-08-25T15:52:17Z	Padrão ISO 8601

Nota

O CLP inicializa a STRING no formato Padrão ISO 8601 (1). Para utilizar o formato default, esta função deve ser chamada com o valor 0 durante a inicialização da aplicação.

Parâmetros

Nome	Direção	Tipo	Padrão	Faixa / Unidade	Descrição
FMT	IN	INT	0	0 .. 1	Número do formato a ser utilizado (0 = default; 1 = ISO 8601).

Retorno / Saídas

INT — código do formato efetivamente aplicado na conversão de DATE, TOD e DT para STRING.

Pré-condições

• Para adotar o formato default, chamar a função com FMT = 0 durante a inicialização da aplicação (o CLP inicia no formato ISO 8601).

Observações

• O formato definido vale para as conversões subsequentes de DATE, TOD e DT para STRING.

Exemplo

Clique aqui para baixar a tabela de variáveis

Código ST

VAR
    fmt : INT; (* Nro do formato a ser utilizado *)
END_VAR

(* Exemplo de utilizacao da funcao SET_DT_FORMAT *)
(* ... *)
fmt := HILS.SET_DT_FORMAT(1);
(* define o formato compativel com o padrao ISO 8601 *)

(* ... *)