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 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.


Aviso

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.


Âncora
formatDateTime
formatDateTime

Formatar data [depreciado]

Formata uma determinada

data utilizando um padrão específico

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

Dica

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

NomeTipoDoc
Parâmetro 1dataData para formatação
Parâmetro 2StringMáscara a ser aplicada

Retorno

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

Compatibilidade

Image Added 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. 


Image Added

Figura 1 - Executando o bloco Formatar data


Âncora
formatDateTimeFuse
formatDateTimeFuse

Formatar data com Fuso Horário [depreciado]

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

Dica

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

NomeTipoDoc
Parâmetro 1dataData para formatação
Parâmetro 2StringMáscara a ser aplicada
Parâmetro 3Inteiro

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

Image Modified Servidor

Image Removed Cliente

Exemplo 1

A função abaixo recebe a data e hora atual, mais o fuso horário (3), e aplica a máscara (

MM/dd/yy) passada como parâmetro. 

EEEEE MMMMM yyyy HH:mm) passada como parâmetro. O resultado está impresso no Console do Depurador.


Image Added

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

Nessa página

Índice

Image Removedtitle


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). 

Informações
title
Saiba mais

Para saber mais sobre as máscaras, acesso o link ao lado: Formatação de máscaras para campos de texto.

Dica
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.

tip
Informações
titleExemplo 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). 


Informações
titleSaiba mais

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