DT_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 contrário a função irá falhar.

Bloco

        DT_TO_STRING
       +-------------+
DT ----|IN           |---- STRING
       +-------------+

Parâmetro

Nome	Parâmetro	Tipo Dado	V. Ini.	Descrição
IN	Entrada	DT		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.

Exemplo

Declaração de variáveis

Nome	Tipo	Valor Inicial	Descrição
str	STRING	‘’	string de teste
i_val	DT	‘DT#2008-06-25-15:36:55.36’	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 := DT_TO_STRING(i_val);
(* str recebe recebe o conteudo '2008-06-25-15:36:55.36' *)