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.

Recursos adicionais

Funções de data e hora