Calculation function differences between engines

In Polaris, the calculated result for unmapped cells is FALSE.

In the Classic Engine, the default value is TRUE.

In Polaris, if you use a value of NaN (Not a Number) for the Number argument, the ADDMONTHS function returns a blank value.

In the Classic Engine, a value of NaN used with ADDMONTHS is equivalent to 0.

In Polaris, if you use a value of NaN (Not a Number) for the Number argument, the ADDYEARS function returns a blank value.

In the Classic Engine, a value of NaN used with ADDYEARS is equivalent to 0.

In Polaris, you cannot use the bracketed aggregation function AVERAGE in formulas of line items with a formula summary method.

In the Classic Engine, you can.

In Polaris, if you use a time period value for the Item argument, the CODE function returns a blank text result. In the Classic Engine, it returns the time period value as text.

In Polaris, you can't use this function for line items that have the Formula or Ratio summary methods. In the Classic Engine, you can.

In the Classic Engine, if you use a timing argument, and it's value is neither 0 nor 1, the formula is not calculated correctly.

In Polaris, if you do this, the formula calculates as expected.

In Polaris, you can't use CUMULATE in formulas of line items with a formula summary method. In the Classic Engine, you can.

In Polaris, the List argument can be any list related to a dimension of the line item the formula is used on. In the Classic Engine, for example, if you specify a subset as the List argument, it runs over the entire list. However, in Polaris, the function applies only within the subset. If a different level of hierarchy is used, the argument aligns and matches with the corresponding level in the target's dimensional hierarchy.

In Polaris, the order of a List argument follows the correct hierarchical ordering instead of the order of the list in General lists.

In Polaris, you can't use the DECUMULATE function for line items that have the Formula summary method. In the Classic Engine, you can.

In Polaris, you can use the DECUMULATE function over any dimension, by including an additional argument. In the Classic Engine, you can't. Where, if the additional argument isn't included, the function defaults to Time as the dimension.

In Polaris, the FIND function considers the length of all Unicode characters to be one. This means that the FIND function returns the correct starting character.

In the Classic Engine, the FIND function considers the length of:

• Unicode characters from within the Basic Multilingual Plane (BMP) to be 1
• Unicode characters from outside the BMP to be 2
• The length of composite characters (such as those with accents or diacritic marks) to be equal to the number of components

In Polaris, you can't use the FINDITEM function on Time dimension. In the Classic Engine, you can.

In Polaris, you can't use this function for line items that have the Formula or Ratio summary methods. In the Classic Engine, you can.

In Polaris, you can use the HALFYEARTODATE function with line items with a time scale of Half-Year.

In the Classic Engine, you can't.

In Polaris, you can't use HALFYEARTODATE in formulas of line items with a formula summary method.

In the Classic Engine, you can.

In Polaris, you must enable Half-year Totals in the Model Calendar to use the HALFYEARVALUE function. In the Classic Engine, you can use the HALFYEARVALUE function regardless of if Half-year Totals is enabled in the Model Calendar.

In Polaris, you can't use the HALFYEARVALUE function in a result line item with a time scale greater than the function. The Classic Engine returns a value of 0 in this case.

In Classic, if the cash flows are out of order with respect to the Transaction list dimension, Classic can associate the wrong index to some cash flows, which leads to unreliable results. Polaris always gives you the right result regardless of the order of transactions.

In Classic, the scaling factor is determined entirely by the time scale of the time dimension of Cash flows, regardless of the actual structure of that time dimension. In Polaris, the scaling factor is the average number of leaf periods (of the time dimension of Cash flows) in a fiscal year. To note, when using the general weeks calendar type, that is, when there are no fiscal years, weekly transactions are converted to daily transactions and a fixed 365 scaling factor is used, the same as in Classic.

In Classic, when the Estimate is NaN, the result is undefined. ‌Polaris returns NaN.

When all cash flows are 0, Classic returns NaN if values are exactly zero. Polaris returns 0 if values are tolerantly equal to zero.

When there're blank values in Dates, Classic treats it as 12/31/1899 (one day before Anaplan era). Polaris returns NaN, regardless of cash flow values.

In Classic, the target line item can be dimensioned by Transaction list. In Polaris, it can't be dimensioned by Transaction list. For the time dimension variant, the target line item can't have a time dimension.

