Поделиться через

range()

  • Статья

Создает динамический массив, содержащий серию равномерно распределенных значений.

Синтаксис

range(остановка запуска, [, шаг])

Дополнительные сведения о соглашениях синтаксиса.

Параметры

Имя (название) Type Обязательно Описание
Начало скаляр ✔️ Значение первого элемента в результирующем массиве.
stop скаляр ✔️ Максимальное значение последнего элемента в результирующем массиве, поэтому последнее значение в серии меньше или равно значению остановки.
шаг скаляр Разница между двумя последовательными элементами массива. Значение по умолчанию для шага — 1 числовой и 1h для timespan или datetime.

Возвраты

Динамический массив, значения которого: start, start + step, ... вплоть до и включая остановку. Массив усечен, если достигнуто максимальное число результатов.

Примечание.

Функция диапазона поддерживает не более 1 048 576 результатов (2^20).

Примеры

В следующем примере возвращается массив чисел от одного до восьми с шагом 3.

Выполнить запрос

print r = range(1, 8, 3)

Выходные данные

r
[1,4,7]

В следующем примере возвращается массив со всеми датами 2007 года.

Выполнить запрос

print r = range(datetime(2007-01-01), datetime(2007-12-31), 1d)

Выходные данные

r
["2007-01-01T00:00:00.000000Z","2007-01-02T00:00:00.0000000Z","2007-02T000:00000Z","2007-02T00:00:0000000Z","12007-01-03T00:00:000000Z",.....,"2007-12-31T00:00:00.0000000Z"]

В следующем примере возвращается массив с числами от одного до трех.

Выполнить запрос

print range(1, 3)

Выходные данные

print_0
[1,2,3]

В следующем примере возвращается диапазон часов от одного часа до пяти часов.

Выполнить запрос

print range(1h, 5h)

Выходные данные

print_0
1 000 000
["01:00:00","02:00:00","03:00:00","04:00:00","05:00:00"]:

В следующем примере возвращается усеченный массив, так как диапазон превышает максимальное ограничение результатов. В примере показано, что ограничение превышено с помощью оператора mv-expand для расширения массива в несколько записей, а затем подсчета количества записей.

Выполнить запрос

print r = range(1,1000000000) 
| mv-expand r 
| count

Выходные данные

Count
1 048 576