Função de ER DATETIMEFORMAT
A função DATETIMEFORMAT devolve um valor Cadeia que apresenta um determinado valor de data/hora 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
DATETIMEFORMAT (datetime, format)
Sintaxe 2
DATETIMEFORMAT (datetime, format, culture)
Argumentos
datetime: DateTime
Um valor de data/hora que representa a data e a hora 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 DATETIMEFORMAT 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.
Quando a função DATETIMEFORMAT converte um determinado valor de data/hora, considera a definição do fuso horário do utilizador da aplicação que está a executar o formato de ER no contexto do qual a função é chamada.
Exemplo 1
DATETIMEFORMAT (NOW(), "dd-MM-yyyy") devolve o valor de data/hora do servidor de aplicações atual, 24 de dezembro de 2015, como "24-12-2015", com base no formato personalizado especificado.
Exemplo 2
DATETIMEFORMAT (SESSIONNOW(), "d", "DE") devolve o valor de data/hora da sessão da aplicação atual, 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") devolve o valor de cadeia 2019-11-12T08:00:00.0000000-08:00 quando a função é chamada durante um processo que foi iniciado por um utilizador da aplicação com o valor de fuso horário (GMT-08:00) Hora do Pacífico (E.U.A. e Canadá) na secção Preferências de idioma e país/região.