Kernel 8.0 APIs Banner
Office of Information and Technology (OIT) Banner
[skip navigation]

$$VOLUME^XLFMSMT(): Convert Volume Measurement

Reference Type: Supported, Category: Measurement Functions, ICR#: 3175 & 10143

Description

The $$VOLUME^XLFMSMT extrinsic function converts U.S. volume to Metric volume and vice versa. Converts milliliters to cubic inches or quarts or ounces. It returns the equivalent value with units.

Format

  $$VOLUME^XLFMSMT(value,from,to)

Input Parameters

value: (required) A positive numeric value.
from: (required) Unit of measure of the value input parameter (see table under the to input parameter).
to: (required) Unit of measure to which the value input parameter is converted (see table below):

Valid units in either uppercase or lowercase are:

Metric US
kl—kiloliter cf—cubic feet
hl—hectoliter ci—cubic inch
dal—dekaliter gal—gallon
l—liters qt—quart
dl—deciliter pt—pint
cl—centiliter c—cup
ml—milliliter oz—ounce

Output

returns:

Returns the volume measurement.

Examples

Example 1

Converting U.S. volume to Metric volume:

>S X=$$VOLUME^XLFMSMT(12,"CF","ML")

>W X
339800.832 ML

Example 2

Converting Metric volume to U.S. volume:

>S X=$$VOLUME^XLFMSMT(339800.832,"ml","cf")

>W X
11.998 CF