Package org.djunits.quantity

Class TemperatureDifference

java.lang.Object
java.lang.Number
org.djunits.quantity.def.Quantity<TemperatureDifference,Temperature.Unit>
org.djunits.quantity.TemperatureDifference
All Implemented Interfaces:
Serializable, Comparable<TemperatureDifference>, Additive<TemperatureDifference>, Scalable<TemperatureDifference>, Value<Temperature.Unit,TemperatureDifference>
public class TemperatureDifference extends Quantity<TemperatureDifference,Temperature.Unit>
TemperatureDifference is a measure of (difference in) thermal state or average kinetic energy of particles, measured in kelvins (K). Note that the TemperatureDifference quantity is relative (it measures a difference between temperatures), whereas the Temperature quantity is absolute.

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:

  • Field Details

  • Constructor Details

    • TemperatureDifference

      public TemperatureDifference(double value, Temperature.Unit unit)
      Instantiate a TemperatureDifference quantity with a unit.
      Parameters:
      value - the value, expressed in the unit
      unit - the unit in which the value is expressed

    • TemperatureDifference

      public TemperatureDifference(double value, String abbreviation)
      Instantiate a TemperatureDifference 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

    • TemperatureDifference

      public TemperatureDifference(TemperatureDifference value)
      Construct TemperatureDifference quantity.
      Parameters:
      value - Scalar from which to construct this instance

  • Method Details

    • ofSi

      public static TemperatureDifference ofSi(double si)
      Return a TemperatureDifference instance based on an SI value.
      Parameters:
      si - the si value
      Returns:
      the TemperatureDifference instance based on an SI value

    • instantiate

      public TemperatureDifference instantiate(double si)
      Description copied from class: Quantity
      Instantiate a quantity with an SI or base value.
      Specified by:
      instantiate in class Quantity<TemperatureDifference,Temperature.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<TemperatureDifference,Temperature.Unit>
      Returns:
      the SI unit of this quantity

    • valueOf

      public static TemperatureDifference valueOf(String text)
      Returns a TemperatureDifference 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 Temperature
      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 TemperatureDifference of(double value, String unitString)
      Returns a TemperatureDifference 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

    • add

      public final Temperature add(Temperature absoluteTemperature)
      Add an absolute temperature to this temperature difference, and return a new absolute temperature. The unit of the return value will be the unit of this temperature difference, and the reference point of the return value will be the reference point of the given temperature. R.add(A) = unit of R and reference value of A.
      Parameters:
      absoluteTemperature - the absolute temperature to add
      Returns:
      the absolute temperature plus this temperature difference

    • divide

      public final Dimensionless divide(TemperatureDifference v)
      Calculate the division of TemperatureDifference and TemperatureDifference, which results in a Dimensionless quantity.
      Parameters:
      v - quantity
      Returns:
      quantity as a division of TemperatureDifference and Temperature