TOD_TO_STRING

Converte o valor de hora do dia (TOD) fornecido para uma string e o retorna; é uma função pura (sem estado) que, em caso de falha na conversão, seta a variável de erro de sistema com o valor HILS.FAIL (1).

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

Função

         TOD_TO_STRING
        +-------------+
TOD ----|IN           |---- STRING
        +-------------+

Esta função converte o valor de hora do dia informado em IN para uma string. Se a string de retorno não puder receber o valor convertido a função seta a variável de erro de sistema com o valor HILS.FAIL (1). Este valor pode ser obtido através da função GET_SYSTEM_ERR().

Parâmetros

Nome	Direção	Tipo	Padrão	Faixa / Unidade	Descrição
IN	IN	TOD	—	—	Valor de hora do dia a ser convertido para string.

Retorno / Saídas

Tipo	Faixa / Unidade	Descrição
STRING	—	Valor da hora do dia (parâmetro `IN`) em formato string. Em caso de falha no processo, seta a variável de erro de sistema (SYSTEM_ERR) com o valor FAIL.

Observações

É de responsabilidade do usuário garantir que a string que irá receber o valor convertido tenha tamanho suficiente para receber o resultado da conversão, caso contrário a função irá falhar.
O formato da string retornada pela função pode ser configurado através da função SET_DT_FORMAT.

Exemplo

Clique aqui para baixar a tabela de variáveis

Código ST

VAR
    str   : STRING := '';         (* string de teste *)
    i_val : TOD := TOD#15:36:28;  (* valor a ser convertido *)
END_VAR

(* Exemplo de ativação da função dentro da POU *)
(* ... *)

str := TOD_TO_STRING(i_val);
(* str recebe o conteúdo 'T15:36:28Z' *)