Package org.djunits.quantity

Class Power

java.lang.Object

java.lang.Number

org.djunits.quantity.def.Quantity<Power,Power.Unit>

org.djunits.quantity.Power

All Implemented Interfaces:

Serializable, Comparable<Power>, Additive<Power>, Scalable<Power>, Value<Power.Unit,Power>

public class Power
extends Quantity<Power,Power.Unit>

Power is the rate of energy transfer or work done per unit time, measured in watts (W).

Copyright (c) 2025-2026 Delft University of Technology, Jaffalaan 5, 2628 BX Delft, the Netherlands. All rights reserved. See for project information https://djunits.org. The DJUNITS project is distributed under a three-clause BSD-style license.

Author:

Alexander Verbraeck

See Also:

• Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Power.Unit	Power.Unit encodes the units for the rate of energy transfer or work done per unit time.

Field Summary

Fields

Modifier and Type	Field	Description
static final Power	NaN	Constant with value NaN.
static final Power	NEG_MAXVALUE	Constant with value -MAX_VALUE.
static final Power	NEGATIVE_INFINITY	Constant with value NEGATIVE_INFINITY.
static final Power	ONE	Constant with value one.
static final Power	POS_MAXVALUE	Constant with value MAX_VALUE.
static final Power	POSITIVE_INFINITY	Constant with value POSITIVE_INFINITY.
static final Power	ZERO	Constant with value zero.

Constructor Summary

Constructors

Constructor	Description
Power(double value, String abbreviation)	Instantiate a Power quantity with a unit, expressed as a String.
Power(double value, Power.Unit unit)	Instantiate a Power quantity with a unit.
Power(Power value)	Construct Power quantity.

Method Summary

Modifier and Type	Method	Description
final Momentum	divide(Acceleration v)	Calculate the division of Power and Acceleration, which results in a Momentum scalar.
final ElectricPotential	divide(ElectricCurrent v)	Calculate the division of Power and ElectricCurrent, which results in a ElectricPotential scalar.
final ElectricCurrent	divide(ElectricPotential v)	Calculate the division of Power and ElectricPotential, which results in a ElectricCurrent scalar.
final Frequency	divide(Energy v)	Calculate the division of Power and Energy, which results in a Frequency scalar.
final Speed	divide(Force v)	Calculate the division of Power and Force, which results in a Speed scalar.
final Energy	divide(Frequency v)	Calculate the division of Power and Frequency, which results in a Energy scalar.
final Acceleration	divide(Momentum v)	Calculate the division of Power and Momentum, which results in a Acceleration scalar.
final Dimensionless	divide(Power v)	Calculate the division of Power and Power, which results in a Dimensionless quantity.
final Force	divide(Speed v)	Calculate the division of Power and Speed, which results in a Force scalar.
Power	instantiate(double si)	Instantiate a quantity with an SI or base value.
final Energy	multiply(Duration v)	Calculate the multiplication of Power and Duration, which results in a Energy scalar.
static Power	of(double value, String unitString)	Returns a Power based on a value and the textual representation of the unit, which can be localized.
static Power	ofSi(double si)	Return a Power instance based on an SI value.
SIUnit	siUnit()	Return the SI unit of this quantity.
static Power	valueOf(String text)	Returns a Power representation of a textual representation of a value with a unit.

Methods inherited from class org.djunits.quantity.def.Quantity

abs, add, as, compareTo, divide, doubleValue, eq, eq0, equals, floatValue, format, format, ge, ge0, getDisplayUnit, getInUnit, getInUnit, getName, gt, gt0, hashCode, instantiate, interpolate, intValue, isRelative, le, le0, longValue, lt, lt0, max, mean, min, multiply, ne, ne0, negate, of, product, reciprocal, scaleBy, setDisplayUnit, si, subtract, sum, toDisplayString, toDisplayString, toString, toString, toString, toString, toStringSIPrefixed, toStringSIPrefixed, toTextualString, toTextualString, valueOf

Methods inherited from class java.lang.Number

byteValue, shortValue

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.djunits.value.Scalable

divideBy

Methods inherited from interface org.djunits.value.Value

isAbsolute, setDisplayUnit

Field Details

ZERO

public static final Power ZERO

Constant with value zero.

ONE

public static final Power ONE

Constant with value one.

NaN

public static final Power NaN

Constant with value NaN.

POSITIVE_INFINITY

public static final Power POSITIVE_INFINITY

Constant with value POSITIVE_INFINITY.

