Parâmetros de Entrada
| Nome | Tipo | Doc |
|---|---|---|
| Parâmetro 1 | String | String para conversão |
| Parâmetro 2 | String | Máscara a ser aplicada |
Retorno
Objeto do tipo DateTime.
Compatibilidade
Servidor
Cliente
Exemplo 1
Dada duas strings: o conteúdo a ser convertido "01/11/12" e uma máscara a ser aplicada "MM/dd/yy", a função deverá retornar um objeto do tipo DateTime convertido utilizando a máscara passada como parâmetro. O resultado da conversão abaixo é: 11/01/2012.
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).
Exemplos de padrões são:
| Informações | ||
|---|---|---|
| ||
dd/MM/yyyy, dd-MM-yyyy, MM/dd/yyyy, yyyy-MM-dd |
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
| Â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.
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
| Índice |
|---|