## `$number()`

**用法:** `$number(arg)`

使用以下轉(zhuǎn)換規(guī)則將 arg 參數(shù)轉(zhuǎn)換為數(shù)字

* 數(shù)字不變
* 包含表示合法 JSON 數(shù)字的字符序列的字符串將轉(zhuǎn)換為該數(shù)字
* 十六進(jìn)制數(shù)以 `0x` 開(kāi)頭，八進(jìn)制數(shù)以 `0o` 開(kāi)頭，二進(jìn)制數(shù)以 `0o` 開(kāi)頭
* 布爾 `true` 轉(zhuǎn)換為 `1`，布爾 `false` 轉(zhuǎn)換為 `0`
* 所有其他值都會(huì)引發(fā)錯(cuò)誤。

如果未指定 `arg`（即此函數(shù)在沒(méi)有參數(shù)的情況下被調(diào)用），則上下文值將用作 `arg` 的值。

舉例：

* `$number("5")` => `5`
* `$number("0x12")` => `0x18`
* `["1", "2", "3", "4", "5"].$number()` => `[1, 2, 3, 4, 5]`

## `$abs()`

**用法:** `$abs(number)`

返回?cái)?shù)字參數(shù)的絕對(duì)值，即如果 `number` 為負(fù)，則返回正值。

如果未指定 `number`（即此函數(shù)在沒(méi)有參數(shù)的情況下調(diào)用），則使用上下文值作為 `number` 的值。

舉例：

* `$abs(5)` => `5`
* `$abs(-5)` => `5`

## `$floor()`

**用法:** `$floor(number)`

返回四舍五入到小于或等于 `number` 的最接近整數(shù)的 `number` 值。

如果未指定 `number`（即此函數(shù)在沒(méi)有參數(shù)的情況下調(diào)用），則使用上下文值作為 `number` 的值。

舉例：

* `$floor(5)` => `5`
* `$floor(5.3)` => `5`
* `$floor(5.8)` => `5`
* `$floor(-5.3)` => `-6`

## `$ceil()`

**用法:** `$ceil(number)`
返回 `number` 的值，四舍五入到大于或等于 `number` 的最接近整數(shù)。

如果未指定 `number`（即此函數(shù)在沒(méi)有參數(shù)的情況下調(diào)用），則使用上下文值作為 `number` 的值。

舉例：

* `$ceil(5)` => `5`
* `$ceil(5.3)` => `6`
* `$ceil(5.8)` => `6`
* `$ceil(-5.3)` => `-5`

## `$round()`

**用法:** `$round(number [, precision])`

返回 `number` 參數(shù)的值，四舍五入到可選精度參數(shù)指定的小數(shù)位數(shù)。

`precision` 參數(shù)（必須是整數(shù)）指定四舍五入數(shù)字中存在的小數(shù)位數(shù)。如果未指定 `precision`，則默認(rèn)值為 `0`，數(shù)字四舍五入到最接近的整數(shù)。如果 `precision` 為負(fù)，則其值指定小數(shù)點(diǎn)左側(cè)四舍五入到那一列。

此函數(shù)使用舍入半偶數(shù)策略來(lái)決定以指定的精度對(duì)恰好位于兩個(gè)候選之間的數(shù)字進(jìn)行舍入。此策略通常用于財(cái)務(wù)計(jì)算，是 IEEE 754 中的默認(rèn)四舍五入模式。

舉例：

* `$round(123.456)` => `123`
* `$round(123.456, 2)` => `123.46`
* `$round(123.456, -1)` => `120`
* `$round(123.456, -2)` => `100`
* `$round(11.5)` => `12`
* `$round(12.5)` => `12`
* `$round(125, -1)` => `120`

## `$power()`

**用法:** `$power(base, exponent)`

返回 `base` 的冪次 `exponent`（基差指數(shù)）。

如果未指定 `base`（即使用一個(gè)參數(shù)調(diào)用此函數(shù)），則使用上下文值作為 base 的值。

如果 `base` 和指數(shù)的值導(dǎo)致無(wú)法表示為 JSON 數(shù)字的值（例如無(wú)窮大、復(fù)數(shù)），則會(huì)拋出錯(cuò)誤。

舉例：

