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.

Recursos adicionais

Funções de data e hora