convert_energy()

Learn how to use the convert_energy() function to convert an energy input value from one unit to another.

Convert an energy value from one unit to another.

Syntax

convert_energy(value,from,to)

Parameters

NameTypeRequiredDescription
valuereal✔️The value to be converted.
fromstring✔️The unit to convert from. For possible values, see Conversion units.
tostring✔️The unit to convert to. For possible values, see Conversion units.

Conversion units

  • BritishThermalUnit
  • Calorie
  • DecathermEc
  • DecathermImperial
  • DecathermUs
  • ElectronVolt
  • Erg
  • FootPound
  • GigabritishThermalUnit
  • GigaelectronVolt
  • Gigajoule
  • GigawattDay
  • GigawattHour
  • HorsepowerHour
  • Joule
  • KilobritishThermalUnit
  • Kilocalorie
  • KiloelectronVolt
  • Kilojoule
  • KilowattDay
  • KilowattHour
  • MegabritishThermalUnit
  • Megacalorie
  • MegaelectronVolt
  • Megajoule
  • MegawattDay
  • MegawattHour
  • Millijoule
  • TeraelectronVolt
  • TerawattDay
  • TerawattHour
  • ThermEc
  • ThermImperial
  • ThermUs
  • WattDay
  • WattHour

Returns

Returns the input value converted from one energy unit to another. Invalid units return null.

Example

print result = convert_energy(1.2, 'Joule', 'BritishThermalUnit')

Output

result
0.00113738054437598