List.Range ดึงช่วงของสมาชิกจาก List โดยระบุตำแหน่งเริ่มต้น (offset) และจำนวนสมาชิกที่ต้องการดึง ฟังก์ชันนี้มีประโยชน์เมื่อต้องการดึงข้อมูลชุดย่อยจากตำแหน่งใดๆ ในรายการ
=List.Range(list as list, offset as number, optional count as nullable number) as list
=List.Range(list as list, offset as number, optional count as nullable number) as list
| Argument | Type | Required | Default | Description |
|---|---|---|---|---|
| list | list | Yes | รายการที่ต้องการดึงช่วงของสมาชิก | |
| offset | number | Yes | ตำแหน่งเริ่มต้น (0 คือตำแหน่งแรก) | |
| count | nullable number | Optional | null | จำนวนสมาชิกที่ต้องการดึง (ถ้าไม่ระบุจะดึงไปจนสุดท้าย) |
ดึงสินค้า 10 รายการต่อหน้า โดยเลือกหน้าที่ 3 (สมาชิกจากตำแหน่ง 20-29)
ดึงข้อมูลจากตำแหน่งกลางของรายการ โดยข้ามหัวและท้าย
List.Range({10, 20, 30, 40, 50}, 1, 3)=List.Range({10, 20, 30, 40, 50}, 1, 3)
{20, 30, 40}
List.Range({"Apple", "Banana", "Cherry", "Date"}, 2)=List.Range({"Apple", "Banana", "Cherry", "Date"}, 2)
{"Cherry", "Date"}
let AllNumbers = {1, 2, 3, 4, 5, 6, 7, 8, 9, 10}, PageSize = 5, PageNumber = 2, StartPosition = (PageNumber - 1) * PageSize, Page2 = List.Range(AllNumbers, Star…let
AllNumbers = {1, 2, 3, 4, 5, 6, 7, 8, 9, 10},
PageSize = 5,
PageNumber = 2,
StartPosition = (PageNumber - 1) * PageSize,
Page2 = List.Range(AllNumbers, StartPosition, PageSize)
in
Page2
{6, 7, 8, 9, 10}
List.FirstN ดึงจากจุดเริ่มต้นเท่านั้น ส่วน List.Range สามารถดึงจากตำแหน่งใดๆ ในรายการ
ฟังก์ชันจะคืนรายการว่างเปล่า เพราะตำแหน่งเริ่มต้นอยู่นอกช่วงของรายการ
ฟังก์ชัน List.Range ใช้สำหรับดึงสมาชิกจากตำแหน่งที่กำหนดไปยังตำแหน่งเฉพาะในรายการ