Time Calculation Rule Fast Formula Reference Guide
Time Calculation Rule Fast Formula Reference Guide
Calculation
Rule Fast
Formula
Reference
Guide
Oracle Fusion Time and Labor
This document is for informational purposes only and is intended solely to assist you in planning for
the implementation and upgrade of the product features described. It isn’t a commitment to deliver
any material, code, or functionality, and shouldn’t be relied upon in making purchasing decisions.
The development, release, and timing of any features or functionality described in this document
remains at the sole discretion of Oracle.
Due to the nature of the product architecture, it may not be possible to safely include all features
described in this document without risking significant destabilization of the code.
Disclaimer .................................................................................................... 2
Introduction .................................................................................................. 8
Formula Name:
ORA_WFM_TCR_ACCESS_ATTESTATION_ANSWERS_AP ................... 9
Description................................................................................................................................... 9
Parameters .................................................................................................................................. 9
Outputs ........................................................................................................................................ 9
Function ....................................................................................................................................... 9
Example .....................................................................................................................................10
Description..................................................................................................................................11
Parameters .................................................................................................................................11
Outputs .......................................................................................................................................11
Formula Name:
ORA_WFM_TCR_FOR_ENTRIES_THAT_SPAN_DAYS_AP (deprecated)27
Parameters .................................................................................................................................27
Outputs .......................................................................................................................................27
Function ......................................................................................................................................28
Examples ....................................................................................................................................28
Formula Name:
ORA_WFM_TCR_OT_EARNED_DAYS_FOR_ENTRIES_THAT_SPAN_D
AYS ........................................................................................................... 31
Description..................................................................................................................................31
Parameters .................................................................................................................................31
Outputs .......................................................................................................................................32
Function ......................................................................................................................................32
Description..................................................................................................................................33
Parameters .................................................................................................................................33
Outputs .......................................................................................................................................33
Function ......................................................................................................................................33
Example .....................................................................................................................................34
Description..................................................................................................................................35
Parameters .................................................................................................................................35
Function ......................................................................................................................................35
Example .....................................................................................................................................36
Description..................................................................................................................................37
Parameters .................................................................................................................................37
Outputs .......................................................................................................................................38
Function ......................................................................................................................................38
Formula Name:
WFM_TCR_INSUFFICIENT_REST_PERIOD_PREMIUM_AP ................. 41
Description..................................................................................................................................41
Parameters .................................................................................................................................41
Outputs .......................................................................................................................................41
Examples ....................................................................................................................................42
Description..................................................................................................................................43
Parameters .................................................................................................................................43
Outputs .......................................................................................................................................43
Examples ....................................................................................................................................44
Description..................................................................................................................................45
Parameters .................................................................................................................................45
Outputs .......................................................................................................................................45
Function ......................................................................................................................................45
Example .....................................................................................................................................46
Description..................................................................................................................................47
Parameters .................................................................................................................................47
Outputs .......................................................................................................................................47
Function ......................................................................................................................................47
Examples ....................................................................................................................................48
Description..................................................................................................................................54
Parameters .................................................................................................................................54
Outputs .......................................................................................................................................54
Function ......................................................................................................................................54
Examples ....................................................................................................................................55
Description..................................................................................................................................58
Parameters .................................................................................................................................58
Outputs .......................................................................................................................................58
Function ......................................................................................................................................58
Examples ....................................................................................................................................59
Formula Name:
WFM_THRESHOLD_W_ABS_TIME_CALCULATION_RULE_AP ............ 62
Description..................................................................................................................................62
Parameters .................................................................................................................................62
Outputs .......................................................................................................................................62
Function ......................................................................................................................................62
Examples ....................................................................................................................................63
Description..................................................................................................................................64
Parameters .................................................................................................................................64
Outputs .......................................................................................................................................64
Function ......................................................................................................................................64
Examples ....................................................................................................................................65
Oracle Fusion Fast Formula Cloud Services is an easy way to configure the existing
functionality in Oracle Fusion Time and Labor Cloud Services. Formulas are pieces of code that
can receive information from calling program (packages), access database information, and
return values to the calling program. The calling program can use this information to modify the
process functionality. The formula language hides the complexity of accessing the tables and
columns.
A formula can return more than one value to the calling program. Different programs that call
the formula expect outputs to return differently. The formula type determines the number and
data type of the values to return.
• Some programs expect the defined names for outputs. In this case, if the formula doesn't use
these expected names, the process errors out at run time. The location of an expected name
in the return statement doesn’t matter.
• Some programs expect the output to return by location. In this case, if the formula doesn't find
the output in the expected location, the process errors out at run time. The name of the output
doesn’t matter.
Time calculation rule formulas create or update time card entries and use the data to create
calculated results based on formula logic. For example, you can handle overtime or premium
pay by updating reported time or creating additional calculated time.
Description
This fast formula checks the specified attestation to see if the person submitted an answer that requires the formula to generate
an additional time entry. For example, generate a penalty when the person didn’t take a meal break for business reasons. This
formula uses an array to process time card data. It isn't associated with any delivered time calculation rule templates.
Parameters
ANSWER_CODE Fixed number Code of the answer that the worker submitted in the attestation.
GENERATED_QUANTITY Fixed number Quantity of the time entry that the formula generates.
Outputs
GRP2_QUANTITY 2 Measure Quantity, in hours or units, of the time entry that the
formula generates according to the answer code.
Function
If the question code is equal to the specified value of the Question code parameter and the answer code is equal to the specified
value of the Answer code parameter, then generate a time entry with the specified quantity.
DAY WEB CLOCK TIME ENTRY ELAPSED DURATION MEAL ATTESTATION GENERATED
EVENTS BETWEEN IN AND OUT BREAK TIME ENTRY
1 In: 8:02a 8:02a – 1:01p 4h 59m 0 None because the elapsed None
Out: 1:01p duration is less than 5h.
2 In: 8:03a 8:03a – 1:58p 5h 55m 0 A question about the meal 1 penalty
Out: 1:58p break appears because the
elapsed duration is more than The payroll
5h. The person answers that time type is
they didn't take their meal measure in
break for business reasons. Units.
4 In: 8:03a 8:03a – 1:58p 8:03a – 1:58p 0 A question about the meal None
Out: 1:58p break appears because the
elapsed duration is more than
5h. The person answers that
they did take their meal break.
They need to report it or ask
their manager to do so.
5 In: 7:58a 7:58a – 1:58p 6h 00m 0 A question about the meal None
Out: 1:58p break appears because the
elapsed duration is more than
5h. The person answers that
they didn't take their meal
break for personal reasons.
Description
This fast formula is associated with the delivered rule template Time Allocation Template. If the person has a time allocation
assigned by the Manage Allocation Assignments task, then the formula uses this allocation. Otherwise, it uses the allocation
selected in the rule configuration. In both cases, the allocation formula uses either reported or calculated time, depending on the
processing sequence of the allocation rule in the rule set. The formula allocates the time identified by the source time category
across the output time attributes. This formula uses an array to process time data.
If you want the review page of the time card to show the cost segment outputs configured in the time allocation, complete these
tasks:
1. Configure the time review layouts for workers and managers accordingly.
2. Associate the appropriate layout set with the worker time entry profiles.
Parameters
ASSIGN_FRACTION_TO_LAST_ROW Yes or No Indicates whether to adjust the last row of the time allocation
output so that total allocated hours match the number of hours
identified by the allocation rule. The time allocations that use
this parameter have either the type Percent or Equally.
Outputs
This formula has no output variables. It uses the outputs configured for the time allocation assigned to the person when the rule
runs.
Example 1: The reported time doesn't include any conflicts with the person's assigned allocation.
Daily totals
Regular 8h
Regular | Cardiac Care 4h
Regular | Intensive Care 4h
Weekly Totals
Regular 40h
Regular | Cardiac Care 20h
Regular | Intensive Care 20h
40h
Daily Total: 8h 8h
Regular Emergency 1p – 5p 4h
Daily Total: 8h 8h
Daily Total: 8h 8h
Daily Total: 8h 8h
Daily Total: 4h 4h
Daily Total: 4h 4h
Weekly Totals
Regular 22h
Regular | Cardiac Care 11h
Regular | Intensive Care 11h
On-Call | Intensive Care 2h 2h
Regular | Emergency 16h 16h
40h 40h
Example 1: The time card period total equals the defined allocation quantity.
Daily Total: 8h 8h
Daily Total: 8h 8h
Daily Total: 8h 8h
Daily Total: 8h 8h
Daily Total: 8h 8h
Weekly Totals
Regular 40h
Regular | Cardiac Care 20h
Regular | Intensive Care 20h
40h
Daily Total: 4h 4h
Daily Total: 8h 8h
Daily Total: 8h 8h
Daily Total: 8h 8h
Daily Total: 4h 4h
Weekly Totals
Regular 32h
Regular | Cardiac Care 20h
Regular | Intensive Care 12h
32h
Daily Total: 8h 8h
Daily Total: 8h 8h
Daily Total: 8h 8h
Daily Total: 8h 8h
Sat Regular 8a – 4p 8h
Daily Total: 8h 8h
Weekly Totals
Regular 50h 10h
Regular | Cardiac Care 20h
Regular | Intensive Care 20h
50h
Time Card Total Is More Than Allocation Quantity, Conflicts Between Reported Time and Assigned Allocation
Daily Total: 8h 8h
Regular Emergency 1p – 5p 4h
Daily Total: 8h 8h
Daily Total: 8h 8h
Daily Total: 8h 8h
Daily Total: 8h 8h
Daily Total: 4h 4h
Daily Total: 4h 4h
Weekly Totals
Regular 26h
Regular | Cardiac Care 20h
Regular | Intensive Care 6h
On-Call | Intensive Care 6h 6h
Regular | Emergency 16h 16h
48h 48h
5 20 Cardiac Care
10 20 Intensive Care
15 Balance Operation
Daily Total: 8h 8h
Regular Emergency 1p – 5p 4h
Daily Total: 8h 8h
Regular Emergency 8a – 4p 8h
Daily Total: 4h 4h
Daily Total: 4h 8h
Daily Total: 8h 8h
Example 1: The reported time doesn't include any conflicts with the person's assigned allocation.
Daily Totals
Regular 8h
Regular Cardiac Care 2.66h
Regular Intensive Care 2.66h
Regular Emergency 2.66h
Weekly Totals
Regular 40h
Regular Cardiac Care 13.3h
Regular Intensive Care 13.3h
Regular Emergency 13.3h
39.9h
Daily Total: 8h 8h
Regular Emergency 1p – 5p 4h
Daily Total: 8h 8h
Daily Total: 4h 8h
Weekly Totals
Regular 22h
Regular | Cardiac Care 7.32h
Regular | Intensive Care 7.32h
Regular | Emergency 12h 19.32h
On-Call | Intensive Care 6h 6.00h
40h 39.96h
Example 1: The reported time doesn't include any conflicts with the person's assigned allocation.
Daily Total: 8h 8h
Daily Total: 8h 8h
Daily Total: 9h 9h
Weekly Totals
Regular 43.5h
Regular | Cardiac Care 20.00h
Regular | Intensive Care 20.00h
Overtime | Cardiac Care 1.75h
Overtime | Intensive Care 1.75h
43.5h
Regular Emergency 1p – 4p 3h
Overtime Emergency 1h
Daily Total: 9h 9h
Daily Total: 9h 9h
Daily Total: 9h 9h
Weekly Totals
Regular 23.0h
Regular | Cardiac Care 10.5h
Regular | Intensive Care 10.5h
Regular | Emergency 12.0h 11.0h
On-Call | Intensive Care 10.5h 8.0h
Overtime | Emergency 1.0h
Overtime | Cardiac Care 1.0h
Overtime | Intensive Care __ 3.5h
45.5h 45.5h
Example: The reported time includes conflicts with the person's assigned allocation. The time card period total is more than the
defined allocation quantity.
Conflicts Between Reported Time and Assigned Allocation, Time Card Total Is More Than Allocated Quantity
Regular Emergency 4p – 6p 2h
Overtime Emergency 2h
Regular Emergency 1p – 5p 4h 4h
Daily Total: 8h 8h 8h
Regular Emergency 4p – 6p 2h
Overtime Emergency 2h
Daily Total: 8h 8h 8h
Daily Total: 8h 8h 8h
Daily Total: 4h 4h 4h
Daily Total: 4h 4h 4h
Weekly Total
Regular 23h
Regular | Cardiac Care 20h 20h
Regular | Intensive Care 3h 3h
Regular | Emergency 20h 20h 16h
On-Call | Intensive Care 9h 9h 9h
Overtime | Emergency __ __ 4h
52h 52h 52h
Allocation configuration: This allocation example distributes reported and calculated time as shown here:
5 20 Cardiac Care
10 20 Intensive Care
15 Balance Operation
Conflicts Between Reported Time and Assigned Allocation, Time Card Total Is Greater Than Allocated Quantity
Daily Total: 9h 9h 9h
Daily Total: 8h 8h 8h
On-Call Emergency 4p – 6p 2h
Overtime Emergency 2h
Overtime Operation 1h
Daily Total: 9h 9h 9h
Daily Total: 4h 4h 4h
Daily Total: 8h 8h 8h
Description
This fast formula is associated with the delivered rule template Time Entries That Span Days AP. It determines whether time
entries span days. If they do, the formula determines on what day to calculate time for those day-spanning entries. By default, the
formula uses rule parameter values. When the rule doesn't pass any values, the formula uses the values of the person's work day
definition. This formula uses an array to process time card data.
Parameters
RESOLVE_SPAN_RULE Fixed text Rule to use to determine on what day to calculate time for reported
time entries that span days. Valid values are:
START_DAY: Time calculation rules should treat time entries as
being entirely on the start day.
STOP_DAY: Time calculation rules should treat time entries as
being entirely on the stop day.
DAY_WITH_MOST_TIME: Time calculation rules should treat
time entries as being entirely on the day with the longest time
duration.
SPLIT_AT_DAY_START: Time calculation rules should split time
entries at the time where one day ends and the other starts.
SCHEDULE_REF_DAY: Time calculation rules treat all time
entries as being on the reference day of the scheduled shift
DAY_START_TIME Time HH:MM Time, in hours and minutes, that marks the start of the day
GROUPING_THRESHOLD Fixed number Threshold, in minutes, used to group reported time entries on one or
another of the multiple days.
ORA_HWM_FF_DAY_SPLIT_FLAG Exclude Internal indicator to split the day. Doesn’t show on the rule pages.
Outputs
This formula has no output variables. It uses the outputs configured for the time allocation assigned to the worker when the rule
runs.
Examples
Scenario: The work day starts at 4:00a.
6 Regular 12a – 8a
6 Regular 12a – 8a
Example 4: The spanning days rule is day with most time and the tie-handling rule is stop day.
Example 6: The spanning days rule is the reference day of the scheduled shift.
Reference Day 2 3 4 5 6
1 Regular 11p – 7a
Description
This fast formula is associated with the delivered rule template Time Entries That Span Overtime and Earned Days AP. It
determines whether time entries span days. If they do, the formula determines these days:
The day to use in calculations that include reported time entries that span days
The earned day for reported time entries that span days
By default, the formula uses rule parameter values. When the rule doesn't pass any values, the formula uses the values of the
person's work day definition. This formula uses an array to process time card data.
Parameters
OVERTIME_DAY_START_TIME Time HH:MM Time, in hours and minutes, that marks the start of the day to use in
time calculation rules that calculate overtime.
EARNED_RESOLVE_SPAN_RULE Fixed text Rule to use to determine the earned day for reported time entries
that span days. Valid values are:
START_DAY: Time calculation rules should treat time entries as
being entirely on the start day.
STOP_DAY: Time calculation rules should treat time entries as
being entirely on the stop day.
DAY_WITH_MOST_TIME: Time calculation rules should treat
time entries as being entirely on the day with the longest time
duration.
SPLIT_AT_DAY_START: Time calculation rules should split time
entries at the time where one day ends and the other starts.
SCHEDULE_REF_DAY: Time calculation rules treat all time
entries as being on the reference day of the scheduled shift
EARNED_GROUPING_THRESHOLD Fixed number Threshold, in minutes, used to group reported time entries on one or
another of the multiple days.
ORA_HWM_FF_DAY_BREAKER_FLAG Exclude Internal indicator to split the day. Doesn’t show on the rule pages.
Function
The function specifies to resolve time entries that span days using the rule {EARNED_RESOLVE_SPAN_RULE} for earned day.
It automatically uses the rule SPLIT_AT_DAY_START for overtime. When determining the earned day, when the time entries
span days equally, use {EARNED_HANDLING_TIES}. For this rule, the day start time is midnight and the threshold for grouping
time entries on one day or the other is {EARNED_GROUPING_THRESHOLD} minutes. When determining the overtime day, the
day start time is {OVERTIME_DAY_START_TIME}.
Description
This fast formula determines unit quantities for reported time based on specific time attributes. It generates a unit time attribute for
the day, if the reported time category hours on that day include the specified time attributes. This formula uses an array to
process time card data. It isn't associated with any delivered time calculation rule templates.
Parameters
WORKED_TIME_CONDITION Time category Time category of reported hours that include the specified
time attributes used to determine whether to generate a units
time attribute.
NUMBER_OF_UNITS Fixed number Numeric value for the number of units with UN unit of
measure to allocate for each detail found.
Outputs
Note that for start and stop times, the formula resets the rate amount and periodicity values in the generated units time entry to
empty values.
Function
For each detail time card record found, depending on the time category, add the number of units specified in
NUMBER_OF_UNITS to the time card. The unit amount is 'UN' (Units).
1 -- 4 Regular 8a – 12p 4h
1p – 4p 3h
Meal 12p – 1p 1h
5 Regular 8a – 12p 4
Description
This fast formula determines unit quantities for reported time that spans a specific time range. It generates a unit time attribute for
the day, if the reported time category hours span the specified range. This formula uses an array to process time card data. It isn't
associated with any delivered time calculation rule templates.
Parameters
WORKED_TIME_CONDITION Time category Time category of reported hours that include the
specified time attributes used to determine whether to
generate a units time attribute.
NUMBER_OF_UNITS Fixed number Numeric value for the number of units with UN unit of
measure to allocate for each detail found.
Both start and stop time parameters must have a value in every rule associated with this formula. These parameters indicate to
generate the specified unit of measure, if reported time during that range included time entries identified by the specified time
category.
Outputs
Function
For each detail time card record found, depending on the time category, if the time card start time is between
START_TIME_HHMM24 and STOP_TIME_HHMM24, add the number of units specified in NUMBER_OF_UNITS to the time
card. The unit amount is 'UN' (Units).
1 Regular 10a – 5p 8h
2 Regular 8p –11p 3h
3 Regular 10a – 5p 8h
4 Regular 8p – 11p 8h
5 Regular 10a – 5p 8h
Description
This fast formula determines unit quantity for reported weekend time. It generates a unit time attribute for the day if the reported
time category hours occur on a weekend day. This formula uses an array to process time card data. It isn't associated with any
delivered time calculation rule templates.
Parameters
WORKED_TIME_CONDITION Time category Time category of reported hours that include the
specified time attributes used to determine whether
to generate a units time attribute.
NUMBER_OF_UNITS Fixed number Numeric value for the number of units with UN unit
of measure to allocate for each detail found.
Function
For each detail time card record found, depending on the time category, if the function finds any time entry for days specified as
weekend day (IS_MON_WEEKEND…), select WORK_ANY_WEEKEND_DAY.
Yes Add the number of units specified in NUMBER_OF_UNITS to the time card
with a unit amount of UN (Units). It doesn't matter if the person worked only
one or every day defined as a weekend day.
Wed Regular 8h 8h
Thu Regular 8h 8h
Fri Regular 8h 8h
Sat Regular 2h 2h
Sun Regular 9h 9h
Wed Regular 8h 8h
Thu Regular 8h 8h
Fri Regular 8h 8h
Sat Regular 2h 2h
Wed Regular 8h 8h
Thu Regular 8h 8h
Fri Regular 8h 8h
Sun Regular 9h 9h
Examples of WORK_ANY_WEEKEND_DAY is No
For these examples, the weekend days are Saturday and Sunday.
Example 1: WORK_ANY_WEEKEND_DAY Is No
Wed Regular 8h 8h
Thu Regular 8h 8h
Fri Regular 8h 8h
Sat Regular 2h 2h
Wed Regular 8h 8h
Thu Regular 8h 8h
Fri Regular 8h 8h
Sun Regular 9h 9h
Description
This fast formula is associated with the delivered rule template Insufficient Rest Premium Template. It compares the end and start
times of consecutive reported time entries identified by the time category of the rest period. If the interim time is less than the
defined rest period, it generates an additional, premium time entry. The premium entry is for either all of the reported hours for the
second shift or only the reported hours until the rest period is met. This formula uses an array processing formula.
Parameters
WORKED_TIME_CONDITION Time category Time category that identifies the time entries
to use to determine whether the minimum
rest period was met for the two shifts
Outputs
Premium 6h
Example 2: You pay a premium for only the time worked in the second shift until the rest period is met.
Premium 2h
Description
This fast formula is associated with the delivered rule template Shift Premium Template. It compares the total hours identified by
the time category for the day or period with the threshold value. It converts hours over the threshold to a single payroll time type. It
leaves hours under the threshold as the same payroll time type or converts them to a new, single payroll time type.
Parameters
PREM_START_TIME Time HH:MM Start time of the premium shift in a 24-hour format,
such as 18:00 instead of 6:00p
PREM_STOP_TIME Time HH:MM End time of the premium shift in a 24-hour format,
such as 23:30 instead of 11:30p
WORKED_TIME_CONDITION Time category Time category that identifies the time entries to use
to determine the hours that qualify for premium pay
Outputs
Function
Compares the start and end time for the detailed entries identified by the time category that are within the defined time range.
Time entries that fall within the defined time range get an additional time attribute. This formula requires start and end time
entries. The calculation splits hours entries that span midnight and the calculated hours appear separately on each day. The
summation level is set to Detailed.
Example1: The person doesn't work any evening hours, so doesn't qualify for the shift premium
Mon Regular 8a – 4p 8h
Tue Regular 8a – 4p 8h
Wed Regular 8a – 4p 8h
Thu Regular 8a – 4p 8h
Fri Regular 8a – 4p 8h
Example 2: The person works evening hours that qualify for the shift premium.
Premium 6h
Premium 4h
Thu
Fri Regular 9p – 5a 8h
Premium 3h
Description
This fast formula compares the reported time with a specific category of public holidays attached to the person's assigned
schedule. If the reported time is on a qualifying holiday, then the person gets a holiday premium payroll time type. This template
uses an array processing formula. It isn't associated with any delivered time calculation rule templates.
If the person should also receive a premium for hours worked over some defined threshold value, you must use a separate
threshold premium rule.
Parameters
WORKED_TIME_CONDITION Time category Time category that identifies the time entries to compare
with the public holiday category of entries associated with
the person's schedule
OVRD_PUB_HOLIDAY_CATEGORY Value set Category of public holiday entries associated with the
person's schedule to compare with the time entries identified
by the specified time category
Outputs
Function
This formula gets a list of holidays for the given public holiday category and time card period. It assigns all time entries that don't
match a public holiday date to the OUT_MEASURE_ARY_UNDER measure. It assigns any time entries that do match to the
measure OUT_MEASURE_ARY_OVER measure.
Example: You create a rule with your template where the time category is All Pay Time Types. For calculated hours over the
threshold, the payroll time type is Overtime. Thursday and Friday are public holidays (PH).
Mon Regular 8h 8h
Tue Regular 8h 8h
Wed Regular 9h 8h
Overtime 1h
Overtime 8h
Overtime 8h
Sat Regular 8h 8h
Description
This fast formula is associated with the delivered rule template Day Periods and Seventh Day Threshold Template. It compares
the total hours identified by the time category for the day, period, or seventh consecutive day with the threshold values for the
day, period, or seventh consecutive day. It converts hours over the threshold to a single payroll time type. It leaves hours under
the threshold as the same payroll time type or converts them to a new payroll time type. This formula uses an array processing
formula.
Parameters
WORKED_TIME_CONDITION Time category Time category that identifies the time entries to use to determine
the hours under and over the thresholds
DAILY_THRESHOLD_1 Fixed number Number of hours marking the threshold for the first day
DAILY_THRESHOLD_2 Fixed number Number of hours marking the second threshold for the first day
SEVENT_DAY_THRESHOLD Fixed number Number of hours marking the threshold for the seventh day
WEEKLY_THRESHOLD Fixed number Number of hours marking the threshold for the weekly time card
Outputs
OUTPUT
NAME GROUP TIME ATTRIBUTE DESCRIPTION
Function
The general overtime provision requirements are that people get 1.5 times their regular pay rate when they work more than X
hours a day or more than Y hours a week. People can work more than X hours a day or more than six days a week if they get
overtime pay according to these tiers.
The first overtime tier includes all hours worked beyond X hours, up to and including X2 hours in a day. It also includes the first
X hours worked on the seventh consecutive day of the week.
The second overtime tier includes all hours worked beyond X2 hours in a day. It also includes all hours worked in excess of X
on the seventh consecutive day of the week.
Hours worked under the first threshold are paid at the regular rate.
Hours worked over the first threshold and under the second threshold are paid at an overtime rate of 1.5 times the regular rate.
Hours worked over the second threshold are paid at an overtime rate of 2 times the regular rate.
Weekly Rule:
Hours worked under the first threshold are paid at the regular rate.
Hours worked over the first threshold are paid at an overtime rate of 1.5 times the regular rate.
1. The rule that checks for and processes any seventh day worked hours runs first. Typically, US rules use a threshold of 8 hours
and calculate hours under the threshold as overtime and over it as double time.
2. The daily rules that check thresholds and process any worked hours run next. Typically, US rules have these configurations:
– Daily double time rule (X2): The daily threshold is 12 hours with calculated hours under the threshold as regular and over it
as double time.
– Daily overtime rule (X): The daily threshold is 8 hours with calculated hours under the threshold as regular and over it as
overtime.
3. The weekly rule that checks the threshold and processes any worked hours runs last. Typically, US rules use a threshold of 40
hours and calculate hours under the threshold as regular and over it as overtime.
Examples
Scenario: The person's rule set includes the following four rules, created with this formula.
1 -- 5 Regular 8h 8h
6 Regular 8h
Overtime 8h
Example 2: The seventh day and daily double time rules don't run, but the daily and weekly overtime rules do.
1 -- 5 Regular 10h 8h
Overtime 2h
6 Regular 4h
Overtime 4h
Example 3 The seventh day and daily double time rules don't run, but the daily and weekly overtime rules do.
1 -- 3 Regular 6h 6h
4 -- 5 Regular 12h 8h
Overtime 4h
6 Regular 10h 6h
Overtime 4h
1 Regular 13h 8h
Overtime 4h
Double Time 1h
2 Regular 6h 6h
3 -- 5 Regular 13h 8h
Overtime 4h
Double Time 1h
6 Regular 10h 2h
Overtime 8h
Example 5: The seventh day, both daily, and the weekly overtime rules all run.
1 Regular 4h 4h
2 Regular 8h 8h
3 Regular 12h 8h
Overtime 4h
4 -- 5 Regular 8h 8h
6 Regular 3h 3h
7 Regular 3h
Overtime 3h
1 -- 3 Regular 4h 4h
4 Regular 13h 8h
Overtime 4h
Double Time 1h
5 Regular 8h 8h
6 Regular 4h 4h
7 Regular 9h
Overtime 8h
Double Time 1h
Example 7: The seventh day and weekly overtime rules run, but both daily rules don't.
1 -- 5 Regular 8h 8h
6 Regular 8h
Overtime 8h
7 Regular 4h
Overtime 4h
1 -- 5 Regular 8h 8h
6 Regular 12h
Overtime 8h
Double Time 4h
7 Regular 13h
Overtime 8h
Double Time 5h
Example 9: The seventh day rule runs, but both daily rules and the weekly overtime rule don't.
1 -- 6 Regular 4h 4h
7 Regular 4h
Overtime 4h
Example 10: The seventh day and daily double time rules don't run, but the daily and weekly overtime rules do.
2 -- 6 Regular 10h 8h
Overtime 2h
7 Regular 7h
Overtime 7h
1 Regular 2h 2h
2 -- 5 Regular 8h 8h
6 Regular 8h 6h
Overtime 2h
7 Regular 5h
Overtime 5h
Example 12: The seventh day, both daily, and the weekly overtime rules all run.
1 -- 5 Regular 15h 8h
Overtime 4h
Double Time 3h
6 Regular 15h
Overtime 12h
Double Time 3h
7 Regular 15h
Overtime 8h
Double Time 7h
Description
This fast formula is associated with the delivered rule templates Daily Threshold Template and Weekly Threshold Template. It
compares the total hours identified by the time category for the day or period with the threshold value. It converts hours over the
threshold to a single payroll time type. It leaves hours under the threshold as the same payroll time type or converts them to a
new, single payroll time type.
Parameters
WORKED_TIME_CONDITION Time category Time category of reported hours that include the specified time
attributes to convert and copy to payroll cost segments.
DEFINED_LIMIT Fixed Number Number of hours marking the daily or weekly threshold
Outputs
Function
This formula sums time entries for each day and the entire time card. It splits the totaled time between the measures
OUT_MEASURE_ARY_UNDER and OUT_MEASURE_ARY_OVER, if the total hours worked are more than the defined limit for
the selected summation level.
Example 1: You create a rule with your template where the daily threshold is 8 hours. The time category is All Payroll Time Types
and the payroll time type for calculated hours over the threshold is Overtime.
Mon Regular 7h 7h
Sick 1h 1h
Tue Regular 8h 8h
Wed Regular 9h 8h
Overtime 1h
Overtime 2h
Regular 8h
Example 2: You create a rule with your template where the weekly threshold is 40 hours. The time category is All Payroll Time
Types, and the payroll time type for calculated hours over the threshold is Overtime.
Mon Regular 7h 7h
Sick 1h 1h
Tue Regular 8h 8h
Wed Regular 9h 9h
Overtime 3h
Example 3: You create a rule with your template where the daily threshold is 8 hours and the time category is All Payroll Time
Types. The payroll time type for calculated hours under the threshold is Straight Time and over the threshold is Overtime.
Daily Threshold is 8 Hours, Pay Type Under is Straight Time and Over is Overtime
Mon Regular 7h
Sick 1h
Straight Time 8h
Tue Regular 8h
Straight Time 8h
Wed Regular 9h
Straight Time 8h
Overtime 1
Straight Time 8h
Overtime 2h
Straight Time 8h
Weekly Threshold is 40 Hours, Pay Type Under is Straight Time and Over is Overtime
Mon Regular 7h
Sick 1h
Straight Time 8h
Tue Regular 8h
Straight Time 8h
Wed Regular 9h
Straight Time 9h
Straight Time 8h
Overtime 2h
Straight Time 5h
Overtime 3h
Description
This fast formula is associated with the delivered rule templates Daily Threshold AP Template and Weekly Threshold AP
Template. It compares the total hours identified by the time category for the day or period with the threshold value. It converts
hours over the threshold to a single payroll time type. It leaves hours under the threshold as the same payroll time type or
converts them to a new payroll time type. This template uses an array processing formula.
Parameters
WORKED_TIME_CONDITION Time category Time category that identifies the time entries to
use to determine the hours under and over the
thresholds
Outputs
Function
This formula sums time entries for each day and the entire time card. It splits the totaled time between the measures
OUT_MEASURE_ARY_UNDER and OUT_MEASURE_ARY_OVER, if the total hours worked exceed the defined limit for the
selected summation level.
Example 1: You create a rule with your template where the daily threshold is 8 hours and the time category is All Pay Time Types.
For calculated hours over the threshold, the payroll time type is Overtime.
Mon Regular 7h 7h
Sick 1h 1h
Tue Regular 8h 8h
Wed Regular 9h 8h
Overtime 1h
Overtime 2h
Example 2: You create a rule with your template where the weekly threshold is 40 hours and the time category is All Pay Time
Types. For calculated hours over the threshold, the payroll time type is Overtime.
Mon Regular 7h 7h
Sick 1h 1h
Tue Regular 8h 8h
Wed Regular 9h 9h
Overtime 3h
Example 3: You create a rule with your template where the daily threshold is 8 hours and the time category is All Pay Time Types.
For calculated hours under the threshold, the payroll time type is Straight Time. For calculated hours over the threshold, it's
Overtime.
Mon Regular 7h
Sick 1h
Straight Time 8h
Tue Regular 8h
Straight Time 8h
Wed Regular 9h
Straight Time 8h
Overtime 1h
Straight Time 8h
Overtime 2h
Straight Time 8h
Mon Regular 7h
Sick 1h
Straight Time 8h
Tue Regular 8h
Straight Time 8h
Wed Regular 9h
Straight Time 9h
Straight Time 5h
Overtime 3h
Description
This time calculation rule fast formula is associated with the delivered rule templates Daily Threshold with Absences AP Template
and Weekly Threshold with Absences AP Template. It compares the total hours identified by the time category, which might
include absence time, for the day or period with the threshold value. It converts hours over the threshold to a single payroll time
type. It leaves hours under the threshold as the same payroll time type or converts them to a new, single payroll time type. This
formula uses an array to process time data.
Parameters
Outputs
Function
Compares the total hours identified by the time category, which might include absence time, for the day or with the threshold
value. The function converts hours over the threshold to a single payroll time type attribute. For hours under the threshold, it either
keeps the attribute or converts the attribute to a new payroll time type attribute.
You create a rule with your template where the weekly threshold is 40 hours and the time category is All Payroll Time Types. The
vacation absence type is included in calculations, and the payroll time type for calculated hours over the threshold is Overtime.
Example 1: The person's hours total to 48 for the time card period when absence time is included.
If your rule execution type is Update, then on Friday, the rule splits the calculated hours. It keeps the hours under the 40-hour
threshold associated with the reported payroll time type. It associates the calculated hours over the threshold with the Overtime
payroll time type.
If your rule execution type is Create, the rule keeps all calculated hours associated with the existing payroll time types. It then
creates a new time entry for the hours over the threshold and associates it with the Overtime payroll time type
Mon Vacation 8h 8h 8h
Overtime 8h
OT Differential 8h
Example 2: The person's hours total to 48 for the time card period when absence time is included.
If your rule execution type is Update, the rule splits the calculated hours. It keeps the hours under the 40-hour threshold
associated with the reported payroll time type. It associates the calculated hours over the threshold with the Overtime payroll
time type. Because update calculation rules can only create additional overtime entries on nonabsence days, the rule enters
the calculated overtime on Thursday.
If your rule execution type is Create, the rule keeps all calculated hours associated with the existing payroll time types. It then
creates a new time entry for the hours over the threshold and associates it with the Overtime payroll time type
Overtime 8h
Fri Vacation 8h 8h 8h
OT Differential 8h
Description
This fast formula is associated with the delivered rule template Variable Day Threshold Template. It compares the total hours
identified by the time category for the variable day with the threshold value. It converts hours over the threshold to a single payroll
time type. It leaves hours under the threshold as the same payroll time type or converts them to a new, single payroll time type.
Parameters
Outputs
Function
The function compares the total variable day hours identified by the time category with the threshold value. It coverts hours over
the threshold to a single payroll time type attribute. For hours under the threshold, it either keeps the attribute or converts the
attribute to a new payroll time type attribute. The function defines the variable day by the start time of the first entry after a
specified time. The day calculation considers all entries from the first time entry time until just before the same time on the next
day, unless the person got an insufficient break during the variable day. If the person did get an insufficient break, the function
includes entries after the same time on the next day, in the overtime calculation for the first day. This formula requires start and
end time entries. The calculation splits hours entries that span midnight and the calculated hours appear separately on each day.
The summation level is set to Detailed.
Example1: The time entries have more than 3 hours between them and no time entry starts before the shift start time.
Example 2: The person works an extra shift that starts an hour before the usual shift start time. This start causes the entire shift to
count as part of the same variable day, thus qualifying the person for overtime.
Mon Regular 6a – 2p 8h
9p – 11p
Overtime 2h
Example 3: The person works an extra shift on Tuesday. The rule considers the shift above the threshold even though it starts
after the shift start time because the reported start time is only 2.5 hours after the reported end time of the previous shift.
Overtime 3.5h
Second Shift on Tuesday Starts Early, Wednesday Has Less Than 3 Hours Between Shift End and Start Times
Tue Regular 8a – 2p 8h
8p – 11p
Overtime 8h
Wed Regular 1a – 8a
Thu
Worldwide Headquarters
500 Oracle Parkway, Redwood Shores, CA 94065 USA
Worldwide Inquiries
TELE + 1.650.506.7000 + 1.800.ORACLE1
FAX + 1.650.506.7200
oracle.com
CONNECT W ITH US
Call +1.800.ORACLE1 or visit oracle.com. Outside North America, find your local office at oracle.com/contact.
Copyright © 2019, Oracle and/or its affiliates. All rights reserved. This document is provided for information purposes only, and the contents hereof are
subject to change without notice. This document isn’t warranted to be error-free, nor subject to any other warranties or conditions, whether expressed
orally or implied in law, including implied warranties and conditions of merchantability or fitness for a particular purpose. We specifically disclaim any
liability with respect to this document, and no contractual obligations are formed either directly or indirectly by this document. This document may not be
reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without our prior written permission.
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.
Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or
registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks
of Advanced Micro Devices. UNIX is a registered trademark of The Open Group. 1019
White Paper Time Calculation Rule Fast Formula Reference GuideThis white paper describes the time calculation rule fast formulas delivered in
various releases of Oracle Fusion Time and Labor.
October 2019October 2019
Author: [OPTIONAL]
Contributing Authors: [OPTIONAL]