Funções de conversão de tipo

Cada função coagi um expressão a um tipo de dados específico .

Sintaxe

CBool( expression )

CByte( expression )

CCur( expression )

CDate( expression )

CDbl( expression )

CDec( expression )

CInt( expression )

CLng( expression )

CSng( expression )

CStr( expression )

CVar( expressão )

A expressão necessáriaargumento é qualquer expressão de cadeia de caracteres ou expressão numérica.

Tipos de Retorno

O nome da função determina o tipo de retorno, conforme mostrado no seguinte:

Comentários

Se a expressão passada para a função estiver fora do intervalo do tipo de dados em que está sendo convertido, ocorrerá um erro.

Em geral, você pode documentar seu código usando as funções de conversão do tipo de dados para mostrar que o resultado de alguma operação deve ser expresso como um tipo de dados específico, em vez do tipo de dados padrão. Por exemplo, use cCur para forçar a aritmética de moeda nos casos em que a aritmética de precisão única, precisão dupla ou aritmética inteiro normalmente ocorreria.

Você deve usar as funções de conversão do tipo de dados em vez do Val para fornecer conversões internacionalmente conscientes de um tipo de dados para outro. Por exemplo, quando você usa CCur, separadores decimal diferentes, milhares de separadores diferentes e várias opções de moeda são devidamente reconhecidos dependendo da configuração de localidade do computador.

Quando a parte fracionária é exatamente 0,5, CInt e CLng sempre arredondam para o número par mais próximo. Por exemplo, 0,5 rodadas para 0 e 1,5 rodadas para 2. CInt e CLng diferem das funções Fix e Int , que truncam, em vez de arredondar, a parte fracionária de um número. Além disso, Correção e Int sempre retornam um valor do mesmo tipo que é passado.

Use a função IsDate para determinar se a data pode ser convertida em uma data ou hora. O CDate reconhece literais de data e literais de hora, bem como alguns números que se enquadram no intervalo de datas aceitáveis. Ao converter um número em uma data, a parte número inteiro é convertida em uma data. Qualquer parte fracionária do número é convertida em uma hora do dia, começando à meia-noite.

O CDate reconhece formatos de data de acordo com a configuração localidade do sistema. A ordem correta de dia, mês e ano pode não ser determinada se ela for fornecida em um formato diferente de uma das configurações de data reconhecidas. Além disso, um formato de data longa não será reconhecido se ele também contiver a cadeia de caracteres do dia da semana.

Uma função CVDate também é fornecida para compatibilidade com versões anteriores do Visual Basic. A sintaxe da função CVDate é idêntica à função CDate , no entanto, o CVDate retorna uma Variant cujo subtipo é Date em vez de um tipo de Data real. Como agora há um tipo de Data intrínseca, não há mais necessidade de CVDate. O mesmo efeito pode ser obtido convertendo uma expressão em uma Data e atribuindo-a a uma Variant. Essa técnica é consistente com a conversão de todos os outros tipos intrínsecos em seus subtipos variant equivalentes.