2017-08-17 22:00:37 +05:30
|
|
|
# Due dates
|
|
|
|
|
2020-03-13 15:44:24 +05:30
|
|
|
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/merge_requests/3614) in GitLab 8.7.
|
2017-08-17 22:00:37 +05:30
|
|
|
|
|
|
|
Please read through the [GitLab Issue Documentation](index.md) for an overview on GitLab Issues.
|
|
|
|
|
2019-09-30 21:07:59 +05:30
|
|
|
Due dates can be used in issues to keep track of deadlines and make sure features are
|
|
|
|
shipped on time. Users must have at least [Reporter permissions](../../permissions.md)
|
|
|
|
to be able to edit them, but they can be seen by everybody with permission to view
|
|
|
|
the issue.
|
2017-08-17 22:00:37 +05:30
|
|
|
|
|
|
|
## Setting a due date
|
|
|
|
|
2019-09-30 21:07:59 +05:30
|
|
|
When creating or editing an issue, you can click in the **due date** field and a calendar
|
|
|
|
will appear to help you choose the date you want. To remove the date, select the date
|
|
|
|
text and delete it. The date is related to the server's timezone, not the timezone of
|
|
|
|
the user setting the due date.
|
2017-08-17 22:00:37 +05:30
|
|
|
|
|
|
|
![Create a due date](img/due_dates_create.png)
|
|
|
|
|
2019-09-30 21:07:59 +05:30
|
|
|
You can also set a due date via the issue sidebar. Expand the
|
|
|
|
sidebar and click **Edit** to pick a due date or remove the existing one.
|
2017-08-17 22:00:37 +05:30
|
|
|
Changes are saved immediately.
|
|
|
|
|
|
|
|
![Edit a due date via the sidebar](img/due_dates_edit_sidebar.png)
|
|
|
|
|
2020-05-24 23:13:21 +05:30
|
|
|
The last way to set a due date is by using [quick actions](../quick_actions.md), directly in an issue's description or comment:
|
|
|
|
|
|
|
|
- `/due <date>`: set due date. Examples of valid `<date>` include `in 2 days`, `this Friday`, and `December 31st`.
|
|
|
|
- `/remove_due_date`: remove due date.
|
|
|
|
|
2017-08-17 22:00:37 +05:30
|
|
|
## Making use of due dates
|
|
|
|
|
2019-09-30 21:07:59 +05:30
|
|
|
Issues that have a due date can be easily seen in the issue tracker,
|
2017-08-17 22:00:37 +05:30
|
|
|
displaying a date next to them. Issues where the date is overdue will have
|
|
|
|
the icon and the date colored red. You can sort issues by those that are
|
2019-09-30 21:07:59 +05:30
|
|
|
`Due soon` or `Due later` from the dropdown menu on the right.
|
2017-08-17 22:00:37 +05:30
|
|
|
|
|
|
|
![Issues with due dates in the issues index page](img/due_dates_issues_index_page.png)
|
|
|
|
|
2019-12-26 22:10:19 +05:30
|
|
|
Due dates also appear in your [todos list](../../todos.md).
|
2017-08-17 22:00:37 +05:30
|
|
|
|
|
|
|
![Issues with due dates in the todos](img/due_dates_todos.png)
|
|
|
|
|
2018-10-15 14:42:47 +05:30
|
|
|
The day before an open issue is due, an email will be sent to all participants
|
2019-09-30 21:07:59 +05:30
|
|
|
of the issue. Like the due date, the "day before the due date" is determined by the
|
2018-10-15 14:42:47 +05:30
|
|
|
server's timezone.
|
|
|
|
|
2018-11-08 19:23:39 +05:30
|
|
|
Issues with due dates can also be exported as an iCalendar feed. The URL of the
|
|
|
|
feed can be added to calendar applications. The feed is accessible by clicking
|
2019-09-30 21:07:59 +05:30
|
|
|
on the **Subscribe to calendar** button on the following pages:
|
2019-07-07 11:18:12 +05:30
|
|
|
|
2019-09-30 21:07:59 +05:30
|
|
|
- on the **Assigned Issues** page that is linked on the right-hand side of the GitLab header
|
2018-11-08 19:23:39 +05:30
|
|
|
- on the **Project Issues** page
|
|
|
|
- on the **Group Issues** page
|