นิพจน์และฟังก์ชันสําหรับ Data Factory ใน Microsoft Fabric

บทความ
03/17/2025

บทความนี้ให้รายละเอียดเกี่ยวกับนิพจน์และฟังก์ชันที่ได้รับการสนับสนุนโดย Data Factory ใน Microsoft Fabric

นิพจน์

ค่านิพจน์ในข้อกําหนดอาจเป็นสัญพจน์หรือนิพจน์ที่มีการประเมินในขณะทํางาน เช่น:

"value"

หรือ

"@pipeline().parameters.password"

นิพจน์สามารถปรากฏที่ใดก็ได้ในค่าสตริงและให้ผลลัพธ์เป็นค่าสตริงอื่นเสมอ ถ้าค่าเป็นนิพจน์ เนื้อความของนิพจน์จะถูกแยกออกโดยการเอาเครื่องหมาย at(@) ออก ถ้าจําเป็นต้องใช้สตริงสัญพจน์ที่ขึ้นต้นด้วย @จะต้องหลีกโดยใช้ @@ ตัวอย่างต่อไปนี้แสดงวิธีการประเมินนิพจน์

ค่านิพจน์	ผล
"พารามิเตอร์"	อักขระ 'พารามิเตอร์' จะถูกส่งกลับ
"พารามิเตอร์[1]"	อักขระ 'พารามิเตอร์[1]' จะถูกส่งกลับ
"@@"	สตริงอักขระ 1 ตัวที่มี '@' จะถูกส่งกลับ
" @"	สตริงอักขระ 2 ตัวที่มี ' @' จะถูกส่งกลับ

นิพจน์ยังสามารถปรากฏภายในสตริง โดยใช้คุณลักษณะที่เรียกว่า การประมาณค่าในช่วงสตริง ที่นิพจน์จะถูกตัดคําใน @{ ... } ตัวอย่างเช่น: "First Name: @{pipeline().parameters.firstName} Last Name: @{pipeline().parameters.lastName}"

การใช้การประมาณค่าในช่วงสตริง ผลลัพธ์จะเป็นสตริงเสมอ สมมติว่าฉันได้กําหนด myNumber เป็น 42 และ myString เป็น foo

ค่านิพจน์	ผล
"@pipeline().parameters.myString"	แสดง `foo` เป็นสตริง
"@{pipeline().parameters.myString}"	แสดง `foo` เป็นสตริง
"@pipeline().parameters.myNumber"	แสดง `42` เป็นตัวเลข
"@{pipeline().parameters.myNumber}"	แสดง `42` เป็นสตริง
"คําตอบคือ: @{pipeline().parameters.myNumber}"	แสดงสตริง `Answer is: 42`
"@concat('คําตอบคือ: ', string(pipeline().parameters.myNumber)""	ส่งกลับสตริง `Answer is: 42`
"คําตอบคือ: @@{pipeline().parameters.myNumber}"	แสดงสตริง `Answer is: @{pipeline().parameters.myNumber}`

ในกิจกรรมโฟลว์ควบคุม เช่น กิจกรรม ForEach คุณสามารถให้อาร์เรย์ที่จะทําซ้ําสําหรับรายการคุณสมบัติ และใช้ @item() ทําซ้ําการแจงนับเดียวในกิจกรรม ForEach ตัวอย่างเช่น ถ้าหน่วยข้อมูลเป็นอาร์เรย์: [1, 2, 3] @item() จะแสดงค่า 1 ในการทําซ้ําครั้งแรก 2 ในการทําซ้ําครั้งที่สอง และ 3 ในการทําซ้ําครั้งที่สาม คุณยังสามารถใช้ @range(0,10) เช่น นิพจน์ เพื่อทําซ้ํา 10 ครั้งโดยเริ่มต้นด้วย 0 ที่ลงท้ายด้วย 9

คุณสามารถใช้ @activity('ชื่อกิจกรรม') เพื่อตรวจจับผลลัพธ์ของกิจกรรมและทําการตัดสินใจได้ พิจารณากิจกรรมบนเว็บที่เรียกว่า Web1 สําหรับการวางผลลัพธ์ของกิจกรรมแรกในเนื้อความของส่วนที่สอง โดยทั่วไปนิพจน์จะมีลักษณะดังนี้: @activity('Web1').output หรือ @activity('Web1').output.data หรือสิ่งที่คล้ายกันขึ้นอยู่กับผลลัพธ์ของกิจกรรมแรกที่มีลักษณะเหมือน

ตัว อย่าง เช่น

ตัวอย่างนิพจน์ที่ซับซ้อน

ตัวอย่างด้านล่างแสดงตัวอย่างที่ซับซ้อนที่อ้างอิงเขตข้อมูลย่อยลึกของผลลัพธ์กิจกรรม เมื่อต้องการอ้างอิงพารามิเตอร์ไปป์ไลน์ที่ประเมินเป็นเขตข้อมูลย่อย ให้ใช้ไวยากรณ์ [] แทนตัวดําเนินการ dot(.) (เช่นในกรณีของ subfield1 และ subfield2) ซึ่งเป็นส่วนหนึ่งของผลลัพธ์กิจกรรม

@activity('*activityName*').output.*subfield1*.*subfield2*[pipeline().parameters.*subfield3*].*subfield4*

การสร้างไฟล์แบบไดนามิกและการตั้งชื่อเป็นรูปแบบทั่วไป ให้เราสํารวจตัวอย่างการตั้งชื่อไฟล์แบบไดนามิกจํานวนหนึ่ง

ผนวกวันที่ไปยังชื่อไฟล์: @concat('Test_', formatDateTime(utcnow(), 'yyyy-dd-MM'))
ผนวก DateTime ในโซนเวลาของลูกค้า: @concat('Test_', convertFromUtc(utcnow(), 'Pacific Standard Time'))
เวลาทริกเกอร์การผนวก: @concat('Test_', pipeline().TriggerTime)
ส่งออกชื่อไฟล์แบบกําหนดเองในโฟลว์ข้อมูลการแมปเมื่อส่งออกไปยังไฟล์เดียวที่มีวันที่: 'Test_' + toString(currentDate()) + '.csv'

ในกรณีข้างต้น มีการสร้างชื่อไฟล์แบบไดนามิกสี่ชื่อโดยเริ่มต้นด้วย Test_

ตัวแก้ไขเนื้อหาแบบไดนามิก

ตัวแก้ไขเนื้อหาแบบไดนามิกจะหลีกอักขระในเนื้อหาของคุณโดยอัตโนมัติเมื่อคุณทําการแก้ไขเสร็จสิ้นแล้ว ตัวอย่างเช่น เนื้อหาต่อไปนี้ในตัวแก้ไขเนื้อหาคือการประมาณค่าในช่วงสตริงกับฟังก์ชันนิพจน์

"@{toUpper('myData')}"

ตัวแก้ไขเนื้อหาแบบไดนามิกแปลงเนื้อหาด้านบนเป็นนิพจน์ "@{toUpper('myData')}" ผลลัพธ์ของนิพจน์นี้คือสตริงที่จัดรูปแบบที่แสดงด้านล่าง

"MYDATA"

การแทนที่อักขระพิเศษ

ตัวแก้ไขเนื้อหาแบบไดนามิกจะหลีกตัวอักขระโดยอัตโนมัติ เช่น เครื่องหมายอัญประกาศคู่ ทับขวาในเนื้อหาของคุณเมื่อคุณแก้ไขเสร็จแล้ว ซึ่งทําให้เกิดปัญหาถ้าคุณต้องการแทนที่ตัวดึงข้อมูลบรรทัดหรือแท็บ โดยใช้ \n, \t ในฟังก์ชัน replace() คุณสามารถแก้ไขเนื้อหาแบบไดนามิกในมุมมองโค้ดเพื่อลบ \ พิเศษในนิพจน์หรือคุณสามารถทําตามขั้นตอนด้านล่างเพื่อแทนที่อักขระพิเศษโดยใช้ภาษานิพจน์:

การเข้ารหัส URL กับค่าสตริงเดิม
แทนที่สตริงที่เข้ารหัส URL ตัวอย่างเช่น ตัวดึงข้อมูลบรรทัด (%0A), อักขระขึ้นบรรทัดใหม่ (%0D), แท็บแนวนอน (%09)
การถอดรหัส URL

ตัวอย่างเช่น ตัวแปร companyName ด้วยอักขระบรรทัดใหม่ในค่า นิพจน์ @uriComponentToString(replace(uriComponent(variables('companyName')), '%0A', '')) สามารถลบอักขระบรรทัดใหม่ได้

Contoso- Corporation

การแยกส่วนอักขระเครื่องหมายคําพูดเดี่ยว

ฟังก์ชันนิพจน์ใช้เครื่องหมายอัญประกาศเดี่ยวสําหรับพารามิเตอร์ค่าสตริง ใช้เครื่องหมายอัญประกาศเดี่ยวสองอันเพื่อหลีกตัวอักขระ ' ในฟังก์ชันสตริง ตัวอย่างเช่น นิพจน์ @concat('Baba', '''s ', 'book store') จะส่งกลับผลลัพธ์ด้านล่าง

Baba's book store

ตัวแปรขอบเขตไปป์ไลน์

ตัวแปรระบบเหล่านี้สามารถอ้างอิงได้ทุกที่ในไปป์ไลน์

ชื่อตัวแปร	คำอธิบาย
@pipeline().DataFactory	ชื่อของข้อมูลหรือพื้นที่ทํางาน Synapse ที่เรียกใช้ไปป์ไลน์กําลังทํางานอยู่
@pipeline().Pipeline	ชื่อของไปป์ไลน์
@pipeline().RunId	ID ของการเรียกใช้ไปป์ไลน์เฉพาะ
@pipeline().TriggerId	ID ของทริกเกอร์ที่เรียกใช้ไปป์ไลน์
@pipeline().TriggerName	ชื่อของทริกเกอร์ที่เรียกใช้ไปป์ไลน์
@pipeline().TriggerTime	เวลาของทริกเกอร์ที่เรียกใช้ไปป์ไลน์ นี่คือเวลาที่ทริกเกอร์ ถูกเรียกใช้จริง เพื่อเรียกใช้การเรียกใช้ไปป์ไลน์และอาจแตกต่างจากเวลาที่กําหนดไว้ของทริกเกอร์เล็กน้อย
@pipeline().GroupId	รหัสของกลุ่มที่มีการเรียกใช้ไปป์ไลน์
@pipeline()? ทริกเกอร์ ByPipelineName	ชื่อของไปป์ไลน์ที่ทริกเกอร์การเรียกใช้ไปป์ไลน์ ใช้งานได้เมื่อการเรียกใช้ไปป์ไลน์ถูกทริกเกอร์โดยกิจกรรม ExecutePipeline ประเมินเพื่อ Null เมื่อใช้ในสถานการณ์อื่น ๆ จดเครื่องหมายคําถามหลังจาก @pipeline()
@pipeline()? TriggeredByPipelineRunId	เรียกใช้รหัสของไปป์ไลน์ที่ทริกเกอร์การเรียกใช้ไปป์ไลน์ ใช้งานได้เมื่อการเรียกใช้ไปป์ไลน์ถูกทริกเกอร์โดยกิจกรรม ExecutePipeline ประเมินเพื่อ Null เมื่อใช้ในสถานการณ์อื่น ๆ จดเครื่องหมายคําถามหลังจาก @pipeline()

โน้ต

ตัวแปรระบบวันที่/เวลาที่เกี่ยวข้องกับทริกเกอร์ (ทั้งในไปป์ไลน์และขอบเขตทริกเกอร์) จะแสดงวันที่ UTC ในรูปแบบ ISO 8601 ตัวอย่างเช่น 2017-06-01T22:20:00.4061448Z

ฟังก์ชัน

คุณสามารถเรียกใช้ฟังก์ชันภายในนิพจน์ได้ ส่วนต่อไปนี้แสดงข้อมูลเกี่ยวกับฟังก์ชันที่สามารถใช้ในนิพจน์ได้

ฟังก์ชันวันที่

ฟังก์ชัน Date หรือ Time	งาน
addDays	เพิ่มจํานวนวันลงในประทับเวลา
addHours	เพิ่มจํานวนชั่วโมงลงในประทับเวลา
addMinutes	เพิ่มจํานวนนาทีลงในการประทับเวลา
เพิ่ม วินาที	เพิ่มจํานวนวินาทีลงในการประทับเวลา
addToTime	เพิ่มจํานวนหน่วยเวลาลงในการประทับเวลา ดูเพิ่มเติม getFutureTime
แปลง FromUtc	แปลงประทับเวลาจากค่าพิกัดเวลาสากล (UTC) เป็นโซนเวลาเป้าหมาย
แปลง โซนเวลา	แปลงประทับเวลาจากโซนเวลาต้นทางเป็นโซนเวลาเป้าหมาย
แปลง ToUtc	แปลงประทับเวลาจากโซนเวลาต้นทางเป็นเวลาสากลเชิงพิกัด (UTC)
วัน เดือน	ส่งกลับวันของคอมโพเนนต์เดือนจากประทับเวลา
วัน สัปดาห์	ส่งกลับคอมโพเนนต์วันของสัปดาห์จากประทับเวลา
วัน ปี	ส่งกลับคอมโพเนนต์วันของปีจากประทับเวลา
รูปแบบ DateTime	ส่งกลับประทับเวลาเป็นสตริงในรูปแบบทางเลือก
getFutureTime	ส่งกลับประทับเวลาปัจจุบันบวกกับหน่วยเวลาที่ระบุ ดูเพิ่มเติม addToTime
getPastTime	ส่งกลับประทับเวลาปัจจุบันลบหน่วยเวลาที่ระบุ ดู นอกจากนี้ ลบจากเวลา
startOfDay	แสดงจุดเริ่มต้นของวันสําหรับการประทับเวลา
startOfHour	แสดงจุดเริ่มต้นของชั่วโมงสําหรับการประทับเวลา
startOfMonth	ส่งกลับจุดเริ่มต้นของเดือนสําหรับการประทับเวลา
ลบจาก เวลา	ลบจํานวนหน่วยเวลาจากประทับเวลา ดูเพิ่มเติม รับPastTime
เครื่องหมาย	แสดงค่าคุณสมบัติ `ticks` สําหรับประทับเวลาที่ระบุ
utcNow	ส่งกลับประทับเวลาปัจจุบันเป็นสตริง

ฟังก์ชันสตริง

เมื่อต้องการทํางานกับสตริง คุณสามารถใช้ฟังก์ชันสตริงเหล่านี้และฟังก์ชันคอลเลกชัน บางอย่าง ฟังก์ชันสตริงทํางานกับสตริงเท่านั้น

ฟังก์ชันสตริง	งาน
concat	รวมสองสตริงหรือมากกว่าและส่งกลับสตริงที่รวมกัน
endsWith	ตรวจสอบว่าสตริงลงท้ายด้วยซับสตริงที่ระบุหรือไม่
guid	สร้างตัวระบุที่ไม่ซ้ํากันทั่วโลก (GUID) เป็นสตริง
indexOf	แสดงตําแหน่งเริ่มต้นสําหรับสตริงย่อย
lastIndexOf	แสดงตําแหน่งเริ่มต้นสําหรับการปรากฏครั้งล่าสุดของสตริงย่อย
แทนที่	แทนที่สตริงย่อยด้วยสตริงที่ระบุและส่งกลับสตริงที่อัปเดตแล้ว
แยก	แสดงอาร์เรย์ที่มีสตริงย่อยที่คั่นด้วยเครื่องหมายจุลภาคจากสตริงที่ใหญ่กว่าโดยยึดตามอักขระตัวคั่นที่ระบุในสตริงเดิม
เริ่มต้น	ตรวจสอบว่าสตริงเริ่มต้นด้วยซับสตริงเฉพาะหรือไม่
สตริงย่อย	แสดงอักขระจากสตริง โดยเริ่มต้นจากตําแหน่งที่ระบุ
toLower	ส่งกลับสตริงในรูปแบบตัวพิมพ์เล็ก
toUpper	ส่งกลับสตริงในรูปแบบตัวพิมพ์ใหญ่
ตัดแต่ง	เอาช่องว่างนําหน้าและต่อท้ายออกจากสตริง และส่งกลับสตริงที่อัปเดตแล้ว

