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

使用指南

如何在 Jira 状态时间中排除周末和非工作时间

要从 Jira 状态时间中排除周末，应让每一段状态区间与工作日历取交集，而不是把进入和离开状态的两个时间戳直接相减。先定义工作日、每日工作时间、时区、节假日和例外，再在时长报表中选择该日历。Jira 历史没有变化，变化的是哪些时间被计入。

自然时间和工作时间回答不同问题

自然时间包含夜间、周末和节假日，回答客户或业务方总共等待了多久。工作时间只包含日历定义的工作区间，回答经过了多少排班时间。

Atlassian 的看板级工作日设置可以为指定的 Jira 原生报表和小组件排除周末及非工作日。StatusPath Reports 则使用报表中选定的独立日历计算时长。不要假设修改其中一处会自动改变另一处。

真实 Jira 场景：周五评审到周一交接

工作项 SR-2201 在周五 16:00 UTC 进入 In Review，周一 10:00 UTC 离开。团队工作时间为周一至周五 09:00-17:00 UTC，期间没有节假日。

自然时间：

周五 16:00 → 周一 10:00 = 66 小时

工作时间：

周五 16:00 → 17:00 = 1 小时
周一 09:00 → 10:00 = 1 小时
工作时间合计          = 2 小时

少掉的 64 小时不是 Jira 历史缺失，而是这些时间不在选定排班内。

Jira 状态时间报表显示周五到周一的评审区间包含两个工作小时
选定 UTC 工作日日历后，In Review 区间计入两个工作小时。

在 StatusPath Reports 中配置工作时间

  1. 选择 Time in Status、Average Time in Status 或 Time in Assignee。日历规则适用于时长报表，不适用于 Status Count 或 Transition Count。
  2. 通过 Project、Filter、JQL、Sprint 或 Epic 选择工作项范围，具体见报表设置与范围。
  3. 检查 工作项日期范围和裁剪历史。裁剪区间与排除非工作时间是两种不同操作。
  4. 选择包含正确时区、工作日、每日时间段、节假日和一次性例外的日历。
  5. 选择便于阅读的时长格式。Calendar 决定哪些时间计入，Format 决定如何显示。
  6. 先人工核对一个简单区间，再把配置用于大范围数据。

StatusPath 日历文档说明了每周时段、时区、日期例外和时长格式。如果示例中的周一是非工作节假日，则只计周五的 1 小时；如果周一是特殊工作日，则使用例外时间覆盖普通周一排班。

时区和历史边界为什么重要

工作时间必须依附于时区。同一个 Jira 时间戳在某个地区可能落在工作时段内，在另一个地区则可能落在工作时段外。客服报告可使用值守团队时区，工程流动分析可使用交付团队时区，多地区服务则应使用约定的运营时区。

Atlassian 说明 Jira Software 的 Control Chart会根据选定工作流状态计算周期时间或前置时间；这里引用的 Control Chart 文档适用于公司管理的空间。与其他报表比较时，需要先确认报表可用，再确认状态集合、工作项范围、时间段、看板工作日和当前状态处理规则一致。

常见错误

排除了周末，却仍然计算夜间

仅选择周一至周五并没有定义完整排班，还应设置 09:00-17:00 之类的每日工作区间。

只改 Format，没有改 Calendar

把小时换算为天只会改变展示方式。要排除非工作时间，必须选择正确日历。

不同团队共用一个不合适的日历

地区、班次或周末规则不同的团队应使用不同日历。

漏配节假日或特殊工作日

应明确维护日期例外，并确认日期边界采用哪个时区。

把当前状态持续增长当作错误

当前状态还没有变为另一个状态，通常会持续计算到报表结束时间。复现旧结果时应固定历史结束时间。

常见问题

排除周末会把工作项移出报表吗？

不会。范围和工作项日期筛选决定是否纳入工作项，日历只改变状态区间中计入的时长。

节假日会像周末一样排除吗？

只有当选定日历将该日期定义为非工作例外时才会排除，否则仍按普通工作日处理。

客户等待时间应该排除周末吗？

不一定。自然时间表示客户总等待时间，工作时间表示排班内的运营时间。两者可以同时保留，但必须明确标注口径。

工作日历会影响 Status Count 吗？

不会。Status Count 和 Transition Count 统计事件；裁剪历史可能改变事件范围，但工作日历不会把计数变成时长。

相关指南

把日历写进指标定义

“评审时长”并不完整，还应说明采用自然时间还是工作时间、使用哪个时区，以及包含哪些例外。将这些配置保存在报表中，并在用于复盘或目标前人工核对一个工作项。

在 Atlassian Marketplace 试用 StatusPath Reports，为 Jira 时长报表应用可复用的工作日历。

截图预览