Converte um texto em formato de data/hora para um objeto do tipo data/hora.
Para a conversão, é necessário informar no parâmetro Máscara exatamente o mesmo padrão de data e hora passado no parâmetro Conteúdo. Dessa forma, o bloco consegue reconhecer quais os caracteres do texto representam o ano, mês e assim por diante, convertendo o tipo texto para data.
Parâmetros de Entrada
Nome
Tipo
Doc
Parâmetro 1
String
String para conversão
Parâmetro 2
String
Máscara que representa o formato do texto
Retorno
Objeto do tipo DateTime.
Compatibilidade
Servidor
Exemplo 1
No exemplo abaixo, o bloco Converter texto para data recebe no parâmetro Conteúdo um texto no formato Data/hora e no parâmetro Máscara, o mesmo padrão utilizado no texto. Em seguida, o bloco converte o conteúdo para um objeto do tipo Date-time e alimenta a variável "data".
São realizadas 2 impressões no Console do depurador, na primeira é apresentado o conteúdo do objeto data e na segunda, é extraído e apresentado apenas o ano da data.
Figura 1- Exemplo de uso do bloco Converter texto para data
Sobre máscaras - Padrões para Formatação
Os padrões de máscara são baseados em sequências de letras e símbolos, usados para criar um formatador. Dentro de cadeias de padrões de data e hora, os padrões mais comumente empregados podem ser usados por uma combinação da letra y (representando um dígito de ano), M (representando um dígito de mês) e d (representando um dígito do dia).