ฟังก์ชันคอลเลกชัน

เมื่อต้องการทํางานกับคอลเลกชัน โดยทั่วไปแล้วอาร์เรย์ สตริง และบางครั้ง พจนานุกรม คุณสามารถใช้ฟังก์ชันคอลเลกชันเหล่านี้ได้

ฟังก์ชัน Collection	งาน
ประกอบด้วย	ตรวจสอบว่าคอลเลกชันมีรายการที่ระบุหรือไม่
ที่ว่างเปล่า	ตรวจสอบว่าคอลเลกชันว่างเปล่าหรือไม่
แรก	แสดงรายการแรกจากคอลเลกชัน
แยก	แสดงคอลเลกชันที่มี เฉพาะ รายการทั่วไปในคอลเลกชันที่ระบุ
การรวม	แสดงสตริงที่มี หน่วยข้อมูลทั้งหมดจากอาร์เรย์ ซึ่งคั่นด้วยอักขระที่ระบุ
ล่าสุดของ	ส่งกลับรายการสุดท้ายจากคอลเลกชัน
ความยาว	แสดงจํานวนรายการในสตริงหรืออาร์เรย์
ข้าม	เอารายการออกจากด้านหน้าของคอลเลกชัน และส่งกลับ อื่นๆ ทั้งหมด
รับ	ส่งกลับรายการจากด้านหน้าของคอลเลกชัน
สหภาพ	แสดงคอลเลกชันที่มี รายการทั้งหมดจากคอลเลกชันที่ระบุ

ฟังก์ชันตรรกะ

ฟังก์ชันเหล่านี้มีประโยชน์ภายในเงื่อนไข สามารถใช้เพื่อประเมินตรรกะชนิดใดก็ได้

ฟังก์ชันการเปรียบเทียบเชิงตรรกะ	งาน
และ	ตรวจสอบว่านิพจน์ทั้งหมดเป็นจริงหรือไม่
เท่ากับ	ตรวจสอบว่าค่าทั้งสองเท่ากันหรือไม่
ที่มากกว่า	ตรวจสอบว่าค่าแรกมากกว่าค่าที่สองหรือไม่
greaterOrEquals	ตรวจสอบว่าค่าแรกมากกว่าหรือเท่ากับค่าที่สองหรือไม่
ถ้า	ตรวจสอบว่านิพจน์เป็นจริงหรือเท็จ ส่งกลับค่าที่ระบุ โดยยึดตามผลลัพธ์
น้อยลง	ตรวจสอบว่าค่าแรกน้อยกว่าค่าที่สองหรือไม่
lessOrEquals	ตรวจสอบว่าค่าแรกน้อยกว่าหรือเท่ากับค่าที่สองหรือไม่
ไม่ใช่	ตรวจสอบว่านิพจน์เป็นเท็จหรือไม่
หรือ	ตรวจสอบว่านิพจน์อย่างน้อยหนึ่งรายการเป็นจริงหรือไม่

ฟังก์ชันการแปลง

ฟังก์ชันเหล่านี้จะถูกใช้เพื่อแปลงระหว่างชนิดเนทีฟแต่ละชนิดในภาษา:

เชือก
จํานวนเต็ม
ลอย
บูลีน
อาร์ เรย์
พจนานุกรม

ฟังก์ชันการแปลง	งาน
อาร์เรย์	ส่งกลับอาร์เรย์จากอินพุตเดียวที่ระบุ สําหรับข้อมูลป้อนเข้าหลายรายการ โปรดดู createArray
base64	ส่งกลับเวอร์ชันที่เข้ารหัส base64 สําหรับสตริง
base64 หลัก	ส่งกลับเวอร์ชันไบนารีสําหรับสตริงที่เข้ารหัส base64
base64ToString	แสดงเวอร์ชันสตริงสําหรับสตริงที่เข้ารหัส base64
ไบนารี	ส่งกลับเวอร์ชันไบนารีสําหรับค่าอินพุต
บูลีน	ส่งกลับเวอร์ชันบูลีนสําหรับค่าที่ป้อนเข้า
coalesce	ส่งกลับค่าที่ไม่ใช่ null แรกจากพารามิเตอร์อย่างน้อยหนึ่งรายการ
สร้าง Array	ส่งกลับอาร์เรย์จากข้อมูลป้อนเข้าหลายรายการ
dataUri	ส่งกลับ URI ข้อมูลสําหรับค่าอินพุต
dataUriToBinary	ส่งกลับเวอร์ชันไบนารีสําหรับ URI ข้อมูล
dataUriToString	แสดงเวอร์ชันสตริงสําหรับ URI ข้อมูล
ถอดรหัส base64	แสดงเวอร์ชันสตริงสําหรับสตริงที่เข้ารหัส base64
ถอดรหัส DataUri	ส่งกลับเวอร์ชันไบนารีสําหรับ URI ข้อมูล
ถอดรหัส คอมโพเนนต์	แสดงสตริงที่แทนที่อักขระหลีกด้วยรุ่นที่ถอดรหัส
encodeUriComponent	แสดงสตริงที่แทนที่อักขระที่ไม่ปลอดภัย URL ด้วยอักขระการหลีก
เลขทศนิยม	ส่งกลับตัวเลขทศนิยมลอยตัวสําหรับค่าป้อนเข้า
int	ส่งกลับเวอร์ชันจํานวนเต็มสําหรับสตริง
สตริง	แสดงเวอร์ชันสตริงสําหรับค่าอินพุต
คอมโพเนนต์	แสดงเวอร์ชันที่เข้ารหัส URI สําหรับค่าการป้อนข้อมูล โดยการแทนที่อักขระที่ไม่ปลอดภัย URL ด้วยอักขระหลีก
uriComponentToBinary	ส่งกลับเวอร์ชันไบนารีสําหรับสตริงที่เข้ารหัส URI
uriComponentToString	แสดงเวอร์ชันสตริงสําหรับสตริงที่เข้ารหัส URI
xml ของ	แสดงเวอร์ชัน XML สําหรับสตริง
xpath	ตรวจสอบ XML สําหรับโหนดหรือค่าที่ตรงกับนิพจน์ XPath (XML Path Language) และส่งกลับโหนดหรือค่าที่ตรงกัน

ฟังก์ชันทางคณิตศาสตร์

ฟังก์ชันเหล่านี้สามารถใช้สําหรับตัวเลขชนิดใดก็ตาม: จํานวนเต็ม และ ทศนิยม

ฟังก์ชันทางคณิตศาสตร์	งาน
เพิ่ม	ส่งกลับผลลัพธ์จากการเพิ่มตัวเลขสองตัว
div	ส่งกลับผลลัพธ์จากการหารตัวเลขสองตัว
สูงสุดของ	ส่งกลับค่าสูงสุดจากชุดตัวเลขหรืออาร์เรย์
นาที	ส่งกลับค่าต่ําสุดจากชุดตัวเลขหรืออาร์เรย์
mod	ส่งกลับเศษที่เหลือจากการหารตัวเลขสองตัว
เหรียญ	ส่งกลับผลคูณจากการคูณตัวเลขสองตัว
rand	ส่งกลับจํานวนเต็มแบบสุ่มจากช่วงที่ระบุ
ช่วง	ส่งกลับอาร์เรย์จํานวนเต็มที่เริ่มต้นจากจํานวนเต็มที่ระบุ
ย่อยของ	ส่งกลับผลลัพธ์จากการลบตัวเลขที่สองจากตัวเลขแรก

การอ้างอิงฟังก์ชัน

ส่วนนี้แสดงรายการฟังก์ชันที่พร้อมใช้งานทั้งหมดตามลําดับตัวอักษร

เพิ่ม

ส่งกลับผลลัพธ์จากการเพิ่มตัวเลขสองตัว

add(<summand_1>, <summand_2>)

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
< summand_1>, <summand_2>	ใช่	จํานวนเต็ม เลขทศนิยม หรือการผสม	ตัวเลขที่จะเพิ่ม

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< > ผลรวมผลลัพธ์	จํานวนเต็มหรือเลขทศนิยม	ผลลัพธ์จากการเพิ่มตัวเลขที่ระบุ

ตัวอย่าง

ตัวอย่างนี้เพิ่มตัวเลขที่ระบุ:

add(1, 1.5)

และแสดงผลลัพธ์นี้: 2.5

addDays

เพิ่มจํานวนวันลงในประทับเวลา

addDays('<timestamp>', <days>, '<format>'?)

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ประทับเวลา <	ใช่	เชือก	สตริงที่มีประทับเวลา
> วัน <	ใช่	จํานวนเต็ม	จํานวนวันที่เป็นค่าบวกหรือลบที่จะเพิ่ม
> รูปแบบ <	ไม่ใช่	เชือก	ตัวระบุรูปแบบเดี่ยว หรือรูปแบบรูปแบบที่กําหนดเอง รูปแบบค่าเริ่มต้นสําหรับประทับเวลาคือ "o" (yyyy-MM-ddTHH:mm:ss.fffffK) ซึ่งสอดคล้องกับ ISO 8601 และรักษาข้อมูลโซนเวลา

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< > ประทับเวลาที่อัปเดตแล้ว	เชือก	ประทับเวลาบวกกับจํานวนวันที่ระบุ

ตัวอย่างที่ 1

ตัวอย่างนี้เพิ่ม 10 วันไปยังประทับเวลาที่ระบุ:

addDays('2018-03-15T13:00:00Z', 10)

และแสดงผลลัพธ์นี้: "2018-03-25T00:00:0000000Z"

ตัวอย่างที่ 2

ตัวอย่างนี้ลบห้าวันจากประทับเวลาที่ระบุ:

addDays('2018-03-15T00:00:00Z', -5)

และแสดงผลลัพธ์นี้: "2018-03-10T00:00:0000000Z"

addHours

เพิ่มจํานวนชั่วโมงลงในประทับเวลา

addHours('<timestamp>', <hours>, '<format>'?)

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ประทับเวลา <	ใช่	เชือก	สตริงที่มีประทับเวลา
> ชั่วโมง <	ใช่	จํานวนเต็ม	จํานวนชั่วโมงที่เป็นบวกหรือลบที่จะเพิ่ม
> รูปแบบ <	ไม่ใช่	เชือก	ตัวระบุรูปแบบเดี่ยว หรือรูปแบบรูปแบบที่กําหนดเอง รูปแบบค่าเริ่มต้นสําหรับประทับเวลาคือ "o" (yyyy-MM-ddTHH:mm:ss.fffffK) ซึ่งสอดคล้องกับ ISO 8601 และรักษาข้อมูลโซนเวลา

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< > ประทับเวลาที่อัปเดตแล้ว	เชือก	ประทับเวลาบวกกับจํานวนชั่วโมงที่ระบุ

ตัวอย่างที่ 1

ตัวอย่างนี้เพิ่ม 10 ชั่วโมงไปยังประทับเวลาที่ระบุ:

addHours('2018-03-15T00:00:00Z', 10)

และแสดงผลลัพธ์นี้: "2018-03-15T10:00:0000000Z"

ตัวอย่างที่ 2

ตัวอย่างนี้ลบห้าชั่วโมงจากประทับเวลาที่ระบุ:

addHours('2018-03-15T15:00:00Z', -5)

และแสดงผลลัพธ์นี้: "2018-03-15T10:00:0000000Z"

addMinutes

เพิ่มจํานวนนาทีลงในการประทับเวลา

addMinutes('<timestamp>', <minutes>, '<format>'?)

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ประทับเวลา <	ใช่	เชือก	สตริงที่มีประทับเวลา
< นาที>	ใช่	จํานวนเต็ม	จํานวนนาทีที่เป็นบวกหรือลบที่จะเพิ่ม
> รูปแบบ <	ไม่ใช่	เชือก	ตัวระบุรูปแบบเดี่ยว หรือรูปแบบรูปแบบที่กําหนดเอง รูปแบบค่าเริ่มต้นสําหรับประทับเวลาคือ "o" (yyyy-MM-ddTHH:mm:ss.fffffK) ซึ่งสอดคล้องกับ ISO 8601 และรักษาข้อมูลโซนเวลา

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< > ประทับเวลาที่อัปเดตแล้ว	เชือก	ประทับเวลาบวกกับจํานวนนาทีที่ระบุ

ตัวอย่างที่ 1

ตัวอย่างนี้เพิ่ม 10 นาทีไปยังประทับเวลาที่ระบุ:

addMinutes('2018-03-15T00:10:00Z', 10)

และแสดงผลลัพธ์นี้: "2018-03-15T00:20:00.0000000Z"

ตัวอย่างที่ 2

ตัวอย่างนี้ลบห้านาทีจากประทับเวลาที่ระบุ:

addMinutes('2018-03-15T00:20:00Z', -5)

และแสดงผลลัพธ์นี้: "2018-03-15T00:15:00.0000000Z"

addSeconds

เพิ่มจํานวนวินาทีลงในการประทับเวลา

addSeconds('<timestamp>', <seconds>, '<format>'?)

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ประทับเวลา <	ใช่	เชือก	สตริงที่มีประทับเวลา
> < วินาที	ใช่	จํานวนเต็ม	จํานวนวินาทีที่เป็นบวกหรือลบที่จะเพิ่ม
> รูปแบบ <	ไม่ใช่	เชือก	ตัวระบุรูปแบบเดี่ยว หรือรูปแบบรูปแบบที่กําหนดเอง รูปแบบค่าเริ่มต้นสําหรับประทับเวลาคือ "o" (yyyy-MM-ddTHH:mm:ss.fffffK) ซึ่งสอดคล้องกับ ISO 8601 และรักษาข้อมูลโซนเวลา

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< > ประทับเวลาที่อัปเดตแล้ว	เชือก	ประทับเวลาบวกกับจํานวนวินาทีที่ระบุ

ตัวอย่างที่ 1

ตัวอย่างนี้เพิ่ม 10 วินาทีในการประทับเวลาที่ระบุ:

addSeconds('2018-03-15T00:00:00Z', 10)

และแสดงผลลัพธ์นี้: "2018-03-15T00:00:10.0000000Z"

ตัวอย่างที่ 2

ตัวอย่างนี้ลบห้าวินาทีกับประทับเวลาที่ระบุ:

addSeconds('2018-03-15T00:00:30Z', -5)

และแสดงผลลัพธ์นี้: "2018-03-15T00:00:25.0000000Z"

addToTime

เพิ่มจํานวนหน่วยเวลาลงในการประทับเวลา ดูเพิ่มเติม getFutureTime()

addToTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ประทับเวลา <	ใช่	เชือก	สตริงที่มีประทับเวลา
> ช่วงเวลา <	ใช่	จํานวนเต็ม	จํานวนหน่วยเวลาที่ระบุที่จะเพิ่ม
เวลา <>	ใช่	เชือก	หน่วยเวลาที่จะใช้กับช่วง : "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
> รูปแบบ <	ไม่ใช่	เชือก	ตัวระบุรูปแบบเดี่ยว หรือรูปแบบรูปแบบที่กําหนดเอง รูปแบบค่าเริ่มต้นสําหรับประทับเวลาคือ "o" (yyyy-MM-ddTHH:mm:ss.fffffK) ซึ่งสอดคล้องกับ ISO 8601 และรักษาข้อมูลโซนเวลา

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< > ประทับเวลาที่อัปเดตแล้ว	เชือก	ประทับเวลาบวกกับจํานวนหน่วยเวลาที่ระบุ

ตัวอย่างที่ 1

ตัวอย่างนี้เพิ่มหนึ่งวันลงในการประทับเวลาที่ระบุ:

addToTime('2018-01-01T00:00:00Z', 1, 'Day')

และแสดงผลลัพธ์นี้: "2018-01-02T00:00:00.0000000Z"

ตัวอย่างที่ 2

ตัวอย่างนี้เพิ่มหนึ่งวันลงในการประทับเวลาที่ระบุ:

addToTime('2018-01-01T00:00:00Z', 1, 'Day', 'D')

และแสดงผลลัพธ์โดยใช้รูปแบบ "D" ที่เลือกได้: "Tuesday, January 2, 2018"

และ

ตรวจสอบว่านิพจน์ทั้งสองเป็นจริงหรือไม่ ส่งกลับเป็น true เมื่อนิพจน์ทั้งสองเป็น true หรือส่งกลับ false เมื่อนิพจน์อย่างน้อยหนึ่งรายการเป็นเท็จ

and(<expression1>, <expression2>)

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
< expression1>, <expression2>	ใช่	บูลีน	นิพจน์ที่จะตรวจสอบ

ค่าผลลัพธ์	ประเภท	คำอธิบาย
จริง หรือ เท็จ	บูลีน	ส่งกลับเป็น true เมื่อนิพจน์ทั้งสองเป็น true ส่งกลับ เท็จ เมื่อนิพจน์อย่างน้อยหนึ่งรายการเป็น เท็จ

ตัวอย่างที่ 1

ตัวอย่างเหล่านี้ตรวจสอบว่าค่าบูลีนที่ระบุเป็นจริงทั้งคู่หรือไม่:

and(true, true)
and(false, true)
and(false, false)

และส่งกลับผลลัพธ์เหล่านี้:

ตัวอย่างแรก: นิพจน์ทั้งสองเป็นจริง ดังนั้นจะส่งกลับ true
ตัวอย่างที่สอง: นิพจน์หนึ่งเป็น false ดังนั้น จะส่งกลับ false
ตัวอย่างที่สาม: นิพจน์ทั้งสองเป็นเท็จ ดังนั้นจะส่งกลับ false

ตัวอย่างที่ 2

ตัวอย่างเหล่านี้ตรวจสอบว่านิพจน์ที่ระบุเป็นจริงทั้งสองหรือไม่:

and(equals(1, 1), equals(2, 2))
and(equals(1, 1), equals(1, 2))
and(equals(1, 2), equals(1, 3))

และส่งกลับผลลัพธ์เหล่านี้:

ตัวอย่างแรก: นิพจน์ทั้งสองเป็นจริง ดังนั้นจะส่งกลับ true
ตัวอย่างที่สอง: นิพจน์หนึ่งเป็น false ดังนั้น จะส่งกลับ false
ตัวอย่างที่สาม: นิพจน์ทั้งสองเป็นเท็จ ดังนั้นจะส่งกลับ false

อาร์เรย์

ส่งกลับอาร์เรย์จากอินพุตเดียวที่ระบุ สําหรับข้อมูลป้อนเข้าหลายรายการ โปรดดู createArray()

array('<value>')

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ค่า <	ใช่	เชือก	สตริงสําหรับการสร้างอาร์เรย์

ค่าผลลัพธ์	ประเภท	คำอธิบาย
[>ค่า<]	อาร์เรย์	อาร์เรย์ ที่มีอินพุตเดี่ยวที่ระบุ

ตัวอย่าง

ตัวอย่างนี้สร้างอาร์เรย์จากสตริง "hello":

array('hello')

และแสดงผลลัพธ์นี้: ["hello"]

base64

ส่งกลับเวอร์ชันที่เข้ารหัส base64 สําหรับสตริง

base64('<value>')

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ค่า <	ใช่	เชือก	สตริงอินพุต

ค่าผลลัพธ์	ประเภท	คำอธิบาย
> สตริง <base64	เชือก	เวอร์ชันที่เข้ารหัส base64 สําหรับสตริงอินพุต

ตัวอย่าง

ตัวอย่างนี้แปลงสตริง "hello" เป็นสตริงที่เข้ารหัส base64:

base64('hello')

และแสดงผลลัพธ์นี้: "aGVsbG8="

base64ToBinary

ส่งกลับเวอร์ชันไบนารีสําหรับสตริงที่เข้ารหัส base64

base64ToBinary('<value>')

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ค่า <	ใช่	เชือก	สตริงที่เข้ารหัส base64 ที่จะแปลง

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< > แบบไบนารีสําหรับสตริง 64-string	เชือก	เวอร์ชันไบนารีสําหรับสตริงที่เข้ารหัส base64

ตัวอย่าง

ตัวอย่างนี้แปลงสตริงที่เข้ารหัส "aGVsbG8=" base64 เป็นสตริงไบนารี:

base64ToBinary('aGVsbG8=')

และแสดงผลลัพธ์ดังนี้:

"0110000101000111010101100111001101100010010001110011100000111101"

base64ToString

แสดงเวอร์ชันสตริงสําหรับสตริงที่เข้ารหัส base64 ซึ่งถอดรหัสสตริง base64 อย่างมีประสิทธิภาพ ใช้ฟังก์ชันนี้แทนที่จะเป็น decodeBase64() แม้ว่าทั้งสองฟังก์ชันจะทํางานด้วยวิธีเดียวกัน แต่ base64ToString() เป็นสิ่งจําเป็น

base64ToString('<value>')

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ค่า <	ใช่	เชือก	สตริงที่เข้ารหัส base64 เพื่อถอดรหัส

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< > ถอดรหัส-base64-string	เชือก	เวอร์ชันสตริงสําหรับสตริงที่เข้ารหัส base64

ตัวอย่าง

ตัวอย่างนี้แปลงสตริงที่เข้ารหัส "aGVsbG8=" base64 เป็นสตริงเดียว:

base64ToString('aGVsbG8=')

และแสดงผลลัพธ์นี้: "hello"

ไบ นารี

ส่งกลับเวอร์ชันไบนารีสําหรับสตริง

binary('<value>')

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ค่า <	ใช่	เชือก	สตริงที่จะแปลง

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< > ค่าไบนารีสําหรับการป้อนข้อมูล	เชือก	เวอร์ชันไบนารีสําหรับสตริงที่ระบุ

ตัวอย่าง

ตัวอย่างนี้แปลงสตริง "hello" เป็นสตริงไบนารี:

binary('hello')

และแสดงผลลัพธ์ดังนี้:

"0110100001100101011011000110110001101111"

bool

แสดงเวอร์ชันบูลีนสําหรับค่า

bool(<value>)

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ค่า <	ใช่	ใด	ค่าที่จะแปลง

ค่าผลลัพธ์	ประเภท	คำอธิบาย
จริง หรือ เท็จ	บูลีน	เวอร์ชันบูลีนสําหรับค่าที่ระบุ

ตัวอย่าง

ตัวอย่างเหล่านี้แปลงค่าที่ระบุเป็นค่าบูลีน:

bool(1)
bool(0)

และส่งกลับผลลัพธ์เหล่านี้:

ตัวอย่างแรก: true
ตัวอย่างที่สอง: false

coalesce

ส่งกลับค่าที่ไม่ใช่ null แรกจากพารามิเตอร์อย่างน้อยหนึ่งรายการ สตริงที่ว่างเปล่า อาร์เรย์ที่ว่างเปล่า และวัตถุว่างไม่ใช่ null

coalesce(<object_1>, <object_2>, ...)

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
< object_1>, <object_2>, ...	ใช่	ใด ๆ, สามารถผสมประเภท	อย่างน้อยหนึ่งรายการเพื่อตรวจสอบ null

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< > ที่ไม่ใช่ null รายการแรก	ใด	รายการหรือค่าแรกที่ไม่ใช่ null ถ้าพารามิเตอร์ทั้งหมดเป็น null ฟังก์ชันนี้จะแสดงค่า null

ตัวอย่าง

ตัวอย่างเหล่านี้จะแสดงค่าที่ไม่ใช่ null แรกจากค่าที่ระบุ หรือ null เมื่อค่าทั้งหมดเป็น null:

coalesce(null, true, false)
coalesce(null, 'hello', 'world')
coalesce(null, null, null)

และส่งกลับผลลัพธ์เหล่านี้:

ตัวอย่างแรก: true
ตัวอย่างที่สอง: "hello"
ตัวอย่างที่สาม: null

concat

รวมสองสตริงหรือมากกว่าและส่งกลับสตริงที่รวมกัน

concat('<text1>', '<text2>', ...)

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
< text1>, <text2>, ...	ใช่	เชือก	อย่างน้อยสองสตริงที่จะรวม

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< text1text2...>	เชือก	สตริงที่สร้างขึ้นจากสตริงที่ป้อนเข้ารวม

ตัวอย่าง

ตัวอย่างนี้รวมสตริง "Hello" และ "World":

concat('Hello', 'World')

และแสดงผลลัพธ์นี้: "HelloWorld"

ประกอบ ด้วย

ตรวจสอบว่าคอลเลกชันมีรายการที่ระบุหรือไม่ ส่งกลับค่า true เมื่อพบรายการ หรือส่งกลับ false เมื่อไม่พบ ฟังก์ชันนี้เป็นแบบไวต่ออักษรใหญ่-เล็ก

contains('<collection>', '<value>')
contains([<collection>], '<value>')

โดยเฉพาะ ฟังก์ชันนี้ทํางานกับชนิดคอลเลกชันเหล่านี้:

สตริง เพื่อค้นหา สตริงย่อย
อาร์เรย์ เพื่อค้นหาค่า
พจนานุกรม เพื่อค้นหา คีย์

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> คอลเลกชัน <	ใช่	สตริง อาร์เรย์ หรือพจนานุกรม	คอลเลกชันที่จะตรวจสอบ
> ค่า <	ใช่	สตริง อาร์เรย์ หรือพจนานุกรม ตามลําดับ	รายการที่จะค้นหา

ค่าผลลัพธ์	ประเภท	คำอธิบาย
จริง หรือ เท็จ	บูลีน	ส่งกลับจริงเมื่อพบรายการ ส่งกลับ false เมื่อไม่พบ

ตัวอย่างที่ 1

ตัวอย่างนี้ตรวจสอบสตริง "hello world" สําหรับสตริงย่อย "world" และส่งกลับ true:

contains('hello world', 'world')

ตัวอย่างที่ 2

ตัวอย่างนี้ตรวจสอบสตริง "hello world" สําหรับสตริงย่อย "จักรวาล" และส่งกลับค่าเท็จ:

contains('hello world', 'universe')

แปลง FromUtc

แปลงประทับเวลาจากค่าพิกัดเวลาสากล (UTC) เป็นโซนเวลาเป้าหมาย

convertFromUtc('<timestamp>', '<destinationTimeZone>', '<format>'?)

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ประทับเวลา <	ใช่	เชือก	สตริงที่มีประทับเวลา
> ปลายทางของเขตเวลา <	ใช่	เชือก	ชื่อสําหรับโซนเวลาเป้าหมาย สําหรับชื่อโซนเวลา ให้ดู ค่าโซนเวลาของ Microsoftแต่คุณอาจต้องลบเครื่องหมายวรรคตอนใดๆ ออกจากชื่อโซนเวลา
> รูปแบบ <	ไม่ใช่	เชือก	ตัวระบุรูปแบบเดี่ยว หรือรูปแบบรูปแบบที่กําหนดเอง รูปแบบค่าเริ่มต้นสําหรับประทับเวลาคือ "o" (yyyy-MM-ddTHH:mm:ss.fffffK) ซึ่งสอดคล้องกับ ISO 8601 และรักษาข้อมูลโซนเวลา

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< > ประทับเวลาที่แปลงแล้ว	เชือก	ประทับเวลาที่แปลงเป็นโซนเวลาเป้าหมาย

ตัวอย่างที่ 1

ตัวอย่างนี้แปลงประทับเวลาเป็นโซนเวลาที่ระบุ:

convertFromUtc('2018-01-01T08:00:00.0000000Z', 'Pacific Standard Time')

และแสดงผลลัพธ์นี้: "2018-01-01T00:00:00Z"

ตัวอย่างที่ 2

ตัวอย่างนี้แปลงประทับเวลาเป็นโซนเวลาและรูปแบบที่ระบุ:

convertFromUtc('2018-01-01T08:00:00.0000000Z', 'Pacific Standard Time', 'D')

และแสดงผลลัพธ์นี้: "Monday, January 1, 2018"

convertTimeZone

แปลงประทับเวลาจากโซนเวลาต้นทางเป็นโซนเวลาเป้าหมาย

convertTimeZone('<timestamp>', '<sourceTimeZone>', '<destinationTimeZone>', '<format>'?)

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ประทับเวลา <	ใช่	เชือก	สตริงที่มีประทับเวลา
> โซนต้นทางของ <	ใช่	เชือก	ชื่อสําหรับโซนเวลาต้นทาง สําหรับชื่อโซนเวลา ให้ดู ค่าโซนเวลาของ Microsoftแต่คุณอาจต้องลบเครื่องหมายวรรคตอนใดๆ ออกจากชื่อโซนเวลา
> ปลายทางของเขตเวลา <	ใช่	เชือก	ชื่อสําหรับโซนเวลาเป้าหมาย สําหรับชื่อโซนเวลา ให้ดู ค่าโซนเวลาของ Microsoftแต่คุณอาจต้องลบเครื่องหมายวรรคตอนใดๆ ออกจากชื่อโซนเวลา
> รูปแบบ <	ไม่ใช่	เชือก	ตัวระบุรูปแบบเดี่ยว หรือรูปแบบรูปแบบที่กําหนดเอง รูปแบบค่าเริ่มต้นสําหรับประทับเวลาคือ "o" (yyyy-MM-ddTHH:mm:ss.fffffK) ซึ่งสอดคล้องกับ ISO 8601 และรักษาข้อมูลโซนเวลา

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< > ประทับเวลาที่แปลงแล้ว	เชือก	ประทับเวลาที่แปลงเป็นโซนเวลาเป้าหมาย

ตัวอย่างที่ 1

ตัวอย่างนี้แปลงโซนเวลาต้นทางเป็นโซนเวลาเป้าหมาย:

convertTimeZone('2018-01-01T08:00:00.0000000Z', 'UTC', 'Pacific Standard Time')

และแสดงผลลัพธ์นี้: "2018-01-01T00:00:00.0000000"

ตัวอย่างที่ 2

ตัวอย่างนี้แปลงโซนเวลาเป็นโซนเวลาและรูปแบบที่ระบุ:

convertTimeZone('2018-01-01T08:00:00.0000000Z', 'UTC', 'Pacific Standard Time', 'D')

และแสดงผลลัพธ์นี้: "Monday, January 1, 2018"

