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

$$LENGTH^XLFMSMT(): Convert Length Measurement

Reference Type: Supported, Category: Measurement Functions, Integration Agreement: 3175 & 10143


This extrinsic function converts U.S. length to Metric length and vice versa. It returns the equivalent value with units.



Input Parameters


(required) A positive numeric value.


(required) Unit of measure of the value input parameter (see table under the to input parameter).


(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
km—kilometers mi—miles
m—meters yd—yards
cm—centimeters ft—feet
mm—millimeters in—inches



Returns the length measurement.

Example 1

Converting U.S. length to Metric length:


>W X
30.48 CM

Example 2

Converting Metric length to U.S. length:

>S X=$$LENGTH^XLFMSMT(30.48,"cm","in")

>W X
12 IN

VA (Internet) / VA(Intranet) / OI / PD / Site Map / Terms of Use / VA Privacy Policy / Accessibility

Reviewed/Updated: August 26, 2011

If you have questions, need more information, or are having accessibility problems with this website, please contact us by E-Mail: Webmasters, Phone: 510-768-6800, or FAX: 510-768-6850.