Skip to main content

RANDBETWEEN

Returns a random number between the numbers specified.

Syntax

expression.RANDBETWEEN(arg1, arg2);

expression - A variable that represents a ApiWorksheetFunction class.

Parameters

NameRequired/OptionalData typeDefaultDescription
arg1RequiredApiRange | ApiName | numberThe smallest integer value.
arg2RequiredApiRange | ApiName | numberThe largest integer value.

Returns

number

Example

Generate a random whole number within a specified range in a spreadsheet.

// How do I pick a random value between two numbers in a spreadsheet?

// Create an unpredictable integer within a minimum and maximum in a spreadsheet.

let worksheet = Api.GetActiveSheet();
let func = Api.WorksheetFunction;
worksheet.GetRange("A1").SetValue(func.RANDBETWEEN(-1, 10));