METERS

Updated 2023-11-09 14:11:00.553000

Syntax

SELECT [westclintech].[wct].[METERS] (
  <@Length, float,>
 ,<@From_scale, nvarchar(4000),>
 ,<@To_scale, nvarchar(4000),>)

Description

Use the scalar function METERS to convert from fathoms, feet, furlongs, inches, meters, miles, nautical miles, pica, points or yards to meters.

Arguments

@From_scale

is the description of the units for @Length. @From_scale must be a valid value as specified in length unit representations. @From_scale must be of a data type that is implicitly convertible to varchar.

@Length

is any real number. @Length is an expression of type float or of a type that can be implicitly converted to float.

@To_scale

is the description of the units for that @Length is to be converted into. @To_scale must be a valid value as specified in length unit representations. In addition to grams, @To_scale  can be decimeters, centimeters, millimeters, micrometers, nanometers, picometers, femtometers, attometers, zeptometers, yoctometers, decameters, hectometers, or kilometers .@To_scale must be of a data type that is implicitly convertible to varchar.

Return Type

float

Remarks

The following table is a representation of the conversion of one of the length units of measure into meters:

{"columns":[{"field":"column 1"},{"field":"column 2","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"}],"rows":[{"column 1":"inches","column 2":"0.02540"},{"column 1":"feet","column 2":"0.30480"},{"column 1":"yards","column 2":"0.91440"},{"column 1":"meters","column 2":"1.00000"},{"column 1":"fathoms","column 2":"1.82880"},{"column 1":"furlongs","column 2":"201.16800"},{"column 1":"miles","column 2":"1609.34400"},{"column 1":"nautical miles","column 2":"1852.00000"},{"column 1":"pica","column 2":"0.004233"},{"column 1":"points","column 2":"0.0003528"}]}

Conversion of meters includes all the standard prefixes with kilo representing 1,000 and yocto representing 10E-24.

Examples

select wct.METERS(100, 'yd', 'km');

Here is the result set.

{"columns":[{"field":"column 1","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"}],"rows":[{"column 1":"0.09144"}]}