When the Transaction list is empty, Classic returns NaN. In Polaris, this always returns 0 unless the Estimate is NaN, in that case, the function returns NaN instead.

In Polaris, the ISANCESTOR function returns a value of false when given a top level item coupled with an orphan entity.

In the Classic Engine, this will return a value of true.

In Polaris, the ISBLANK function considers a text value that consists exclusively of carriage return characters to be a blank value.

In the Classic Engine, the ISBLANK function considers a carriage return to be a non-blank value.

Note: Performance of ISFIRSTOCCURRENCE is known to be poor in Polaris for high dimensionality. It's strongly advised to avoid ISFIRSTOCCURRENCE in Polaris.

In Polaris, you can use the ISFIRSTOCCURRENCE function with the Time list. In the Classic Engine, you cannot.

Also in Polaris, the ISFIRSTOCCURRENCE function does not have a 50 million cell limit as it does in the Classic Engine.

In Polaris, the ISNOTBLANK function considers a text value that consists exclusively of carriage return characters to be a blank value.

In the Classic Engine, the ISNOTBLANK function considers a carriage return to be a non-blank value.

In Polaris, you can't use the ITEM function for line items that have the Ratio summary method. In the Classic Engine, you can.

In Polaris, you can't use this function with a two-argument variant of Time, for example ITEM(Time, "Feb 10"). In the Classic Engine, you can.

In Polaris:

• Any number used for the Offset amount argument is rounded to the nearest integer. A value of NaN (Not a Number) for the Offset amount argument returns the Substitute value argument.
• You can use LAG with any dimension except Versions. In the Classic Engine, you can use this function only with a time dimension.

In the Classic Engine:

• You can use non-numeric Value to offset arguments, but only when the Offset amount is a constant. Otherwise, an error message displays.
• Any number used for the Offset amount argument is rounded toward zero. A value of NaN is equivalent to 0.

In Polaris:

• Any number used for the Offset amount argument is rounded to the nearest integer. A value of NaN (Not a Number) for the Offset amount argument returns the Substitute value argument.
• You can use LEAD with any dimension except Versions. In the Classic Engine, you can use this function only with a time dimension.

In the Classic Engine:

• You can use non-numeric Value to offset arguments, but only when the Offset amount is a constant. Otherwise, an error message displays.
• Any number used for the Offset amount argument is rounded towards zero. A value of NaN is equivalent to 0.

In Polaris, the LEFT function behaves as expected with all text values, including those that contain composite characters or characters from outside the Basic Multilingual Plane (BMP).

In the Classic Engine, the LEFT function considers the length of:

• Unicode characters from within the BMP to be 1
• Unicode characters from outside the BMP to be 2
• The length of composite characters (such as those with accents or diacritic marks) to be equal to the number of components

In Polaris, the LENGTH function behaves as expected with all text values, including those that contain composite characters or characters from outside the Basic Multilingual Plane (BMP).

In the Classic Engine, the LENGTH function considers the length of:

• Unicode characters from within the BMP to be 1
• Unicode characters from outside the BNP to be 2
• The length of composite characters (such as those with accents or diacritic marks) to be equal to the number of components

In Polaris, the LOG function returns a value of NaN (Not a Number) if you use positive infinity for the Base argument.

In the Classic Engine, the LOG function returns 0 if you use positive infinity for the Base argument.

In Polaris, the LOOKUP function returns the value of the aggregate item in composite and non-composite hierarchies. The Classic Engine returns the value of the aggregate item in a composite hierarchy, and the default value for the line item in a non-composite hierarchy. 

In Polaris, you can't use the LOOKUP function in a result line item with a time scale greater than the values you look up. The Classic Engine returns a value of 0 in this case. 

In Polaris, if the target line item can't reference the mapping line item, then the LOOKUP is invalid.

In Polaris, a LOOKUP will be invalid if the mapping line item has a dimension that is not related to a dimension in the target line item. This includes cases where the mapping line item is dimensioned by a line item subset.

In Polaris, the MID function behaves as expected with all text values, including those that contain composite characters or characters from outside the Basic Multilingual Plane (BMP).

In the Classic Engine, the MID function considers the length of:

