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

$$WEIGHT^XLFMSMT(): Convert Weight Measurement

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


This extrinsic function converts U.S. weights to approximate Metric weights 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
t—metric tons tn— tons
kg—kilograms lb—pounds
g—grams oz—ounces
mg—milligram gr—grain



Returns the weight measurement.

Example 1

Converting U.S. weight to Metric weight:


>W X
5448 G

Example 2

Converting Metric weight to U.S. weight:

>S X=$$WEIGHT^XLFMSMT(5448,"g","lb")

>W X
12.011 LB

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.