Create a business calendar

  • Release version: Washingtondc
  • Updated February 1, 2024
  • 4 minutes to read

    • Create a definition record for an individual parent or child business calendar. You create this record so that you can easily identify a specific business calendar when you use it in a ServiceNow AI Platform package or functional area. A business calendar can represent any length of time, such as a week, a month, a year, or a fiscal period.

    Before you begin

    Role required: admin

    About this task

    When you create a business calendar, you specify a reference name, labeling, parent business calendar, if any, and a time zone for it.
    1. You first create a business calendar record and then create business calendar entries for it in the Business Calendar Entries related list. To learn more about how business calendar entries work, see Define business calendar entries and Create business calendar entry names.
    2. Using the Business Calendar Filter Options related list, you can also define the date and time filtering options for the business calendar that you are creating.
    Note:
    Fiscal calendars or schedules you may have created in the Fiscal Calendar or System Scheduler > Schedules menu also appear on the lists on the Business Calendar menu. If you select a fiscal calendar or schedule, it appears in the legacy function that you originally used to create it. You can't view or update legacy fiscal calendars or schedules using this form.

    Procedure

    1. Navigate to All > Business Calendar > Business Calendars.
    2. Click New.
    3. On the form, fill in the fields.
      Table 1. Business calendar form
      Field Description
      Name Unique reference name and identifier for the business calendar record. The name should be unique per domain.
      Label Unique singular label for identifying the business calendar when you perform filtering. For example, you can assign a week-long work calendar with a label of Workweek.
      Plural Labels Unique plural label for identifying the business calendar. For example, you can assign a week-long work calendar with a label of Workweeks. Use plural labels when you do filtering that is based on more than one unit in the past or future. For example, Last 2 Fiscal Quarters.
      Parent Parent business calendar to the current business calendar that you are creating. To search for an existing business calendar, click Search button
      • For example, you created a business calendar for 2020, and an individual child calendar for each month within the year, each with its own business calendar entries. As you create a business calendar for each month, you would select 2020 as the parent calendar for each.
      • These entries create the relationship between a parent and its child business calendars. Leave this field blank if you are creating a parent business calendar itself.
      Application Application that is associated with this business calendar. If you are working on an application or are creating a business calendar from an application record, the field defaults to that application. Otherwise, the field defaults to Global. Any records that are created from the table record, such as modules and security rules, are assigned to this application by default. To learn more about application scoping, see Application scope
      Time zone
      Time zone to use for the business calendar when you specify the starting and ending times for each associated business calendar entry. Select a time zone entry:
      • -None-: Use the time zone specified in the logged in user's profile.
      • Use System Time Zone: Use the default system time zone specified for the instance.
      • – Floating --: Time zone is relative to whatever is accessing the business calendar entry at any given time. For example, if an administrator in Amsterdam creates a floating business calendar for 08:00 a.m. to 5:00 p.m., a person in San Jose, California, sees it as 08:00 a.m. to 5:00 p.m. When you define a business calendar in a specific time zone, users in different time zones see the business calendar in their own time zone.
      • Actual time zone. For example, Europe/London, US/Pacific, US/Central.
      Description Description of the business calendar.
    4. Click Submit.
    5. In the Business Calendars list, select the business calendar that you created.
    6. In the Business Calendar Entries related list, create entries that define each span of time within the business calendar.
      Create at least one business calendar entry for the selected calendar.
      Note:
      To learn more about creating business calendar entries, see Define business calendar entries and Creating business calendars.
    7. In the Business Calendar Filter Options related list, click New to create filtering options for the business calendar.
      You can define the date and time filtering options for the business calendar that you are creating. These filtering options are in addition to the standard date and time filtering in the ServiceNow AI Platform.
      Note:
      To learn more about creating business calendar filtering options, see Define business calendar filtering options.
    8. Click Submit.

    Result

    A business calendar record is saved in the Business Calendar [business_calendar] table.
    • If you create business calendar entries in the Business Calendar Entries related list, records are created in the Business Calendar Entry (business_calendar_span) table. The records are associated with the business calendar.
    • If you created business calendar filter options in the Business Calendar Filter Options related list, a record is saved in the Business Calendar Filter Option (business_calendar_filter_option) table. The record is associated with the business calendar.