Sequence function

Article
03/22/2024

Applies to: Canvas apps Desktop flows Model-driven apps Power Platform CLI

Generate a table of sequential numbers.

Description

The Sequence function generates a single column table of sequential numbers, such as 1, 2, 3. The name of the column is Value. Sequence( 4 ) is equivalent to [1,2,3,4].

Use Sequence with the ForAll function to iterate a specific number of times. For example, the following formula adds 10 random numbers to the collection MyRandomNumbers:

ForAll( Sequence( 10 ), Collect( MyRandomNumbers, Rand() ) )

ForAll can also be used to transform the value into other data types and return a new table. For example, the following formula returns a table of the next 10 days:

ForAll( Sequence( 10 ), DateAdd( Today(), Value, Days ) )

The number of records to generate is rounded down to the nearest whole number and must be in the range 0 to 50,000. Generating a table with zero records results in an empty table.

Note

Sequence is limited to 50,000 records.

Syntax

Sequence( Records [, Start [, Step ] ] )

Records – Required. The number of records to create. Must be in the range 0 to 50,000.
Start – Optional. The starting number for the sequence. Default is 1.
Step – Optional. The increment for each successive number in the sequence. Step can be negative to count down from the Start. Default is 1.

Examples

Basic usage

Formula	Description	Result
Sequence( 4 )	Generates a 4 record table starting at the default 1 and incrementing by the default 1.
Sequence( 4, 24 )	Generates a 4 record table starting at 24 and incrementing by the default 1.
Sequence( 4, 4, -1 )	Generates a 4 record table starting at 4 and incrementing by -1, effectively counting backward.
Sequence( 4, -100, 0.5 )	Generates a 4 record table starting at -100 and incrementing by 0.5.
Sequence( 0.9 )	Generates an empty table as the count rounds down to 0.
ForAll( Sequence( 4 ), Rand() )	Generates a 4 record table of random numbers.	Actual numbers will vary.
Concat( Sequence( 5 ), Text( Value ) & " " )	Generates a string of numbers from 1 to 5.	"1 2 3 4 5 "