• Unicode characters from within the BMP to be 1
• Unicode characters from outside the BNP to be 2
• The length of composite characters (such as those with accents or diacritic marks) to be equal to the number of components

In Polaris, when comparing a blank date value to a non-blank date value, the MIN function returns the non-blank value.

In the Classic Engine, when comparing a blank date value to a non-blank date value, the MIN function returns the blank value.

In Polaris, when comparing a blank date value to a non-blank date value, the MIN function returns the non-blank value.

In the Classic Engine, when comparing a blank date value to a non-blank date value, the MIN function returns the blank value.

For dates, blank cells calculate to blank for Polaris and 2399-12-31 for the Classic Engine. For numbers, blank cells calculate to 0 for Polaris and positive infinity for the Classic Engine.

In Polaris, you cannot use the bracketed aggregation function MIN in formulas of line items with a formula summary method. In the Classic Engine, you can.

In Polaris, the MOD(0, NaN) returns NaN.

In the Classic Engine, MOD(0, NaN) returns 0.

In Polaris, you can use the MONTHTODATE function with line items with a time scale of Month.

In the Classic Engine, you cannot.

In Polaris, you cannot use MONTHTODATE in formulas of line items with a formula summary method. In the Classic Engine, you can.

In Polaris, you cannot use the MONTHVALUE function in a result line item with a time scale greater than the function.

The Classic Engine returns a value of 0 in this case.

In Polaris, you can't use NEXT for line items that have the Formula summary method. In the Classic Engine, you can.

In Polaris, you can use NEXT with any dimension compatible with a dimension of the target, except Versions. For example you can use a list or its subset as the second argument when the target line item is dimensioned by a list. For versions, use NEXTVERSION. In the Classic Engine, you can use NEXT only with a time dimension.

In Polaris, for time outside the time range hierarchy, NEXT returns zero or blank values.

In Classic, if the cash flows are out of order with respect to the Transaction list dimension, Classic can associate the wrong index to some cash flows, which leads to unreliable results. Polaris always gives you the right result regardless of the order of transactions.

In Classic, the scaling factor is determined entirely by the time scale of the time dimension of Cash flows, regardless of the actual structure of that time dimension. In Polaris, the scaling factor is the average number of leaf periods (of the time dimension of Cash flows) in a fiscal year. To note, when using the general weeks calendar type, that is, when there are no fiscal years, weekly transactions are converted to daily transactions and a fixed 365 scaling factor is used, the same as in Classic.

In Classic, when the Discount rate is NaN, the result is undefined. ‌Polaris returns NaN.

When there're blank values in Dates, Classic treats it as 12/31/1899 (one day before Anaplan era). Polaris returns NaN, regardless of cash flow values.

In Classic, the target line item can be dimensioned by Transaction list. In Polaris, for the time dimension variant, the target line item can't have a time dimension.

When the Transaction list is empty, the Classic Engine rejects the formula and gives an error message. In Polaris, this always returns 0 unless the Discount rate is NaN, in that case, the function returns NaN instead.

In Polaris, a value of NaN (Not a Number) for the Offset amount argument returns the Substitute value argument. ‌In the Classic Engine, a value of NaN is equivalent to 0.

In Polaris, you can use OFFSET with any dimension except Versions. In the Classic Engine, you can use this function only with a time dimension.

In Polaris, operators such as >, <, and = return a value of FALSE when used with blank date or time period values.

In the Classic Engine, a non-blank date or time period value is greater than a blank date or time period value.

In Polaris, operators such as >, <, and = are tolerant of small differences to 1E-14. In the Classic Engine, the operators are exact.

For arithmetic operators + and -, Polaris returns a blank date when any date operands are blank. In the Classic Engine, a blank date assumes the minimum possible value.

For the arithmetic operator *, Polaris returns 0 when any operands are NaN (Not a Number). The Classic Engine returns NaN.

In Polaris, the parent of Years within the Time list is All Periods.

In the Classic Engine, All Periods has a time scale of Years, which means Years is the parent of Years.

In Polaris, the results of formulas aren't coerced into different timescales. For example, if a formula returns a result with a Months timescale in a line item with the Years timescale, the formula is invalid.

In the Classic Engine, the results of formulas are coerced into different timescales. For example, if a formula returns a result with a Months timescale in a line item with the Years timescale, the Months value automatically converts to display in the Years line item.

