2.2.11.3 Unit Number

A unit number is a numeric value with a unit of measure. Unit numbers represent length, angle, duration and typographic units, higher dimensional forms of these units, and dates.

All unit numbers have a Dimension property. One-dimensional unit numbers are used to represent length, angle, duration, and typographic measurements. Two-dimensional units are used to represent area measurements, and three-dimensional units are used to represent volume measurements. A numeric value that has a Dimension greater than one is called a multidimensional unit number.

The Value property of a one-dimensional unit number is specified as a Custom Internal Unit Type or a date and time as specified by a PtgDate parse token. The Value of a multidimensional unit number is specified as a Custom Internal Unit Type for the PtgAcre and PtgHectare operand tokens or as a value as specified by the PtgNumMultiDim parse token.

For numeric values where the Value is expressed as a Custom Internal Unit Types, the Unit property determines how the numeric value is formatted and displayed in a formula expression, or the user interface. When found in a formula expression or the user interface, the Value is converted to the Unit and Dimension of the operand token; this is called the display value. During formula evaluation, the operand token Value, not the display value from the formula expression, is used.