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

บทความ
12/18/2024

บทความนี้ให้รายละเอียดเกี่ยวกับนิพจน์และฟังก์ชันที่ได้รับการสนับสนุนโดย 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) นิพจน์ like เพื่อทําซ้ํา 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

ตัวอย่างเช่น variable 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	เพิ่มจํานวนนาทีลงในการประทับเวลา
addSeconds	เพิ่มจํานวนวินาทีลงในการประทับเวลา
addToTime	เพิ่มจํานวนหน่วยเวลาลงในการประทับเวลา ดู getFutureTime ด้วยเช่นกัน
แปลง FromUtc	แปลงประทับเวลาจากค่าพิกัดเวลาสากล (UTC) เป็นโซนเวลาเป้าหมาย
convertTimeZone	แปลงประทับเวลาจากโซนเวลาต้นทางเป็นโซนเวลาเป้าหมาย
แปลงเป็น Utc	แปลงประทับเวลาจากโซนเวลาต้นทางเป็นเวลาสากลเชิงพิกัด (UTC)
dayOfMonth	ส่งกลับวันของคอมโพเนนต์เดือนจากประทับเวลา
dayOfWeek	ส่งกลับคอมโพเนนต์วันของสัปดาห์จากประทับเวลา
dayOfYear	ส่งกลับคอมโพเนนต์วันของปีจากประทับเวลา
formatDateTime	ส่งกลับประทับเวลาเป็นสตริงในรูปแบบทางเลือก
getFutureTime	ส่งกลับประทับเวลาปัจจุบันบวกกับหน่วยเวลาที่ระบุ ดูเพิ่มเติมที่ addToTime
getPastTime	ส่งกลับประทับเวลาปัจจุบันลบหน่วยเวลาที่ระบุ ดูลบจากเวลา
startOfDay	แสดงจุดเริ่มต้นของวันสําหรับการประทับเวลา
startOfHour	แสดงจุดเริ่มต้นของชั่วโมงสําหรับการประทับเวลา
startOfMonth	ส่งกลับจุดเริ่มต้นของเดือนสําหรับการประทับเวลา
SubtractFromTime	ลบจํานวนหน่วยเวลาจากประทับเวลา ดู getPastTime ด้วยเช่นกัน
เครื่องหมาย	แสดงค่า `ticks` คุณสมบัติสําหรับการประทับเวลาที่ระบุ
utcNow	ส่งกลับประทับเวลาปัจจุบันเป็นสตริง

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

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

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

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

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

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

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

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

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

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

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

string
integer
ลอยตัว
แบบบูลีน
อาร์ เรย์
พจนานุกรม

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

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

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

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

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

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

เพิ่ม

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

add(<summand_1>, <summand_2>)

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

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

ตัวอย่าง

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

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>'?)

พารามิเตอร์	ต้องมี	ชนิด	คำอธิบาย
<ประทับเวลา>	ใช่	สตริง	สตริงที่มีประทับเวลา
<ช่วง>	ใช่	จำนวนเต็ม	จํานวนหน่วยเวลาที่ระบุที่จะเพิ่ม
<timeUnit>	ใช่	สตริง	หน่วยเวลาที่จะใช้กับ ช่วงเวลา: "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ส่งกลับ

ตัวอย่าง 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ส่งกลับ

อาร์เรย์

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

array('<value>')

พารามิเตอร์	ต้องมี	ชนิด	คำอธิบาย
<ค่า>	ใช่	สตริง	สตริงสําหรับการสร้างอาร์เรย์

ค่าที่ส่งกลับ	ชนิด	คำอธิบาย
[<value>]	อาร์เรย์	อาร์เรย์ ที่มีอินพุตเดี่ยวที่ระบุ

ตัวอย่าง

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

array('hello')

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

base64

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

base64('<value>')

พารามิเตอร์	ต้องมี	ชนิด	คำอธิบาย
<ค่า>	ใช่	สตริง	สตริงอินพุต

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

ตัวอย่าง

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

base64('hello')

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

base64ToBinary

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

base64ToBinary('<value>')

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

ค่าที่ส่งกลับ	ชนิด	คำอธิบาย
<binary-for-base64-string>	สตริง	เวอร์ชันไบนารีสําหรับสตริงที่เข้ารหัส base64

ตัวอย่าง

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

base64ToBinary('aGVsbG8=')

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

"0110000101000111010101100111001101100010010001110011100000111101"

base64ToString

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

base64ToString('<value>')

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

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

ตัวอย่าง

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

