CDate

Devolve uma expressão que foi convertida num Variant do subtipo Date.

Estrutura

CDate(data)

Parâmetros

O argumento «date» pode ser qualquer expressão de data válida.

Descrição

Utilize a função IsDate para determinar se a data pode ser convertida numa data ou hora. O CDate reconhece literais de data e de hora, bem como alguns números que se enquadram no intervalo de datas aceitáveis. Ao converter um número numa data, a parte inteira do número é convertida numa data. Qualquer fração do número é convertida numa hora do dia, a partir da meia-noite.

O CDate reconhece os formatos de data de acordo com as configurações regionais do seu sistema. A ordem correta do dia, mês e ano poderá não ser determinada se for fornecida num formato diferente das configurações de data reconhecidas. Além disso, um formato de data longo não é reconhecido se também contiver a sequência do dia da semana.

Exemplo

O exemplo seguinte utiliza a função CDate para converter uma cadeia de caracteres numa data. Em geral, não é recomendável definir datas e horas como cadeias de caracteres (como se vê neste exemplo). Em vez disso, utilize literais de data e hora (como #19/10/1962#, #16:45:23#).

MyDate = "19 de outubro de 1962" ' Definir data.

MyShortDate = CDate(MyDate) ' Converter para o tipo de dados Date.

MyTime = "16:35:47" ' Definir a hora.

MyShortTime = CDate(MyTime) ' Converter para o tipo de dados Date. |