dw.value
Class Quantity dw.value.Quantity
Represents the quantity of an item.
Properties
Identifies if the instance contains settings for value and unit.
The quantity as Decimal, `null` is returned when the quantity is not available.
The value for unit which identifies the unit of measure for the quantity. Examples of unit are 'inches' or 'pounds'.
The quantity value.
Constructor Summary
Quantity(value : Number, unit : String)
Creates a new quantity instance with the specified value and unit.
Method Summary
Add Quantity object to the current object.
compareTo(other : Quantity) : Number
Compares two Quantity values.
divide(divisor : Number) : Quantity
Divide Quantity object by specified divisor.
equals(other : Object) : boolean
Compares two decimal values whether they are equivalent.
getDecimalValue() : Decimal
Returns the quantity as Decimal, `null` is returned when the quantity is not available.
getUnit() : String
Returns the value for unit which identifies the unit of measure for the quantity.
getValue() : Number
Returns the quantity value.
hashCode() : Number
Calculates the hash code for a decimal.
isAvailable() : boolean
Identifies if the instance contains settings for value and unit.
isOfSameUnit(value : Quantity) : boolean
Identifies if two Quantities have the same unit.
multiply(factor : Number) : Quantity
Multiply Quantity object by specified factor.
newQuantity(value : Decimal) : Quantity
Method returns a new instance of Quantity with the same unit but different value.
round(precision : Number) : Quantity
Rounds the Quantity value to the number of specified decimal digits.
subtract(value : Quantity) : Quantity
Subtract Quantity object from the current object.
toString() : String
Returns a string representation of this quantity object.
valueOf() : Object
According to the ECMA spec returns the "natural" primitive value.
Methods inherited from class Object
Constructor Detail
Quantity
public Quantity(value : Number, unit : String)
Creates a new quantity instance with the specified value and unit.
Parameters:
value - the actual quantity, must not be `null`
unit - the unit identifier for the quantity, must not be `null`

Method Detail
Add Quantity object to the current object. Only objects representing the same unit can be added.
Parameters:
value - Quantity object
Returns:
Quantity object representing the sum of the operands

compareTo
compareTo(other : Quantity) : Number
Compares two Quantity values. An exception is thrown if the two Quantities values are of different unit. If one of the Quantity values represents the N/A value it is treated as 0.0.
Parameters:
other - the other quantity to compare.
Returns:
the comparison.

divide
divide(divisor : Number) : Quantity
Divide Quantity object by specified divisor.
Parameters:
divisor - divisor
Returns:
Quantity object representing division result

equals
equals(other : Object) : boolean
Compares two decimal values whether they are equivalent.
Parameters:
other - the object to compare against this quantity instance.
Returns:
true if equal, false otherwise.

getDecimalValue
getDecimalValue() : Decimal
Returns the quantity as Decimal, `null` is returned when the quantity is not available.
Returns:
the quantity as Decimal

getUnit
getUnit() : String
Returns the value for unit which identifies the unit of measure for the quantity. Examples of unit are 'inches' or 'pounds'.
Returns:
the unit value.

getValue
getValue() : Number
Returns the quantity value.
Returns:
the quantity value.

hashCode
hashCode() : Number
Calculates the hash code for a decimal.
Returns:
the hash code.

isAvailable
isAvailable() : boolean
Identifies if the instance contains settings for value and unit.
Returns:
true if the instance is initialized with value and unit, false if the state is 'not available'.

isOfSameUnit
isOfSameUnit(value : Quantity) : boolean
Identifies if two Quantities have the same unit.
Parameters:
value - the second quantity for the comparison.
Returns:
true if both quantities have the same unit, false otherwise.

multiply
multiply(factor : Number) : Quantity
Multiply Quantity object by specified factor.
Parameters:
factor - multiplication factor
Returns:
Quantity object representing multiplication result

newQuantity
newQuantity(value : Decimal) : Quantity
Method returns a new instance of Quantity with the same unit but different value. An N/A instance is returned if value is null.
Parameters:
value - as a decimal
Returns:
new Quantity instance with same unit

round
round(precision : Number) : Quantity
Rounds the Quantity value to the number of specified decimal digits.
Parameters:
precision - number of decimal digits after the decimal point
Returns:
the new rounded Quantity value

subtract
subtract(value : Quantity) : Quantity
Subtract Quantity object from the current object. Only objects representing the same unit can be subtracted.
Parameters:
value - Quantity object to subtract
Returns:
Quantity object representing the result of subtraction

toString
toString() : String
Returns a string representation of this quantity object.
Returns:
a string representation of this quantity object.

valueOf
valueOf() : Object
According to the ECMA spec returns the "natural" primitive value. Here the value portion of the Quantity is returned.

X Privacy Update: We use cookies to make interactions with our websites and services easy and meaningful, to better understand how they are used. By continuing to use this site you are giving us your consent to do this. Privacy Policy.