logologo
开始
手册
开发
插件
API
English
简体中文
开始
手册
开发
插件
API
English
简体中文
logologo
概述
配置说明

模板语法

基础用法
循环处理

格式化工具

概述
文本格式化
数字格式化
货币格式化
日期格式化
时间间隔格式化
数组格式化

高级功能

条件判断
高级特性
常见问题
应用场景
Previous Page文本格式化
Next Page货币格式化

#数字格式化

#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

#语法说明

将数字转换为法文格式(小数点为 ','),不推荐使用。

#示例与结果

依据具体转换情况。