CDBL

Syntaxe

Paramètres

Description

Cette fonction permet de convertir un type de données quelconque à un format de double précision.

Remarques

• La fonction convertit une expression en nombre à double précision : La fonction CDbl transforme une expression compatible en une valeur de type Double. Ce type numérique permet de représenter des nombres très grands ou très petits tout en conservant une excellente précision. Il est largement utilisé dans les calculs scientifiques, techniques et financiers nécessitant davantage de précision qu'un entier.
• Le type Double permet de manipuler des nombres décimaux avec une grande précision : Contrairement aux types Integer ou Long, qui ne peuvent entreposer que des nombres entiers, le type Double accepte les valeurs décimales. Il offre environ 15 chiffres significatifs de précision, ce qui convient à la majorité des calculs numériques complexes. Cette précision est suffisante pour de nombreuses applications de simulation, de statistiques ou d'ingénierie.
• La fonction accepte plusieurs types de données en entrée : Le paramètre peut être un entier, un nombre décimal, une chaîne contenant une valeur numérique, une variable, un champ de table ou encore le résultat d'une expression arithmétique. CDbl tente d'interpréter automatiquement cette valeur afin de produire un nombre à double précision. Si la conversion est possible, le résultat est directement exploitable dans les calculs.
• Une conversion invalide génère une erreur d'exécution : Si l'expression ne contient pas une valeur numérique valide, Access retourne une erreur de conversion. Par exemple, une chaîne telle que "Bonjour" ne peut pas être convertie en type Double. Pour éviter ce problème, il est recommandé d'utiliser la fonction IsNumeric avant d'appeler CDbl lorsque les données proviennent d'une source externe.
• La fonction est souvent utilisée avant des calculs complexes : Dans de nombreuses applications Access, CDbl permet de convertir explicitement des valeurs avant d'effectuer des divisions, des calculs trigonométriques ou des opérations statistiques. Cette conversion garantit que les calculs seront réalisés avec la précision du type Double. Elle permet également d'éviter certaines conversions implicites réalisées par le moteur VBA.
• Le type Double utilise une représentation en virgule flottante : Les valeurs de type Double sont entreposées selon le standard IEEE 754 en virgule flottante. Cette représentation offre une très grande plage de valeurs, mais peut introduire de légères erreurs d'arrondi lors de certains calculs. Pour cette raison, le type Currency est généralement préférable lorsqu'il s'agit exclusivement de montants financiers.
• La fonction peut être utilisée dans les requêtes et dans le code VBA : CDbl est disponible aussi bien dans les modules VBA que dans les requêtes SQL, les formulaires, les états et les contrôles calculés. Cette polyvalence permet d'effectuer des conversions directement dans les expressions Access sans devoir créer de procédures personnalisées. Le même comportement est conservé dans tous ces environnements.
• Elle fait partie des fonctions de conversion du langage VBA : La fonction CDbl appartient à la famille des fonctions de conversion comprenant notamment CBool, CByte, CCur, CDate, CInt, CLng, CSng et CStr. Ces fonctions permettent de convertir explicitement une valeur vers un type précis. Leur utilisation améliore la lisibilité du code et réduit les risques liés aux conversions automatiques.
• Elle est utile lors de l'importation de données : Lorsqu'un fichier texte, CSV ou Excel contient des nombres enregistrés sous forme de chaînes de caractères, CDbl permet de les convertir rapidement en véritables valeurs numériques. Une fois la conversion effectuée, les données peuvent être utilisées dans des calculs, des graphiques ou des analyses statistiques. Cette fonction est donc très fréquente dans les procédures d'importation.
• La fonction est compatible avec toutes les versions modernes de Microsoft Access : CDbl est présente depuis les premières versions d'Access intégrant VBA et son comportement est resté stable au fil des années. Elle est compatible avec Access 2000, Access XP, Access 2003, Access 2007, Access 2010, Access 2013, Access 2016 ainsi qu'avec Microsoft 365. Cette stabilité garantit la compatibilité des applications Access développées sur différentes générations du logiciel.

Exemple de code VBA

La fonction CDbl peut être utilisée dans le code VBA de Microsoft Access.

Par exemple :

La variable appelée LDouble contiendrait désormais la valeur 0,0004225.