- Criado por Usuário desconhecido (557058:4b1b311a-8636-4ab4-87d8-6a41e4d941bf), última alteração por Igor Andrade em 12/09/2023
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
Nesta Página