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, if you use a time period value for the Item argument, the CODE function returns the time period value as text.

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 cannot use CUMULATE in formulas of line items with a formula summary method.

In the Classic Engine, you can.

In Polaris, the List argument must identically match a dimension of the line item to which the formula is applied.

In the Classic Engine, you can also use a subset of a line item dimension as List.

In Polaris, you cannot use DECUMULATE in formulas of line items with a formula summary method.

In the Classic Engine, you can.

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 cannot use the FINDITEM function with one Time argument.

In the Classic Engine, you can use FINDITEM with one or two Time arguments.

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

In the Classic Engine, you cannot.

In Polaris, you cannot 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 cannot 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 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 cannot use ITEM in formulas of line items with formula summary method. In the Classic Engine, you can.

In Polaris, you cannot use the ITEM function with one Time argument. In the Classic Engine, you can.

In Polaris, the Offset amount argument rounds to the nearest whole number.

In the Classic Engine, the Offset amount argument rounds towards zero.

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

In Polaris, the Offset amount argument rounds to the nearest whole number.

In the Classic Engine, the Offset amount argument rounds towards zero.

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

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, you cannot 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, an invalid LOOKUP is rejected where the Mapping is dimensioned by a line item the formula is set on, and the values to look up are not dimensioned by that subset. 

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

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

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

In the Classic Engine, you can.

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 cannot use NEXT in formulas of line items with a formula summary method. In the Classic Engine, you can.

For time outside the time range hierarchy, Polaris returns zero or blank values. In the Classic Engine, NEXT can apply to a time outside the time range hierarchy.

In the Classic Engine, you can use the NEXT function only with a time dimension. In Polaris, you can use NEXT with any dimension except Versions. For Versions, use NEXTVERSION.

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 the Classic Engine, you can use the OFFSET function only with a time dimension. In Polaris, you can use OFFSET with any dimension except Versions.

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 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 are not 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 cannot use POST in formulas of line items with a formula summary method.

In the Classic Engine, you can.

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

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

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

In the Classic Engine, you can use the PREVIOUS function only with a time dimension. In Polaris, you can use PREVIOUS with any dimension.

In Polaris, the lookup dimension cannot relate to any dimension of the line item to which the formula is applied.

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

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 cannot use SPREAD in formulas of line items with a formula summary method.

In the Classic Engine, you can.

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.