How to create a new public calendar with labels - Dataphin

Dataphin offers a tenant-level public calendar feature that supports custom calendars, custom date types (working days and holidays), and flexible calendar labels. This functionality enables the configuration of conditional scheduling parameters using the public calendar when setting up scheduling tasks, providing versatility in scheduling. Additionally, referencing the public calendar when creating tasks eliminates the need for redundant definitions, thereby reducing development and maintenance costs. This topic outlines the process for creating and managing public calendars.

Permission description

Only super administrators or system administrators have the authority to add, modify, or delete public calendars.

Public calendar page overview

Area	Description
①Public Calendar List	This area displays the public calendars that have been created. You can search for calendars by name or encoding. It supports editing and deleting calendars. The system checks for any dependencies, such as labels, calendars, and date types, before allowing deletion. Dependencies must be removed before deleting a public calendar.
②Operation Area	Built-in function description: The public calendar includes built-in functions for related calculations, enhancing development efficiency. For a list of supported functions, see Public calendar built-in functions. Create a new public calendar: Use the created public calendar in offline tasks, label conditions, and other calculation scenarios. For instructions on creating a public calendar, see Create a public calendar. Today: Click Today to quickly navigate to the current day on the calendar. Page turning: Navigate through the calendar pages using the and icons. Label search: Search for labels by entering label keywords. View calendar references: View the labels, date types, and calendars that reference the current calendar. This includes label names/encodings, date ranges, reference counts, and supports detail viewing, editing, and deleting operations. Search for labels by name or encoding. Reference Labels: This includes the label's name/encoding, date range, and reference count, with functionality for detailed viewing, editing, and deletion. Labels can be searched for by their name or encoding. Date Types: This encompasses the associated project/section, object name, object type, reference type, and reference time, with options for detailed viewing, editing, and deletion. Calendars: This includes the associated project/section, object name, object type, and reference time, with features for detailed viewing, editing, and deletion. Create a new label: Create labels for the current calendar, used in offline tasks, label condition calculations, and other scenarios. For instructions on creating a label, see Create a new label.
③Calendar	The calendar displays information for each day, including the type (working day, holiday), and label name.

Create a public calendar

Navigate to the Dataphin home page and select Planning followed by Common Business Logic.
Proceed to the Create A New Public Calendar dialog box by following these steps:
Select Public calendar and then + Create A New Public Calendar.

In the Create A New Public Calendar dialog box, fill in the calendar information as follows:

Parameter	Description
Calendar name	Input the name of the calendar, adhering to the following naming convention: Accepts Chinese characters, English letters, numbers, underscores (_), and hyphens (-). Must not exceed 32 characters in length.
Encoding	Specify a unique identifier for the public calendar, used when referencing tasks. Only letters, numbers, and underscores (_) are permitted. The encoding must not exceed 32 characters.
Calendar template	Initialize the calendar using a selected template. Default templates include *4 13, 5-4-4, 4-5-4, and 4-4-5 fiscal calendars. Select one that suits your business requirements or Customize your fiscal calendar as needed. The 4 * 13 Fiscal Calendar divides a year into 13 months, each with 4 weeks. An extra week is added to the last month every 6 years. The 5-4-4 Fiscal Calendar has 13 weeks per quarter, with months following a 5-4-4 week distribution. An extra week is added to the last month every 6 years. The 4-5-4 Fiscal Calendar has 13 weeks per quarter, with months following a 4-5-4 week distribution. An extra week is added to the last month every 6 years. The 4-4-5 Fiscal Calendar has 13 weeks per quarter, with months following a 4-4-5 week distribution. An extra week is added to the last month every 6 years. Custom fiscal calendar: Customize the week start day and fiscal benchmark day to suit your needs. Important** Note that editing the calendar to change template settings will invalidate all prior adjustments.
Week start day	Designate the first day of the week.
Fiscal benchmark day	Set the last day of the fiscal year.
Overflow week attribution	For non-custom built-in fiscal calendars, configure which month of the 6th year will include the extra week that occurs every 6 years.
Calendar title format	Choose a title format for each month of the calendar. The following six formats are available: Format FY{YYYY} M{n} displays the 8th month of the 2024 fiscal year as FY2024 M8. Format FY{YYYY} Q{n} M{n} displays the 2nd month of the 3rd quarter of the 2024 fiscal year as FY2024 Q3 M2. Format FY{YY} Q{n} M{n} displays the 2nd month of the 3rd quarterof the 2024 fiscal year as FY24 Q3 M2. Format FY{YY} M{n} displays the 8th month of the 2024 fiscal year as FY24 M8. Format {YYYY} Fiscal Year Q{n} Fiscal Month displays the 2nd month of the 3rd quarter of the 2024 fiscal year as 2024 Fiscal Year Q3 Fiscal Month. Format {YYYY} Fiscal Year Fiscal Month {n} displays the 8th month of the 2024 fiscal year as 2024 Fiscal Year Fiscal Month 8.

Click OK to finalize the creation of the public calendar.

What to do next

Once the public calendar is created, you can add labels as needed for your business processes. For guidance on adding labels, refer to Create a new label.