Length

The length category provides conversions between SI units (meters, kilometers, centimeters, millimeters) and Imperial/US units (inches, feet, yards, miles).

This category is useful for engineering, construction, design, or any domain where measurements need to be compared or converted across systems.

Supported Units

• Metric: millimeter mm, centimeter cm, meter m, kilometer km
• Imperial / US: inch in, foot ft, yard yd, mile mi

Quick Example

import { Conversion } from "@devhaven/unit-conversion";

const convert = new Conversion();

// Convert 100 meters → kilometers
console.log(convert.value(100).from("meter").to("kilometer"));
// "0.1km"

// Convert 1 inch → centimeters
console.log(convert.value(1).from("inch").to("centimeter"));
// "2.54cm"

Common Conversions

All conversions are approximate to the configured decimal precision.

import { Conversion } from "@devhaven/unit-conversion";

const convert = new Conversion({ includeUnit: false });
convert.value(1).from("meter").to("foot");      // 3.28

SI units are exact; conversions involving Imperial/US units are approximations due to defined ratios.

Meters ↔ Kilometers

convert.value(1000).from("meter").to("kilometer");
convert.value(2).from("kilometer").to("meter");

Meters ↔ Feet

convert.value(1).from("meter").to("foot");
convert.value(10).from("foot").to("meter");

Inches ↔ Centimeters

convert.value(1).from("inch").to("centimeter");
convert.value(30).from("centimeter").to("inch");

Miles ↔ Kilometers

convert.value(1).from("mile").to("kilometer");
convert.value(5).from("kilometer").to("mile");

Yards ↔ Meters

convert.value(1).from("yard").to("meter");
convert.value(50).from("meter").to("yard");

Configuration Options

Conversions can be customized with global config values when creating a Conversion instance.

import { Conversion } from "@devhaven/unit-conversion";

const convert = new Conversion({
  decimals: 4,       // set precision
  isFloat: true,     // keep decimals or round
});

const { value, unit } = convert.value(1).from("mile").to("kilometer");
console.log(value, unit);