In Polaris, you can't use the DECUMULATE function for line items that have the Formula summary method. In the Classic Engine, you can.

In Polaris, you can use the DECUMULATE function over any dimension, by including an additional argument. In the Classic Engine, you can't. Where, if the additional argument isn't included, the function defaults to Time as the dimension.mension, by including an additional argument. In the Classic Engine, you can't. Where, if the additional argument isn't included, the function defaults to Time as the dimension.

In Polaris, POWER(0,0) returns 0.

In the Classic Engine, POWER(0,0) returns 1.

In Polaris, you can't use PREVIOUS for line items that have the Formula summary method. In the Classic Engine, you can.

In Polaris, you can use PREVIOUS with any dimension compatible with a dimension of the target, except Versions. For example you can use a list or its subset as the second argument when the target line item is dimensioned by a list. For versions, use PREVIOUSVERSION. In the Classic Engine, you can use PREVIOUS only with a time dimension.

In Polaris, for time outside the time range hierarchy, PREVIOUS returns zero or blank values.

In Polaris, the lookup dimension of the Profile line item can't be related to any of the dimensions of the target line item to which the formula is applied.

In Polaris, you can't use the PROFILE function for line items that have the Formula summary method. In the Classic Engine, you can.

In Polaris, you can use the PROFILE function over any dimension, by including an additional argument. In the Classic Engine, you can't. Where, if the additional argument isn't included, the function defaults to Time as the dimension.

In Polaris, you can use the QUARTERTODATE function with line items with a time scale of Quarter.

In the Classic Engine, you cannot.

In Polaris, you cannot use QUARTERTODATE in formulas of line items with a formula summary method. In the Classic Engine, you can.

In Polaris, you must enable Quarter Totals in the Model Calendar to use the QUARTERVALUE function. In the Classic engine, you can use the QUARTERVALUE function regardless of if Quarter Totals is enabled in the Model Calendar.

In Polaris, you cannot use the QUARTERVALUE function in a result line item with a time scale greater than the function. The Classic Engine returns a value of 0 in this case.

You cannot use RANK in Polaris, if:

• The target is dimensioned by a line item subset.
• Any of the arguments reference a line item dimensioned by a line item subset.

In Classic, a value of FALSE for the Include value argument omits a value from the ranking and returns a result of NaN (Not a Number). In Polaris it returns a value of 0 (zero).

In Classic, you can use a text data type for the Ranking groups argument. In Polaris, you cannot.

In Polaris you do not have a cell limit. In Classic, it is 50 million cells.

In Classic, infinities and NaN are automatically excluded from the RANK function and return a result of NaN. In Polaris, NaN values are automatically excluded from the RANK function and return a result of 0. Infinities have also been removed.

In Polaris, RANKCUMULATE can not be used when the target is dimensioned by a line item subset, or the function makes a reference to a line item subset.

In Polaris you do not have a cell limit. In Classic, it is 50 million cells.

Polaris does not support infinities, in Classic it does. In Classic, if a cumulation source contains an Infinity, then the result from then on until the end of the cumulation is that infinity. However, if an opposite Infinity follows it, the result becomes NaN (Not a Number). In Polaris it will return NaN instead of Infinity.

In Polaris, blank is unordered , so it is unrankable. For RANKCUMULATE, if the ranking value is blank the the function returns zero.

In Polaris, the ranking values can be the BLANK literal, this is, RANKCUMULATE(1, BLANK) is valid (although the function will always return zero in this case).

In Polaris, the RIGHT function behaves as expected with all text values, including those that contain composite characters or characters from outside the Basic Multilingual Plane (BMP).

In the Classic Engine, the RIGHT function considers the length of:

• Unicode characters from within the BMP to be 1
• Unicode characters from outside the BMP to be 2
• The length of composite characters (such as those with accents or diacritic marks) to be equal to the number of components

In Polaris, the ROUND function always uses the EXACT rounding method. As such, you cannot provide the Rounding method argument. In the Classic engine, the ROUND function uses the NORMAL rounding method unless you provide EXACT for the Rounding method argument.

In Polaris, if Number to round is 0 and Number of decimal places is NaN (Not a Number), then the ROUND function returns 0. In the Classic Engine, this returns NaN.

