Versões comparadas
Chave
- Esta linha foi adicionada.
- Esta linha foi removida.
- A formatação mudou.
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.
Âncora textoParaData textoParaData
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.
Parâmetros de Entrada
Image Added
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
Retorno
Objeto do tipo DateTime.
Compatibilidade
Image Removed Servidor
. 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
Exemplo 1No exemplo abaixo, o bloco Converter texto para data recebe no parâmetro Conteúdo um texto no formato Datadata/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 DateTime e alimenta a variável "data".
São 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.
Image RemovedImage Added
Figura 12 - Exemplo de uso do bloco Converter texto para data
Âncora | ||||
---|---|---|---|---|
|
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.
Image Added
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.
Image Added
Figura 4 - Exemplo de uso do bloco Converter texto para data e hora com Fuso Horário
Nesta Página
Índice |
---|
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).
Para conhecer os demais símbolos, acesse a documentação dos padrões utilizados no Java.