base64ToString('aGVsbG8=')

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

ไบ นารี

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

binary('<value>')

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

ค่าที่ส่งกลับ	ชนิด	คำอธิบาย
<binary-for-input-value>	สตริง	เวอร์ชันไบนารีสําหรับสตริงที่ระบุ

ตัวอย่าง

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

binary('hello')

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

"0110100001100101011011000110110001101111"

bool

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

bool(<value>)

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

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

ตัวอย่าง

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

bool(1)
bool(0)

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

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

coalesce

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

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

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

ค่าที่ส่งกลับ	ชนิด	คำอธิบาย
<first-non-null-item>	Any	รายการหรือค่าแรกที่ไม่ใช่ 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>'?)

พารามิเตอร์	ต้องมี	ชนิด	คำอธิบาย
<ประทับเวลา>	ใช่	สตริง	สตริงที่มีประทับเวลา
<destinationTimeZone>	ใช่	สตริง	ชื่อสําหรับโซนเวลาเป้าหมาย สําหรับชื่อโซนเวลา ดู ค่าโซนเวลาของ 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>'?)

พารามิเตอร์	ต้องมี	ชนิด	คำอธิบาย
<ประทับเวลา>	ใช่	สตริง	สตริงที่มีประทับเวลา
<sourceTimeZone>	ใช่	สตริง	ชื่อสําหรับโซนเวลาต้นทาง สําหรับชื่อโซนเวลา ดู ค่าโซนเวลาของ Microsoft แต่คุณอาจต้องลบเครื่องหมายวรรคตอนใดๆ ออกจากชื่อโซนเวลา
<destinationTimeZone>	ใช่	สตริง	ชื่อสําหรับโซนเวลาเป้าหมาย สําหรับชื่อโซนเวลา ดู ค่าโซนเวลาของ 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>'?)

พารามิเตอร์	ต้องมี	ชนิด	คำอธิบาย
<ประทับเวลา>	ใช่	สตริง	สตริงที่มีประทับเวลา
<sourceTimeZone>	ใช่	สตริง	ชื่อสําหรับโซนเวลาต้นทาง สําหรับชื่อโซนเวลา ดู ค่าโซนเวลาของ 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>')

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

ค่าที่ส่งกลับ	ชนิด	คำอธิบาย
<data-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 เพื่อถอดรหัส

ค่าที่ส่งกลับ	ชนิด	คำอธิบาย
<decoded-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>')

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

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

ตัวอย่าง

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

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

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

Div

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

div(<dividend>, <divisor>)

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

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

ตัวอย่าง

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

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

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

encodeUriComponent

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

encodeUriComponent('<value>')

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

ค่าที่ส่งกลับ	ชนิด	คำอธิบาย
<encoded-uri>	สตริง	สตริงที่เข้ารหัส URI ที่มีอักขระหลีก

ตัวอย่าง

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

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

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

empty

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

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

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

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

ตัวอย่าง

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

empty('')
empty('abc')

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

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

endsWith

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

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

พารามิเตอร์	ต้องมี	ชนิด	รายละเอียด
<text>	ใช่	สตริง	สตริงที่จะตรวจสอบ
<searchText>	ใช่	สตริง	สตริงย่อยที่ลงท้ายเพื่อค้นหา

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

ตัวอย่าง 1

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

endsWith('hello world', 'world')

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

ตัวอย่าง 2

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

endsWith('hello world', 'universe')

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

equals

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

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

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

ค่าที่ส่งกลับ	ชนิด	คำอธิบาย
จริง หรือ เท็จ	บูลีน	ส่งกลับจริงเมื่อทั้งสองค่าเทียบเท่ากัน ส่งกลับ false เมื่อไม่เทียบเท่า

ตัวอย่าง

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

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

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

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

ที่หนึ่ง

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

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

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

ค่าที่ส่งกลับ	ชนิด	คำอธิบาย
<first-collection-item>	Any	รายการแรกในคอลเลกชัน

ตัวอย่าง

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

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

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

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

ลอยตัว

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

float('<value>')

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

ค่าที่ส่งกลับ	ชนิด	คำอธิบาย
<ค่าลอยตัว>	Float	เลขจุดทศนิยมลอยตัวสําหรับสตริงที่ระบุ

ตัวอย่าง

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

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>?)

พารามิเตอร์	ต้องมี	ชนิด	คำอธิบาย
<ช่วง>	ใช่	จำนวนเต็ม	จํานวนหน่วยเวลาที่ระบุที่จะเพิ่ม
<timeUnit>	ใช่	สตริง	หน่วยเวลาที่จะใช้กับ ช่วงเวลา: "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>?)

