Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security Policy
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

units

package module

Go to main page

Versions in this module

v1

v1.0.5

Oct 4, 2021

Changes in this version

+ var KiloMeterPerHour = NewUnit("kilometer/hour", "km/h", MetricTime, SI, UnitOptionAliases("kilometre/hour"))

+ var KiloMeterPerSecond = NewUnit("kilometer/second", "km/s", MetricTime, SI, ...)

+ var MeterPerHour = NewUnit("meter/hour", "m/h", MetricTime, SI, UnitOptionAliases("metre/hour"))

+ var MeterPerSecond = NewUnit("meter/second", "m/s", MetricTime, SI, UnitOptionAliases("metre/second"))

+ var MetricTime = UnitOptionQuantity("metric/time")

v1.0.4

Jul 16, 2021

Changes in this version

+ var Angle = UnitOptionQuantity("Angle")

+ var Degree = NewUnit("degree", "°", Angle, SI)

+ var Percentage = NewUnit("percentage", "%", Ratio)

+ var Permille = NewUnit("permille", "‰", Ratio)

+ var Permyriad = NewUnit("permyriad", "‱", Ratio)

+ var Radian = NewUnit("radians", "rad", Angle, SI)

+ var Ratio = UnitOptionQuantity("ratio")

+ var Turn = NewUnit("turn", "rot", Angle, SI, UnitOptionAliases("revolution", "rotation"))

v1.0.3

May 24, 2021

Changes in this version

+ var Angstrom = NewUnit("angstrom", "Å", Length, BI, UnitOptionPlural("angstroms"))

+ var At = NewUnit("technical atmosphere", "at", Pressure, BI, ...)

+ var Atm = NewUnit("standard atmosphere", "atm", Pressure, BI, ...)

+ var AttoGram = Atto(Gram)

+ var AttoJoule = Atto(Joule)

+ var AttoLiter = Atto(Liter)

+ var AttoMeter = Atto(Meter)

+ var AttoPascal = Atto(Pascal)

+ var AttoSecond = Atto(Second)

+ var AttoWatt = Atto(Watt)

+ var AttoWattHour = Atto(WattHour)

+ var BI = UnitOptionSystem("imperial")

+ var Bar = NewUnit("bar", "bar", Pressure, BI, UnitOptionPlural("bars"))

+ var Barye = NewUnit("barye", "Ba", Pressure, BI, UnitOptionPlural("baryes"))

+ var Bi = UnitOptionQuantity("bits")

+ var Bit = NewUnit("bit", "b", Bi)

+ var Byte = NewUnit("byte", "B", Data)

+ var Celsius = NewUnit("celsius", "C", Temp, UnitOptionPlural("none"), SI)

+ var CentiBar = Centi(Bar)

+ var CentiGram = Centi(Gram)

+ var CentiJoule = Centi(Joule)

+ var CentiLiter = Centi(Liter)

+ var CentiMeter = Centi(Meter)

+ var CentiPascal = Centi(Pascal)

+ var CentiSecond = Centi(Second)

+ var CentiWatt = Centi(Watt)

+ var CentiWattHour = Centi(WattHour)

+ var Century = NewUnit("century", "", Time)

+ var CmH2O = Centi(MH2O)

+ var CmHg = Centi(MHg)

+ var CustomaryFluidOunce = NewUnit("customary fluid ounce", "", Volume, US)

+ var Data = UnitOptionQuantity("bytes")

+ var Day = NewUnit("day", "d", Time)

+ var DecaGram = Deca(Gram)

+ var DecaJoule = Deca(Joule)

+ var DecaLiter = Deca(Liter)

+ var DecaMeter = Deca(Meter)

+ var DecaPascal = Deca(Pascal)

+ var DecaSecond = Deca(Second)

+ var DecaWatt = Deca(Watt)

+ var DecaWattHour = Deca(WattHour)

+ var Decade = NewUnit("decade", "", Time)

+ var DeciGram = Deci(Gram)

+ var DeciJoule = Deci(Joule)

+ var DeciLiter = Deci(Liter)

+ var DeciMeter = Deci(Meter)

+ var DeciPascal = Deci(Pascal)

+ var DeciSecond = Deci(Second)

+ var DeciWatt = Deci(Watt)

+ var DeciWattHour = Deci(WattHour)

+ var DefaultFmtOptions = FmtOptions

+ var Drachm = NewUnit("drachm", "dr", Mass, BI)

