Entitlements Conversion Formula Library

Some entitlement rules contain conversion formula settings that can adjust the value that’s calculated by the rule engine. By configuring a conversion formula, you’re setting up a logic where Dayforce adjusts the rule’s output based on variables such as mathematical operators and some employee properties. For example, you can set up a conversion formula so that the value calculated by an entitlement rule is multiplied by an employee’s average daily hours value to determine their balance amount.

The following sections describes the entitlement conversion formula operators and tokens used to convert the values specified in entitlement rules based on employee records.

The Token {g}

Entitlement rules that support conversion formula settings require the token {g} in the formula. The token {g} represents a different value depending on the entitlement rule you’re configuring. For many rules, {g} represents the value calculated by the rule. This value might be a balance value that represents a unit of time or a dollar amount. For example, to configure a conversion formula where Dayforce multiplies the rule’s output by the employee’s average daily hours value, you’d enter the following formula:

{g}*{EMP_DAILY_HR}

Alternatively, some entitlement rules derive the {g} value from a specific setting. For example, the Award Balance Amount Rule applies the value in the Balance amount to award field to the token {g} when you set up a formula using the token in the Conversion formula field. It’s recommended that you carefully review the functionality of entitlement rules as described in this document to determine how the token {g} works for different rules.

Important: Remember to format the token {g} correctly so that Dayforce properly retrieves the intended value. You must enter “g” in curly or brace brackets { }.

Supported Operators, Functions, and Tokens

Supported arithmetic operators
Arithmetic Operator	Description
`+`	Addition
`-`	Subtraction
`/`	Division
`*`	Multiplication

Supported functions
Function	Description
`abs(a)`	Returns the absolute value of `a`.
`max(a,b)`	Returns the larger value between `a` and `b`.
`min(a,b)`	Returns the smaller value between `a` and `b`.
`round(a,b)`	Rounds `a` to `b` decimal places (using midpoint rounding).
`if(logic expression, true result, false result)`	Evaluates the “logic expression” and returns `true result` when true and `false result` when false.

Supported formula operators
Operator	Description
`==`	Equal
`!=`	Not equal
`>`	Greater than
`<`	Less than
`>=`	Greater than or equal to
`<=`	Less than or equal to
`&&`	And
`\|\|`	Or

Supported tokens
Token	Description
`EMP_CONTRACT_HR`	The base Contract Hours value for a work contract, as configured in People in the Work > Work Contracts screen.
`EMP_CONTRACT_DAILY_HR`	The result of the following formula: `{EMP_CONTRACT_HR}` / `{EMP_CONTRACT_WORKDAYS}` If the employee doesn’t have a work contract, this value is the result of the following formula: `{EMP_WEEKLY_HR}` / `5`
`EMP_CONTRACT_WKS`	The result of the following formula: (`Work Contract Balance Period End` - `Work Contract Balance Period Start`) / `7`
`EMP_CONTRACT_WORKDAYS`	The number of contract workdays within the specified period.
`EMP_DAILY_HR`	The Average Daily Hours value in People.
`EMP_WEEKLY_HR`	The Normal Weekly Hours value in People.
`EMP_BASE_RATE`	The Base Rate value in People.
`EMP_VAC_RATE`	The Vacation Rate value in People.
`EMP_ALT_RATE`	The Alternate Rate value in People.
`EMP_JOB_RATE`	The Rate Level value in People in the Work > Work Assignments screen for the appropriate work assignment. If the employee isn’t assigned a job step rate, Dayforce uses the Rate field in the Work > Work Assignments screen for the appropriate work assignment.