Class DistanceConverter

java.lang.Object
com.irurueta.units.DistanceConverter

public class DistanceConverter extends Object
Does distance conversions to different units. To prevent loss of accuracy, conversion should only be done as a final step before displaying distance measurements.
  • Field Details

    • METERS_PER_MILLIMETER

      static final double METERS_PER_MILLIMETER
      Number of meters in 1 millimeter.
      See Also:
    • METERS_PER_CENTIMETER

      static final double METERS_PER_CENTIMETER
      Number of meters in 1 centimeter.
      See Also:
    • METERS_PER_KILOMETER

      static final double METERS_PER_KILOMETER
      Number of meters in 1 kilometer.
      See Also:
    • METERS_PER_INCH

      static final double METERS_PER_INCH
      Number of meters in 1 inch.
      See Also:
    • METERS_PER_FOOT

      static final double METERS_PER_FOOT
      Number of meters in 1 foot.
      See Also:
    • METERS_PER_YARD

      static final double METERS_PER_YARD
      Number of meters in 1 yard.
      See Also:
    • METERS_PER_MILE

      static final double METERS_PER_MILE
      Number of meters in 1 mile.
      See Also:
  • Constructor Details

    • DistanceConverter

      private DistanceConverter()
      Constructor. Prevents instantiation of helper class.
  • Method Details

    • convert

      public static void convert(Distance input, Distance output)
      Converts a distance to provided output distance unit.
      Parameters:
      input - input distance to be converted.
      output - output distance where result will be stored and containing output unit.
    • convertAndReturnNew

      public static Distance convertAndReturnNew(Distance input, DistanceUnit outputUnit)
      Converts a distance to requested output unit.
      Parameters:
      input - input distance to be converted.
      outputUnit - requested output unit.
      Returns:
      converted distance.
    • convert

      public static void convert(Distance distance, DistanceUnit outputUnit)
      Converts and updates a distance to requested output unit.
      Parameters:
      distance - input distance to be converted and updated.
      outputUnit - requested output unit.
    • convert

      public static void convert(Distance input, DistanceUnit outputUnit, Distance result)
      Converts a distance to requested output unit.
      Parameters:
      input - input distance to be converted.
      outputUnit - requested output unit.
      result - distance instance where result will be stored.
    • convert

      public static Number convert(Number input, DistanceUnit inputUnit, DistanceUnit outputUnit)
      Converts a distance value from input unit to provided output unit.
      Parameters:
      input - distance value.
      inputUnit - input distance unit.
      outputUnit - output distance unit.
      Returns:
      converted distance value.
    • convert

      public static double convert(double input, DistanceUnit inputUnit, DistanceUnit outputUnit)
      Converts a distance value from input unit to provided output unit.
      Parameters:
      input - distance value.
      inputUnit - input distance unit.
      outputUnit - output distance unit.
      Returns:
      converted distance value.
    • meterToMillimeter

      public static double meterToMillimeter(double meter)
      Converts provided meter value to millimeters.
      Parameters:
      meter - meter value.
      Returns:
      same distance converted to millimeters.
    • millimeterToMeter

      public static double millimeterToMeter(double millimeter)
      Converts provided milimeter value to meters.
      Parameters:
      millimeter - milimeter value.
      Returns:
      same distance converted to meters.
    • meterToCentimeter

      public static double meterToCentimeter(double meter)
      Converts provided meter value to centimeters.
      Parameters:
      meter - meter value.
      Returns:
      same distance converted to centimeters.
    • centimeterToMeter

      public static double centimeterToMeter(double centimeter)
      Converts provided centimeter value to meters.
      Parameters:
      centimeter - centimeter value.
      Returns:
      same distance converted to meters.
    • meterToKilometer

      public static double meterToKilometer(double meter)
      Converts provided meter value to kilometers.
      Parameters:
      meter - meter value.
      Returns:
      same distance converted to kilometer.
    • kilometerToMeter

      public static double kilometerToMeter(double kilometer)
      Converts provided kilometer value to meters.
      Parameters:
      kilometer - kilometer value.
      Returns:
      same distance converted to meters.
    • meterToInch

      public static double meterToInch(double meter)
      Converts provided meter value to inches.
      Parameters:
      meter - meter value.
      Returns:
      same distance converted to inches.
    • inchToMeter

      public static double inchToMeter(double inch)
      Converts provided inch value to meters.
      Parameters:
      inch - inch value.
      Returns:
      same distance converted to meters.
    • meterToFoot

      public static double meterToFoot(double meter)
      Converts provided meter value to feet.
      Parameters:
      meter - meter value.
      Returns:
      same distance converted to feet.
    • footToMeter

      public static double footToMeter(double foot)
      Converts provided foot value to meters.
      Parameters:
      foot - foot value.
      Returns:
      same distance converted to meters.
    • meterToYard

      public static double meterToYard(double meter)
      Converts provided meter value to yards.
      Parameters:
      meter - meter value.
      Returns:
      same distance converted to yards.
    • yardToMeter

      public static double yardToMeter(double yard)
      Converts provided yard value to meters.
      Parameters:
      yard - yard value.
      Returns:
      same distance converted to meters.
    • meterToMile

      public static double meterToMile(double meter)
      Converts provided meter value to miles.
      Parameters:
      meter - meter value.
      Returns:
      same distance converted to miles.
    • mileToMeter

      public static double mileToMeter(double mile)
      Converts provided mile value to meters.
      Parameters:
      mile - mile value.
      Returns:
      same distance converted to meters.