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.