cronapi.dateTime.Operations.formatDateTime

cronapi.dateTime.Operations.formatDateTime

Essa documentação diz respeito aos blocos de programação Formatar Data (depreciado) e Formatar Data com Fuso (depreciado), apesar de terem nomes parecidos, funcionam de formas diferentes.

Para mais detalhes sobre as máscaras aceitas por esses blocos, acesse a documentação oficial.

 

Os blocos a seguir estão depreciados e serão descontinuados em breve, recomendamos utilizar os novos blocos Formatar Data e Formatar Data com Fuso.

Formatar data [depreciado]

Formata uma determinada data a partir da máscara (padrão) informada. 

Esse bloco sempre retornará termos em inglês ao informar meses ou dias. Utilize o novo bloco Formatar Data para selecionar o idioma de retorno.

Parâmetros de Entrada

Nome

Tipo

Doc

Nome

Tipo

Doc

Parâmetro 1

data

Data para formatação

Parâmetro 2

String

Máscara a ser aplicada

Retorno

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

Compatibilidade

 Servidor

Exemplo 1

A função abaixo recebe a data e hora atual e aplica a máscara (EEEEE MMMMM yyyy HH:mm:ss.SSS) passada como parâmetro. O resultado está impresso no Console do Depurador. 

Figura 1 - Executando o bloco Formatar data

Formatar data com Fuso Horário [depreciado]

Formata uma determinada data (com um fuso horário) a partir da máscara (padrão) informada. 

Esse bloco sempre retornará termos em inglês ao informar meses ou dias. Utilize o novo bloco Formatar data com Fuso Horário para selecionar o idioma de retorno.

Parâmetros de Entrada

Nome

Tipo

Doc

Nome

Tipo

Doc

Parâmetro 1

data

Data para formatação

Parâmetro 2

String

Máscara a ser aplicada

Parâmetro 3

Inteiro

Valor do fuso horário. Não é necessário informar "+" para valores positivos.

Ex:

  • -5

  • 3

Retorno

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

Compatibilidade

 Servidor

Exemplo 1

A função abaixo recebe a data e hora atual, mais o fuso horário (3), e aplica a máscara (EEEEE MMMMM yyyy HH:mm) passada como parâmetro. O resultado está impresso no Console do Depurador.

Figura 2 - Executando o bloco Formatar data com Fuso Horário

Nessa página

 

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

  • dd/MM/yyyy

  • dd-MM-yyyy

  • MM/dd/yyyy

  • yyyy-MM-dd

  • yy/MM/dd

 


É possível ainda utilizar padrões específicos para hora, minuto e segundo.

Exemplo de padrão

dd/MM/yyyy hh:mm:ss

A letra h(representa um dígito da hora), m(representa um dígito de minuto) e s(representa um dígito do segundo). 

 

Saiba mais

Para saber mais sobre as máscaras, acesse os links abaixo: