#数値の書式設定

#1. :formatN(precision)

#構文説明

数値をロケール設定に基づいて書式設定します。
パラメーター:

• precision: 小数点以下の桁数
  ODS/XLSX形式の場合、表示される小数点以下の桁数はテキストエディターによって決まります。その他の形式では、このパラメーターが使用されます。

#実行例

// 実行環境の例: APIオプション { "lang": "en-us" }
'10':formatN()         // 出力 "10.000"
'1000.456':formatN()   // 出力 "1,000.456"

#結果

指定された精度とロケール形式で数値が出力されます。

#2. :round(precision)

#構文説明

数値を指定された小数点以下の桁数で四捨五入します。

#実行例

10.05123:round(2)      // 出力 10.05
1.05:round(1)          // 出力 1.1

#結果

四捨五入された数値が出力されます。

#3. :add(value)

#構文説明

現在の数値に指定された値を加算します。
パラメーター:

• value: 加算する値

#実行例

1000.4:add(2)         // 出力 1002.4
'1000.4':add('2')      // 出力 1002.4

#結果

加算結果の数値が出力されます。

#4. :sub(value)

#構文説明

現在の数値から指定された値を減算します。
パラメーター:

• value: 減算する値

#実行例

1000.4:sub(2)         // 出力 998.4
'1000.4':sub('2')      // 出力 998.4

#結果

減算結果の数値が出力されます。

#5. :mul(value)

#構文説明

現在の数値に指定された値を乗算します。
パラメーター:

• value: 乗算する値

#実行例

1000.4:mul(2)         // 出力 2000.8
'1000.4':mul('2')      // 出力 2000.8

#結果

乗算結果の数値が出力されます。

#6. :div(value)

#構文説明

現在の数値を指定された値で除算します。
パラメーター:

• value: 除算する値

#実行例

1000.4:div(2)         // 出力 500.2
'1000.4':div('2')      // 出力 500.2

#結果

除算結果の数値が出力されます。

#7. :mod(value)

#構文説明

現在の数値を指定された値で割った剰余（モジュラス）を計算します。
パラメーター:

• value: 剰余を計算するための除数

#実行例

4:mod(2)              // 出力 0
3:mod(2)              // 出力 1

#結果

剰余演算の結果が出力されます。

#8. :abs

#構文説明

数値の絶対値を返します。

#実行例

-10:abs()             // 出力 10
-10.54:abs()          // 出力 10.54
10.54:abs()           // 出力 10.54
'-200':abs()          // 出力 200

#結果

絶対値が出力されます。

#9. :ceil

#構文説明

数値を切り上げて、現在の数値以上の最小の整数を返します。

#実行例

10.05123:ceil()       // 出力 11
1.05:ceil()           // 出力 2
-1.05:ceil()          // 出力 -1

#結果

切り上げられた整数が出力されます。

#10. :floor

#構文説明

数値を切り捨てて、現在の数値以下の最大の整数を返します。

#実行例

10.05123:floor()      // 出力 10
1.05:floor()          // 出力 1
-1.05:floor()         // 出力 -2

#結果

切り捨てられた整数が出力されます。

#11. :int

#構文説明

数値を整数に変換します（非推奨）。

#実行例と結果

変換の状況によって異なります。

#12. :toEN

#構文説明

数値を英語形式（小数点に . を使用）に変換します（非推奨）。

#実行例と結果

変換の状況によって異なります。

#13. :toFixed

#構文説明

数値を文字列に変換し、指定された小数点以下の桁数のみを保持します（非推奨）。

#実行例と結果

変換の状況によって異なります。

#14. :toFR

#構文説明

数値をフランス語形式（小数点に , を使用）に変換します（非推奨）。

#実行例と結果

変換の状況によって異なります。