แปลงเป็น Utc

แปลงประทับเวลาจากโซนเวลาต้นทางเป็นเวลาสากลเชิงพิกัด (UTC)

convertToUtc('<timestamp>', '<sourceTimeZone>', '<format>'?)

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ประทับเวลา <	ใช่	เชือก	สตริงที่มีประทับเวลา
> โซนต้นทางของ <	ใช่	เชือก	ชื่อสําหรับโซนเวลาต้นทาง สําหรับชื่อโซนเวลา ให้ดู ค่าโซนเวลาของ Microsoftแต่คุณอาจต้องลบเครื่องหมายวรรคตอนใดๆ ออกจากชื่อโซนเวลา
> รูปแบบ <	ไม่ใช่	เชือก	ตัวระบุรูปแบบเดี่ยว หรือรูปแบบรูปแบบที่กําหนดเอง รูปแบบค่าเริ่มต้นสําหรับประทับเวลาคือ "o" (yyyy-MM-ddTHH:mm:ss.fffffK) ซึ่งสอดคล้องกับ ISO 8601 และรักษาข้อมูลโซนเวลา

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< > ประทับเวลาที่แปลงแล้ว	เชือก	ประทับเวลาที่แปลงเป็น UTC

ตัวอย่างที่ 1

ตัวอย่างนี้แปลงประทับเวลาเป็น UTC:

convertToUtc('01/01/2018 00:00:00', 'Pacific Standard Time')

และแสดงผลลัพธ์นี้: "2018-01-01T08:00:00.0000000Z"

ตัวอย่างที่ 2

ตัวอย่างนี้แปลงประทับเวลาเป็น UTC:

convertToUtc('01/01/2018 00:00:00', 'Pacific Standard Time', 'D')

และแสดงผลลัพธ์นี้: "Monday, January 1, 2018"

createArray

ส่งกลับอาร์เรย์จากข้อมูลป้อนเข้าหลายรายการ สําหรับอาร์เรย์อินพุตเดียว โปรดดู array()

createArray('<object1>', '<object2>', ...)

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
< object1>, <object2>, ...	ใช่	ใด ๆ แต่ไม่ผสม	อย่างน้อยสองรายการเพื่อสร้างอาร์เรย์

ค่าผลลัพธ์	ประเภท	คำอธิบาย
[<object1>, <object2>, ...]	อาร์เรย์	อาร์เรย์ที่สร้างขึ้นจากรายการอินพุตทั้งหมด

ตัวอย่าง

ตัวอย่างนี้สร้างอาร์เรย์จากอินพุตเหล่านี้:

createArray('h', 'e', 'l', 'l', 'o')

และแสดงผลลัพธ์นี้: ["h", "e", "l", "l", "o"]

dataUri

ส่งกลับ Data Uniform Resource Identifier (URI) สําหรับสตริง

dataUri('<value>')

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ค่า <	ใช่	เชือก	สตริงที่จะแปลง

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< > uri ของข้อมูล	เชือก	URI ข้อมูลสําหรับสตริงที่ป้อนเข้า

ตัวอย่าง

ตัวอย่างนี้สร้าง URI ข้อมูลสําหรับสตริง "hello":

dataUri('hello')

และแสดงผลลัพธ์นี้: "data:text/plain;charset=utf-8;base64,aGVsbG8="

dataUriToBinary

ส่งกลับเวอร์ชันไบนารีสําหรับตัวระบุทรัพยากรรูปแบบข้อมูล (URI) ใช้ฟังก์ชันนี้แทนที่จะ decodeDataUri() แม้ว่าทั้งสองฟังก์ชันจะทํางานด้วยวิธีเดียวกัน แต่ dataUriBinary() เป็นสิ่งจําเป็น

dataUriToBinary('<value>')

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ค่า <	ใช่	เชือก	URI ข้อมูลที่จะแปลง

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< > binary-for-data-uri	เชือก	เวอร์ชันไบนารีสําหรับ URI ข้อมูล

ตัวอย่าง

ตัวอย่างนี้สร้างเวอร์ชันไบนารีสําหรับ URI ข้อมูลนี้:

dataUriToBinary('data:text/plain;charset=utf-8;base64,aGVsbG8=')

และแสดงผลลัพธ์ดังนี้:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

dataUriToString

แสดงเวอร์ชันสตริงสําหรับตัวระบุทรัพยากรรูปแบบข้อมูล (URI)

dataUriToString('<value>')

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ค่า <	ใช่	เชือก	URI ข้อมูลที่จะแปลง

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< > string-for-data-uri	เชือก	เวอร์ชันสตริงสําหรับ URI ข้อมูล

ตัวอย่าง

ตัวอย่างนี้สร้างสตริงสําหรับ URI ข้อมูลนี้:

dataUriToString('data:text/plain;charset=utf-8;base64,aGVsbG8=')

และแสดงผลลัพธ์นี้: "hello"

dayOfMonth

ส่งกลับวันของเดือนนับจากประทับเวลา

dayOfMonth('<timestamp>')

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ประทับเวลา <	ใช่	เชือก	สตริงที่มีประทับเวลา

ค่าผลลัพธ์	ประเภท	คำอธิบาย
> วัน <ของเดือน	จํานวนเต็ม	วันของเดือนนับจากประทับเวลาที่ระบุ

ตัวอย่าง

ตัวอย่างนี้ส่งกลับตัวเลขสําหรับวันของเดือนจากประทับเวลานี้:

dayOfMonth('2018-03-15T13:27:36Z')

และแสดงผลลัพธ์นี้: 15

dayOfWeek

แสดงวันของสัปดาห์จากประทับเวลา

dayOfWeek('<timestamp>')

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ประทับเวลา <	ใช่	เชือก	สตริงที่มีประทับเวลา

ค่าผลลัพธ์	ประเภท	คำอธิบาย
> วัน <ของสัปดาห์	จํานวนเต็ม	วันของสัปดาห์จากประทับเวลาที่ระบุซึ่งวันอาทิตย์คือ 0 วันจันทร์คือ 1 และอื่น ๆ

ตัวอย่าง

ตัวอย่างนี้ส่งกลับตัวเลขสําหรับวันของสัปดาห์จากประทับเวลานี้:

dayOfWeek('2018-03-15T13:27:36Z')

และแสดงผลลัพธ์นี้: 3

dayOfYear

ส่งกลับวันของปีจากประทับเวลา

dayOfYear('<timestamp>')

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ประทับเวลา <	ใช่	เชือก	สตริงที่มีประทับเวลา

ค่าผลลัพธ์	ประเภท	คำอธิบาย
> วัน <ของปี	จํานวนเต็ม	วันของปีนับจากประทับเวลาที่ระบุ

ตัวอย่าง

ตัวอย่างนี้แสดงจํานวนวันของปีจากประทับเวลานี้:

dayOfYear('2018-03-15T13:27:36Z')

และแสดงผลลัพธ์นี้: 74

decodeBase64

แสดงเวอร์ชันสตริงสําหรับสตริงที่เข้ารหัส base64 ซึ่งถอดรหัสสตริง base64 อย่างมีประสิทธิภาพ พิจารณาใช้ base64ToString() แทนที่จะเป็น decodeBase64() แม้ว่าทั้งสองฟังก์ชันจะทํางานด้วยวิธีเดียวกัน แต่ base64ToString() เป็นสิ่งจําเป็น

decodeBase64('<value>')

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ค่า <	ใช่	เชือก	สตริงที่เข้ารหัส base64 เพื่อถอดรหัส

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< > ถอดรหัส-base64-string	เชือก	เวอร์ชันสตริงสําหรับสตริงที่เข้ารหัส base64

ตัวอย่าง

ตัวอย่างนี้สร้างสตริงสําหรับสตริงที่เข้ารหัส base64:

decodeBase64('aGVsbG8=')

และแสดงผลลัพธ์นี้: "hello"

decodeDataUri

ส่งกลับเวอร์ชันไบนารีสําหรับตัวระบุทรัพยากรรูปแบบข้อมูล (URI) พิจารณาการใช้ dataUriToBinary()แทนที่จะเป็น decodeDataUri() แม้ว่าทั้งสองฟังก์ชันจะทํางานด้วยวิธีเดียวกัน แต่ dataUriToBinary() เป็นสิ่งจําเป็น

decodeDataUri('<value>')

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ค่า <	ใช่	เชือก	สตริง URI ข้อมูลที่จะถอดรหัส

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< > binary-for-data-uri	เชือก	เวอร์ชันไบนารีสําหรับสตริง URI ข้อมูล

ตัวอย่าง

ตัวอย่างนี้ส่งกลับเวอร์ชันไบนารีสําหรับ URI ข้อมูลนี้:

decodeDataUri('data:text/plain;charset=utf-8;base64,aGVsbG8=')

และแสดงผลลัพธ์ดังนี้:

decodeUriComponent

แสดงสตริงที่แทนที่อักขระหลีกด้วยรุ่นที่ถอดรหัส

decodeUriComponent('<value>')

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ค่า <	ใช่	เชือก	สตริงที่มีอักขระหลีกที่จะถอดรหัส

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< > ถอดรหัส-uri	เชือก	สตริงที่อัปเดตที่มีอักขระการหลีกที่ถอดรหัส

ตัวอย่าง

ตัวอย่างนี้แทนที่อักขระการหลีกในสตริงนี้ด้วยรุ่นที่ถอดรหัส:

decodeUriComponent('http%3A%2F%2Fcontoso.com')

และแสดงผลลัพธ์นี้: "https://contoso.com"

div

ส่งกลับผลลัพธ์ของจํานวนเต็มจากการหารตัวเลขสองตัว หากต้องการรับผลลัพธ์ที่เหลือ โปรดดู mod()

div(<dividend>, <divisor>)

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> เงินปันผล <	ใช่	จํานวนเต็มหรือเลขทศนิยม	จํานวนที่จะหารด้วย ตัวหาร
> ตัวหาร <	ใช่	จํานวนเต็มหรือเลขทศนิยม	ตัวเลขที่หาร เงินปันผลแต่ไม่สามารถเป็น 0

ค่าผลลัพธ์	ประเภท	คำอธิบาย
> ผลหาร <	จํานวนเต็ม	ผลลัพธ์ของจํานวนเต็มจากการหารตัวเลขแรกด้วยตัวเลขที่สอง

ตัวอย่าง

ทั้งสองตัวอย่างหารตัวเลขแรกด้วยตัวเลขที่สอง:

div(10, 5)
div(11, 5)

และส่งกลับผลลัพธ์นี้: 2

encodeUriComponent

แสดงเวอร์ชันเข้ารหัส Uniform Resource Identifier (URI) สําหรับสตริงโดยแทนที่อักขระที่ไม่ปลอดภัย URL ด้วยอักขระหลีก พิจารณาใช้ uriComponent()แทนที่จะเป็น encodeUriComponent() แม้ว่าทั้งสองฟังก์ชันจะทํางานด้วยวิธีเดียวกัน แต่ uriComponent() เป็นสิ่งจําเป็น

encodeUriComponent('<value>')

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ค่า <	ใช่	เชือก	สตริงที่จะแปลงเป็นรูปแบบที่เข้ารหัส URI

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< > เข้ารหัส uri	เชือก	สตริงที่เข้ารหัส URI ที่มีอักขระหลีก

ตัวอย่าง

ตัวอย่างนี้สร้างเวอร์ชันเข้ารหัส URI สําหรับสตริงนี้:

encodeUriComponent('https://contoso.com')

และแสดงผลลัพธ์นี้: "http%3A%2F%2Fcontoso.com"

เปล่า

ตรวจสอบว่าคอลเลกชันว่างเปล่าหรือไม่ ส่งกลับเป็น จริง เมื่อคอลเลกชันว่างเปล่า หรือส่งกลับ false เมื่อไม่ว่างเปล่า

empty('<collection>')
empty([<collection>])

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> คอลเลกชัน <	ใช่	สตริง อาร์เรย์ หรือวัตถุ	คอลเลกชันที่จะตรวจสอบ

ค่าผลลัพธ์	ประเภท	คำอธิบาย
จริง หรือ เท็จ	บูลีน	ส่งกลับจริงเมื่อคอลเลกชันว่างเปล่า ส่งกลับ false เมื่อไม่ว่างเปล่า

ตัวอย่าง

ตัวอย่างเหล่านี้ตรวจสอบว่าคอลเลกชันที่ระบุว่างเปล่าหรือไม่:

empty('')
empty('abc')

และส่งกลับผลลัพธ์เหล่านี้:

ตัวอย่างแรก: ส่งผ่านสตริงที่ว่างเปล่า ดังนั้นฟังก์ชันจะส่งกลับ true
ตัวอย่างที่สอง: ส่งผ่านสตริง "abc" ดังนั้นฟังก์ชันจะส่งกลับ false

endsWith

ตรวจสอบว่าสตริงลงท้ายด้วยซับสตริงที่ระบุหรือไม่ ส่งกลับเป็น true เมื่อพบสตริงย่อย หรือส่งกลับ false เมื่อไม่พบ ฟังก์ชันนี้ไม่ตรงตามตัวพิมพ์ใหญ่-เล็ก

endsWith('<text>', '<searchText>')

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ข้อความ <	ใช่	เชือก	สตริงที่จะตรวจสอบ
< searchText>	ใช่	เชือก	สตริงย่อยที่ลงท้ายเพื่อค้นหา

ค่าผลลัพธ์	ประเภท	คำอธิบาย
จริง หรือ เท็จ	บูลีน	แสดงค่าเป็น true เมื่อพบสตริงย่อยที่ลงท้าย ส่งกลับ false เมื่อไม่พบ

ตัวอย่างที่ 1

ตัวอย่างนี้จะตรวจสอบว่าสตริง "hello world" ลงท้ายด้วยสตริง "world"หรือไม่:

endsWith('hello world', 'world')

และแสดงผลลัพธ์นี้: true

ตัวอย่างที่ 2

ตัวอย่างนี้ตรวจสอบว่าสตริง "hello world" ลงท้ายด้วยสตริง "universe"หรือไม่:

endsWith('hello world', 'universe')

และแสดงผลลัพธ์นี้: false

เท่ากับ

ตรวจสอบว่าค่า นิพจน์ หรือวัตถุทั้งสองเท่ากันหรือไม่ ส่งกลับเป็น true เมื่อทั้งสองค่าเทียบเท่ากัน หรือส่งกลับ false เมื่อไม่เทียบเท่ากัน

equals('<object1>', '<object2>')

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
< object1><object2>	ใช่	หลากหลาย	ค่า นิพจน์ หรือวัตถุที่จะเปรียบเทียบ

ค่าผลลัพธ์	ประเภท	คำอธิบาย
จริง หรือ เท็จ	บูลีน	ส่งกลับจริงเมื่อทั้งสองค่าเทียบเท่ากัน ส่งกลับ false เมื่อไม่เทียบเท่า

ตัวอย่าง

ตัวอย่างเหล่านี้ตรวจสอบว่าอินพุตที่ระบุเทียบเท่าหรือไม่

equals(true, 1)
equals('abc', 'abcd')

และส่งกลับผลลัพธ์เหล่านี้:

ตัวอย่างแรก: ค่าทั้งสองจะเทียบเท่ากัน ดังนั้นฟังก์ชันจะแสดง true
ตัวอย่างที่สอง: ค่าทั้งสองไม่เทียบเท่ากัน ดังนั้นฟังก์ชันจะแสดง false

ที่หนึ่ง

