DATE_TO_STRING

Converte o valor de uma data (DATE) em uma string; é uma função pura (sem estado; retorna o resultado diretamente).

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

Função

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

Esta função converte o valor de entrada IN (tipo DATE) para uma string de saída, no formato configurado através da função SET_DT_FORMAT.

Se a string de retorno não tiver tamanho suficiente para receber o valor convertido, a função falha e 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 tamanho suficiente para receber o valor convertido, caso contrário a função irá falhar.

Parâmetros

Nome	Direção	Tipo	Faixa / Unidade	Descrição
IN	IN	DATE	—	Valor da data a ser convertido para string.

Retorno / Saídas

Tipo	Faixa / Unidade	Descrição
STRING	—	Valor da data (parâmetro `IN`) convertido em formato string. Se a conversão falhar, a variável de erro de sistema (`SYSTEM_ERR`) é setada com o valor `FAIL`.

Observações

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 : DATE := D#2008-06-25; (* valor a ser convertido *)
END_VAR

(* Exemplo de ativação da função dentro da POU *)
(* ... *)
str := DATE_TO_STRING(i_val);
(* str recebe o conteudo '2008-06-25' *)