Reference > Functions reference > Aggregate functions > Count
 

Count

Returns the number of valid, non-blank values in a field.

Format 

Count ( field {; field...} )

Parameters 

field - any related field, repeating field, or set of non-repeating fields; or an expression that returns a field, repeating field, or set of non-repeating fields.

Parameters in braces { } are optional.

Data type returned 

number

Originated in version 

6.0 or earlier

Description 

Field can be any of the following:

a repeating field (repeatingField).

a field in matching related records specified by (table::field), whether or not these records appear in a portal.

several non-repeating fields in a record (field1;field2;field3...).

corresponding repetitions of repeating fields in a record (repeatingField1;repeatingField2;repeatingField3), if the result is returned in a repeating field with at least the same number of repeats.

several fields in the first matching record specified by (table::field1;table::field2;...). You can include fields from different tables (table 1::field A;table 2::field B...).

Notes 

When a referenced field is a repeating field, the Count function returns the total number of valid, non-blank values in the first repetition field, then the number of valid, non-blank values in the second repetition field, and so on.

Example 1 

The Accounts layout has a portal showing installment payments made.

Count(Payments::Payment) returns the number of payments made on an account.

Example 2 

In the following examples:

Field1 contains two repetitions with values of 1 and 2.

Field2 contains four repetitions with values of 5, 6, 7, and 8.

Field3 contains 6.

Count(Field2) returns 4 when the calculation isn’t a repeating field.

Count(Field1;Field2;Field3) returns 3, 2, 1, 1 when the calculation is a repeating field.

Related topics 

Functions reference (category list)

Functions reference (alphabetical list)

About formulas

About functions

Defining calculation fields

Using operators in formulas