@terascope/core-utils / numbers
numbers
Interfaces
| Interface | Description |
|---|---|
| InNumberRangeArg | - |
Functions
bigIntToJSON()
bigIntToJSON(
int):string|number
Defined in: packages/core-utils/src/numbers.ts:107
Convert a BigInt to either a number or a string
Parameters
| Parameter | Type |
|---|---|
int | bigint |
Returns
string | number
inNumberRange()
inNumberRange(
input,args):input is number
Defined in: packages/core-utils/src/numbers.ts:268
Returns true if number is between min or max value provided
Parameters
| Parameter | Type |
|---|---|
input | unknown |
args | InNumberRangeArg |
Returns
input is number
Example
inNumberRange(42, { min: 0, max: 100}); // true
inNumberRange(-42, { min:0 , max: 100 }); // false
inNumberRange(42, { min: 0, max: 42 }); // false
inNumberRange(42, { min: 0, max: 42, inclusive: true }) // true
inNumberRangeFP()
inNumberRangeFP(
args): (input) =>input is number
Defined in: packages/core-utils/src/numbers.ts:281
Parameters
| Parameter | Type |
|---|---|
args | InNumberRangeArg |
Returns
(input) => input is number
isBigInt()
isBigInt(
input):input is bigint
Defined in: packages/core-utils/src/numbers.ts:44
Check if value is a bigint
Parameters
| Parameter | Type |
|---|---|
input | unknown |
Returns
input is bigint
isFloat()
isFloat(
val):val is number
Defined in: packages/core-utils/src/numbers.ts:182
Verify the input is float
Parameters
| Parameter | Type |
|---|---|
val | unknown |
Returns
val is number
isInteger()
isInteger(
val):val is number
Defined in: packages/core-utils/src/numbers.ts:140
A simplified implementation of lodash isInteger
Parameters
| Parameter | Type |
|---|---|
val | unknown |
Returns
val is number
isNumber()
isNumber(
input):input is number
Defined in: packages/core-utils/src/numbers.ts:22
Check if an input is a number
Parameters
| Parameter | Type |
|---|---|
input | unknown |
Returns
input is number
isNumberLike()
isNumberLike(
input):boolean
Defined in: packages/core-utils/src/numbers.ts:119
return true if value could be a number
Parameters
| Parameter | Type |
|---|---|
input | unknown |
Returns
boolean
isValidateNumberType()
isValidateNumberType(
type): (input) =>boolean
Defined in: packages/core-utils/src/numbers.ts:413
Parameters
| Parameter | Type |
|---|---|
type | FieldType |
Returns
(input) => boolean
parseNumberList()
parseNumberList(
input):number[]
Defined in: packages/core-utils/src/numbers.ts:226
Like parseList, except it returns numbers
Parameters
| Parameter | Type |
|---|---|
input | unknown |
Returns
number[]
random()
random(
min,max):number
Defined in: packages/core-utils/src/numbers.ts:17
A native implementation of lodash random
Parameters
| Parameter | Type |
|---|---|
min | number |
max | number |
Returns
number
setPrecision()
setPrecision(
input,fractionDigits,truncate?):number
Defined in: packages/core-utils/src/numbers.ts:293
Returns a truncated number to nth decimal places.
Parameters
| Parameter | Type | Default value | Description |
|---|---|---|---|
input | unknown | undefined | - |
fractionDigits | number | undefined | The number of decimal points to round to. |
truncate | boolean | false | If this is true the number will not be rounded |
Returns
number
setPrecisionFP()
setPrecisionFP(
fractionDigits,truncate?): (input) =>number
Defined in: packages/core-utils/src/numbers.ts:319
A functional programming version of setPrecision
Parameters
| Parameter | Type | Default value | Description |
|---|---|---|---|
fractionDigits | number | undefined | The number of decimal points to round to. |
truncate | boolean | false | If this is true the number will not be rounded |
Returns
(input) => number
toBigInt()
toBigInt(
input):bigint|false
Defined in: packages/core-utils/src/numbers.ts:49
Convert any input to a bigint
Parameters
| Parameter | Type |
|---|---|
input | unknown |
Returns
bigint | false
toBigIntOrThrow()
toBigIntOrThrow(
input):bigint
Defined in: packages/core-utils/src/numbers.ts:66
Convert any input to a bigint
Parameters
| Parameter | Type |
|---|---|
input | unknown |
Returns
bigint
toCelsius()
toCelsius(
input):number
Defined in: packages/core-utils/src/numbers.ts:349
Convert a fahrenheit value to celsius, this will return a precision of 2 decimal points
Parameters
| Parameter | Type |
|---|---|
input | unknown |
Returns
number
toFahrenheit()
toFahrenheit(
input):number
Defined in: packages/core-utils/src/numbers.ts:360
Convert a celsius value to fahrenheit, this will return a precision of 2 decimal points
Parameters
| Parameter | Type |
|---|---|
input | unknown |
Returns
number
toFloat()
toFloat(
input):number|false
Defined in: packages/core-utils/src/numbers.ts:190
Convert an input to a float, return false if unable to convert input
Parameters
| Parameter | Type |
|---|---|
input | unknown |
Returns
number | false
toFloatOrThrow()
toFloatOrThrow(
input):number
Defined in: packages/core-utils/src/numbers.ts:199
Convert an input to a float or throw
Parameters
| Parameter | Type |
|---|---|
input | unknown |
Returns
number
toInteger()
toInteger(
input):number|false
Defined in: packages/core-utils/src/numbers.ts:146
Convert an input to a integer, return false if unable to convert input
Parameters
| Parameter | Type |
|---|---|
input | unknown |
Returns
number | false
toIntegerOrThrow()
toIntegerOrThrow(
input):number
Defined in: packages/core-utils/src/numbers.ts:155
Convert an input to a integer or throw
Parameters
| Parameter | Type |
|---|---|
input | unknown |
Returns
number
toNumber()
toNumber(
input):number
Defined in: packages/core-utils/src/numbers.ts:27
Convert any input to a number, return Number.NaN if unable to convert input
Parameters
| Parameter | Type |
|---|---|
input | unknown |
Returns
number
toNumberOrThrow()
toNumberOrThrow(
input):number
Defined in: packages/core-utils/src/numbers.ts:34
Will throw if converted number is NaN
Parameters
| Parameter | Type |
|---|---|
input | unknown |
Returns
number
validateByteNumber()
validateByteNumber(
input):number
Defined in: packages/core-utils/src/numbers.ts:395
Parameters
| Parameter | Type |
|---|---|
input | unknown |
Returns
number
validateIntegerNumber()
validateIntegerNumber(
input):number
Defined in: packages/core-utils/src/numbers.ts:403
Parameters
| Parameter | Type |
|---|---|
input | unknown |
Returns
number
validateNumberType()
validateNumberType(
type): (input) =>number
Defined in: packages/core-utils/src/numbers.ts:407
Parameters
| Parameter | Type |
|---|---|
type | FieldType |
Returns
(input) => number
validateShortNumber()
validateShortNumber(
input):number
Defined in: packages/core-utils/src/numbers.ts:399
Parameters
| Parameter | Type |
|---|---|
input | unknown |
Returns
number