CCUR

Syntaxe

Paramètres

Description

Cette fonction permet de convertir un type de données quelconque à un format de monnaie.

Remarques

• La fonction convertit une expression en type Monnaie (Currency) : La fonction CCur transforme une expression numérique compatible en une valeur de type Currency (Monnaie). Ce type de données est spécialement conçu pour représenter des montants financiers avec une grande précision. Il est particulièrement adapté aux applications de comptabilité, de facturation ou de gestion commerciale.
• Le type Monnaie offre une précision supérieure aux nombres à virgule flottante : Contrairement aux types Single et Double, le type Currency utilise une représentation à virgule fixe. Cette approche réduit considérablement les erreurs d'arrondi pouvant apparaître lors des calculs financiers. Pour cette raison, il est fortement recommandé d'utiliser CCur lorsqu'il est question de devises ou de montants monétaires.
• La fonction effectue un arrondi lorsque cela est nécessaire : Si l'expression contient davantage de décimales que ne peut en représenter le type Currency, Access effectue automatiquement un arrondi. Ce comportement garantit que la valeur obtenue respecte la précision du type Monnaie. Il convient toutefois de vérifier les règles d'arrondi si l'application est soumise à des exigences comptables particulières.
• Elle accepte différents types de données compatibles : Le paramètre peut être un entier, un nombre décimal, une variable, un champ de table ou une expression arithmétique. Dans certains cas, une chaîne contenant une valeur numérique peut également être convertie. Si le contenu ne représente pas un nombre valide, Access génère une erreur de conversion.
• La fonction est particulièrement adaptée aux calculs financiers : CCur est largement utilisée pour manipuler des prix, des salaires, des taxes, des intérêts ou des montants de factures. Grâce à sa précision, elle évite les petites erreurs d'accumulation qui peuvent apparaître lors d'additions ou de multiplications répétées avec des nombres à virgule flottante. Elle constitue donc un excellent choix pour les applications de gestion.
• Le type Currency peut représenter de très grandes valeurs : Le type Monnaie prend en charge des montants très élevés tout en conservant quatre décimales de précision. Cette plage de valeurs est largement suffisante pour la majorité des applications commerciales et financières développées avec Microsoft Access. Elle permet également de manipuler des montants négatifs, par exemple pour représenter des crédits ou des remboursements.
• La fonction peut être utilisée dans les requêtes et dans le code VBA : CCur 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 de convertir des données monétaires directement lors de leur affichage ou de leur traitement. Le développeur peut ainsi garantir un type cohérent dans toute l'application.
• Une conversion invalide provoque une erreur d'exécution : Si l'expression fournie ne peut pas être interprétée comme une valeur numérique, Access génère une erreur. C'est notamment le cas lorsque la chaîne contient des caractères alphabétiques ou un format numérique incorrect. Il est donc recommandé de vérifier les données avec IsNumeric avant d'utiliser CCur sur des valeurs provenant d'une saisie utilisateur.
• Elle appartient à la famille des fonctions de conversion de VBA : La fonction CCur fait partie du même groupe que CBool, CByte, CInt, CLng, CSng, CDbl, CDate et CStr. Toutes ces fonctions permettent de convertir explicitement une expression vers un type de données précis. Leur utilisation améliore la robustesse du code et limite les conversions implicites réalisées par Access.
• La fonction est compatible avec toutes les versions modernes de Microsoft Access : CCur est disponible depuis les premières versions de Microsoft Access intégrant VBA et son comportement est demeuré stable au fil des versions. 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é facilite la maintenance et la migration des applications Access développées sur plusieurs générations du produit.

Exemple de code VBA

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

Par exemple :

Dans cet exemple, la fonction CCur renverrait la valeur 123,4568. La variable appelée LCurValue contiendrait alors la valeur 123,4568.