gitlab-org--gitlab-foss/doc/user/project/issues/due_dates.md

57 lines
2.4 KiB
Markdown
Raw Normal View History

---
stage: Plan
group: Project Management
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments
---
# Due dates **(FREE)**
2017-01-24 08:59:37 -05:00
Due dates can be used in [issues](index.md) to keep track of deadlines and make sure features are
shipped on time. Users need at least [Reporter permissions](../../permissions.md)
to be able to edit the due date. All users with permission to view
the issue can view the due date.
2017-01-24 08:59:37 -05:00
## Setting a due date
When creating an issue, select the **Due date** field to make a calendar
appear for choosing the date. 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-01-24 08:59:37 -05:00
![Create a due date](img/due_dates_create.png)
You can also set a due date by using the issue sidebar. Expand the
sidebar and select **Edit** to pick a due date or remove the existing one.
2017-01-24 08:59:37 -05:00
Changes are saved immediately.
![Edit a due date with the sidebar](img/due_dates_edit_sidebar.png)
2017-01-24 08:59:37 -05:00
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-01-24 08:59:37 -05:00
## Making use of due dates
You can see issues with their due dates in the issues list.
Overdue issues have their icon and date colored red.
To sort issues by their due dates, select **Due date** from the dropdown menu on the right.
Issues are then sorted from the earliest due date to the latest.
To display issues with the latest due dates at the top, select **Sort direction** (**{sort-lowest}**).
2017-01-24 08:59:37 -05:00
Due dates also appear in your [to-do list](../../todos.md).
2017-01-24 08:59:37 -05:00
![Issues with due dates in the to dos](img/due_dates_todos.png)
2017-01-24 08:59:37 -05:00
The day before an open issue is due, an email is sent to all participants
of the issue. Like the due date, the "day before the due date" is determined by the
server's timezone.
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 selecting
the **Subscribe to calendar** button on the following pages:
- The **Assigned Issues** page linked on the right side of the GitLab header
- The **Project Issues** page
- The **Group Issues** page