{{< details >}}

  • Tier: 基础版, 专业版, 旗舰版
  • Offering: JihuLab.com, 私有化部署

{{< /details >}}

{{< history >}}

  • 对于人物的时间追踪引入于极狐GitLab 17.0。
  • 对史诗的时间追踪引入于极狐GitLab 17.5。必须启用史诗的新外观。
  • 在极狐GitLab 17.7 中，最小角色添加、编辑和删除估计更改为计划者。

{{< /history >}}

时间跟踪帮助记录和管理投入到极狐GitLab 工作项中的时间。时间跟踪：

  • 记录在议题、合并请求、史诗新外观 和任务上实际花费的时间。
  • 估计完成所需的总时间。
  • 提供详细的时间条目报告。
  • 使用标准化时间单位计算总数。
  • 通过快速操作和 UI 跟踪历史记录。

您可以在工作项的右侧边栏中查看时间跟踪信息：

Time tracking in the sidebar

根据您的角色，可以使用不同的时间跟踪功能：

  • 要添加、编辑和删除估计，您至少需要议题和任务的计划者角色，或者合并请求的开发者角色。
  • 要添加和编辑花费时间，您至少需要项目的计划者角色。
  • 要删除时间条目，您必须是作者或至少拥有 Maintainer 角色。

使用快速操作或用户界面输入和删除时间跟踪数据。快速操作需要单独输入在各行。如果您在单个评论中多次使用任何快速操作，则只有最后一次出现被应用。

估算

估算旨在显示完成项目所需的总时间。

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

Estimated time remaining

添加估算

先决条件：

  • 在议题中，您必须至少拥有项目的计划者角色。
  • 在任务中，您必须至少拥有项目的计划者角色。
  • 在合并请求中，您必须至少拥有项目的开发者角色。

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

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

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

删除估算

先决条件：

  • 在议题中，您必须至少拥有项目的计划者角色。
  • 在任务中，您必须至少拥有项目的计划者角色。
  • 在合并请求中，您必须至少拥有项目的开发者角色。

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

花费时间

在工作时，您可以记录花费的时间。

每个新的时间花费条目都会添加到议题、任务或合并请求的当前总花费时间中。

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

添加花费时间

先决条件：

  • 您必须至少拥有项目的计划者角色。

使用用户界面

{{< history >}}

  • 引入于极狐GitLab 15.7。
  • 在极狐GitLab 17.0 中，如果未指定花费时间的时间，则使用当前时间。

{{< /history >}}

要使用用户界面添加时间条目：

  1. 在侧边栏的 时间跟踪 部分，选择 添加时间条目 ({{< icon name=”plus” >}})。将打开一个对话框。

  2. 输入：

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

侧边栏中的 花费 总数将更新，您可以在时间跟踪报告中查看所有条目。

使用快速操作

要输入花费时间，请使用 /spend 快速操作，后跟时间。

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

要通过笔记添加时间跟踪报告条目，请创建带有描述和快速操作的评论。然后它会显示在时间跟踪报告的 摘要/笔记 列中。例如：

Draft MR and respond to initial comments

/spend 30m

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

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

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

减去花费时间

先决条件：

  • 您必须至少拥有项目的计划者角色。

要减去时间，请输入负值。例如，/spend -3d 从总花费时间中减去三天。您不能低于 0 分钟的花费时间，因此如果您删除的时间超过已输入的时间，极狐GitLab 会忽略减法。

删除花费时间

{{< history >}}

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

{{< /history >}}

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

先决条件：

  • 您必须是时间记录的作者或至少拥有项目的 Maintainer 角色。

要删除时间记录，可以：

  • 在时间跟踪报告中，在时间记录条目的右侧，选择 删除花费时间 ({{< icon name=”remove” >}})。
  • 使用 GraphQL API。

删除所有花费时间

先决条件：

  • 您必须至少拥有项目的计划者角色。

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

查看项目的时间跟踪报告

要查看项目上花费时间的时间跟踪报告：

  • 对于议题或合并请求：

    1. 转到议题或合并请求。
    2. 在右侧边栏，选择 时间跟踪报告。

  • 对于史诗或任务：

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

Time tracking report

显示的花费时间细分最多限于 100 个条目。

全局时间跟踪报告

{{< details >}}

  • Status: 实验

{{< /details >}}

{{< history >}}

  • 引入于极狐GitLab 15.11，使用名为 global_time_tracking_report 的功能标志。默认禁用。
  • 在极狐GitLab 16.5 中，在 JihuLab.com 上启用。

{{< /history >}}

{{< alert type=”flag” >}}

在极狐GitLab 私有化部署中，默认情况下此功能不可用。为了使其可用，管理员可以启用功能标志名为 global_time_tracking_report。在 JihuLab.com 上，此功能可用。在极狐GitLab Dedicated 上，此功能不可用。此功能尚未准备好用于生产环境。

{{< /alert >}}

查看在极狐GitLab 中跨所有议题、任务和合并请求花费时间的报告。

此功能是一个实验。

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

  1. 在您的浏览器中，输入全局报告的 URL：
    • 对于极狐GitLab 私有化部署，将 /-/timelogs 添加到您的基本 URL。例如，https://gitlab.example.com/-/timelogs。
    • 对于 JihuLab.com，转到 https://jihulab.com/-/timelogs。
  2. 可选。要按特定用户过滤，输入他们的用户名，不带 @ 符号。
  3. 选择开始和结束日期。
  4. 选择 运行报告。

global time tracking report

可用时间单位

以下时间单位可用：

时间单位 输入内容 转换率
月 mo、month 或 months 4 w (160 h)
周 w、week 或 weeks 5 d (40 h)
天 d、day 或 days 8 h
小时 h、hour 或 hours 60 m
分钟 m、minute 或 minutes  

限制显示单位为小时

{{< details >}}

  • Tier: 基础版, 专业版, 旗舰版
  • Offering: 私有化部署

{{< /details >}}

在极狐GitLab 私有化部署中，您可以将时间单位的显示限制为小时。要这样做：

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

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

相关主题