แสดงหน่วยข้อมูลแรกจากสตริงหรืออาร์เรย์

first('<collection>')
first([<collection>])

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> คอลเลกชัน <	ใช่	สตริงหรืออาร์เรย์	คอลเลกชันที่จะค้นหารายการแรก

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< > first-collection-item	ใด	รายการแรกในคอลเลกชัน

ตัวอย่าง

ตัวอย่างเหล่านี้ค้นหารายการแรกในคอลเลกชันเหล่านี้:

first('hello')
first(createArray(0, 1, 2))

และส่งกลับผลลัพธ์เหล่านี้:

ตัวอย่างแรก: "h"
ตัวอย่างที่สอง: 0

ลอย

แปลงเวอร์ชันสตริงสําหรับตัวเลขจุดทศนิยมลอยตัวเป็นจํานวนจุดลอยตัวที่แท้จริง

float('<value>')

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ค่า <	ใช่	เชือก	สตริงที่มีตัวเลขทศนิยมลอยตัวที่ถูกต้องที่จะแปลง

ค่าผลลัพธ์	ประเภท	คำอธิบาย
> ค่าลอยตัวของ <	ลอย	เลขจุดทศนิยมลอยตัวสําหรับสตริงที่ระบุ

ตัวอย่าง

ตัวอย่างนี้สร้างเวอร์ชันสตริงสําหรับตัวเลขทศนิยมลอยตัวนี้:

float('10.333')

และแสดงผลลัพธ์นี้: 10.333

formatDateTime

ส่งกลับประทับเวลาในรูปแบบที่ระบุ

formatDateTime('<timestamp>', '<format>'?)

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ประทับเวลา <	ใช่	เชือก	สตริงที่มีประทับเวลา
> รูปแบบ <	ไม่ใช่	เชือก	ตัวระบุรูปแบบเดี่ยว หรือรูปแบบรูปแบบที่กําหนดเอง รูปแบบค่าเริ่มต้นสําหรับประทับเวลาคือ "o" (yyyy-MM-ddTHH:mm:ss.fffffK) ซึ่งสอดคล้องกับ ISO 8601 และรักษาข้อมูลโซนเวลา

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< > ประทับเวลาที่จัดรูปแบบใหม่	เชือก	ประทับเวลาที่อัปเดตในรูปแบบที่ระบุ

ตัวอย่าง

ตัวอย่างนี้แปลงประทับเวลาเป็นรูปแบบที่ระบุ:

formatDateTime('03/15/2018 12:00:00', 'yyyy-MM-ddTHH:mm:ss')

และแสดงผลลัพธ์นี้: "2018-03-15T12:00:00"

getFutureTime

ส่งกลับประทับเวลาปัจจุบันบวกกับหน่วยเวลาที่ระบุ

getFutureTime(<interval>, <timeUnit>, <format>?)

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ช่วงเวลา <	ใช่	จํานวนเต็ม	จํานวนหน่วยเวลาที่ระบุที่จะเพิ่ม
เวลา <>	ใช่	เชือก	หน่วยเวลาที่จะใช้กับช่วง : "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
> รูปแบบ <	ไม่ใช่	เชือก	ตัวระบุรูปแบบเดี่ยว หรือรูปแบบรูปแบบที่กําหนดเอง รูปแบบค่าเริ่มต้นสําหรับประทับเวลาคือ "o" (yyyy-MM-ddTHH:mm:ss.fffffK) ซึ่งสอดคล้องกับ ISO 8601 และรักษาข้อมูลโซนเวลา

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< > ประทับเวลาที่อัปเดตแล้ว	เชือก	ประทับเวลาปัจจุบันบวกกับจํานวนหน่วยเวลาที่ระบุ

ตัวอย่างที่ 1

สมมติว่าประทับเวลาปัจจุบันคือ "2018-03-01T00:00:00.000000Z" ตัวอย่างนี้เพิ่มห้าวันไปยังประทับเวลานั้น:

getFutureTime(5, 'Day')

และแสดงผลลัพธ์นี้: "2018-03-06T00:00:00.0000000Z"

ตัวอย่างที่ 2

สมมติว่าประทับเวลาปัจจุบันคือ "2018-03-01T00:00:00.000000Z" ตัวอย่างนี้เพิ่มห้าวันและแปลงผลลัพธ์เป็นรูปแบบ "D":

getFutureTime(5, 'Day', 'D')

และแสดงผลลัพธ์นี้: "Tuesday, March 6, 2018"

getPastTime

ส่งกลับประทับเวลาปัจจุบันลบหน่วยเวลาที่ระบุ

getPastTime(<interval>, <timeUnit>, <format>?)

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ช่วงเวลา <	ใช่	จํานวนเต็ม	จํานวนหน่วยเวลาที่ระบุที่จะลบ
เวลา <>	ใช่	เชือก	หน่วยเวลาที่จะใช้กับช่วง : "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
> รูปแบบ <	ไม่ใช่	เชือก	ตัวระบุรูปแบบเดี่ยว หรือรูปแบบรูปแบบที่กําหนดเอง รูปแบบค่าเริ่มต้นสําหรับประทับเวลาคือ "o" (yyyy-MM-ddTHH:mm:ss.fffffK) ซึ่งสอดคล้องกับ ISO 8601 และรักษาข้อมูลโซนเวลา

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< > ประทับเวลาที่อัปเดตแล้ว	เชือก	ประทับเวลาปัจจุบันลบจํานวนหน่วยเวลาที่ระบุ

ตัวอย่างที่ 1

สมมติว่าประทับเวลาปัจจุบันคือ "2018-02-01T00:00:00.000000Z" ตัวอย่างนี้ลบห้าวันจากประทับเวลานั้น:

getPastTime(5, 'Day')

และแสดงผลลัพธ์นี้: "2018-01-27T00:00:00.0000000Z"

ตัวอย่างที่ 2

สมมติว่าประทับเวลาปัจจุบันคือ "2018-02-01T00:00:00.000000Z" ตัวอย่างนี้ลบห้าวันและแปลงผลลัพธ์เป็นรูปแบบ "D":

getPastTime(5, 'Day', 'D')

และแสดงผลลัพธ์นี้: "Saturday, January 27, 2018"

มากกว่า

ตรวจสอบว่าค่าแรกมากกว่าค่าที่สองหรือไม่ ส่งกลับเป็น true เมื่อค่าแรกมากกว่า หรือส่งกลับ false เมื่อน้อยกว่า

greater(<value>, <compareTo>)
greater('<value>', '<compareTo>')

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ค่า <	ใช่	จํานวนเต็ม เลขทศนิยม หรือสตริง	ค่าแรกที่จะตรวจสอบว่ามีค่ามากกว่าค่าที่สองหรือไม่
< เปรียบเทียบกับ>	ใช่	จํานวนเต็ม เลขทศนิยม หรือสตริง ตามลําดับ	ค่าการเปรียบเทียบ

ค่าผลลัพธ์	ประเภท	คำอธิบาย
จริง หรือ เท็จ	บูลีน	ส่งกลับเป็น true เมื่อค่าแรกมากกว่าค่าที่สอง ส่งกลับ false เมื่อค่าแรกเท่ากับหรือน้อยกว่าค่าที่สอง

ตัวอย่าง

ตัวอย่างเหล่านี้ตรวจสอบว่าค่าแรกมากกว่าค่าที่สองหรือไม่:

greater(10, 5)
greater('apple', 'banana')

และส่งกลับผลลัพธ์เหล่านี้:

ตัวอย่างแรก: true
ตัวอย่างที่สอง: false

greaterOrEquals

ตรวจสอบว่าค่าแรกมากกว่าหรือเท่ากับค่าที่สองหรือไม่ ส่งกลับเป็น true เมื่อค่าแรกมากกว่าหรือเท่ากับ หรือส่งกลับ false เมื่อค่าแรกน้อยกว่า

greaterOrEquals(<value>, <compareTo>)
greaterOrEquals('<value>', '<compareTo>')

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ค่า <	ใช่	จํานวนเต็ม เลขทศนิยม หรือสตริง	ค่าแรกที่จะตรวจสอบว่ามีค่ามากกว่าหรือเท่ากับค่าที่สองหรือไม่
< เปรียบเทียบกับ>	ใช่	จํานวนเต็ม เลขทศนิยม หรือสตริง ตามลําดับ	ค่าการเปรียบเทียบ

ค่าผลลัพธ์	ประเภท	คำอธิบาย
จริง หรือ เท็จ	บูลีน	ส่งกลับเป็น true เมื่อค่าแรกมากกว่าหรือเท่ากับค่าที่สอง ส่งกลับ false เมื่อค่าแรกน้อยกว่าค่าที่สอง

ตัวอย่าง

ตัวอย่างเหล่านี้ตรวจสอบว่าค่าแรกมากกว่าหรือเท่ากับค่าที่สองหรือไม่:

greaterOrEquals(5, 5)
greaterOrEquals('apple', 'banana')

และส่งกลับผลลัพธ์เหล่านี้:

ตัวอย่างแรก: true
ตัวอย่างที่สอง: false

guid

สร้างตัวระบุที่ไม่ซ้ํากันทั่วโลก (GUID) เป็นสตริง ตัวอย่างเช่น "c2ecc88d-88c8-4096-912c-d6f2e2b138ce":

guid()

นอกจากนี้คุณยังสามารถระบุรูปแบบอื่นสําหรับ GUID นอกเหนือจากรูปแบบเริ่มต้น "D" ซึ่งเป็น 32 หลักที่คั่นด้วยเครื่องหมายยัติภังค์

guid('<format>')

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> รูปแบบ <	ไม่ใช่	เชือก	ตัวระบุรูปแบบ เดียว สําหรับ GUID ที่ส่งกลับมา ตามค่าเริ่มต้น รูปแบบคือ "D" แต่คุณสามารถใช้ "N", "D", "B", "P" หรือ "X" ได้

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< > GUID-value	เชือก	GUID ที่สร้างขึ้นแบบสุ่ม

ตัวอย่าง

ตัวอย่างนี้สร้าง GUID เดียวกัน แต่มีตัวเลข 32 หลัก คั่นด้วยเครื่องหมายยัติภังค์ และล้อมรอบด้วยวงเล็บ:

guid('P')

และแสดงผลลัพธ์นี้: "(c2ecc88d-88c8-4096-912c-d6f2e2b138ce)"

ถ้า

ตรวจสอบว่านิพจน์เป็นจริงหรือเท็จ ส่งกลับค่าที่ระบุ โดยยึดตามผลลัพธ์

if(<expression>, <valueIfTrue>, <valueIfFalse>)

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> นิพจน์ <	ใช่	บูลีน	นิพจน์ที่จะตรวจสอบ
< valueIfTrue>	ใช่	ใด	ค่าที่จะส่งกลับเมื่อนิพจน์เป็นจริง
> valueIfFalse <	ใช่	ใด	ค่าที่จะส่งกลับเมื่อนิพจน์เป็นเท็จ

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< > ค่าผลลัพธ์ที่ระบุ	ใด	ค่าที่ระบุที่แสดงโดยยึดตามว่านิพจน์เป็นจริงหรือเท็จ

ตัวอย่าง

ตัวอย่างนี้ส่งกลับ "yes" เนื่องจากนิพจน์ที่ระบุส่งกลับ true มิฉะนั้น ตัวอย่างจะแสดง "no":

if(equals(1, 1), 'yes', 'no')

indexOf

แสดงค่าตําแหน่งหรือดัชนีเริ่มต้นสําหรับสตริงย่อย ฟังก์ชันนี้ไม่ตรงตามตัวพิมพ์ใหญ่-เล็ก และดัชนีเริ่มต้นด้วยตัวเลข 0

indexOf('<text>', '<searchText>')

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ข้อความ <	ใช่	เชือก	สตริงที่มีสตริงย่อยที่จะค้นหา
< searchText>	ใช่	เชือก	สตริงย่อยที่จะค้นหา

ค่าผลลัพธ์	ประเภท	คำอธิบาย
> ค่าดัชนี <	จํานวนเต็ม	ค่าตําแหน่งหรือดัชนีเริ่มต้นสําหรับสตริงย่อยที่ระบุ ถ้าไม่พบสตริง ให้ส่งกลับตัวเลข -1

ตัวอย่าง

ตัวอย่างนี้ค้นหาค่าดัชนีเริ่มต้นสําหรับสตริงย่อย "world" ในสตริง "hello world":

indexOf('hello world', 'world')

และแสดงผลลัพธ์นี้: 6

int

ส่งกลับเวอร์ชันจํานวนเต็มสําหรับสตริง

int('<value>')

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ค่า <	ใช่	เชือก	สตริงที่จะแปลง

ค่าผลลัพธ์	ประเภท	คำอธิบาย
> ผลลัพธ์จํานวนเต็ม <	จํานวนเต็ม	เวอร์ชันจํานวนเต็มสําหรับสตริงที่ระบุ

ตัวอย่าง

ตัวอย่างนี้สร้างเวอร์ชันจํานวนเต็มสําหรับสตริง "10":

int('10')

และแสดงผลลัพธ์นี้: 10

json

แสดงค่าชนิด JavaScript Object Notation (JSON) หรือออบเจ็กต์สําหรับสตริงหรือ XML

json('<value>')

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ค่า <	ใช่	สตริงหรือ XML	สตริงหรือ XML ที่จะแปลง

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< > ผลลัพธ์ JSON	ชนิดหรือวัตถุดั้งเดิมของ JSON	ค่าหรือออบเจ็กต์ชนิดเนทีฟ JSON สําหรับสตริงหรือ XML ที่ระบุ ถ้าสตริงเป็น null ฟังก์ชันจะส่งกลับวัตถุที่ว่างเปล่า

ตัวอย่างที่ 1

ตัวอย่างนี้แปลงสตริงนี้เป็นค่า JSON:

json('[1, 2, 3]')

และแสดงผลลัพธ์นี้: [1, 2, 3]

ตัวอย่างที่ 2

ตัวอย่างนี้แปลงสตริงนี้เป็น JSON:

json('{"fullName": "Sophia Owen"}')

และแสดงผลลัพธ์ดังนี้:

{
  "fullName": "Sophia Owen"
}

ตัวอย่างที่ 3 ของ 3

ตัวอย่างนี้แปลง XML นี้เป็น JSON:

json(xml('<?xml version="1.0"?> <root> <person id='1'> <name>Sophia Owen</name> <occupation>Engineer</occupation> </person> </root>'))

และแสดงผลลัพธ์ดังนี้:

{
   "?xml": { "@version": "1.0" },
   "root": {
      "person": [ {
         "@id": "1",
         "name": "Sophia Owen",
         "occupation": "Engineer"
      } ]
   }
}

ทางแยก

แสดงคอลเลกชันที่มี เฉพาะ รายการทั่วไปในคอลเลกชันที่ระบุ เมื่อต้องการปรากฏในผลลัพธ์ รายการต้องปรากฏในคอลเลกชันทั้งหมดที่ส่งผ่านไปยังฟังก์ชันนี้ ถ้ารายการอย่างน้อยหนึ่งรายการมีชื่อเดียวกัน หน่วยข้อมูลสุดท้ายที่มีชื่อนั้นจะปรากฏในผลลัพธ์

intersection([<collection1>], [<collection2>], ...)
intersection('<collection1>', '<collection2>', ...)

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
< collection1>, <collection2>, ...	ใช่	อาร์เรย์หรือวัตถุ แต่ไม่ใช่ทั้งสองอย่าง	คอลเลกชันจากตําแหน่งที่คุณต้องการ เท่านั้น รายการทั่วไป

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< > รายการทั่วไป	อาร์เรย์หรือวัตถุ ตามลําดับ	คอลเลกชันที่มีเฉพาะรายการทั่วไปในคอลเลกชันที่ระบุ

