BlueGrove Labs
帮助中心StatusPath ReportsJira Cloud
联系支持
EN

使用指南

如何计算 Jira Cloud 中的状态停留时间

状态停留时间（Time in Status）用于衡量一个 Jira 工作项在每个工作流状态中停留了多长时间，例如“待办”“进行中”“等待评审”或“已完成”。

想用自己的 Jira 数据运行这份报表？ 在 Atlassian Marketplace 免费试用 StatusPath Reports，先从一个小而真实的 Jira 范围开始。

通过状态停留时间报表，团队可以回答以下问题：

  • 工作项在哪些状态中停留的时间最长？
  • 哪个工作流阶段形成了瓶颈？
  • 代码评审或测试通常需要多长时间？
  • 工作项通过整个流程的速度是否正在改善？
  • 工作项在不同负责人名下分别停留了多长时间？

Jira 会在工作项历史记录中保存状态变更。要生成详细的状态停留时间报表，需要将这些状态流转记录转换为时间区间，并按工作项和状态进行汇总。

什么是状态停留时间？

每当工作项发生状态变更时，Jira 都会记录此次流转发生的时间。

例如：

时间 状态
周一 09:00 待办
周一 10:30 进行中
周一 12:00 等待评审
周二 11:00 已完成

计算得到的各状态停留时间为：

状态 停留时间
待办 1 小时 30 分钟
进行中 1 小时 30 分钟
等待评审 23 小时

如果工作项当前仍处于某个状态，该状态的停留时间通常会计算到报表结束时间或当前时间，具体取决于报表配置。

如果一个工作项多次进入同一个状态，通常会将该状态下所有停留区间的时长累加起来。

Jira 是否自带状态停留时间报表？

Jira Cloud 提供控制图（Control Chart）等原生报表，可以根据选定的工作流状态展示周期时间或前置时间。

这些原生报表适合进行整体流程分析，但很多团队还需要更详细的数据，例如：

  • 每个工作项单独显示一行
  • 每个工作流状态单独显示一列
  • 按状态统计平均停留时间
  • 按负责人统计停留时间
  • 支持工作时间和节假日日历
  • 按项目、JQL、迭代、Epic 或已保存筛选器查询
  • 导出 CSV 和 Excel
  • 查看状态进入日期和流转次数

专门的状态停留时间报表应用可以读取 Jira 历史记录，计算这些数据，并以可重复使用的报表形式展示。

状态停留时间是如何计算的？

基本计算公式为：

状态停留时间 = 下一次状态变化时间 − 当前状态进入时间

对于工作项当前所在的状态：

当前状态停留时间 = 报表结束时间 − 当前状态进入时间

一份完整的状态停留时间报表通常会执行以下步骤：

  1. 读取工作项创建时间。
  2. 读取 Jira 历史记录中的状态变更。
  3. 按时间顺序排列状态变更记录。
  4. 为每次状态停留创建一个时间区间。
  5. 根据报表日期范围裁剪时间区间。
  6. 应用工作日历和时长格式设置。
  7. 合并同一状态的多次停留时间。
  8. 按工作项、状态、分组或时间周期展示结果。

哪些设置会影响计算结果？

即使使用相同的 Jira 数据，不同报表也可能显示不同的状态停留时间。在比较报表结果之前，应重点检查以下设置。

1. 自然时间与工作时间

自然时间会计算晚上、周末和节假日。

工作时间只计算工作日历中配置的有效时间，例如：

  • 周一至周五
  • 每天 09:00 至 17:00
  • 排除法定节假日

例如，一个工作项从周五下午等待到周一上午，按自然时间可能会显示几天，但按工作时间计算，可能只有很短的有效时长。

2. 时区

时区设置会影响：

  • 每天的开始和结束时间
  • 工作时间边界
  • 按周和按月分组的边界
  • 夏令时变化
  • 日期范围裁剪结果

建议选择与团队所在地或报表统计要求一致的时区。

3. 报表日期范围

报表可以计算工作项的完整历史记录，也可以只计算与所选日期范围重叠的部分。

例如，一个工作项在报表开始日期之前已经进入“进行中”，报表可以只统计开始日期之后的停留时间。

4. 重复进入同一个状态

工作项可能多次进入相同状态。

例如：

进行中 → 评审 → 进行中 → 已完成

状态停留时间报表通常会合并两次“进行中”的时间。状态进入次数报表则可以显示工作项进入该状态的具体次数。重复进入状态计算指南会按时间戳核对一个两次停留行和一个相同时长的单次停留对照。

5. 当前状态

当前状态还没有变为另一个状态，因此它的停留时间取决于所选的报表结束时间，或者生成报表时的当前时间。可使用当前状态时长排查指南比较两次受控运行，并固定可复现的历史边界。

如何使用 StatusPath Reports 创建状态停留时间报表？

StatusPath Reports 可以为 Jira Cloud 创建详细的工作流时长报表。

第一步：选择报表类型

打开 StatusPath Reports，然后选择 Time in Status（状态停留时间）。

其他可用报表类型包括：

  • Average Time in Status：平均状态停留时间
  • Time in Assignee：负责人停留时间
  • Status Count：状态进入次数
  • Status Entry Date：状态进入日期
  • Transition Count：状态流转次数
