Função DATEFORMAT ER
A função DATEFORMAT retorna um valor de Cadeia de caracteres que apresenta um valor de data determinado como texto no formato especificado e em uma cultura opcionalmente especificada. Para obter informações sobre os formatos com suporte, 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 do formato.
format: Cadeia de caracteres
O formato da cadeia de caracteres de saída. Para obter informações sobre os formatos com suporte, consulte padrão e personalizado.
Observação
A cadeia de caracteres de formato diferencia maiúsculas de minúsculas quando você usa um formato padrão ou um formato personalizado. Por exemplo, o especificador de formato "d" padrão retorna a data usando o padrão de data abreviada, enquanto o especificador de formato "D" padrão retorna a data usando o padrão de data por extenso. Além disso, o especificador de formato "M" personalizado retorna o mês de 1 a 12, enquanto o especificador "m" de formato personalizado retorna o minuto de 0 a 59.
culture: Cadeia de caracteres
A cultura a ser usada para formatação. Para obter informações sobre culturas com suporte, consulte cultura.
Valores de retorno
Sequência de caracteres
O valor da cadeia de caracteres resultante.
Notas de uso
Se a cultura não é definida como um argumento da função chamada, o valor de culture é definido pelo contexto de chamada. Por exemplo, se a função DATEFORMAT for chamada usando a sintaxe 1 em um formato de relatório eletrônico (ER) para um elemento FILE de arquivo configurado para usar a cultura alemã, a conversão será feita usando a cultura alemã. O valor padrão culture é EN-US.
Exemplo 1
DATEFORMAT (TODAY (), "dd-MM-yyyy") retorna a data atual do servidor do aplicativo, 24 de dezembro de 2015, como a cadeia de caracteres "24-12-2015", com base no formato personalizado especificado.
Exemplo 2
DATEFORMAT (SESSIONTODAY (), "d", "DE") retorna a data atual da sessão do aplicativo, 24 de dezembro de 2015, como a cadeia de caracteres "24-12-2015", com base na cultura alemã selecionada e no formato especificado.