ตัวอย่าง

ตัวอย่างนี้ค้นหารายการทั่วไปในอาร์เรย์เหล่านี้:

intersection(createArray(1, 2, 3), createArray(101, 2, 1, 10), createArray(6, 8, 1, 2))

และแสดงอาร์เรย์ที่มี รายการเหล่านี้เท่านั้น: [1, 2]

ต่อ

แสดงสตริงที่มีรายการทั้งหมดจากอาร์เรย์ และมีอักขระแต่ละตัวที่คั่นด้วยตัวคั่น

join([<collection>], '<delimiter>')

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> คอลเลกชัน <	ใช่	อาร์เรย์	อาร์เรย์ที่มีหน่วยข้อมูลที่จะรวม
> ตัวคั่น <	ใช่	เชือก	ตัวคั่นที่ปรากฏระหว่างอักขระแต่ละตัวในสตริงผลลัพธ์

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< char1 ตัวคั่น><><char2 ตัวคั่น><>...	เชือก	สตริงที่เป็นผลลัพธ์ที่สร้างขึ้นจากรายการทั้งหมดในอาร์เรย์ที่ระบุ

ตัวอย่าง

ตัวอย่างนี้สร้างสตริงจากรายการทั้งหมดในอาร์เรย์นี้ด้วยอักขระที่ระบุเป็นตัวคั่น:

join(createArray('a', 'b', 'c'), '.')

และแสดงผลลัพธ์นี้: "a.b.c"

สุดท้าย

ส่งกลับรายการสุดท้ายจากคอลเลกชัน

last('<collection>')
last([<collection>])

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> คอลเลกชัน <	ใช่	สตริงหรืออาร์เรย์	คอลเลกชันที่จะค้นหารายการสุดท้าย

ค่าผลลัพธ์	ประเภท	คำอธิบาย
> รายการสุดท้ายของ <	สตริงหรืออาร์เรย์ ตามลําดับ	รายการสุดท้ายในคอลเลกชัน

ตัวอย่าง

ตัวอย่างเหล่านี้ค้นหารายการสุดท้ายในคอลเลกชันเหล่านี้:

last('abcd')
last(createArray(0, 1, 2, 3))

และส่งกลับผลลัพธ์เหล่านี้:

ตัวอย่างแรก: "d"
ตัวอย่างที่สอง: 3

lastIndexOf

แสดงค่าตําแหน่งหรือดัชนีเริ่มต้นสําหรับการปรากฏครั้งล่าสุดของสตริงย่อย ฟังก์ชันนี้ไม่ตรงตามตัวพิมพ์ใหญ่-เล็ก และดัชนีเริ่มต้นด้วยตัวเลข 0

lastIndexOf('<text>', '<searchText>')

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ข้อความ <	ใช่	เชือก	สตริงที่มีสตริงย่อยที่จะค้นหา
< searchText>	ใช่	เชือก	สตริงย่อยที่จะค้นหา

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< > ค่าดัชนีสิ้นสุด	จํานวนเต็ม	ค่าตําแหน่งหรือดัชนีเริ่มต้นสําหรับการปรากฏครั้งล่าสุดของสตริงย่อยที่ระบุ ถ้าไม่พบสตริง ให้ส่งกลับตัวเลข -1

ตัวอย่าง

ตัวอย่างนี้ค้นหาค่าดัชนีเริ่มต้นสําหรับการปรากฏครั้งล่าสุดของสตริงย่อย "world" ในสตริง "hello world":

lastIndexOf('hello world', 'world')

และแสดงผลลัพธ์นี้: 6

ความยาว

แสดงจํานวนรายการในคอลเลกชัน

length('<collection>')
length([<collection>])

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> คอลเลกชัน <	ใช่	สตริงหรืออาร์เรย์	คอลเลกชันที่มีหน่วยข้อมูลที่จะนับ

ค่าผลลัพธ์	ประเภท	คำอธิบาย
> ความยาวหรือจํานวน <	จํานวนเต็ม	จํานวนรายการในคอลเลกชัน

ตัวอย่าง

ตัวอย่างเหล่านี้นับจํานวนรายการในคอลเลกชันเหล่านี้:

length('abcd')
length(createArray(0, 1, 2, 3))

และส่งกลับผลลัพธ์นี้: 4

น้อยกว่า

ตรวจสอบว่าค่าแรกน้อยกว่าค่าที่สองหรือไม่ ส่งกลับเป็น true เมื่อค่าแรกน้อยกว่า หรือส่งกลับ false เมื่อค่าแรกเป็นมากกว่า

less(<value>, <compareTo>)
less('<value>', '<compareTo>')

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ค่า <	ใช่	จํานวนเต็ม เลขทศนิยม หรือสตริง	ค่าแรกที่จะตรวจสอบว่าน้อยกว่าค่าที่สองหรือไม่
< เปรียบเทียบกับ>	ใช่	จํานวนเต็ม เลขทศนิยม หรือสตริง ตามลําดับ	รายการเปรียบเทียบ

ค่าผลลัพธ์	ประเภท	คำอธิบาย
จริง หรือ เท็จ	บูลีน	ส่งกลับเป็น true เมื่อค่าแรกน้อยกว่าค่าที่สอง ส่งกลับ false เมื่อค่าแรกเท่ากับหรือมากกว่าค่าที่สอง

ตัวอย่าง

ตัวอย่างเหล่านี้ตรวจสอบว่าค่าแรกน้อยกว่าค่าที่สองหรือไม่

less(5, 10)
less('banana', 'apple')

และส่งกลับผลลัพธ์เหล่านี้:

ตัวอย่างแรก: true
ตัวอย่างที่สอง: false

lessOrEquals

ตรวจสอบว่าค่าแรกน้อยกว่าหรือเท่ากับค่าที่สองหรือไม่ ส่งกลับเป็น true เมื่อค่าแรกน้อยกว่าหรือเท่ากับ หรือส่งกลับ false เมื่อค่าแรกมากกว่า

lessOrEquals(<value>, <compareTo>)
lessOrEquals('<value>', '<compareTo>')

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ค่า <	ใช่	จํานวนเต็ม เลขทศนิยม หรือสตริง	ค่าแรกที่จะตรวจสอบว่าน้อยกว่าหรือเท่ากับค่าที่สองหรือไม่
< เปรียบเทียบกับ>	ใช่	จํานวนเต็ม เลขทศนิยม หรือสตริง ตามลําดับ	รายการเปรียบเทียบ

ค่าผลลัพธ์	ประเภท	คำอธิบาย
จริง หรือ เท็จ	บูลีน	ส่งกลับเป็น true เมื่อค่าแรกน้อยกว่าหรือเท่ากับค่าที่สอง ส่งกลับ false เมื่อค่าแรกมากกว่าค่าที่สอง

ตัวอย่าง

ตัวอย่างเหล่านี้ตรวจสอบว่าค่าแรกน้อยกว่าหรือเท่ากับค่าที่สองหรือไม่

lessOrEquals(10, 10)
lessOrEquals('apply', 'apple')

และส่งกลับผลลัพธ์เหล่านี้:

ตัวอย่างแรก: true
ตัวอย่างที่สอง: false

สูง สุด

ส่งกลับค่าสูงสุดจากรายการหรืออาร์เรย์ที่มีตัวเลขรวมอยู่ที่ทั้งสองด้าน

max(<number1>, <number2>, ...)
max([<number1>, <number2>, ...])

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
< number1>, <number2>, ...	ใช่	จํานวนเต็ม เลขทศนิยม หรือทั้งสองอย่าง	ชุดของตัวเลขที่คุณต้องการค่าสูงสุด
[<number1>, <number2>, ...]	ใช่	อาร์เรย์ - จํานวนเต็ม เลขทศนิยม หรือทั้งสองอย่าง	อาร์เรย์ของตัวเลขที่คุณต้องการค่าสูงสุด

ค่าผลลัพธ์	ประเภท	คำอธิบาย
> ค่าสูงสุด <	จํานวนเต็มหรือเลขทศนิยม	ค่าสูงสุดในอาร์เรย์หรือชุดตัวเลขที่ระบุ

ตัวอย่าง

ตัวอย่างเหล่านี้ได้รับค่าสูงสุดจากชุดตัวเลขและอาร์เรย์:

max(1, 2, 3)
max(createArray(1, 2, 3))

และส่งกลับผลลัพธ์นี้: 3

นาที

ส่งกลับค่าต่ําสุดจากชุดตัวเลขหรืออาร์เรย์

min(<number1>, <number2>, ...)
min([<number1>, <number2>, ...])

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
< number1>, <number2>, ...	ใช่	จํานวนเต็ม เลขทศนิยม หรือทั้งสองอย่าง	ชุดของตัวเลขที่คุณต้องการค่าต่ําสุด
[<number1>, <number2>, ...]	ใช่	อาร์เรย์ - จํานวนเต็ม เลขทศนิยม หรือทั้งสองอย่าง	อาร์เรย์ของตัวเลขที่คุณต้องการค่าต่ําสุด

ค่าผลลัพธ์	ประเภท	คำอธิบาย
> ค่าต่ําสุด <	จํานวนเต็มหรือเลขทศนิยม	ค่าต่ําสุดในชุดตัวเลขที่ระบุหรืออาร์เรย์ที่ระบุ

ตัวอย่าง

ตัวอย่างเหล่านี้ได้รับค่าต่ําสุดในชุดของตัวเลขและอาร์เรย์:

min(1, 2, 3)
min(createArray(1, 2, 3))

และส่งกลับผลลัพธ์นี้: 1

มด

ส่งกลับเศษที่เหลือจากการหารตัวเลขสองตัว หากต้องการรับผลลัพธ์จํานวนเต็ม โปรดดู div()

mod(<dividend>, <divisor>)

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> เงินปันผล <	ใช่	จํานวนเต็มหรือเลขทศนิยม	จํานวนที่จะหารด้วย ตัวหาร
> ตัวหาร <	ใช่	จํานวนเต็มหรือเลขทศนิยม	ตัวเลขที่หาร เงินปันผล แต่ไม่สามารถเป็น 0 ได้

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< > ผลลัพธ์มอดุโล	จํานวนเต็มหรือเลขทศนิยม	เศษที่เหลือจากการหารจํานวนแรกด้วยตัวเลขที่สอง

ตัวอย่าง

ตัวอย่างนี้หารตัวเลขแรกด้วยตัวเลขที่สอง:

mod(3, 2)

และส่งกลับผลลัพธ์นี้: 1

mul

ส่งกลับผลคูณจากการคูณตัวเลขสองตัว

mul(<multiplicand1>, <multiplicand2>)

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> < multiplicand1	ใช่	จํานวนเต็มหรือเลขทศนิยม	ตัวเลขที่จะคูณด้วย multiplicand2
> < multiplicand2	ใช่	จํานวนเต็มหรือเลขทศนิยม	จํานวนที่คูณ multiplicand1

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< > ผลลัพธ์ผลิตภัณฑ์	จํานวนเต็มหรือเลขทศนิยม	ผลิตภัณฑ์จากการคูณตัวเลขแรกด้วยตัวเลขที่สอง

ตัวอย่าง

ตัวอย่างเหล่านี้จะคูณตัวเลขแรกด้วยตัวเลขที่สอง:

mul(1, 2)
mul(1.5, 2)

และส่งกลับผลลัพธ์เหล่านี้:

ตัวอย่างแรก: 2
ตัวอย่างที่สอง 3

ไม่

ตรวจสอบว่านิพจน์เป็นเท็จหรือไม่ ส่งกลับเป็น จริง เมื่อนิพจน์เป็น เท็จ หรือส่งกลับ เท็จ เมื่อเป็นจริง

not(<expression>)

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> นิพจน์ <	ใช่	บูลีน	นิพจน์ที่จะตรวจสอบ

ค่าผลลัพธ์	ประเภท	คำอธิบาย
จริง หรือ เท็จ	บูลีน	ส่งกลับเป็น true เมื่อนิพจน์เป็นเท็จ ส่งกลับ เท็จ เมื่อนิพจน์เป็นจริง

ตัวอย่างที่ 1

ตัวอย่างเหล่านี้ตรวจสอบว่านิพจน์ที่ระบุเป็นเท็จหรือไม่:

not(false)
not(true)

และส่งกลับผลลัพธ์เหล่านี้:

ตัวอย่างแรก: นิพจน์เป็น false ดังนั้นฟังก์ชันจึงส่งกลับ true
ตัวอย่างที่สอง: นิพจน์เป็น true ดังนั้นฟังก์ชันจะส่งกลับ false

ตัวอย่างที่ 2

ตัวอย่างเหล่านี้ตรวจสอบว่านิพจน์ที่ระบุเป็นเท็จหรือไม่:

not(equals(1, 2))
not(equals(1, 1))

และส่งกลับผลลัพธ์เหล่านี้:

ตัวอย่างแรก: นิพจน์เป็น false ดังนั้นฟังก์ชันจึงส่งกลับ true
ตัวอย่างที่สอง: นิพจน์เป็น true ดังนั้นฟังก์ชันจะส่งกลับ false

หรือ

ตรวจสอบว่านิพจน์อย่างน้อยหนึ่งรายการเป็นจริงหรือไม่ ส่งกลับเป็น จริง เมื่อนิพจน์อย่างน้อยหนึ่งรายการเป็น จริง หรือส่งกลับ เท็จ เมื่อทั้งสองนิพจน์เป็น เท็จ

or(<expression1>, <expression2>)

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
< expression1>, <expression2>	ใช่	บูลีน	นิพจน์ที่จะตรวจสอบ

ค่าผลลัพธ์	ประเภท	คำอธิบาย
จริง หรือ เท็จ	บูลีน	ส่งกลับเป็น true เมื่อนิพจน์อย่างน้อยหนึ่งรายการเป็นจริง ส่งกลับ เท็จ เมื่อนิพจน์ทั้งสองเป็น เท็จ

ตัวอย่างที่ 1

ตัวอย่างเหล่านี้ตรวจสอบว่านิพจน์อย่างน้อยหนึ่งรายการเป็นจริงหรือไม่:

or(true, false)
or(false, false)

และส่งกลับผลลัพธ์เหล่านี้:

ตัวอย่างแรก: นิพจน์อย่างน้อยหนึ่งรายการเป็นจริง ดังนั้นฟังก์ชันจะส่งกลับ true
ตัวอย่างที่สอง: นิพจน์ทั้งสองเป็น false ดังนั้นฟังก์ชันจะส่งกลับ false

ตัวอย่างที่ 2

or(equals(1, 1), equals(1, 2))
or(equals(1, 2), equals(1, 3))

และส่งกลับผลลัพธ์เหล่านี้:

ตัวอย่างแรก: นิพจน์อย่างน้อยหนึ่งรายการเป็นจริง ดังนั้นฟังก์ชันจะส่งกลับ true
ตัวอย่างที่สอง: นิพจน์ทั้งสองเป็น false ดังนั้นฟังก์ชันจะส่งกลับ false

แรนด์

ส่งกลับจํานวนเต็มแบบสุ่มจากช่วงที่ระบุ ซึ่งรวมเฉพาะที่จุดเริ่มต้นเท่านั้น

