Edit

Sequence function

  • Article

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

Character map

See the Char function reference for two Sequence functions working together to display a character map in a two-dimensional layout.

Chessboard

See the As operator reference for two Sequence functions working together to create a chessboard in a text string and in two nested galleries.