Função DATETIMEFORMAT ER
A função DATETIMEFORMAT retorna um valor da String que apresenta um valor de data/hora 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
DATETIMEFORMAT (datetime, format)
Sintaxe 2
DATETIMEFORMAT (datetime, format, culture)
Argumentos
datetime: DateTime
Um valor de data/hora que representa a data e a hora para formatação.
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 DATETIMEFORMAT 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.
Quando a função DATETIMEFORMAT converte um determinado valor de data/hora, ela considera a configuração de fuso horário do usuário do aplicativo que está executando o formato ER no qual a função é chamada pelo contexto.
Exemplo 1
DATETIMEFORMAT (NOW(), "dd-MM-yyyy") retorna o valor da data/hora atual do servidor do aplicativo, 24 de dezembro de 2015, como "24-12-2015", com base no formato personalizado especificado.
Exemplo 2
DATETIMEFORMAT (SESSIONNOW(), "d", "DE") retorna o valor de data/hora atual da sessão do aplicativo, 24 de dezembro de 2015, como "24.12.2015", com base na cultura alemã selecionada e no formato especificado.
Exemplo 3
DATETIMEFORMAT (DATETIMEVALUE( "2019-11-12T09:00:00.0000000-07:00", "O"), "O") retorna o valor de cadeia de caracteres 2019-11-12T08:00:00.0000000-08:00 quando a função é chamada durante um processo iniciado por um usuário de aplicativo com o valor de fuso horário (GMT-08:00) Hora do Pacífico (EUA e Canadá) na seção Preferências de idioma e país/região.