พารามิเตอร์	ต้องมี	ชนิด	คำอธิบาย
<ช่วง>	ใช่	จำนวนเต็ม	จํานวนหน่วยเวลาที่ระบุที่จะลบ
<timeUnit>	ใช่	สตริง	หน่วยเวลาที่จะใช้กับ ช่วงเวลา: "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"

greater

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

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

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

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

ตัวอย่าง

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

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

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

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

greaterOrEquals

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

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

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

ค่าที่ส่งกลับ	ชนิด	คำอธิบาย
<specified-return-value>	Any	ค่าที่ระบุที่แสดงโดยยึดตามว่านิพจน์เป็นจริงหรือเท็จ

ตัวอย่าง

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

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

indexOf

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

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

พารามิเตอร์	ต้องมี	ชนิด	รายละเอียด
<text>	ใช่	สตริง	สตริงที่มีสตริงย่อยที่จะค้นหา
<searchText>	ใช่	สตริง	สตริงย่อยที่จะค้นหา

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

ตัวอย่าง

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

indexOf('hello world', 'world')

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

int

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

int('<value>')

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

ค่าที่ส่งกลับ	ชนิด	คำอธิบาย
<integer-result>	จำนวนเต็ม	เวอร์ชันจํานวนเต็มสําหรับสตริงที่ระบุ

ตัวอย่าง

ตัวอย่างนี้สร้างเวอร์ชันจํานวนเต็มสําหรับสตริง "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

ตัวอย่างนี้แปลง 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-collection-item>	สตริงหรืออาร์เรย์ ตามลําดับ	รายการสุดท้ายในคอลเลกชัน

ตัวอย่าง

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

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

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

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

lastIndexOf

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

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

พารามิเตอร์	ต้องมี	ชนิด	รายละเอียด
<text>	ใช่	สตริง	สตริงที่มีสตริงย่อยที่จะค้นหา
<searchText>	ใช่	สตริง	สตริงย่อยที่จะค้นหา

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

ตัวอย่าง

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

lastIndexOf('hello world', 'world')

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

ความยาว

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

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

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

ค่าที่ส่งกลับ	ชนิด	คำอธิบาย
<length-or-count>	จำนวนเต็ม	จํานวนรายการในคอลเลกชัน

ตัวอย่าง

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

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

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

less

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

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

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

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

ตัวอย่าง

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

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

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

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

lessOrEquals

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

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

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

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

ตัวอย่าง

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

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

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

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

สูง สุด

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

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

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

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

ตัวอย่าง

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

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

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

นาที

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

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

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

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

ตัวอย่าง

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

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

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

mod

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

mod(<dividend>, <divisor>)

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

ค่าที่ส่งกลับ	ชนิด	คำอธิบาย
<modulo-result>	จํานวนเต็มหรือเลขทศนิยม	เศษที่เหลือจากการหารจํานวนแรกด้วยตัวเลขที่สอง

ตัวอย่าง

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

mod(3, 2)

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

mul

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

mul(<multiplicand1>, <multiplicand2>)

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

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

ตัวอย่าง

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

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

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

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

not

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

not(<expression>)

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

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

ตัวอย่าง 1

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

not(false)
not(true)

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

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

ตัวอย่าง 2

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

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

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

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

or

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

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(1, 4)

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

แทนที่

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

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

พารามิเตอร์	ต้องมี	ชนิด	รายละเอียด
<text>	ใช่	สตริง	สตริงที่มีสตริงย่อยที่จะแทนที่
<oldText>	ใช่	สตริง	สตริงย่อยที่จะแทนที่
<newText>	ใช่	สตริง	สตริงแทนที่

ค่าที่ส่งกลับ	ชนิด	คำอธิบาย
<updated-text>	สตริง	สตริงที่อัปเดตหลังจากแทนที่สตริงย่อย ถ้าไม่พบสตริงย่อย ให้ส่งกลับสตริงเดิม

ตัวอย่าง

ตัวอย่างนี้ค้นหาสตริงย่อย "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>')

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

ค่าที่ส่งกลับ	ชนิด	คำอธิบาย
[<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>')

พารามิเตอร์	ต้องมี	ชนิด	รายละเอียด
<text>	ใช่	สตริง	สตริงที่จะตรวจสอบ
<searchText>	ใช่	สตริง	สตริงเริ่มต้นในการค้นหา

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

ตัวอย่าง 1

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

startsWith('hello world', 'hello')

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

ตัวอย่าง 2

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

startsWith('hello world', 'greetings')

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

string

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

string(<value>)

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

ค่าที่ส่งกลับ	ชนิด	คำอธิบาย
<string-value>	สตริง	เวอร์ชันสตริงสําหรับค่าที่ระบุ

ตัวอย่าง 1

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

string(10)

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

ตัวอย่าง 2

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

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

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

sub

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

sub(<minuend>, <subtrahend>)

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

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

ตัวอย่าง

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

sub(10.3, .3)

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

สตริงย่อย

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

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

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

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

ตัวอย่าง

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

substring('hello world', 6, 5)

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

SubtractFromTime

ลบจํานวนหน่วยเวลาจากประทับเวลา ดู getPastTime ด้วยเช่นกัน

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

พารามิเตอร์	ต้องมี	ชนิด	คำอธิบาย
<ประทับเวลา>	ใช่	สตริง	สตริงที่มีประทับเวลา
<ช่วง>	ใช่	จำนวนเต็ม	จํานวนหน่วยเวลาที่ระบุที่จะลบ
<timeUnit>	ใช่	สตริง	หน่วยเวลาที่จะใช้กับ ช่วงเวลา: "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>')

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

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

toLower

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

toLower('<text>')

พารามิเตอร์	ต้องมี	ชนิด	รายละเอียด
<text>	ใช่	สตริง	สตริงที่จะส่งกลับในรูปแบบตัวพิมพ์เล็ก

ค่าที่ส่งกลับ	ชนิด	คำอธิบาย
<lowercase-text>	สตริง	สตริงเดิมในรูปแบบตัวพิมพ์เล็ก

ตัวอย่าง

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

toLower('Hello World')

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

toUpper

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

toUpper('<text>')

พารามิเตอร์	ต้องมี	ชนิด	รายละเอียด
<text>	ใช่	สตริง	สตริงที่จะส่งกลับในรูปแบบตัวพิมพ์ใหญ่

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

ตัวอย่าง

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

toUpper('Hello World')

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

ตัด

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

trim('<text>')

พารามิเตอร์	ต้องมี	ชนิด	รายละเอียด
<text>	ใช่	สตริง	สตริงที่มีช่องว่างนําหน้าและต่อท้ายที่จะลบออก

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

ตัวอย่าง

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

trim(' Hello World  ')

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

สหภาพ

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

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

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

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

ตัวอย่าง

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

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

ค่าที่ส่งกลับ	ชนิด	คำอธิบาย
<encoded-uri>	สตริง	สตริงที่เข้ารหัส URI ที่มีอักขระหลีก

ตัวอย่าง

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

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

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

uriComponentToBinary

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

uriComponentToBinary('<value>')

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

ค่าที่ส่งกลับ	ชนิด	คำอธิบาย
<binary-for-encoded-uri>	สตริง	เวอร์ชันไบนารีสําหรับสตริงที่เข้ารหัส URI เนื้อหาไบนารีคือ base64-encoded และแสดงด้วย`$content`

ตัวอย่าง

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

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

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

"001000100110100001110100011101000111000000100101001100 11010000010010010100110010010001100010010100110010010001 10011000110110111101101110011101000110111101110011011011 110010111001100011011011110110110100100010"

uriComponentToString

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

uriComponentToString('<value>')

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

ค่าที่ส่งกลับ	ชนิด	คำอธิบาย
<decoded-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-version>	ออบเจ็กต์	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>	ใช่	Any	สตริง XML เพื่อค้นหาโหนดหรือค่าที่ตรงกับค่านิพจน์ XPath
<Xpath>	ใช่	Any	นิพจน์ XPath ที่ใช้ในการค้นหาโหนด XML หรือค่าที่ตรงกัน

ค่าที่ส่งกลับ	ชนิด	คำอธิบาย
<xml-node>	XML	โหนด XML เมื่อโหนดเดียวตรงกับนิพจน์ XPath ที่ระบุเท่านั้น
<ค่า>	Any	ค่าจากโหนด 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 นิพจน์ใช้อักขระเครื่องหมายทับขวา (\) เป็นอักขระการเลี่ยงสําหรับเครื่องหมายอัญศัพท์คู่ (")

นิพจน์ 1

xpath(xml(body('Http')), '/*[name()=\"file\"]/*[name()=\"location\"]')
Expression 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 ตัวอย่างนี้จะค้นหาค่าใน <location></location> โหนด:

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

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

หมายเหตุ

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

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

แชร์ผ่าน

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