rand(<minValue>, <maxValue>)

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> < minValue	ใช่	จํานวนเต็ม	จํานวนเต็มต่ําสุดในช่วง
> maxValue <	ใช่	จํานวนเต็ม	จํานวนเต็มที่อยู่หลังจํานวนเต็มสูงสุดในช่วงที่ฟังก์ชันสามารถส่งกลับได้

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< > ผลลัพธ์แบบสุ่ม	จํานวนเต็ม	จํานวนเต็มสุ่มที่ส่งกลับจากช่วงที่ระบุ

ตัวอย่าง

ตัวอย่างนี้ได้รับจํานวนเต็มแบบสุ่มจากช่วงที่ระบุ โดยไม่รวมค่าสูงสุด:

rand(1, 5)

และแสดงหนึ่งในตัวเลขเหล่านี้เป็นผลลัพธ์: 1, 2, 3หรือ 4

เทือก

ส่งกลับอาร์เรย์จํานวนเต็มที่เริ่มต้นจากจํานวนเต็มที่ระบุ

range(<startIndex>, <count>)

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
< startIndex>	ใช่	จํานวนเต็ม	ค่าจํานวนเต็มที่เริ่มต้นอาร์เรย์เป็นรายการแรก
> จํานวน <	ใช่	จํานวนเต็ม	จํานวนเต็มในอาร์เรย์

ค่าผลลัพธ์	ประเภท	คำอธิบาย
[<range-result>]	อาร์เรย์	อาร์เรย์ที่มีจํานวนเต็มโดยเริ่มต้นจากดัชนีที่ระบุ

ตัวอย่าง

ตัวอย่างนี้สร้างอาร์เรย์จํานวนเต็มที่เริ่มต้นจากดัชนีที่ระบุ และมีจํานวนจํานวนเต็มที่ระบุ:

range(1, 4)

และแสดงผลลัพธ์นี้: [1, 2, 3, 4]

แทน

แทนที่สตริงย่อยด้วยสตริงที่ระบุและแสดงสตริงผลลัพธ์ ฟังก์ชันนี้เป็นแบบไวต่ออักษรใหญ่-เล็ก

replace('<text>', '<oldText>', '<newText>')

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ข้อความ <	ใช่	เชือก	สตริงที่มีสตริงย่อยที่จะแทนที่
< oldText>	ใช่	เชือก	สตริงย่อยที่จะแทนที่
< newText>	ใช่	เชือก	สตริงแทนที่

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< > ข้อความที่อัปเดตแล้ว	เชือก	สตริงที่อัปเดตหลังจากแทนที่สตริงย่อย ถ้าไม่พบสตริงย่อย ให้ส่งกลับสตริงเดิม

ตัวอย่าง

ตัวอย่างนี้ค้นหาสตริงย่อย "old" ใน "สตริงเก่า" และแทนที่ "old" ด้วย "new":

replace('the old string', 'old', 'new')

และแสดงผลลัพธ์นี้: "the new string"

ข้าม

เอารายการออกจากด้านหน้าของคอลเลกชัน และส่งกลับ อื่นๆ ทั้งหมด

skip([<collection>], <count>)

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> คอลเลกชัน <	ใช่	อาร์เรย์	คอลเลกชันที่มีรายการที่คุณต้องการนําออก
> จํานวน <	ใช่	จํานวนเต็ม	จํานวนเต็มบวกสําหรับจํานวนหน่วยข้อมูลที่จะลบออกที่ด้านหน้า

ค่าผลลัพธ์	ประเภท	คำอธิบาย
[<updated-collection>]	อาร์เรย์	คอลเลกชันที่อัปเดตหลังจากเอารายการที่ระบุออก

ตัวอย่าง

ตัวอย่างนี้จะลบหนึ่งรายการ ตัวเลข 0 จากด้านหน้าของอาร์เรย์ที่ระบุ:

skip(createArray(0, 1, 2, 3), 1)

และแสดงอาร์เรย์นี้ด้วยหน่วยข้อมูลที่เหลือ: [1,2,3]

ผ่า

แสดงอาร์เรย์ที่มีสตริงย่อยที่คั่นด้วยเครื่องหมายจุลภาค ตามอักขระตัวคั่นที่ระบุในสตริงต้นฉบับ

split('<text>', '<delimiter>')

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ข้อความ <	ใช่	เชือก	สตริงที่จะแยกเป็นสตริงย่อยตามตัวคั่นที่ระบุในสตริงต้นฉบับ
> ตัวคั่น <	ใช่	เชือก	อักขระในสตริงต้นฉบับที่จะใช้เป็นตัวคั่น

ค่าผลลัพธ์	ประเภท	คำอธิบาย
[<substring1>,<substring2>,...]	อาร์เรย์	อาร์เรย์ที่มีสตริงย่อยจากสตริงเดิม ซึ่งคั่นด้วยเครื่องหมายจุลภาค

ตัวอย่าง

ตัวอย่างนี้สร้างอาร์เรย์ที่มีสตริงย่อยจากสตริงที่ระบุโดยยึดตามอักขระที่ระบุเป็นตัวคั่น:

split('a_b_c', '_')

และแสดงอาร์เรย์นี้เป็นผลลัพธ์: ["a","b","c"]

startOfDay

แสดงจุดเริ่มต้นของวันสําหรับการประทับเวลา

startOfDay('<timestamp>', '<format>'?)

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ประทับเวลา <	ใช่	เชือก	สตริงที่มีประทับเวลา
> รูปแบบ <	ไม่ใช่	เชือก	ตัวระบุรูปแบบเดี่ยว หรือรูปแบบรูปแบบที่กําหนดเอง รูปแบบค่าเริ่มต้นสําหรับประทับเวลาคือ "o" (yyyy-MM-ddTHH:mm:ss.fffffK) ซึ่งสอดคล้องกับ ISO 8601 และรักษาข้อมูลโซนเวลา

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< > ประทับเวลาที่อัปเดตแล้ว	เชือก	ประทับเวลาที่ระบุ แต่เริ่มต้นที่เครื่องหมายศูนย์ชั่วโมงสําหรับวัน

ตัวอย่าง

ตัวอย่างนี้จะค้นหาจุดเริ่มต้นของวันสําหรับการประทับเวลานี้:

startOfDay('2018-03-15T13:30:30Z')

และแสดงผลลัพธ์นี้: "2018-03-15T00:00:00.0000000Z"

startOfHour

แสดงจุดเริ่มต้นของชั่วโมงสําหรับการประทับเวลา

startOfHour('<timestamp>', '<format>'?)

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ประทับเวลา <	ใช่	เชือก	สตริงที่มีประทับเวลา
> รูปแบบ <	ไม่ใช่	เชือก	ตัวระบุรูปแบบเดี่ยว หรือรูปแบบรูปแบบที่กําหนดเอง รูปแบบค่าเริ่มต้นสําหรับประทับเวลาคือ "o" (yyyy-MM-ddTHH:mm:ss.fffffK) ซึ่งสอดคล้องกับ ISO 8601 และรักษาข้อมูลโซนเวลา

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< > ประทับเวลาที่อัปเดตแล้ว	เชือก	ประทับเวลาที่ระบุ แต่เริ่มต้นที่เครื่องหมายศูนย์นาทีสําหรับชั่วโมง

ตัวอย่าง

ตัวอย่างนี้จะค้นหาจุดเริ่มต้นของชั่วโมงสําหรับการประทับเวลานี้:

startOfHour('2018-03-15T13:30:30Z')

และแสดงผลลัพธ์นี้: "2018-03-15T13:00:00.0000000Z"

startOfMonth

ส่งกลับจุดเริ่มต้นของเดือนสําหรับการประทับเวลา

startOfMonth('<timestamp>', '<format>'?)

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ประทับเวลา <	ใช่	เชือก	สตริงที่มีประทับเวลา
> รูปแบบ <	ไม่ใช่	เชือก	ตัวระบุรูปแบบเดี่ยว หรือรูปแบบรูปแบบที่กําหนดเอง รูปแบบค่าเริ่มต้นสําหรับประทับเวลาคือ "o" (yyyy-MM-ddTHH:mm:ss.fffffK) ซึ่งสอดคล้องกับ ISO 8601 และรักษาข้อมูลโซนเวลา

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< > ประทับเวลาที่อัปเดตแล้ว	เชือก	ประทับเวลาที่ระบุ แต่เริ่มต้นในวันแรกของเดือนที่เครื่องหมายศูนย์ชั่วโมง

ตัวอย่าง

ตัวอย่างนี้ส่งกลับจุดเริ่มต้นของเดือนสําหรับประทับเวลานี้:

startOfMonth('2018-03-15T13:30:30Z')

และแสดงผลลัพธ์นี้: "2018-03-01T00:00:00.0000000Z"

startsWith

ตรวจสอบว่าสตริงเริ่มต้นด้วยซับสตริงเฉพาะหรือไม่ ส่งกลับเป็น true เมื่อพบสตริงย่อย หรือส่งกลับ false เมื่อไม่พบ ฟังก์ชันนี้ไม่ตรงตามตัวพิมพ์ใหญ่-เล็ก

startsWith('<text>', '<searchText>')

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ข้อความ <	ใช่	เชือก	สตริงที่จะตรวจสอบ
< searchText>	ใช่	เชือก	สตริงเริ่มต้นในการค้นหา

ค่าผลลัพธ์	ประเภท	คำอธิบาย
จริง หรือ เท็จ	บูลีน	ส่งกลับเป็น true เมื่อพบสตริงย่อยเริ่มต้น ส่งกลับ false เมื่อไม่พบ

ตัวอย่างที่ 1

ตัวอย่างนี้จะตรวจสอบว่าสตริง "hello world" ขึ้นต้นด้วยสตริงย่อย "hello"หรือไม่:

startsWith('hello world', 'hello')

และแสดงผลลัพธ์นี้: true

ตัวอย่างที่ 2

ตัวอย่างนี้จะตรวจสอบว่าสตริง "hello world" เริ่มต้นด้วยสตริงย่อย "ทักทาย" หรือไม่:

startsWith('hello world', 'greetings')

และแสดงผลลัพธ์นี้: false

เชือก

แสดงเวอร์ชันสตริงสําหรับค่า

string(<value>)

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ค่า <	ใช่	ใด	ค่าที่จะแปลง

ค่าผลลัพธ์	ประเภท	คำอธิบาย
> ค่าสตริง <	เชือก	เวอร์ชันสตริงสําหรับค่าที่ระบุ

ตัวอย่างที่ 1

ตัวอย่างนี้สร้างเวอร์ชันสตริงสําหรับตัวเลขนี้:

string(10)

และแสดงผลลัพธ์นี้: "10"

ตัวอย่างที่ 2