按工作流状态显示时长的 Jira 状态停留时间报表
完整的状态停留时间表格：每个 Jira 工作项占一行，每个工作流状态对应一个时长列。

第二步：选择数据源

可以通过以下数据源选择需要统计的 Jira 工作项：

  • 项目
  • 已保存筛选器
  • JQL
  • 迭代
  • Epic

当需要按照工作项类型、优先级、解决结果、标签、组件或创建日期进行精确筛选时，可以使用 JQL。

第三步：配置日期范围

选择报表需要统计的时间范围。

日期范围可以用于分析：

  • 最近一次迭代
  • 上一个月
  • 某个版本发布周期
  • 某个季度
  • 工作项的完整历史记录

第四步：选择时长格式

StatusPath Reports 支持使用不同格式展示时长，例如：

  • 天、小时和分钟
  • 小数小时
  • 小数天
  • 工作小时
  • 工作日

在比较不同团队或不同统计周期之前，建议统一使用相同的时长格式。

第五步：配置工作日历

如果需要按工作时间统计，可以选择或配置一个工作日历，包括：

  • 工作日
  • 每日工作时间
  • 时区
  • 节假日

这样可以避免周末和非工作时间导致工作流时长被放大。

配置用于计算状态停留时间的 Jira 工作时间
StatusPath Reports 工作日历用于定义时区、工作日、每日工作时间、节假日和其他例外日期。

第六步：运行并分析报表

报表生成后，可以执行以下操作：

  • 按状态停留时间排序
  • 筛选时长数据
  • 添加 Jira 字段列
  • 添加或移除状态列
  • 创建状态分组
  • 按负责人分组
  • 查找停留时间最长的工作流阶段
  • 切换到图表视图

将某个状态列按照停留时间从长到短排序，是查找异常工作项和潜在瓶颈的一种简单方式。

按状态停留时间展示的 Jira 工作流瓶颈图表
Top Bottleneck Work Items 图表用于比较每个 Jira 工作项在各工作流状态中的停留时间。

第七步：导出报表

报表可以导出为 CSV 或 XLSX，用于：

  • 管理层汇报
  • 审计和问题分析
  • 迭代回顾
  • 流程改进会议
  • 在电子表格工具中继续分析
将 Jira 状态停留时间报表导出到 Excel
在电子表格中打开的 StatusPath Reports XLSX 导出结果，包含冻结标题行和各状态时长列。

状态停留时间与平均状态停留时间有什么区别？

这两类报表回答的问题不同。

状态停留时间

状态停留时间报表展示每个工作项在各状态中的具体时长。

例如：

工作项 待办 进行中 评审
DEV-101 2 小时 6 小时 3 小时
DEV-102 4 小时 10 小时 1 小时

该报表适合分析具体工作项。

平均状态停留时间

平均状态停留时间报表会汇总多个工作项，并计算每个状态或分组的平均时长。

例如：

状态 平均停留时间
待办 3 小时
进行中 8 小时
评审 2 小时

该报表适合比较不同项目、迭代、团队或统计周期的工作流表现。

常见使用场景

识别工作流瓶颈

比较各状态的总停留时间或平均停留时间。

如果“等待评审”“测试”或“等待处理”等状态长期具有较高数值，可能说明团队容量不足、交接规则不清晰，或者存在外部依赖。

比较不同迭代的效率

按照迭代筛选工作项，然后比较不同迭代中各状态的平均停留时间。使用 Jira Sprint 工作流分析流程可以保持范围、返工和趋势定义一致。

分析返工情况

通过状态进入次数或状态流转次数，找出频繁在工作流中返回上一阶段的工作项。

分析负责人停留时间

使用 Time in Assignee了解工作项分别在不同负责人名下停留了多长时间，同时避免把归属时间误解为 Work log。

准备管理报表

将结果导出到 Excel，或者保存报表配置，用于重复生成每周或每月的管理报表。Jira 工作流报表完整指南说明了从问题和范围到核查与输出的完整路径。

常见问题

Jira 会自动记录状态变更吗？

会。Jira 会在工作项历史记录中保存工作流状态变更及其发生时间。报表工具可以使用这些时间戳计算每次状态停留的时长。

可以排除周末吗？

可以。使用工作日历配置工作日、每日工作时间、节假日和时区，即可排除周末和其他非工作时间。

工作项两次进入同一个状态时会怎样计算？

报表可以将所有停留区间相加，得到该状态的总停留时间。状态进入次数报表可以显示工作项一共进入该状态多少次。

可以使用 JQL 创建报表吗？

可以。StatusPath Reports 支持使用 JQL 作为数据源，从而只统计符合特定条件的 Jira 工作项。

可以将结果导出到 Excel 吗？

可以。StatusPath Reports 支持 CSV 和 XLSX 导出。

相关指南

开始分析 Jira 工作流延迟

StatusPath Reports – Time in Status for Jira 可以帮助团队分析状态停留时间、负责人停留时间、状态进入情况、流转次数和工作流瓶颈趋势。

它支持工作日历、已保存报表、趋势图、Jira 仪表板小程序，以及 CSV 和 XLSX 导出。

在 Atlassian Marketplace 免费试用 StatusPath Reports，先从一个小而真实的 Jira 范围生成报表。

截图预览