Função de ER DATETIMEVALUE
A função DATETIMEVALUE devolve um valor DateTime que é convertido a partir de um determinado valor de texto no formato especificado e numa cultura opcionalmente especificada para um valor de data/hora. Para obter informações sobre os formatos suportados, consulte padrão e personalizado.
Sintaxe 1
DATETIMEVALUE (text, format)
Sintaxe 2
DATETIMEVALUE (text, format, culture)
Argumentos
text: Cadeia
Texto que representa o valor a formatar.
format: Cadeia
O formato do texto especificado. Para obter informações sobre os formatos suportados, consulte padrão e personalizado.
culture: Cadeia
A cultura utilizada para a formatação do texto especificado. Para obter informações sobre as culturas suportadas, consulte cultura.
Valores de retorno
DateTime
O valor de data/hora resultante.
Notas de utilização
Quando a cultura não é definida como um argumento da função chamada, o valor culture é definido pelo contexto de chamada. Por exemplo, se a função DATETIMEVALUE 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
DATETIMEVALUE ("21-Dec-2016 02:55:00", "dd-MMM-yyyy hh:mm:ss") devolve 2:55:00 AM em 21 de dezembro de 2016, com base no formato personalizado especificado e na cultura predefinida EN-US da aplicação.
Exemplo 2
DATETIMEVALUE ("21-Gen-2016 02:55:00", "dd-MMM-yyyy hh:mm:ss", "IT") devolve 2:55:00 AM em 21 de dezembro de 2016, com base no formato e na cultura personalizados especificados.
Contudo, DATETIMEVALUE ("21-Gen-2016 02:55:00", "dd-MMM-yyyy hh:mm:ss", "EN-US") inicia uma exceção para informar o utilizador de que a cadeia especificada não é reconhecida como um valor válido de data/hora para a cultura especificada.