Microsoft Access VBA Tip: Use the NZ() NullToZero Function to Handle Null Values

Any arithmetic calculation in VBA with a Null value results in a null value. If one of the values is NULL, the result is Null (blank). According to VBA rules for calculating values, the result is null because a null value is an unknown.

Nulls are not the same value as zero (0). However, in many situations that's exactly what we want. We want to treat Nulls as zeros.

Thankfully, Microsoft Access offers a way around this issue in VBA module code or queries. The NullToZero function (NZ) takes a null value and converts it to zero. You should use this function anywhere a value could be null (like a field that is not required).

The following can be used to calculate the sum of two fields in the query:

Nz([Field1]) + Nz([Field2])

If [Field1] is null and [Field2] is 2, the result is 2. Without the Nz() function, the result would be null. So be safe! Wrap your potential null values with NZ.

Definition

Nz(Value, ValueIfNull)

Parameters

There are two parameters. The second one is optional and lets you override the default value for nulls. For instance, you may want Nulls to be treated as 1, or for text fields, a zero-length string ("") rather than zero.

Parameter Required or Optional Data Type Description
Value Required Variant Value to evaluate for Null
ValueIfNull Optional Variant The custom return value if the value being evaluated is Null (overrides the default value)

Return Value

  • If the Value parameter is not null, the Value is returned.
  • If the Value parameter is null:
    • If the ValueIfNull parameter is provided, ValueIfNull
    • If the ValueIfNull parameter is not provided, a zero (0) or zero-length string ("").
      Note that when used in a query expression, the NZ function returns a zero-length string.

Check out the VBA help file for the complete definition of the NZ function.

On a related note, read our whitepaper Microsoft Access Query Sorting on Multiple Date or Numeric Fields with Blank (Null) Values where we discuss how the Immediate If command (IIF) is used to choose which field to sort and behaves differently from using the NZ function.

Note that the Nz Function is a Microsoft Access VBA function and does not exist in Visual Basic 6 (VB6) or other Office VBA environments.

Table Design

Query Design

Form Design

Form Tips and Mistakes

Copy Command Button and Keep Picture

Module VBA to Forms and Controls

Form Navigation Caption

Resync Record in a Subform

Synchronize Two Subforms

Multiple OpenArgs Values

Late Bind Tab Subforms

Subform Reference to Control Rather than Field

Tab Page Reference

Shortcut Keys


Combo Box Top 6 Tips

Properties and Validation

Select First Item

Cascading Combo Boxes

Zip, City, State AutoFill

Report Design

Suppress Page Headers and Footers on the First Page of Your Report

Add the NoData Event

Annual Monthly Crosstab Columns

Design Environment

Add Buttons to the Quick Access Toolbar

Collapse the Office Ribbon for more space

VBA Programming

Basics: Forms and Controls

Run VBA Code from a Macro

Use Nz() to Handle Nulls

Avoid Exits in the Body of a Procedure

Shortcut Debugging Keys

Set Module Options

Math Rounding Issues

Rename a File or Folder

Avoid DoEvents in Loops

Age Calculations

Weekday Math

Send Emails with DoCmd.SendObject

Source Code Library

Microsoft Access Modules Library

Microsoft Access Modules

VBA Error Handling

Error Handling and Debugging Techniques

Error Number and Description Reference

Basic Error Handling

Pinpointing the Error Line

Performance Tips

Linked Database

Subdatasheet Name

Visual SourceSafe

Deployment

Runtime Downloads

Simulate Runtime

Prevent Close Box

Disable Design Changes

Broken References

Remote Desktop Connection Setup

Terminal Services and RemoteApp Deployment

Reboot Remote Desktop

Missing Package & Deployment Wizard

Avoid Program Files Folder

Unavailable Mapped Drives

Microsoft Access Front-End Deployment

System Admin

Disaster Recovery Plan

Compact Database

Compact on Close

Database Corruption

Remove 'Save to SharePoint Site' Prompt from an Access Database

Class Not Registered Run-time Error -2147221164

Inconsistent Compile Error

Decompile Database

Bad DLL Calling Convention

Error 3045: Could Not Use

Converting ACCDB to MDB

SQL Server Upsizing

Microsoft Access to SQL Server Upsizing Center

Microsoft Access to SQL Server Upsizing Center

When and How to Upsize Access to SQL Server

SQL Server Express Versions and Downloads

Cloud and Azure

Cloud Implications

MS Access and SQL Azure

Deploying MS Access Linked to SQL Azure

SQL Server Azure Usage and DTU Limits

Visual Studio LightSwitch

LightSwitch Introduction

Comparison Matrix

Additional Resources

Connect with Us

 

Free Product Catalog from FMS