ตัวอย่างนี้สร้างสตริงสําหรับวัตถุ JSON ที่ระบุและใช้อักขระเครื่องหมายทับขวา (\) เป็นอักขระเลี่ยงสําหรับเครื่องหมายอัญประกาศคู่ (")

string( { "name": "Sophie Owen" } )

และแสดงผลลัพธ์นี้: "{ \\"name\\": \\"Sophie Owen\\" }"

ย่อย

ส่งกลับผลลัพธ์จากการลบตัวเลขที่สองจากตัวเลขแรก

sub(<minuend>, <subtrahend>)

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ต่ําสุดใน <	ใช่	จํานวนเต็มหรือเลขทศนิยม	ตัวเลขที่จะลบ การลบ
> รายย่อย <	ใช่	จํานวนเต็มหรือเลขทศนิยม	ตัวเลขที่จะลบออกจาก การลบ

ค่าผลลัพธ์	ประเภท	คำอธิบาย
> ผลลัพธ์ <	จํานวนเต็มหรือเลขทศนิยม	ผลลัพธ์จากการลบตัวเลขที่สองออกจากตัวเลขแรก

ตัวอย่าง

ตัวอย่างนี้ลบตัวเลขที่สองออกจากตัวเลขแรก:

sub(10.3, .3)

และแสดงผลลัพธ์นี้: 10

สตริงย่อย

แสดงอักขระจากสตริง โดยเริ่มต้นจากตําแหน่งหรือดัชนีที่ระบุ ค่าดัชนีเริ่มต้นด้วยตัวเลข 0

substring('<text>', <startIndex>, <length>)

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ข้อความ <	ใช่	เชือก	สตริงที่มีอักขระที่คุณต้องการ
< startIndex>	ใช่	จํานวนเต็ม	จํานวนบวกที่เท่ากับหรือมากกว่า 0 ที่คุณต้องการใช้เป็นค่าตําแหน่งเริ่มต้นหรือค่าดัชนี
> ความยาว <	ใช่	จํานวนเต็ม	จํานวนอักขระที่เป็นบวกที่คุณต้องการในสตริงย่อย

ค่าผลลัพธ์	ประเภท	คำอธิบาย
> ผลลัพธ์สตริงย่อย <	เชือก	สตริงย่อยที่มีจํานวนอักขระที่ระบุ โดยเริ่มต้นที่ตําแหน่งดัชนีที่ระบุในสตริงต้นทาง

ตัวอย่าง

ตัวอย่างนี้สร้างสตริงย่อยห้าอักขระจากสตริงที่ระบุ โดยเริ่มต้นจากค่าดัชนี 6:

substring('hello world', 6, 5)

และแสดงผลลัพธ์นี้: "world"

SubtractFromTime

ลบจํานวนหน่วยเวลาจากประทับเวลา ดูเพิ่มเติม รับPastTime

subtractFromTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ประทับเวลา <	ใช่	เชือก	สตริงที่มีประทับเวลา
> ช่วงเวลา <	ใช่	จํานวนเต็ม	จํานวนหน่วยเวลาที่ระบุที่จะลบ
เวลา <>	ใช่	เชือก	หน่วยเวลาที่จะใช้กับช่วง : "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
> รูปแบบ <	ไม่ใช่	เชือก	ตัวระบุรูปแบบเดี่ยว หรือรูปแบบรูปแบบที่กําหนดเอง รูปแบบค่าเริ่มต้นสําหรับประทับเวลาคือ "o" (yyyy-MM-ddTHH:mm:ss.fffffK) ซึ่งสอดคล้องกับ ISO 8601 และรักษาข้อมูลโซนเวลา

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< > ประทับเวลาที่อัปเดตแล้ว	เชือก	ประทับเวลาลบจํานวนหน่วยเวลาที่ระบุ

ตัวอย่างที่ 1

ตัวอย่างนี้จะลบหนึ่งวันจากประทับเวลานี้:

subtractFromTime('2018-01-02T00:00:00Z', 1, 'Day')

และแสดงผลลัพธ์นี้: "2018-01-01T00:00:00:0000000Z"

ตัวอย่างที่ 2

ตัวอย่างนี้จะลบหนึ่งวันจากประทับเวลานี้:

subtractFromTime('2018-01-02T00:00:00Z', 1, 'Day', 'D')

และแสดงผลลัพธ์นี้โดยใช้รูปแบบ "D" ที่เลือกได้: "Monday, January, 1, 2018"

รับ

ส่งกลับรายการจากด้านหน้าของคอลเลกชัน

take('<collection>', <count>)
take([<collection>], <count>)

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> คอลเลกชัน <	ใช่	สตริงหรืออาร์เรย์	คอลเลกชันที่มีรายการที่คุณต้องการ
> จํานวน <	ใช่	จํานวนเต็ม	จํานวนเต็มบวกสําหรับจํานวนหน่วยข้อมูลที่คุณต้องการจากด้านหน้า

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< > ชุดย่อย หรือ [<ชุดย่อย>]	สตริงหรืออาร์เรย์ ตามลําดับ	สตริงหรืออาร์เรย์ที่มีจํานวนรายการที่ระบุ ซึ่งนํามาจากด้านหน้าของคอลเลกชันต้นฉบับ

ตัวอย่าง

ตัวอย่างเหล่านี้ได้รับจํานวนรายการที่ระบุจากด้านหน้าของคอลเลกชันเหล่านี้:

take('abcde', 3)
take(createArray(0, 1, 2, 3, 4), 3)

และส่งกลับผลลัพธ์เหล่านี้:

ตัวอย่างแรก: "abc"
ตัวอย่างที่สอง: [0, 1, 2]

เครื่องหมาย

แสดงค่าคุณสมบัติ ticks สําหรับประทับเวลาที่ระบุ เครื่องหมาย คือช่วงเวลา 100 นาโนวินาที

ticks('<timestamp>')

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ประทับเวลา <	ใช่	เชือก	สตริงสําหรับประทับเวลา

ค่าผลลัพธ์	ประเภท	คำอธิบาย
> ตัวเลขเครื่องหมายขีด <	จํานวนเต็ม	จํานวนของเครื่องหมายที่ผ่านไปตั้งแต่ 12:00:00 เที่ยงคืน วันที่ 1 มกราคม 0001 ในปฏิทินเกรกอเรียนตั้งแต่ประทับเวลาอินพุต

toLower

ส่งกลับสตริงในรูปแบบตัวพิมพ์เล็ก ถ้าอักขระในสตริงไม่มีเวอร์ชันตัวพิมพ์เล็ก อักขระนั้นจะยังคงไม่เปลี่ยนแปลงในสตริงที่ส่งกลับ

toLower('<text>')

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ข้อความ <	ใช่	เชือก	สตริงที่จะส่งกลับในรูปแบบตัวพิมพ์เล็ก

ค่าผลลัพธ์	ประเภท	คำอธิบาย
> ข้อความตัวอักษรพิมพ์เล็ก <	เชือก	สตริงเดิมในรูปแบบตัวพิมพ์เล็ก

ตัวอย่าง

ตัวอย่างนี้แปลงสตริงนี้เป็นตัวพิมพ์เล็ก:

toLower('Hello World')

และแสดงผลลัพธ์นี้: "hello world"

toUpper

ส่งกลับสตริงในรูปแบบตัวพิมพ์ใหญ่ ถ้าอักขระในสตริงไม่มีเวอร์ชันตัวพิมพ์ใหญ่ อักขระนั้นจะยังคงไม่เปลี่ยนแปลงในสตริงที่ส่งกลับ

toUpper('<text>')

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ข้อความ <	ใช่	เชือก	สตริงที่จะส่งกลับในรูปแบบตัวพิมพ์ใหญ่

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< > ข้อความตัวพิมพ์ใหญ่	เชือก	สตริงเดิมในรูปแบบตัวพิมพ์ใหญ่

ตัวอย่าง

ตัวอย่างนี้แปลงสตริงนี้เป็นตัวพิมพ์ใหญ่:

toUpper('Hello World')

และแสดงผลลัพธ์นี้: "HELLO WORLD"

เล็ม

เอาช่องว่างนําหน้าและต่อท้ายออกจากสตริง และส่งกลับสตริงที่อัปเดตแล้ว

trim('<text>')

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ข้อความ <	ใช่	เชือก	สตริงที่มีช่องว่างนําหน้าและต่อท้ายที่จะลบออก

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< อัปเดต> Text	เชือก	เวอร์ชันที่อัปเดตสําหรับสตริงต้นฉบับโดยไม่มีช่องว่างนําหน้าหรือต่อท้าย

ตัวอย่าง

ตัวอย่างนี้จะลบช่องว่างนําหน้าและต่อท้ายออกจากสตริง " Hello World ":

trim(' Hello World  ')

และแสดงผลลัพธ์นี้: "Hello World"

สหภาพ

แสดงคอลเลกชันที่มี รายการทั้งหมดจากคอลเลกชันที่ระบุ เมื่อต้องการปรากฏในผลลัพธ์ รายการสามารถปรากฏในคอลเลกชันใด ๆ ที่ส่งผ่านไปยังฟังก์ชันนี้ ถ้ารายการอย่างน้อยหนึ่งรายการมีชื่อเดียวกัน หน่วยข้อมูลสุดท้ายที่มีชื่อนั้นจะปรากฏในผลลัพธ์

union('<collection1>', '<collection2>', ...)
union([<collection1>], [<collection2>], ...)

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
< collection1>, <collection2>, ...	ใช่	อาร์เรย์หรือวัตถุ แต่ไม่ใช่ทั้งสองอย่าง	คอลเลกชันจากตําแหน่งที่คุณต้องการ รายการทั้งหมด

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< อัปเดต> คอลเลกชัน	อาร์เรย์หรือวัตถุ ตามลําดับ	คอลเลกชันที่มีรายการทั้งหมดจากคอลเลกชันที่ระบุ - ไม่มีรายการที่ซ้ํากัน

ตัวอย่าง

ตัวอย่างนี้ได้รับ รายการจากคอลเลกชันเหล่านี้ทั้งหมด:

union(createArray(1, 2, 3), createArray(1, 2, 10, 101))

และแสดงผลลัพธ์นี้: [1, 2, 3, 10, 101]

uriComponent

แสดงเวอร์ชันเข้ารหัส Uniform Resource Identifier (URI) สําหรับสตริงโดยแทนที่อักขระที่ไม่ปลอดภัย URL ด้วยอักขระหลีก ใช้ฟังก์ชันนี้แทนที่จะ encodeUriComponent() แม้ว่าทั้งสองฟังก์ชันจะทํางานด้วยวิธีเดียวกัน แต่ uriComponent() เป็นสิ่งจําเป็น

uriComponent('<value>')

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ค่า <	ใช่	เชือก	สตริงที่จะแปลงเป็นรูปแบบที่เข้ารหัส URI

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< > เข้ารหัส uri	เชือก	สตริงที่เข้ารหัส URI ที่มีอักขระหลีก

ตัวอย่าง

ตัวอย่างนี้สร้างเวอร์ชันเข้ารหัส URI สําหรับสตริงนี้:

uriComponent('https://contoso.com')

และแสดงผลลัพธ์นี้: "http%3A%2F%2Fcontoso.com"

uriComponentToBinary

ส่งกลับเวอร์ชันไบนารีสําหรับคอมโพเนนต์ Uniform Resource Identifier (URI)

uriComponentToBinary('<value>')

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ค่า <	ใช่	เชือก	สตริงที่เข้ารหัส URI ที่จะแปลง

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< ไบนารีสําหรับ> เข้ารหัส uri	เชือก	เวอร์ชันไบนารีสําหรับสตริงที่เข้ารหัส URI เนื้อหาไบนารีถูกเข้ารหัส base64 และแสดงโดย `$content`

ตัวอย่าง

ตัวอย่างนี้สร้างเวอร์ชันไบนารีสําหรับสตริงที่เข้ารหัส URI นี้:

uriComponentToBinary('http%3A%2F%2Fcontoso.com')

และแสดงผลลัพธ์ดังนี้:

"001000100110100001110100011101000111000000100101001100 11010000010010010100110010010001100010010100110010010001 10011000110110111101101110011101000110111101110011011011 110010111001100011011011110110110100100010"

uriComponentToString

แสดงเวอร์ชันสตริงสําหรับสตริงที่เข้ารหัส Uniform Resource Identifier (URI) ซึ่งเข้ารหัสสตริง URI อย่างมีประสิทธิภาพ

uriComponentToString('<value>')

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ค่า <	ใช่	เชือก	สตริงที่เข้ารหัส URI ที่จะถอดรหัส

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< > ถอดรหัส-uri	เชือก	เวอร์ชันถอดรหัสสําหรับสตริงที่เข้ารหัส URI

ตัวอย่าง

ตัวอย่างนี้สร้างเวอร์ชันสตริงที่ถอดรหัสสําหรับสตริงที่เข้ารหัส URI นี้:

uriComponentToString('http%3A%2F%2Fcontoso.com')

และแสดงผลลัพธ์นี้: "https://contoso.com"

utcNow

ส่งกลับประทับเวลาปัจจุบัน

utcNow('<format>')

อีกทางหนึ่งคือคุณสามารถระบุรูปแบบที่แตกต่างกันด้วยพารามิเตอร์> รูปแบบ <

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> รูปแบบ <	ไม่ใช่	เชือก	ตัวระบุรูปแบบเดี่ยว หรือรูปแบบรูปแบบที่กําหนดเอง รูปแบบค่าเริ่มต้นสําหรับประทับเวลาคือ "o" (yyyy-MM-ddTHH:mm:ss.fffffK) ซึ่งสอดคล้องกับ ISO 8601 และรักษาข้อมูลโซนเวลา

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< > ประทับเวลาปัจจุบัน	เชือก	วันที่และเวลาปัจจุบัน

ตัวอย่างที่ 1

สมมติว่าวันนี้คือ 15 เมษายน 2018 เวลา 13:00:00 PM ตัวอย่างนี้ได้รับประทับเวลาปัจจุบัน:

utcNow()

และแสดงผลลัพธ์นี้: "2018-04-15T13:00:00.0000000Z"

ตัวอย่างที่ 2

สมมติว่าวันนี้คือ 15 เมษายน 2018 เวลา 13:00:00 PM ตัวอย่างนี้ได้รับประทับเวลาปัจจุบันโดยใช้รูปแบบ "D" ที่เลือกได้:

utcNow('D')

และแสดงผลลัพธ์นี้: "Sunday, April 15, 2018"

xml

ส่งกลับเวอร์ชัน XML สําหรับสตริงที่มีออบเจ็กต์ JSON

xml('<value>')

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> ค่า <	ใช่	เชือก	สตริงที่มีวัตถุ JSON ที่จะแปลง ออบเจ็กต์ JSON ต้องมีคุณสมบัติรากเดียวเท่านั้นซึ่งไม่สามารถเป็นอาร์เรย์ได้ ใช้อักขระเครื่องหมายทับขวา (\) เป็นอักขระเลี่ยงสําหรับเครื่องหมายอัญพจท์คู่ (")

ค่าผลลัพธ์	ประเภท	คำอธิบาย
> เวอร์ชัน xml ของ <	วัตถุ	XML ที่เข้ารหัสสําหรับสตริงที่ระบุหรือวัตถุ JSON

ตัวอย่างที่ 1

ตัวอย่างนี้สร้างเวอร์ชัน XML สําหรับสตริงนี้ ซึ่งมีออบเจ็กต์ JSON:

xml(json('{ \"name\": \"Sophia Owen\" }'))

และแสดง XML ผลลัพธ์นี้:

<name>Sophia Owen</name>

ตัวอย่างที่ 2

สมมติว่าคุณมีวัตถุ JSON นี้:

{
  "person": {
    "name": "Sophia Owen",
    "city": "Seattle"
  }
}

ตัวอย่างนี้สร้าง XML สําหรับสตริงที่ประกอบด้วยวัตถุ JSON นี้:

xml(json('{\"person\": {\"name\": \"Sophia Owen\", \"city\": \"Seattle\"}}'))

และแสดง XML ผลลัพธ์นี้:

<person>
  <name>Sophia Owen</name>
  <city>Seattle</city>
<person>

xpath

ตรวจสอบ XML สําหรับโหนดหรือค่าที่ตรงกับนิพจน์ XPath (XML Path Language) และส่งกลับโหนดหรือค่าที่ตรงกัน นิพจน์ XPath หรือเพียงแค่ "XPath" ช่วยให้คุณนําทางโครงสร้างเอกสาร XML เพื่อให้คุณสามารถเลือกโหนดหรือคํานวณค่าในเนื้อหา XML ได้

xpath('<xml>', '<xpath>')

พารามิเตอร์	ต้องระบุ	ประเภท	คำอธิบาย
> xml ของ <	ใช่	ใด	สตริง XML เพื่อค้นหาโหนดหรือค่าที่ตรงกับค่านิพจน์ XPath
> xpath <	ใช่	ใด	นิพจน์ XPath ที่ใช้ในการค้นหาโหนด XML หรือค่าที่ตรงกัน

ค่าผลลัพธ์	ประเภท	คำอธิบาย
< > โหนด xml	XML	โหนด XML เมื่อโหนดเดียวตรงกับนิพจน์ XPath ที่ระบุเท่านั้น
> ค่า <	ใด	ค่าจากโหนด XML เมื่อเฉพาะค่าเดียวตรงกับนิพจน์ XPath ที่ระบุ
[<xml-node1>, <xml-node2>, ...] -or- [<value1>, <value2>, ...]	อาร์เรย์	อาร์เรย์ที่มีโหนด XML หรือค่าที่ตรงกับนิพจน์ XPath ที่ระบุ

ตัวอย่างที่ 1

ตามตัวอย่างที่ 1 ตัวอย่างนี้จะค้นหาโหนดที่ตรงกับโหนด <count></count> และเพิ่มค่าโหนดเหล่านั้นด้วยฟังก์ชัน sum():

xpath(xml(parameters('items')), 'sum(/produce/item/count)')

และแสดงผลลัพธ์นี้: 30

ตัวอย่างที่ 2

สําหรับตัวอย่างนี้ นิพจน์ทั้งสองจะค้นหาโหนดที่ตรงกับโหนด <location></location> ในอาร์กิวเมนต์ที่ระบุ ซึ่งรวมถึง XML ที่มี namespace นิพจน์ใช้อักขระเครื่องหมายทับขวา (\) เป็นอักขระการเลี่ยงสําหรับเครื่องหมายอัญศัพท์คู่ (")

นิพจน์

xpath(xml(body('Http')), '/*[name()=\"file\"]/*[name()=\"location\"]')
นิพจน์ 2

xpath(xml(body('Http')), '/*[local-name()=\"file\" and namespace-uri()=\"http://contoso.com\"]/*[local-name()=\"location\"]')

ต่อไปนี้คืออาร์กิวเมนต์:

XML นี้ซึ่งรวมถึง namespace เอกสาร XML xmlns="http://contoso.com":
```
<?xml version="1.0"?> <file xmlns="http://contoso.com"> <location>Paris</location> </file>
```
นิพจน์ XPath ที่นี่:
- /*[name()=\"file\"]/*[name()=\"location\"]
- /*[local-name()=\"file\" and namespace-uri()=\"http://contoso.com\"]/*[local-name()=\"location\"]

นี่คือโหนดผลลัพธ์ที่ตรงกับโหนด <location></location>:

<location xmlns="https://contoso.com">Paris</location>

ตัวอย่างที่ 3 ของ 3

ตามตัวอย่างที่ 3 ตัวอย่างนี้จะค้นหาค่าในโหนด <location></location>:

xpath(xml(body('Http')), 'string(/*[name()=\"file\"]/*[name()=\"location\"])')

และแสดงผลลัพธ์นี้: "Paris"

โน้ต

ผู้ใช้สามารถเพิ่มข้อคิดเห็นไปยังนิพจน์กระแสข้อมูลได้ แต่ไม่สามารถเพิ่มในนิพจน์ไปป์ไลน์ได้

สําหรับคําแนะนําเกี่ยวกับการใช้พารามิเตอร์ทั่วไป โปรดดูที่ พารามิเตอร์ สําหรับ Data Factory ใน Fabric

แชร์ผ่าน

นิพจน์และฟังก์ชันสําหรับ Data Factory ใน Microsoft Fabric