Click or drag to resize
Distance data type
Print this page

The data type Distance represents a distance measurement.

The TDE data types for quantifiable data (numeric values with units of measure) are all stored as double and are handled similarly for Template scripting.

Tip Tip

Since every quantifiable data type is stored as double, be sure to account for that when you test equivalency (for example, 1 may actually be stored as 0.999999). Either round off the values being compared, or use ranges for the comparison.

Units

  • Kilometer or km — default

  • Mile or mi

  • Meter or m

  • Feet or ft

  • Radian or rad (the distance at the equator in radians)

  • Hectometer or hm

  • Centimeter or cm

Data from TDE defaults to the first unit listed for each data type. In the [Output] section, you can convert these values to the units you need:

Copy
[Output]
Mileage(mile) = Input.Distance   # converts km to mi
Field length

The effective range of this data type is: 0 to 40,000,000,000 km

JavaScript conversion

When you use the optional [Script] section to insert your own JavaScript functions, access this data type as follows:

Constructor
JavaScript
Copy
new Distance({Unit:Value})
Available fields for (get,set)

You can access the valid units of measure as fields:

  • .Kilometer

  • .Mile

  • .Meter

  • .Feet

  • .Radian

  • .Hectometer

  • .Centimeter