In Polaris, if Number to round is not 0 and Number of decimal places is NaN (Not a Number), then the ROUND function returns NaN. In the Classic Engine, this returns NaN.

In Polaris, if Number of decimal places is not a whole number, then Number of decimal places rounds to the nearest whole number. The Classic Engine does not support the NORMAL Rounding method  in this case, and with the EXACT Rounding method, ROUND rounds towards zero.

In Polaris, if Number of decimal places is -Infinity or less than -308.5, then ROUND returns 0, -Infinity, or Infinity, as expected. If Number of decimal places is Infinity or greater than 308.5, then ROUND returns Number to round. In the Classic Engine, all these return NaN (Not a Number).

In Polaris, if Rounding direction is UP, DOWN, AWAYFROMZERO, or TOWARDSZERO, and the result is too small to represent, then ROUND returns the smallest possible number. In the Classic Engine, these cases, with a Rounding method of EXACT, return 0.

In Polaris, if Number to round is negative, Rounding direction is NEAREST, and Number of decimal places is negative, then ROUND rounds away from zero. The Classic Engine rounds this towards zero.

In Polaris, the reference in SELECT must be literal, rather than an expression.

In the Classic Engine, SELECT allows expressions only on the time axis, for Time.'Current Period' and literal offsets.

In Polaris, you can't use the SPREAD function for line items that have the Formula summary method. In the Classic Engine, you can.

In Polaris, you can use the SPREAD function over any dimension, by including an additional argument. In the Classic Engine, you can't. Where, if the additional argument isn't included, the function defaults to Time as the dimension.

In Polaris, the SUBSTITUTE function does not match the base characters of a composite characters. For example, the SUBSTITUTE function does not consider â to contain a or が to contain か.

In the Classic Engine, the SUBSTITUTE function matches the base characters of composite characters. For example, the SUBSTITUTE function considers â to contain a or が to contain か.

In Polaris, the TEXT function returns a text value of NaN (Not a Number) when used with the numerical value NaN.

In the Classic Engine, the TEXT function returns a blank value when you use it with the numerical value NaN.

In Polaris you can only use a number or Boolean type for the Line item, to aggregate arguments. In Classic, you can use number, Boolean, date, list, and text type line items.

In Polaris, if you only provide a value for the Start period argument and not the End period argument, the TIMESUM function aggregates all values from the Start period through to the end of the applicable time range. In Classic it will just return the value from the Start period.

In Polaris, when you use date values for the Start period and End period arguments, they behave as expected. In Classic, the date for the Start period should be in the period where aggregation ends and the date for the End period should be in the period where aggregation begins.

In Polaris, if Start period or End period are outside the range of the time dimension, then the formula using TIMESUM  is invalid.

You cannot currently use the TRIM function in Polaris.

In the Classic Engine, the TRIM function removes all leading and trailing spaces, and extra spaces between words in a text string.

In Polaris, you cannot use the Locale argument with the UPPER function.

In the Classic Engine, you can use the Locale argument.

In Polaris, the VALUE function returns NaN (Not a Number) for non-decimal representations of numbers (for example, "0x11.11p0").

In the Classic Engine, non decimal representations of numbers do not necessarily return NaN.

In Polaris, you can use a decimal value for the Day offset argument and it rounds to the nearest whole number. If you use a value outside of 1 to 7, the function returns a value of 0.

In the Classic Engine, you must use a whole number for the Day offset argument.

In Polaris, you can use the WEEKTODATE function with line items with a time scale of Week.

In the Classic Engine, you cannot.

In Polaris, you cannot use WEEKTODATE in formulas of line items with a formula summary method. In the Classic Engine, you can.

In Polaris, you cannot use the WEEKVALUE function in a result line item with a time scale greater than the function.

The Classic Engine returns a value of 0 in this case.

In Polaris, you can use the YEARTODATE function with line items with a time scale of Year.

In the Classic Engine, you cannot.

In Polaris, you cannot use YEARTODATE in formulas of line items with a formula summary method. In the Classic Engine, you can.

In Polaris, you cannot use the YEARVALUE function in a result line item with a time scale greater than the function.

The Classic Engine returns a value of 0 in this case.

In Polaris, you cannot use YEARVALUE in formulas of line items with a formula summary method. In the Classic Engine, you can.