* `$power(2, 8)` => `256`
* `$power(2, 0.5)` => `1.414213562373`
* `$power(2, -2)` => `0.25`

## `$sqrt()`

**用法:** `$sqrt(number)`

返回 `number` 參數(shù)值的平方根。

如果未指定 `number`（即使用一個(gè)參數(shù)調(diào)用此函數(shù)），則使用上下文值作為 `number` 的值。

如果 `number` 的值為負(fù)，則拋出錯(cuò)誤。

舉例：

* `$sqrt(4)` => `2`
* `$sqrt(2)` => `1.414213562373`

## `$random()`

**用法:** `$random()`

返回一個(gè)大于等于零且小于 1 的偽隨機(jī)數(shù)（`0 ≤ n < 1`）

舉例：

* `$random()` => `0.7973541067127`
* `$random()` => `0.4029142127028`
* `$random()` => `0.6558078550072`

## `$formatNumber()`

**用法:** `$formatNumber(number, picture [, options])`

將 `number` 轉(zhuǎn)換為字符串，并將其格式化為 `picture` 字符串指定的十進(jìn)制表示形式。

此函數(shù)的行為與 XPath F&O 3.1 規(guī)范中定義的 XPath/XQuery 函數(shù) fn:format number 一致。圖片字符串參數(shù)定義了數(shù)字的格式，其語(yǔ)法與 fn:format number 相同。

可選的第三個(gè)參數(shù) `options` 用于覆蓋默認(rèn)的特定于區(qū)域設(shè)置的格式化字符，如小數(shù)分隔符。如果提供，此參數(shù)必須是一個(gè)包含 XPath F&O 3.1 規(guī)范的十進(jìn)制格式部分中指定的名稱(chēng)/值對(duì)的對(duì)象。

舉例：

* `$formatNumber(12345.6, '#,###.00')` => `"12,345.60"`
* `$formatNumber(1234.5678, "00.000e0")` => `"12.346e2"`
* `$formatNumber(34.555, "#0.00;(#0.00)")` => `"34.56"`
* `$formatNumber(-34.555, "#0.00;(#0.00)")` => `"(34.56)"`
* `$formatNumber(0.14, "01%")` => `"14%"`
* `$formatNumber(0.14, "###pm", {"per-mille": "pm"})` => `"140pm"`
* `$formatNumber(1234.5678, "①①.①①①e①", {"zero-digit": "\u245f"})` => `"①②.③④⑥e②"`

## `$formatBase()`

**用法:** `$formatBase(number [, radix])`

將 `number` 轉(zhuǎn)換為字符串，并將其格式化為以基數(shù)參數(shù)指定的 `radix` 表示的整數(shù)。如果未指定 `radix`，則默認(rèn)為基數(shù) 10。基數(shù)可以在 2 和 36 之間，否則會(huì)拋出錯(cuò)誤。

舉例：

* `$formatBase(100, 2)` => `"1100100"`
* `$formatBase(2555, 16)` => `"9fb"`

## `$formatInteger()`

**用法:** `$formatInteger(number, picture)`

將 `number` 轉(zhuǎn)換為字符串，并將其格式化為 `picture` 字符串指定的整數(shù)表示形式。

此函數(shù)的行為與 XPath F&O 3.1 規(guī)范中定義的 XPath/XQuery 函數(shù) fn:format integer 的雙參數(shù)版本一致。圖片字符串參數(shù)定義了數(shù)字的格式，其語(yǔ)法與 fn:format integer 相同。

舉例：

* `$formatInteger(2789, 'w')` => `"two thousand, seven hundred and eighty-nine"`
* `$formatInteger(1999, 'I')` => `"MCMXCIX"`

## `$parseInteger()`

**用法:** `$parseInteger(string, picture)`

使用 `picture` 字符串指定的格式將字符串參數(shù)的內(nèi)容解析為整數(shù)（JSON 數(shù)字）。圖片 `string` 參數(shù)的格式與 `$formatInteger` 相同。雖然 XPath 規(guī)范沒(méi)有解析整數(shù)的等效功能，但 JSONata 中添加了此功能。

舉例：

* `$parseInteger("twelve thousand, four hundred and seventy-six", 'w')` => `12476`
* `$parseInteger('12,345,678', '#,##0')` => `12345678`

17、數(shù)值函數(shù)