syntax:functions:random

### Table of Contents

# Random()

Category: Number function

## Description

This function generates a random number between 0 and 1.

## Arguments

This function does not require arguments.

**Return value type:** Number

## Remarks

### Generating random numbers within a given range

To generate a random number between a specific minimum and maximum value, use the following calculation (extra spaces have been added for clarity):

( random() * ( [number of values in range] - 1) ) + [minimum value]

The expression to generate a random number between 1 and 10 would be the following:

( random() * (10-1) ) +1

or

( random() * 9 ) +1

The expression above will provide a decimal result you will need to round for an integer result:

roundxl( ( random() * 9 ) +1 , 0 ) //Excel-style rounding

### Determining the number of values in a given range

The number of values in a given range is determined as:

(max value) - (min value) + 1

This can be deceiving at first glance. For example, the range between 20 and 40 includes *21* values.

## Examples

Extra spaces added for clarity.

random() //Returns 0.37130572949209748204

( random() * 10 ) +2 //Random number between 2 and 12, unrounded.

roundxl( ( random() * 20 ) +20 , 0 ) //Random number between 20 and 40, rounded to an integer.

## See also

syntax/functions/random.txt · Last modified: 2021/10/15 14:56 by craigt