NEGATIVE_INFINITY

public static final Power NEGATIVE_INFINITY

Constant with value NEGATIVE_INFINITY.

POS_MAXVALUE

public static final Power POS_MAXVALUE

Constant with value MAX_VALUE.

NEG_MAXVALUE

public static final Power NEG_MAXVALUE

Constant with value -MAX_VALUE.

Constructor Details

Power

public Power(double value,
 Power.Unit unit)

Instantiate a Power quantity with a unit.

Parameters:

value - the value, expressed in the unit

unit - the unit in which the value is expressed

Power

public Power(double value,
 String abbreviation)

Instantiate a Power quantity with a unit, expressed as a String.

Parameters:

value - the value, expressed in the unit

abbreviation - the String abbreviation of the unit in which the value is expressed

Power

public Power(Power value)

Construct Power quantity.

Parameters:

value - Scalar from which to construct this instance

Method Details

ofSi

public static Power ofSi(double si)

Return a Power instance based on an SI value.

Parameters:

si - the si value

Returns:

the Power instance based on an SI value

instantiate

public Power instantiate(double si)

Description copied from class: Quantity

Instantiate a quantity with an SI or base value.

Specified by:

instantiate in class Quantity<Power,Power.Unit>

Parameters:

si - the value expressed in the base (SI) unit

Returns:

a quantity with the given SI-value and base (SI) unit

siUnit

public SIUnit siUnit()

Description copied from class: Quantity

Return the SI unit of this quantity.

Overrides:

siUnit in class Quantity<Power,Power.Unit>

Returns:

the SI unit of this quantity

valueOf

public static Power valueOf(String text)

Returns a Power representation of a textual representation of a value with a unit. The String representation that can be parsed is the double value in the unit, followed by a localized or English abbreviation of the unit. Spaces are allowed, but not required, between the value and the unit.

Parameters:

text - the textual representation to parse into a Power

Returns:

the Scalar representation of the value in its unit

Throws:

IllegalArgumentException - when the text cannot be parsed

NullPointerException - when the text argument is null

of

public static Power of(double value,
 String unitString)

Returns a Power based on a value and the textual representation of the unit, which can be localized.

Parameters:

value - the value to use

unitString - the textual representation of the unit

Returns:

the Scalar representation of the value in its unit

Throws:

IllegalArgumentException - when the unit cannot be parsed or is incorrect

NullPointerException - when the unitString argument is null

divide

public final Dimensionless divide(Power v)

Calculate the division of Power and Power, which results in a Dimensionless quantity.

Parameters:

v - quantity

Returns:

quantity as a division of Power and Power

multiply

public final Energy multiply(Duration v)

Calculate the multiplication of Power and Duration, which results in a Energy scalar.

Parameters:

v - scalar

Returns:

scalar as a multiplication of Power and Duration

divide

public final Energy divide(Frequency v)

Calculate the division of Power and Frequency, which results in a Energy scalar.

Parameters:

v - scalar

Returns:

scalar as a division of Power and Frequency

divide

public final Frequency divide(Energy v)

Calculate the division of Power and Energy, which results in a Frequency scalar.

Parameters:

v - scalar

Returns:

scalar as a division of Power and Energy

divide

public final Force divide(Speed v)

Calculate the division of Power and Speed, which results in a Force scalar.

Parameters:

v - scalar

Returns:

scalar as a division of Power and Speed

divide

public final Speed divide(Force v)

Calculate the division of Power and Force, which results in a Speed scalar.

Parameters:

v - scalar

Returns:

scalar as a division of Power and Force

divide

public final ElectricCurrent divide(ElectricPotential v)

Calculate the division of Power and ElectricPotential, which results in a ElectricCurrent scalar.

Parameters:

v - scalar

Returns:

scalar as a division of Power and ElectricPotential

divide

public final ElectricPotential divide(ElectricCurrent v)

Calculate the division of Power and ElectricCurrent, which results in a ElectricPotential scalar.

Parameters:

v - scalar

Returns:

scalar as a division of Power and ElectricCurrent

divide

public final Momentum divide(Acceleration v)

Calculate the division of Power and Acceleration, which results in a Momentum scalar.

Parameters:

v - scalar

Returns:

scalar as a division of Power and Acceleration

divide

public final Acceleration divide(Momentum v)

Calculate the division of Power and Momentum, which results in a Acceleration scalar.

Parameters:

v - scalar

Returns:

scalar as a division of Power and Momentum