dw.value
Class Quantity
![](https://sfcclearning.com/infocenter/DWAPI/scriptapi/html/api/images/inherit.gif.pagespeed.ce.4vPrGmNumQ.gif)
Represents the quantity of an item.
Properties
decimalValue
:
Decimal
(Read Only)
The quantity as Decimal,
null
is returned when the quantity is not available.
unit
:
String
(Read Only)
The value for unit which identifies the
unit of measure for the quantity. Examples of unit
are 'inches' or 'pounds'.
value
:
Number
(Read Only)
The quantity value.
Constructor Summary
Method Summary
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.
isAvailable()
:
boolean
Identifies if the instance contains settings for value and unit.
isOfSameUnit(value
:
Quantity)
:
boolean
Identifies if two Quantities have the same unit.
newQuantity(value
:
Decimal)
:
Quantity
Method returns a new instance of Quantity with the same unit but different value.
Methods inherited from class
Object
assign, create, create, defineProperties, defineProperty, entries, freeze, fromEntries, getOwnPropertyDescriptor, getOwnPropertyNames, getOwnPropertySymbols, getPrototypeOf, hasOwnProperty, is, isExtensible, isFrozen, isPrototypeOf, isSealed, keys, preventExtensions, propertyIsEnumerable, seal, setPrototypeOf, toLocaleString, toString, valueOf, values
Constructor Detail
Method Detail
add
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
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 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.
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 Quantity object by specified factor.
Parameters:
factor
-
multiplication factor
Returns:
Quantity object representing multiplication result
newQuantity
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
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 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.