NZ

Syntaxe

Paramètres

Description

Cette fonction permet de retourner la valeur spécifié lorsque la variante est nulle.

Remarques

• La fonction permet de remplacer une valeur Null : La fonction Nz est utilisée pour remplacer une valeur Null par une valeur définie par le développeur. Si l'expression n'est pas Null, la valeur d'origine est simplement retournée. Cette fonction simplifie grandement le traitement des champs pouvant être vides dans une base de données Access.
• Le deuxième paramètre est facultatif : Le paramètre value_if_null permet de préciser la valeur à retourner lorsque le premier argument est Null. S'il est omis, Nz retourne généralement une chaîne vide ("") dans un contexte textuel ou la valeur 0 dans un contexte numérique. Cette valeur par défaut facilite les traitements simples.
• Elle évite de nombreuses erreurs de calcul : Les opérations arithmétiques impliquant une valeur Null produisent généralement un résultat Null. En utilisant Nz, il est possible de remplacer cette valeur absente par 0 ou une autre valeur appropriée avant d'effectuer les calculs. Cette pratique améliore la robustesse des applications.
• Elle est souvent utilisée avec IsNull : Bien que IsNull permette de vérifier si une valeur est nulle, Nz va plus loin en fournissant directement une valeur de remplacement. Dans de nombreux cas, Nz permet d'écrire des expressions plus courtes et plus lisibles. C'est pourquoi elle est très populaire dans les applications Access.
• Elle fonctionne avec différents types de données : Le premier paramètre est de type Variant, ce qui permet à Nz de traiter des nombres, des chaînes de caractères, des dates ou d'autres types de données. La valeur de remplacement peut être adaptée au type attendu par l'application. Cette souplesse rend la fonction très polyvalente.
• Elle est très utilisée dans les requêtes et les formulaires : Nz apparaît fréquemment dans les requêtes SQL, les contrôles calculés, les formulaires et les états Access. Elle permet d'éviter l'affichage de valeurs Null et de présenter des données plus conviviales aux utilisateurs. Elle est également utilisée dans les rapports afin d'éviter des résultats incomplets.
• Elle améliore la lisibilité du code : Sans Nz, il est souvent nécessaire d'utiliser une expression plus complexe basée sur IIf et IsNull. En remplaçant ces constructions par un simple appel à Nz, le code devient plus compact et plus facile à comprendre. Cette simplification facilite également la maintenance des applications.
• Elle est utile pour personnaliser les valeurs par défaut : Le deuxième paramètre peut contenir n'importe quelle valeur adaptée au contexte. Par exemple, il est possible de remplacer une valeur Null par "Inconnu", 0, -1, une date ou tout autre résultat pertinent. Cette possibilité permet d'adapter précisément le comportement de l'application.
• Elle est souvent combinée avec d'autres fonctions : Nz est fréquemment utilisée avec Sum, Avg, Count, Format, DateDiff, CStr ou encore IIf. Cette combinaison permet de construire des expressions robustes qui continuent de fonctionner même lorsque certaines données sont absentes. Il s'agit d'une pratique très répandue dans le développement Access.
• La fonction est compatible avec toutes les versions modernes de Microsoft Access : La fonction Nz est disponible depuis les premières versions de Microsoft Access intégrant VBA et son fonctionnement est demeuré 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 que les applications utilisant cette fonction continueront de fonctionner correctement lors des migrations vers des versions plus récentes d'Access.

Exemple

Voici un exemple de comment utiliser la fonction Nz dans Microsoft Access :

L'exemple ci-dessus renverrait la valeur « n/a » si la variable varName contenait une valeur nulle.

L'exemple ci-dessus renverrait une chaîne de caractères vide si la variable varName contenait une valeur nulle.

Exemple de code VBA

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

Par exemple :

Dans cet exemple, la variable LOption contiendra désormais la valeur de la variable varChoice, sauf si celle-ci est nulle. Si la variable varChoice est nulle, la fonction Nz renverra «Introuvable».