Função de ER DATEVALUE
A função DATEVALUE devolve um valor Data que é convertido a partir de um determinado valor de texto no formato especificado e numa cultura opcionalmente especificada para um valor de data. Para obter informações sobre os formatos suportados, consulte padrão e personalizado.
Sintaxe 1
DATEVALUE (text, format)
Sintaxe 2
DATEVALUE (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
Data
O valor de data 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 DATEVALUE 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
DATEVALUE ("21-Dec-2016", "dd-MMM-yyyy") devolve o valor de data 21 de dezembro de 2016, com base no formato personalizado especificado e na cultura predefinida EN-US da aplicação.
Exemplo 2
DATEVALUE ("21-Gen-2016", "dd-MMM-yyyy", "IT") devolve o valor de data 21 de janeiro de 2016, com base no formato e na cultura personalizados especificados.
Contudo, DATEVALUE ("21-Gen-2016", "dd-MMM-yyyy", "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 para a cultura especificada.