Class DigitalSpeedUnit
Extends
Measurement.
Create a new DigitalSpeed measurement instance. This measures the speed of
transfer of data.
Defined in: DigitalSpeedUnit.js.
| Constructor Attributes | Constructor Name and Description |
|---|---|
|
DigitalSpeedUnit(options)
|
| Method Attributes | Method Name and Description |
|---|---|
| <static> |
DigitalSpeedUnit.convert(to, from, digitalSpeed)
Convert a digitalSpeed to another measure.
|
|
expand(measurementsystem, units)
Expand the current measurement such that any fractions of the current unit
are represented in terms of smaller units in the same system instead of fractions
of the current unit.
|
|
|
Return the type of this measurement.
|
|
|
localize(locale)
Localize the measurement to the commonly used measurement in that locale.
|
|
|
newUnit(params)
Return a new instance of this type of measurement.
|
|
|
scale(measurementsystem, units)
Scale the measurement unit to an acceptable level.
|
Class Detail
DigitalSpeedUnit(options)
- Parameters:
- options
- {{unit:string,amount:number|string|undefined}} Options controlling the construction of this instance
Method Detail
<static>
{number|undefined}
DigitalSpeedUnit.convert(to, from, digitalSpeed)
Convert a digitalSpeed to another measure.
- Parameters:
- to
- {string} unit to convert to
- from
- {string} unit to convert from
- digitalSpeed
- {number} amount to be convert
- Returns:
- {number|undefined} the converted amount
{Array.}
expand(measurementsystem, units)
Expand the current measurement such that any fractions of the current unit
are represented in terms of smaller units in the same system instead of fractions
of the current unit. For example, "6.25 feet" may be represented as
"6 feet 4 inches" instead. The return value is an array of measurements which
are progressively smaller until the smallest unit in the system is reached
or until there is a whole number of any unit along the way.
- Parameters:
- {string=} measurementsystem
- system to use (uscustomary|imperial|metric), or undefined if the system can be inferred from the current measure
- {Object=} units
- mapping from the measurement system to the units to use for this scaling. If this is not defined, this measurement type will use the set of units that it knows about for the given measurement system
- Returns:
- {Array.
} an array of new measurements in order from the current units to the smallest units in the system which together are the same measurement as this one
{string}
getMeasure()
Return the type of this measurement. Examples are "mass",
"length", "speed", etc. Measurements can only be converted
to measurements of the same type.
The type of the units is determined automatically from the units. For example, the unit "grams" is type "mass". Use the static call Measurement.getAvailableUnits to find out what units this version of ilib supports.
- Returns:
- {string} the name of the type of this measurement
{Measurement}
localize(locale)
Localize the measurement to the commonly used measurement in that locale. For example
If a user's locale is "en-US" and the measurement is given as "60 kmh",
the formatted number should be automatically converted to the most appropriate
measure in the other system, in this case, mph. The formatted result should
appear as "37.3 mph".
- Parameters:
- {string} locale
- current locale string
- Returns:
- {Measurement} a new instance that is converted to locale
{Measurement}
newUnit(params)
Return a new instance of this type of measurement.
- Parameters:
- {Object} params
- parameters to the constructor
- Returns:
- {Measurement} a measurement subclass instance
{Measurement}
scale(measurementsystem, units)
Scale the measurement unit to an acceptable level. The scaling
happens so that the integer part of the amount is as small as
possible without being below zero. This will result in the
largest units that can represent this measurement without
fractions. Measurements can only be scaled to other measurements
of the same type.
- Parameters:
- {string=} measurementsystem
- system to use (uscustomary|imperial|metric), or undefined if the system can be inferred from the current measure
- {Object=} units
- mapping from the measurement system to the units to use for this scaling. If this is not defined, this measurement type will use the set of units that it knows about for the given measurement system
- Returns:
- {Measurement} a new instance that is scaled to the right level