+ var Energy = UnitOptionQuantity("energy")

+ var ExaBit = Exa(Bit)

+ var ExaByte = NewUnit("exabyte", "", Data)

+ var ExaGram = Exa(Gram)

+ var ExaJoule = Exa(Joule)

+ var ExaLiter = Exa(Liter)

+ var ExaMeter = Exa(Meter)

+ var ExaPascal = Exa(Pascal)

+ var ExaSecond = Exa(Second)

+ var ExaWatt = Exa(Watt)

+ var ExaWattHour = Exa(WattHour)

+ var Fahrenheit = NewUnit("fahrenheit", "F", Temp, UnitOptionPlural("none"), US)

+ var FemtoGram = Femto(Gram)

+ var FemtoJoule = Femto(Joule)

+ var FemtoLiter = Femto(Liter)

+ var FemtoMeter = Femto(Meter)

+ var FemtoPascal = Femto(Pascal)

+ var FemtoSecond = Femto(Second)

+ var FemtoWatt = Femto(Watt)

+ var FemtoWattHour = Femto(WattHour)

+ var FluidGallon = NewUnit("fluid gallon", "", Volume, US)

+ var FluidOunce = NewUnit("fluid ounce", "fl oz", Volume, BI, UnitOptionAliases("floz"))

+ var FluidPint = NewUnit("fluid pint", "", Volume, US)

+ var FluidQuart = NewUnit("fluid quart", "", Volume, US)

+ var Foot = NewUnit("foot", "ft", Length, BI, UnitOptionPlural("feet"))

+ var Fortnight = NewUnit("fortnight", "", Time)

+ var Furlong = NewUnit("furlong", "fur", Length, BI)

+ var Gallon = NewUnit("gallon", "gal", Volume, BI)

+ var GigaBit = Giga(Bit)

+ var GigaByte = NewUnit("gigabyte", "GB", Data)

+ var GigaGram = Giga(Gram)

+ var GigaJoule = Giga(Joule)

+ var GigaLiter = Giga(Liter)

+ var GigaMeter = Giga(Meter)

+ var GigaPascal = Giga(Pascal)

+ var GigaSecond = Giga(Second)

+ var GigaWatt = Giga(Watt)

+ var GigaWattHour = Giga(WattHour)

+ var Grain = NewUnit("grain", "gr", Mass, BI)

+ var Gram = NewUnit("gram", "g", Mass)

+ var HectoGram = Hecto(Gram)

+ var HectoJoule = Hecto(Joule)

+ var HectoLiter = Hecto(Liter)

+ var HectoMeter = Hecto(Meter)

+ var HectoPascal = Hecto(Pascal)

+ var HectoSecond = Hecto(Second)

+ var HectoWatt = Hecto(Watt)

+ var HectoWattHour = Hecto(WattHour)

+ var Hour = NewUnit("hour", "hr", Time)

+ var InH2O = NewUnit("inch of Water Column", "inH2O", Pressure, BI)

+ var InHg = NewUnit("inch of Mercury", "inHg", Pressure, BI)

+ var Inch = NewUnit("inch", "in", Length, BI, UnitOptionPlural("inches"))

+ var Joule = NewUnit("joule", "J", Energy, SI)

+ var Kelvin = NewUnit("kelvin", "K", Temp, UnitOptionPlural("none"), SI)

+ var KiloBit = Kilo(Bit)

+ var KiloByte = NewUnit("kilobyte", "KB", Data)

+ var KiloGram = Kilo(Gram)

+ var KiloJoule = Kilo(Joule)

+ var KiloLiter = Kilo(Liter)

+ var KiloMeter = Kilo(Meter)

+ var KiloPascal = Kilo(Pascal)

+ var KiloSecond = Kilo(Second)

+ var KiloWatt = Kilo(Watt)

+ var KiloWattHour = Kilo(WattHour)

+ var League = NewUnit("league", "lea", Length, BI)

+ var Length = UnitOptionQuantity("length")

+ var Liter = NewUnit("liter", "l", Volume, SI, UnitOptionAliases("litre"))

+ var LiterPerHour = NewUnit("liter/hour", "l/h", VolumeTime, SI, UnitOptionAliases("litre/hour"))

+ var LiterPerSecond = NewUnit("liter/second", "l/s", VolumeTime, SI, UnitOptionAliases("litre/second"))

+ var M3 = NewUnit("cubicmeter", "m3", Volume, SI, UnitOptionAliases("cubicmetre"))

