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

模板语法

基础用法
循环处理

格式化工具

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

高级功能

条件判断
高级特性
常见问题
应用场景
Previous Page日期格式化
Next Page数组格式化

#时间间隔格式化

#1. :formatI(patternOut, patternIn)

#语法说明

格式化时长或间隔,支持的输出格式包括:

  • human+、human(适合人性化显示)
  • 以及 millisecond(s)、second(s)、minute(s)、hour(s)、year(s)、month(s)、week(s)、day(s) 等单位(或其简写)。

参数:

  • patternOut:输出格式(例如 'second'、'human+' 等)
  • patternIn:可选,输入单位(例如 'milliseconds'、's' 等)
#示例
// 示例环境:API 选项 { "lang": "en", "timezone": "Europe/Paris" }
2000:formatI('second')       // 输出 2
2000:formatI('seconds')      // 输出 2
2000:formatI('s')            // 输出 2
3600000:formatI('minute')    // 输出 60
3600000:formatI('hour')      // 输出 1
2419200000:formatI('days')   // 输出 28

// 法语示例:
2000:formatI('human')        // 输出 "quelques secondes"
2000:formatI('human+')       // 输出 "dans quelques secondes"
-2000:formatI('human+')      // 输出 "il y a quelques secondes"

// 英语示例:
2000:formatI('human')        // 输出 "a few seconds"
2000:formatI('human+')       // 输出 "in a few seconds"
-2000:formatI('human+')      // 输出 "a few seconds ago"

// 单位转换示例:
60:formatI('ms', 'minute')   // 输出 3600000
4:formatI('ms', 'weeks')      // 输出 2419200000
'P1M':formatI('ms')          // 输出 2628000000
'P1Y2M3DT4H5M6S':formatI('hour')  // 输出 10296.085
#结果

输出结果根据输入值和单位转换显示为相应的时长或间隔。