IBM Lotus Symphony


Função DateValue [Tempo de Execução]

Retorna um valor de data de uma sequência de caracteres de data. A sequência de data é uma data completa em um único valor numérico. Você também pode usar esse número de série para determinar a diferença entre duas datas.

Sintaxe:

DateValue [(date)]

Valores de Retorno:

Data

Parâmetros:

Date: Expressão de sequência que contém a data que você deseja calcular. A data pode ser especificada na maioria dos formatos.

É possível usar essa função para converter uma data que ocorra entre 1º de dezembro de 1582 e 31 de dezembro de 9999 em um único valor inteiro. Pode ainda usar esse valor para calcular a diferença entre as duas datas. Se o argumento de data estiver fora do intervalo aceitável, o Lotus® Symphony™ Basic retornará uma mensagem de erro.

Ao contrário da função DateSerial que transmite anos, meses e dias como valores numéricos separados, a função DateValue transmite a data usando o formato "month.[,]day.[,]year".

É possível definir o código do idioma usado para controlar os números, datas e moedas de formatação no Lotus Symphony Basic em Ferramentas - Opções - Definições de Idioma - Idiomas. Em códigos de formatação Basic, o ponto decimal (.) é sempre usado como marcador para o separador de decimal definido no local e será substituído pelo caractere correspondente.

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

Códigos de Erro

5 Chamada de procedimento inválida

Exemplo:

Sub ExampleDateValue

msgbox DateValue("12/02/1997")

end sub


Feedback do Produto | Documentação Adicional | Marcas Registradas