+ var M3PerHour = NewUnit("cubicmeter/hour", "m3/h", VolumeTime, SI, ...)

+ var M3PerSecond = NewUnit("cubicmeter/second", "m3/s", VolumeTime, SI, ...)

+ var MH2O = NewUnit("meter of Water Column", "mmH2O", Pressure, BI, ...)

+ var MHg = NewUnit("meter of Mercury", "mmHg", Pressure, BI, ...)

+ var Mass = UnitOptionQuantity("mass")

+ var MegaBit = Mega(Bit)

+ var MegaByte = NewUnit("megabyte", "MB", Data)

+ var MegaGram = Mega(Gram)

+ var MegaJoule = Mega(Joule)

+ var MegaLiter = Mega(Liter)

+ var MegaMeter = Mega(Meter)

+ var MegaPascal = Mega(Pascal)

+ var MegaSecond = Mega(Second)

+ var MegaWatt = Mega(Watt)

+ var MegaWattHour = Mega(WattHour)

+ var Meter = NewUnit("meter", "m", Length, SI, UnitOptionAliases("metre"))

+ var MicroBar = Micro(Bar)

+ var MicroGram = Micro(Gram)

+ var MicroJoule = Micro(Joule)

+ var MicroLiter = Micro(Liter)

+ var MicroMeter = Micro(Meter)

+ var MicroPascal = Micro(Pascal)

+ var MicroSecond = Micro(Second)

+ var MicroWatt = Micro(Watt)

+ var MicroWattHour = Micro(WattHour)

+ var Mile = NewUnit("mile", "", Length, BI)

+ var Millennium = NewUnit("millennium", "", Time)

+ var MilliBar = Milli(Bar)

+ var MilliGram = Milli(Gram)

+ var MilliJoule = Milli(Joule)

+ var MilliLiter = Milli(Liter)

+ var MilliMeter = Milli(Meter)

+ var MilliPascal = Milli(Pascal)

+ var MilliSecond = Milli(Second)

+ var MilliWatt = Milli(Watt)

+ var MilliWattHour = Milli(WattHour)

+ var Minute = NewUnit("minute", "min", Time)

+ var MmH2O = Milli(MH2O)

+ var MmHg = Milli(MHg)

+ var Month = NewUnit("month", "", Time)

+ var NanoGram = Nano(Gram)

+ var NanoJoule = Nano(Joule)

+ var NanoLiter = Nano(Liter)

+ var NanoMeter = Nano(Meter)

+ var NanoPascal = Nano(Pascal)

+ var NanoSecond = Nano(Second)

+ var NanoWatt = Nano(Watt)

+ var NanoWattHour = Nano(WattHour)

+ var Newton = NewUnit("newton per square meter", "N/m²", Pressure, BI)

+ var Nibble = NewUnit("nibble", "", Data)

+ var Ounce = NewUnit("ounce", "oz", Mass, BI)

+ var Pascal = NewUnit("pascal", "Pa", Pressure, SI)

+ var PetaBit = Peta(Bit)

+ var PetaByte = NewUnit("petabyte", "PB", Data)

+ var PetaGram = Peta(Gram)

+ var PetaJoule = Peta(Joule)

+ var PetaLiter = Peta(Liter)

+ var PetaMeter = Peta(Meter)

+ var PetaPascal = Peta(Pascal)

+ var PetaSecond = Peta(Second)

+ var PetaWatt = Peta(Watt)

+ var PetaWattHour = Peta(WattHour)

+ var PicoGram = Pico(Gram)

+ var PicoJoule = Pico(Joule)

+ var PicoLiter = Pico(Liter)

+ var PicoMeter = Pico(Meter)

+ var PicoPascal = Pico(Pascal)

+ var PicoSecond = Pico(Second)

+ var PicoWatt = Pico(Watt)

+ var PicoWattHour = Pico(WattHour)

+ var Pint = NewUnit("pint", "pt", Volume, BI)

+ var PlanckTime = NewUnit("planck time", "𝑡ₚ", Time)

+ var Pound = NewUnit("pound", "lb", Mass, BI)

+ var Power = UnitOptionQuantity("power")

+ var Pressure = UnitOptionQuantity("pressure")

+ var Psi = NewUnit("pound-force per square inch", "psi", Pressure, BI)

+ var Quart = NewUnit("quart", "qt", Volume, BI)

+ var SI = UnitOptionSystem("metric")

