Função DATEVALUE ER
A função DATEVALUE retorna um valor de Data que é convertido de um valor de texto determinado no formato especificado e em uma cultura opcionalmente especificada para um valor de data. Para obter informações sobre os formatos com suporte, consulte padrão e personalizado.
Sintaxe 1
DATEVALUE (text, format)
Sintaxe 2
DATEVALUE (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
O valor de data 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 DATEVALUE 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
DATEVALUE ("21-Dec-2016", "dd-MMM-yyyy") retorna o valor de data 21 de dezembro de 2016 com base no formato personalizado especificado e na cultura padrão EN-US do aplicativo.
Exemplo 2
DATEVALUE ("21-Gen-2016", "dd-MMM-yyyy", "IT") retorna o valor de data 21 de janeiro de 2016, com base no formato e cultura personalizados especificados.
Porém, DATEVALUE ("21-Gen-2016", "dd-MMM-yyyy", "EN-US") gerará uma exceção para informar ao usuário que a sequência de caracteres especificada não é reconhecida como uma data válida da cultura especificada.