Função de ER DATEFORMAT
A função DATEFORMAT devolve um valor Cadeia que apresenta um determinado valor de data como texto no formato especificado e numa cultura opcionalmente especificada. Para obter informações sobre os formatos suportados, consulte padrão e personalizado.
Sintaxe 1
DATEFORMAT (date, format)
Sintaxe 2
DATEFORMAT (date, format, culture)
Argumentos
date: Data
Um valor de data que representa a data a formatar.
format: Cadeia
O formato da cadeia de saída. Para obter informações sobre os formatos suportados, consulte padrão e personalizado.
Nota
A cadeia de formato é sensível às maiúsculas e minúsculas quando utiliza um formato padrão ou um formato personalizado. Por exemplo, o especificador de formato padrão "d" devolve a data utilizando o padrão de data abreviada, enquanto o especificador de formato padrão "D" devolve a data utilizando o padrão de data por extenso. Adicionalmente, o especificador de formato personalizado "M" devolve o mês de 1 a 12, enquanto o especificador de formato personalizado "m" devolve o minuto de 0 a 59.
culture: Cadeia
A cultura a utilizar para a formatação. Para obter informações sobre as culturas suportadas, consulte cultura.
Valores de retorno
Cadeia
O valor de cadeia resultante.
Notas de utilização
Se a cultura não for definida como um argumento da função chamada, o valor culture é definido pelo contexto de chamada. Por exemplo, se a função DATEFORMAT for chamada utilizando a sintaxe 1 num formato de Relatórios eletrónicos (ER) para um elemento FICHEIRO configurado para utilizar a cultura alemã, a conversão será efetuada utilizando a cultura alemã. O valor culture predefinido é EN-US.
Exemplo 1
DATEFORMAT (TODAY (), "dd-MM-yyyy") devolve o valor de data do servidor de aplicações atual, 24 de dezembro de 2015, como a cadeia "24-12-2015", com base no formato personalizado especificado.
Exemplo 2
DATEFORMAT (SESSIONTODAY (), "d", "DE") devolve a data da sessão da aplicação atual, 24 de dezembro de 2015, como a cadeia "24-12-2015", com base na cultura alemã selecionada e no formato especificado.