+ var Score = NewUnit("score", "", Time)

+ var Second = NewUnit("second", "s", Time)

+ var Slug = NewUnit("slug", "", Mass, BI)

+ var Stone = NewUnit("stone", "st", Mass, BI)

+ var Temp = UnitOptionQuantity("temperature")

+ var TeraBit = Tera(Bit)

+ var TeraByte = NewUnit("terabyte", "TB", Data)

+ var TeraGram = Tera(Gram)

+ var TeraJoule = Tera(Joule)

+ var TeraLiter = Tera(Liter)

+ var TeraMeter = Tera(Meter)

+ var TeraPascal = Tera(Pascal)

+ var TeraSecond = Tera(Second)

+ var TeraWatt = Tera(Watt)

+ var TeraWattHour = Tera(WattHour)

+ var Time = UnitOptionQuantity("time")

+ var Ton = NewUnit("ton", "t", Mass, BI)

+ var Torr = NewUnit("torr", "Torr", Pressure, BI)

+ var US = UnitOptionSystem("us")

+ var Volume = UnitOptionQuantity("volume")

+ var VolumeTime = UnitOptionQuantity("volume/time")

+ var Watt = NewUnit("watt", "W", Power, SI)

+ var WattHour = NewUnit("watthour", "Wh", Energy, SI)

+ var Yard = NewUnit("yard", "yd", Length, BI)

+ var Year = NewUnit("year", "yr", Time)

+ var YottaByte = NewUnit("yottabyte", "", Data)

+ var ZettaByte = NewUnit("zettabyte", "", Data)

+ func NewConversion(from, to Unit, formula string)

+ func NewConversionFromFn(from, to Unit, f ConversionFn, formula string)

+ func NewRatioConversion(from, to Unit, ratio float64)

+ type Conversion struct

+ Fn ConversionFn

+ Formula string

+ func ResolveConversion(from, to Unit) (cpath []Conversion, err error)

+ func (c Conversion) From() string

+ func (c Conversion) String() string

+ func (c Conversion) To() string

+ type ConversionFn func(float64) float64

+ type FmtOptions struct

+ Label bool

+ Precision int

+ Short bool

+ type Unit struct

+ Name string

+ Quantity string

+ Symbol string

+ func All() []Unit

+ func Atto(b Unit, o ...UnitOption) Unit

+ func Centi(b Unit, o ...UnitOption) Unit

+ func Deca(b Unit, o ...UnitOption) Unit

+ func Deci(b Unit, o ...UnitOption) Unit

+ func Exa(b Unit, o ...UnitOption) Unit

+ func Femto(b Unit, o ...UnitOption) Unit

+ func Find(s string) (Unit, error)

+ func Giga(b Unit, o ...UnitOption) Unit

+ func Hecto(b Unit, o ...UnitOption) Unit

+ func Kilo(b Unit, o ...UnitOption) Unit

+ func Mega(b Unit, o ...UnitOption) Unit

+ func Micro(b Unit, o ...UnitOption) Unit

+ func Milli(b Unit, o ...UnitOption) Unit

+ func Nano(b Unit, o ...UnitOption) Unit

+ func NewUnit(name, symbol string, opts ...UnitOption) Unit

+ func Peta(b Unit, o ...UnitOption) Unit

+ func Pico(b Unit, o ...UnitOption) Unit

+ func Tera(b Unit, o ...UnitOption) Unit

+ func (u Unit) Names() []string

+ func (u Unit) PluralName() string

+ func (u Unit) System() string

+ type UnitList []Unit

+ func (a UnitList) Len() int

+ func (a UnitList) Less(i, j int) bool

+ func (a UnitList) Swap(i, j int)

+ type UnitOption func(Unit) Unit

+ func UnitOptionAliases(a ...string) UnitOption

+ func UnitOptionPlural(s string) UnitOption

+ func UnitOptionQuantity(s string) UnitOption

+ func UnitOptionSystem(s string) UnitOption

+ type Value struct

+ func ConvertFloat(x float64, from, to Unit) (Value, error)

+ func MustConvertFloat(x float64, from, to Unit) Value

+ func NewValue(v float64, u Unit) Value

+ func (v Value) Convert(to Unit) (Value, error)

+ func (v Value) Float() float64

+ func (v Value) Fmt(opts FmtOptions) string

+ func (v Value) MustConvert(to Unit) Value

+ func (v Value) String() string

+ func (v Value) Unit() Unit