Função DATETIMEVALUE ER

A função DATETIMEVALUE retorna um valor DateTime que é convertido de um valor de texto determinado no formato especificado e em uma cultura para um valor de data/hora. Para obter informações sobre os formatos com suporte, consulte padrão e personalizado.

Sintaxe 1

DATETIMEVALUE (text, format)

Sintaxe 2

DATETIMEVALUE (text, format, culture)

Argumentos

text: Cadeia de caracteres

Texto que representa o valor do formato.

format: Cadeia de caracteres

O formato de determinado texto. Para obter informações sobre os formatos com suporte, consulte padrão e personalizado.

culture: Cadeia de caracteres

A cultura usada para a formatação do texto especificado. Para obter informações sobre culturas com suporte, consulte cultura.

Valores de retorno

Data e Hora

O valor de data/hora resultante.

Notas de uso

Quando 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 DATETIMEVALUE 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

DATETIMEVALUE ("21-Dec-2016 02:55:00", "dd-MMM-yyyy hh:mm:ss") retorna o valor de data 2:55:00 AM em 21 de dezembro de 2016 com base no formato personalizado especificado e na cultura padrão EN-US do aplicativo.

Exemplo 2

DATETIMEVALUE ("21-Gen-2016 02:55:00", "dd-MMM-yyyy hh:mm:ss", "IT") retorna 2:55:00 em 21 de dezembro de 2016, com base no formato e cultura personalizados especificados.

Porém, DATETIMEVALUE ("21-Gen-2016 02:55:00", "dd-MMM-yyyy hh:mm:ss", "EN-US") gerará uma exceção para informar ao usuário que a sequência de caracteres especificada não é reconhecida como um valor de data/tempo válido da cultura especificada.

Recursos adicionais

Funções de data e de hora