时间追踪

  • 在极狐GitLab 17.0中引入时间追踪。
  • 在极狐GitLab 17.5中引入史诗（Epics）。

您可以估算并追踪您在以下项上的花费时间：

然后，您可以查看报告，该报告显示了总时间的统计。

使用时间追踪进行以下操作：

  • 记录在项上工作的时间。
  • 添加或更新完成项所需的总时间估算。
  • 查看在项上工作的时间细分。

您无需提供估算才能记录已花费的时间，反之亦然。

要输入和移除时间追踪数据，您必须使用快捷操作。 所有快捷操作应单独输入一行。 如果您在同一评论中多次使用相同的快捷操作，则只有最后一次应用。

您可以在右侧边栏中查看时间追踪的数据：

时间追踪在侧边栏中的展示

估算

估算用于显示完成某个项所需的总时间。

当您将鼠标悬停在右侧边栏中的时间追踪信息上时，可以看到剩余的估算时间。

剩余估算时间

添加估算

先决条件：

  • 在问题中，您必须至少具有项目的 Planner 角色。
  • 在任务中，您必须至少具有项目的 Planner 角色。
  • 在合并请求中，您必须至少具有项目的 Developer 角色。

要输入估算，请使用/estimate快捷操作，后跟时间。

例如，如果您需要输入1个月、2周、3天、4小时和5分钟的估算时间， 请输入/estimate 1mo 2w 3d 4h 5m。 检查可用时间单位。

每个项只能有一个估算值。 每次输入新的时间估算时，它将覆盖之前的值。

移除估算

先决条件：

  • 在问题中，您必须至少具有项目的 Planner 角色。
  • 在任务中，您必须至少具有项目的 Planner 角色。
  • 在合并请求中，您必须至少具有项目的 Developer 角色。

要完全移除估算，请使用/remove_estimate快捷操作。

已花费时间

在工作过程中，您可以记录已花费的时间。

每条新的时间记录会被添加到当前问题、任务或合并请求的总已花费时间中。

问题、任务或合并请求的总已花费时间不能超过一年。

添加已花费时间

先决条件：

  • 您必须至少具有项目的 Planner 角色。

使用用户界面

  • 在极狐GitLab 15.7中引入。
  • 在极狐GitLab 17.0中更改。如果没有指定时间，则默认使用当前时间。

使用用户界面添加时间记录：

  1. 在侧边栏的 时间追踪 部分，选择 添加时间记录 ( )。会弹出一个对话框。

  2. 输入：

    • 花费的时间。
    • 可选。花费的时间。若为空，则使用当前时间。
    • 可选。摘要。
  3. 选择 保存。

侧边栏中的 已花费 总时间会更新，您可以在时间追踪报告中查看所有记录。

使用快捷操作

要记录已花费的时间，请使用/spend快捷操作，后跟时间。

例如，如果您需要记录 1 个月、2 周、3 天、4 小时和 5 分钟，请输入 /spend 1mo 2w 3d 4h 5m。 请查看可用的时间单位。

要添加带备注的时间追踪报告条目，请创建一条带有描述和快捷操作的评论。 该条目将显示在时间追踪报告的 摘要/备注 列中。例如：

草拟 MR 并回复初步评论

/spend 30m

要记录时间的具体日期，请在时间后输入日期，使用 YYYY-MM-DD 格式。

例如，要记录 2021 年 1 月 31 日花费的 1 小时，请输入 /spend 1h 2021-01-31。

如果您输入未来日期，则不会记录时间。

减少已花费时间

先决条件：

  • 您必须至少具有项目的 Planner 角色。

要减少已花费时间，请输入负值。例如，/spend -3d 会从总已花费时间中移除三天。 您不能将已花费的时间减少到 0 以下，因此如果您移除的时间超过已有记录的时间，极狐GitLab会忽略该减少操作。

删除已花费时间

  • 在极狐GitLab 15.1中引入删除按钮。

时间记录是一个单一的已花费时间条目，可以是正数或负数。

先决条件：

  • 您必须是该时间记录的作者，或者具有至少 Maintainer 角色的权限。

要删除时间记录，请执行以下操作之一：

  • 在时间追踪报告中，在时间记录条目的右侧，选择删除已花费时间 ( )。
  • 使用GraphQL API。

删除所有已花费的时间

先决条件：

  • 您必须至少具有项目的 Planner 角色。

要一次性删除所有已花费的时间，请使用/remove_time_spent快捷操作。

查看项目的时间追踪报告

要查看项目的时间追踪报告：

  • 对于问题或合并请求：

    1. 转到一个问题或合并请求。
    2. 在右侧边栏中选择 时间追踪报告。

  • 对于史诗或任务：

    1. 转到一个史诗或任务。
    2. 在右侧边栏中选择 已花费 旁边的时间。

时间追踪报告

显示的已花费时间明细最多限制为 100 条条目。

全局时间追踪报告

  • 在极狐GitLab 15.11中通过一个名为global_time_tracking_report的功能标志，默认禁用。
  • 在极狐GitLab 16.5中在jihulab.com上启用。

功能标志： 在极狐GitLab子管理中，默认此功能不可用。管理员可以 启用该功能标志，名为 global_time_tracking_report。 在jihulab.com上，此功能可用。

查看跨GitLab所有问题、任务和合并请求的时间追踪报告。

要查看全局时间追踪报告：

  1. 在浏览器中，输入全局报告的 URL：
    • 对于自管理版本，在您的基础 URL 后添加 /-/timelogs。例如，https://gitlab.example.com/-/timelogs。
    • 对于极狐saas，请访问 https://jihulab.com/-/timelogs。
  2. 可选。要按特定用户进行过滤，请输入他们的用户名，不带 @ 符号。
  3. 选择开始和结束日期。
  4. 选择 运行报告。

全局时间追踪报告

可用时间单位

以下时间单位是可用的：

Time unit What to type Conversion rate
Month mo, month, or months 4 w (160 h)
Week w, week, or weeks 5 d (40 h)
Day d, day, or days 8 h
Hour h, hour, or hours 60 m
Minute m, minute, or minutes  

限制显示单位为小时 （FREE ALL）

在极狐GitLab自管理实例中，您可以将时间单位的显示限制为小时。操作步骤如下：

  1. 在左侧边栏中，选择 搜索或转到。
  2. 选择 设置 > 偏好设置。
  3. 展开 本地化。
  4. 在 时间跟踪 下，选中 将时间跟踪单位显示限制为小时 复选框。
  5. 选择 保存更改。

启用此选项后，75h将显示为1w 4d 3h。

相关主题