Formata uma determinada data, hora ou data e hora, a partir da máscara informada.


Figura 1 - Bloco Formatar data

Compatibilidade

  • Bloco cliente: cronapi.dateTime.formatDateTime()

Retorno

Retorna uma string formatada com o padrão da máscara passada como argumento.

Parâmetros

Data

Data a ser formatada.

Formato

Máscara a ser aplicada. Para saber mais sobre as máscaras, acesse a documentação Formatação de máscaras na camada cliente.

  • Posição: 2
  • Inglês: Format
  • Tipo: Texto / String
  • Exemplo: "DD/MM/YYYY HH:mm:ss"

Exemplo

A imagem abaixo exibe um exemplo de uso do bloco Formatar data. O bloco Formatar data converte o conteúdo obtido pelo bloco Obter data e hora atual (baseado no fuso horário do cliente) e formata utilizando a máscara "DD/MM/YYYY HH:mm:ss". Em seguida, será impresso no console do navegador o resultado do bloco Obter data e hora atual e a nova data formatada (Figura 2.1).


Figura 2 - Exemplo de uso do bloco Formatar data


Na imagem a seguir, o primeiro resultado mostra o retorno do bloco Obter data e hora atual, que exibe a hora com o fuso horário do cliente, neste exemplo, GMT -3. O segundo resultado apresenta o retorno do bloco Formatar Data, que exibe a mesma data e hora, mas convertida de acordo com a máscara informada e sem o fuso horário, por isso a diferença nas horas.


Figura 2.1 - Resultado de execução da função da Figura 2

Nesta página