持续时间(duration)
基本说明
持续时间类型表示一段时间的长度,例如配送时长、处理耗时、工龄。它保存时长数值,默认单位为秒,例如 30 表示 30 秒。
数据要求
映射后的值应表示时长数值,并使用一致的时间单位。原始数据为 "30秒"、"00:30:00" 等文本时,可以在映射中换算为对应数值。
如果原始数据以分钟保存,而模型使用秒,可以在映射中配置 duration_minutes * 60。如果只有开始和结束两个时间点,也可以在映射中计算时间差,无需在数据库中额外维护时长列。
配置与问答
需要修改时间单位时,在专家模式中设置 unit,支持的中文值为:秒、天、月、季度、年。例如:
unit 应与实际数值的单位一致,修改配置前应先确认是否需要转换数据。总工时等可累计时长可以作为可加指标;平均配送时长等应使用均值逻辑,参见是否可加。
使用示例
两笔订单的配送时长以秒存储:
把配送时长设为持续时间类型、单位为秒,并按均值计算,「平均配送时长」为 1500 秒,即 25 分钟。
常见问题
持续时间和日期时间有什么区别?
持续时间回答「多久」,保存长度;日期时间回答「什么时候」,保存时间点。例如「配送耗时 30 分钟」是持续时间,「发货于 2025-06-01 10:00:00」是日期时间。
分钟数直接按默认单位接入,会有什么问题?
默认按秒解释,30 会被理解为 30 秒。接入前应统一单位,不能只改展示文字而忽略实际数值。

