YEAR_START_DATE

Description:

This parameter defines the start date of the year, which is used to calculate the totals on the balance information card on the Time Off Calendar. The date must be in the MMDD format.

By default, the balance totals are displayed as of the current calendar year, starting on January 1. For customers that follow a different fiscal year than January 1-December 31, you can configure this parameter to define an alternative year start date. When an alternative year start date has been defined, the balance totals are determined based on the current day's relationship to the specified start date.

For example, if your fiscal year starts on April 1, set this parameter to 0401. If you then hover over your vacation balance on June 2, the totals are calculated as follows:

  • The accrued value displays the sum total of any vacation-related accruals in the balance log dated between April 1 and June 2 (today) of the current year.
  • The used value displays the sum total of any vacation-related decrements in the balance log dated between April 1 and June 2 of the current year.
  • The current value displays your current balance as of June 2.
  • The future approved value displays the sum total of any vacation-related accruals in the balance log dated between June 3 of the current year and March 31 of the following year.
Note: If 0229 is specified as the start date, then special rules apply. If the start date is in a leap year, then the balance period starts on February 29 and ends on February 27 of the following year. If the start date is in a non-leap year, then the balance period starts on March 1 and ends on February 28 of the following year.

When defining the start date of the fiscal year, you can also specify whether the fiscal year starts before or after the calendar year. This rollover instruction determines the current year that is displayed on the balance information card.

Specify one of these keywords for the rollover instruction:

  • BEFORE: New fiscal year starts before the new calendar year.

    For example, if FY 2018 runs from July 1, 2017 to June 30, 2018, specify 0701,BEFORE. If you hover over your vacation balance on June 30, 2017, then 2017 is displayed as the current year. If you hover over your vacation balance on July 1, 2017, then 2018 is displayed as the current year.

  • AFTER: New fiscal year starts after the new calendar year. This is the default.

    For example, if FY 2017 runs from March 1, 2017 to February 28, 2018, specify 0301,AFTER. If you hover your vacation balance on February 28, 2017, then 2016 is displayed as the current year. If you hover over your vacation balance on March 1, 2017, then 2017 is displayed as the current year.

Valid Values:

Any valid date in the MMDD format. Optionally, the date can be followed by a comma (,) and then the rollover instruction, BEFORE or AFTER.

Default Value:

0101

Location:

system/modules/timeOffPlanner/

Effective:

6.2.2