TOD_TO_STRING

Converte e retorna o valor da hora do dia fornecida em uma string. Se a string de retorno não puder receber o valor fornecido 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().

Nota

É de responsabilidade do usuário garantir que a string que irá receber o valor convertido tem um tamanho suficiente para receber o tamanho convertido, caso contrario a função irá falhar.

Bloco

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

Parâmetro

Nome	Parâmetro	Tipo Dado	V. Ini.	Descrição
IN	Entrada	TOD		valor a ser convertido para string

Retorno

Tipo Dado	Descrição
STRING	Valor da data (parâmetro IN) em formato string. Se falha no processo seta variável de erro de sistema (SYSTEM_ERR) com o valor FAIL.

Nota

O formato da string retornada pela função pode ser configurado através da função SET_DT_FORMAT.

Exemplo

Declaração de variáveis

Nome	Tipo	Valor Inicial	Descrição
str	STRING	‘’	string de teste
i_val	TOD	‘TOD#15:36:28’	valor a ser convertido

Clique aqui para baixar a tabela de variáveis

Código ST

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

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