The Calendar field offers an intuitive and dynamic way to manage date-related information. Seamlessly integrating into your Jira environment, the Calendar field empowers teams to effortlessly track, visualize, and organize time-sensitive data. Whether you're monitoring project milestones, planning releases, or managing tasks with specific due dates, the Calendar field streamlines your workflow and enhances your project management capabilities.
The field gives you the opportunity to set dates manually or automatically based on existing fields/values.
Field Configuration
Before starting the field configuration, please follow the instructions for creating custom fields
Step 1: Set a name and description
Provide a good name for the new custom field. Make it descriptive, concise, and easy to understand for others who will use it. Avoid using ambiguous or overly technical terms.
Step 2: Configure your custom field
The field allows you to choose from a pre-defined set of field sizes and calendar styles
Step 3 (Optional): Dependent date
The value of the Calendar field can depend on other date fields, such as the due date, for example. If you wish to have such a dependency, you can configure it in the date field select.
This option does not work when used in Jira Service Management
Field view and edit
Related Use Cases
Jira Service Management (JSM)
Depending on the configuration the field will not work in JSM
The “dependent date” setting is not compatible
Before you can add a custom field for Jira Service Management (JSM) projects, you first need to setup the custom field
https://help-seibertmedia.atlassian.net/wiki/spaces/ACF/pages/11894823/Calendar#Field-Configuration
Then follow this guide to use the field in the request form or the portal view
JQL expression
${fieldName}.calendar: Date
Find further information here https://support.atlassian.com/jira-software-cloud/docs/find-specific-issues/
Example: a search for all issues with a calendar date on Christmas
"Calendar.Iso Datetime" = 2023-12-20T12:00:00Z
therefore, use the ISO-8601 date time format: YYYY-MM-DDTHH:MM:SS[.sss]Z
Data Structure (Automation)
To set the value via automation, you need the following object structure
Please note, that this will only work correctly, if you choose the manual date configuration.
{
"calendar": "YYYY-MM-DD"
}
Example date: 2023-12-24 (for the 24th of December 2023)