DATE_TO_STRING

Converte e retorna o valor da data 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

          DATE_TO_STRING
         +-------------+
DATE ----|IN           |---- STRING
         +-------------+

Parâmetro

Nome	Parâmetro	Tipo Dado	V. Ini.	Descrição
IN	Entrada	DATE		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	DATE	D#2008-06-25	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 := DATE_TO_STRING(i_val);
(* str recebe recebe o conteudo '2008-06-25' *)