Calendars

Payroll Calendars

Was ist ein Payroll Calendar:

• Zyklus und Periodentyp
• Wochendefinition und Arbeitswoche
• Jahresbeginn

Calendar types

Der Payrollkalender interpretiert die Zeitdaten nach zwei Zeiteinheiten:

• Lohnzyklus in welchem die Löhne erfolgen, üblicherweise das Kalenderjahr (CycleTimeUnit)
• Lohnperiod in der Zeitraum der Lohnzahlung wie z.B. der Kalendermonat (PeriodTimeUnit)

Der Lohnzyklus ist immer ein Vielfaches der Lohnperiode

Die folgende Übersicht zeigt die möglichen Kombinationen beider Zeiteinheiten mit der Anzahl der Lohnzahlungen während eines Zyklus:

Pay Period	Week Cycle	Bi-Week Cycle	Semi-Month Cycle	Lunar-Month Cycle	Month Cycle	Bi-Month Cycle	Quarter Cycle	Semi-Year Cycle	Year Cycle
Week	1	2	-	4	-	-	13	26	52
Bi-Week	-	1	-	2	-	-	-	13	26
Semi-Month 3)	-	-	1	-	2	4	6	12	24
Lunar-Month	-	-	-	1	-	-	-	-	13
Month 1)	-	-	-	-	1	2	3	6	12 4)
Bi-Month 2)	-	-	-	-	-	1	-	3	6
Quarter 2)	-	-	-	-	-	-	1	2	4
Semi-Year 2)	-	-	-	-	-	-	-	1	2
Year 2)	-	-	-	-	-	-	-	-	1

¹⁾ Übersteuerung der effektiven Anzahl der Tage im Kalendermonat mit einem Durchschnittswert
²⁾ Fiskale Jahre mit dem Jahresstart an einem beliebigen Kalendermonat
³⁾ Monatsaufteilung: [1 ... 15] + [16 ... Tage im Monat]
⁴⁾ Default calendar

Für die Interpretation der Zeitdaten wird dem Kalender

• Zeitwert ist zyklisch (z.B. Jahreslohn) oder periodisch (z.B. Monatslohn)
• Werte auf Kalendertage oder Arbeitstage aufteilen (z.B. Montag bis Freitag)

---

Calendar example

Beispiel zweier Kalender:

1   "calendars": [
2     {
3       "name": "YearlySalary",
4       "cycleTimeUnit": "Year",
5       "periodTimeUnit": "CalendarMonth",
6       "valueType": "Cycle"
7     },
8     {
9       "name": "MonthlySalary",
10      "cycleTimeUnit": "Year",
11      "periodTimeUnit": "CalendarMonth",
12      "valueType": "Period"
13    },
14    {
15      "name": "QuarterSalary",
16      "cycleTimeUnit": "Year",
17      "periodTimeUnit": "Quarter",
18      "firstMonthOfYear": "April",
19      "valueType": "Cycle"
20    }
21  ]

Die Kalender im Detail:

• 3: Kalendername YearlySalary
• 4: Zyklus Zeittyp ist Year
• 5: Periodenzeittyp ist CalendarMonth
• 6: Daten gelten für das Jahr (Jahreslöhne)
• 9: Kalendername MonthlySalary
• 10: Zyklus Zeittyp ist Year
• 11: Periodenzeittyp ist CalendarMonth
• 12: Daten gelten für die Periode (Monatslöhne)
• 15: Kalendername QuarterSalary
• 16: Zyklus Zeittyp ist Year
• 17: Periodenzeittyp ist Quarter
• 18: Beginn des Jahres ist April
• 19: Daten gelten für das Quartal (Quartalslöhne)

---

Calendar objects

Der Kalender wird von folgenden Objekten bestimmt und kann auf verschiedenen Ebenen übersteuert werden. Im Lohnlauf besteht folgende Kalenderpriorität:

1. Wage Type
2. Empoloyee
3. Division
4. Tenant
5. Backend Server
6. System User

Die Backend-Server Culture wird in der Applikationskonfiguration app.config bestimmt.