IBM Lotus Symphony


Função DateValue [Runtime]

Devolve um valor de data a partir de uma cadeia de data. A sequência de data é uma data completa num só valor numérico. É também possível utilizar este ordinal para determinar a diferença entre duas datas.

Sintaxe:

DateValue [(data)]

Valor de retorno:

Data

Parâmetros:

Data: Expressão em caracteres que contém a data que pretende calcular. A data pode ser especificada em quase todos os formatos.

É possível utilizar esta função para converter uma data que ocorra entre 1 de Dezembro de 1582 e 31 de Dezembro de 9999 num só valor inteiro. Em seguida, é possível utilizar este valor para calcular a diferença entre duas datas. Se o argumento de data estiver fora do intervalo aceitável, o Lotus® Symphony™ Basic devolve uma mensagem de erro.

Ao contrário da função DateSerial que transfere anos, meses e dias como valores numéricos separados, a função DateValue transfere a data utilizando o formato "mês.[,]dia.[,]ano".

Pode definir a configuração regional utilizada para controlar os números de formatação, as datas e as unidades monetárias no Lotus Symphony Basic em Ferramentas - Opções - Definições de idioma - Idiomas. Nos códigos de formatação do Basic, a vírgula decimal (,) é sempre utilizada como marcador de posição do separador decimal definido na configuração regional e será substituída pelo carácter correspondente.

O mesmo se aplica às definições de configuração regional para os formatos da data, hora e moeda. O código de formatação do Basic será interpretado e apresentado de acordo com a configuração regional.

Códigos de erro

5 Chamada de procedimento não válido

Exemplo:

Sub ExampleDateValue

msgbox DateValue("12/02/1997")

end sub


Comentários sobre o produto | Documentação adicional | Marcas comerciais