ssjs.guide SFMC
⌘K

Math Object

The Math built-in object in SSJS — which methods and constants work, which are partial, and which ES6 members are missing, with fallbacks.

Almost every Math member is ES3 and works in SSJS. Two members are partial (Math.max / Math.min), one constant is missing (Math.LOG10E), and several ES6 methods are not available. Members that need a fallback are flagged below.

Status legend

Icon Meaning
✅ Works Available and behaves as expected
⚠️ Partial Available but with a documented caveat or bug
❌ Missing Not available (or undefined) — use the workaround

Members

Member ES Status Notes
Math.abs(x) ES3 ✅ Works  
Math.ceil(x) ES3 ✅ Works  
Math.floor(x) ES3 ✅ Works  
Math.round(x) ES3 ✅ Works  
Math.pow(x, y) ES3 ✅ Works  
Math.sqrt(x) ES3 ✅ Works  
Math.random() ES3 ✅ Works  
Math.log(x) ES3 ✅ Works  
Math.exp(x) ES3 ✅ Works  
Math.sin/cos/tan/asin/acos/atan/atan2 ES3 ✅ Works  
Math.PI / E / LN2 / LN10 / LOG2E / SQRT2 / SQRT1_2 ES3 ✅ Works  
Math.max(...values) ES3 ⚠️ Partial Throws with 3+ args; no-arg returns 0 — see Polyfills
Math.min(...values) ES3 ⚠️ Partial Throws with 3+ args; no-arg returns 0 — see Polyfills
Math.LOG10E ES3 ❌ Missing undefined — use the literal 0.4342944819032518
Math.trunc(x) ES6 ❌ Missing x < 0 ? Math.ceil(x) : Math.floor(x)
Math.sign(x) ES6 ❌ Missing x > 0 ? 1 : x < 0 ? -1 : 0
Math.cbrt(x) ES6 ❌ Missing Math.pow(x, 1 / 3) for non-negative x
Math.log2(x) ES6 ❌ Missing Math.log(x) / Math.LN2
Math.log10(x) ES6 ❌ Missing Math.log(x) / Math.LN10
Math.hypot(a, b) ES6 ❌ Missing Math.sqrt(a * a + b * b)

Constants

(ES3) — ✅ Works (except LOG10E).

Constant Value
Math.PI 3.141592653589793
Math.E 2.718281828459045
Math.LN2 0.6931471805599453
Math.LN10 2.302585092994046
Math.LOG2E 1.4426950408889634
Math.SQRT2 1.4142135623730951
Math.SQRT1_2 0.7071067811865476

abs

(ES3) — ✅ Works. Absolute value.

Math.abs(-5);   // 5

ceil

(ES3) — ✅ Works. Rounds up to the nearest integer.

Math.ceil(4.1);   // 5

floor

(ES3) — ✅ Works. Rounds down to the nearest integer.

Math.floor(4.9);   // 4

round

(ES3) — ✅ Works. Rounds to the nearest integer.

Math.round(4.5);   // 5
function roundTo(n, decimals) {
    var factor = Math.pow(10, decimals);
    return Math.round(n * factor) / factor;
}
roundTo(3.14159, 2);   // 3.14

pow

(ES3) — ✅ Works. x raised to the power y.

Math.pow(2, 10);   // 1024
Math.pow(9, 0.5);  // 3

sqrt

(ES3) — ✅ Works. Square root.

Math.sqrt(16);   // 4

random

(ES3) — ✅ Works. Float in [0, 1).

function randomInt(min, max) {
    return Math.floor(Math.random() * (max - min + 1)) + min;
}
randomInt(1, 6);   // dice roll

log

(ES3) — ✅ Works. Natural logarithm.

Math.log(Math.E);   // 1

exp

(ES3) — ✅ Works. e raised to the power x.

Math.exp(1);   // 2.718281828459045

Trigonometry

(ES3) — ✅ Works. Math.sin, cos, tan, asin, acos, atan, atan2.

Math.sin(Math.PI / 2);   // 1
Math.cos(0);             // 1
Math.atan2(1, 1);        // π/4

max

(ES3) — ⚠️ Partial.

Math.max(1, 5);   // 5  — two-argument form is safe
// Math.max(1, 5, 3); — ❌ throws in SFMC

var arr = [3, 1, 4, 1, 5];
var max = arr[0];
for (var i = 1; i < arr.length; i++) { if (arr[i] > max) { max = arr[i]; } }

min

(ES3) — ⚠️ Partial. Same caveat as Math.max: throws with 3+ args, no-arg returns 0 instead of +Infinity. See the polyfill.

Math.min(1, 5);   // 1  — two-argument form is safe

LOG10E

(ES3) — ❌ Missing. Math.LOG10E is undefined in SFMC. Use the literal 0.4342944819032518.

var LOG10E = 0.4342944819032518;

trunc

(ES6) — ❌ Missing. Use x < 0 ? Math.ceil(x) : Math.floor(x).

function trunc(x) { return x < 0 ? Math.ceil(x) : Math.floor(x); }
trunc(4.7);    // 4
trunc(-4.7);   // -4

sign

(ES6) — ❌ Missing. Use x > 0 ? 1 : x < 0 ? -1 : 0.

function sign(n) { return n > 0 ? 1 : n < 0 ? -1 : 0; }

cbrt

(ES6) — ❌ Missing. Use Math.pow(x, 1 / 3) for non-negative x.

function cbrt(x) { return Math.pow(Math.abs(x), 1 / 3) * (x < 0 ? -1 : 1); }
cbrt(27);    // 3
cbrt(-27);   // -3

log2

(ES6) — ❌ Missing. Use Math.log(x) / Math.LN2.

Math.log(8) / Math.LN2;   // 3

log10

(ES6) — ❌ Missing. Use Math.log(x) / Math.LN10.

Math.log(100) / Math.LN10;   // 2

hypot

(ES6) — ❌ Missing. Use Math.sqrt(a * a + b * b).

function hypot(a, b) { return Math.sqrt(a * a + b * b); }
hypot(3, 4);   // 5

See Also

See Also