Essa documentação diz respeito aos blocos de programação Converter texto para data e Converter texto para data com Fuso Horário, apesar de terem nomes parecidos, funcionam de formas diferentes.

Converter texto para data

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.

Figura 1 - Bloco de programação Converter texto para data

Compatibilidade

• Bloco servidor: cronapi.conversion.Operations.stringToDate()

Retorno

Retorna um objeto do tipo DateTime.

Parâmetros

Conteúdo

Local destinado para informar a string para conversão.

• Posição: 1
• Inglês: Content
• Tipo: Texto / String
• Exemplo: "05/09/2023 14:52:00"

Máscara

Neste campo o usuário deve introduzir a máscara que representa o formato do texto. Para mais detalhes, acesse a documentação Formatação de máscaras na camada servidor.

• Posição: 2
• Inglês: Mask
• Tipo: Texto / String
• Exemplo: "dd/MM/yyyy HH:mm:ss"

Exemplo 

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 DateTime 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 2 - Exemplo de uso do bloco Converter texto para data

Converter texto para data e hora com Fuso Horário

Converte um texto em formato de data/hora com fuso horário para um objeto do tipo data/hora com fuso horário.

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. Além desses dois parâmetros, é necessário informar o valor do Fuso Horário, esse valor é obtido através do servidor da aplicação, que pode ser alterado nas configurações do projeto.

Figura 3 - Bloco de programação Converter texto para data com Fuso Horário

Compatibilidade

• Bloco servidor: cronapi.conversion.Operations.stringToDate()

Retorno

Retorna um objeto do tipo DateTime.

Parâmetros

Conteúdo

Local destinado para informar a string para conversão.

• Posição: 1
• Inglês: Content
• Tipo: Texto / String
• Exemplo: "05/09/2023 14:52:00"

Máscara

Neste campo o usuário deve introduzir a máscara que representa o formato do texto. Para mais detalhes, acesse a documentação Formatação de máscaras na camada servidor.

• Posição: 2
• Inglês: Mask
• Tipo: Texto / String
• Exemplo: "dd/MM/yyyy HH:mm:ss"

Fuso Horário

Neste campo o usuário deve introduzir o valor do fuso horário, tanto positivo quanto negativo. Esse valor é obtido através do servidor da aplicação, podendo ser alterado nas configurações do projeto. Por padrão utilizamos o  GMT00:00 UTC. Acesse o tópico "Configuração do fuso horário" da documentação Entendendo o funcionamento dos tipos data e hora para mais detalhes.

• Posição: 3
• Inglês: Timezone
• Tipo: Inteiro / Integer
• Exemplo: 5

Exemplo 

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 DateTime, respeitando o valor do Fuso Horário informado.

Figura 4 - Exemplo de uso do bloco Converter texto para data e hora com Fuso Horário