Ekspresi dan fungsi untuk Data Factory di Microsoft Fabric

Artikel ini menyediakan detail tentang ekspresi dan fungsi yang didukung oleh Data Factory di Microsoft Fabric.

Expressions

Nilai ekspresi dalam definisi dapat berupa literal atau ekspresi yang dievaluasi saat runtime. Contohnya:

"value"

"@pipeline().parameters.password"

Ekspresi dapat muncul di mana saja dalam nilai string dan selalu menghasilkan nilai string lain. Jika nilai adalah ekspresi, isi ekspresi diekstrak dengan menghapus tanda tangan (@). Jika string harfiah diperlukan yang dimulai dengan @, string tersebut harus diloloskan dengan menggunakan @@. Contoh berikut menunjukkan bagaimana ekspresi dievaluasi.

Nilai ekspresi	Result
"parameter"	Karakter 'parameter' dikembalikan.
"parameters[1]"	Karakter 'parameter[1]' dikembalikan.
"@@"	String 1 karakter yang berisi '@' dikembalikan.
" @"	String 2 karakter yang berisi ' @' dikembalikan.

Ekspresi juga dapat muncul di dalam string, menggunakan fitur yang disebut interpolasi string di mana ekspresi dibungkus dalam @{ ... }. Misalnya: "First Name: @{pipeline().parameters.firstName} Last Name: @{pipeline().parameters.lastName}"

Menggunakan interpolasi string, hasilnya selalu merupakan string. Katakanlah saya telah mendefinisikan myNumber sebagai 42 dan myString sebagai foo:

Nilai ekspresi	Result
"@pipeline().parameters.myString"	Mengembalikan `foo` sebagai string.
"@{pipeline().parameters.myString}"	Mengembalikan `foo` sebagai string.
"@pipeline().parameters.myNumber"	Mengembalikan `42` sebagai angka.
"@{pipeline().parameters.myNumber}"	Mengembalikan `42` sebagai string.
"Jawabannya adalah: @{pipeline().parameters.myNumber}"	Mengembalikan string `Answer is: 42`.
"@concat('Jawabannya adalah: ', string(pipeline().parameters.myNumber))"	Mengembalikan string `Answer is: 42`
"Jawabannya adalah: @@{pipeline().parameters.myNumber}"	Mengembalikan string `Answer is: @{pipeline().parameters.myNumber}`.

Dalam aktivitas alur kontrol seperti aktivitas ForEach, Anda dapat menyediakan array yang akan diulang untuk item properti dan digunakan @item() untuk mengulangi satu enumerasi dalam aktivitas ForEach. Misalnya, jika item adalah array: [1, 2, 3], @item() mengembalikan 1 dalam iterasi pertama, 2 di iterasi kedua, dan 3 di iterasi ketiga. Anda juga dapat menggunakan @range(0,10) ekspresi like untuk melakukan iterasi 10 kali dimulai dengan 0 yang diakhir dengan 9.

Anda dapat menggunakan @activity('nama aktivitas') untuk mengambil output aktivitas dan membuat keputusan. Pertimbangkan aktivitas web yang disebut Web1. Untuk menempatkan output aktivitas pertama di isi kedua, ekspresi umumnya terlihat seperti: @activity('Web1').output atau @activity('Web1').output.data atau sesuatu yang serupa tergantung pada output aktivitas pertama.

Examples

Contoh ekspresi kompleks

Contoh di bawah ini menunjukkan contoh kompleks yang mereferensikan sub-bidang output aktivitas yang mendalam. Untuk mereferensikan parameter alur yang mengevaluasi ke sub-bidang, gunakan sintaks [] alih-alih operator dot(.) (seperti dalam kasus subfield1 dan subfield2), sebagai bagian dari output aktivitas.

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

Membuat file secara dinamis dan menamainya adalah pola umum. Mari kita jelajahi beberapa contoh penamaan file dinamis.

Tambahkan Tanggal ke nama file: @concat('Test_', formatDateTime(utcnow(), 'yyyy-dd-MM'))
Tambahkan DateTime dalam zona waktu pelanggan: @concat('Test_', convertFromUtc(utcnow(), 'Pacific Standard Time'))
Tambahkan Waktu Pemicu: @concat('Test_', pipeline().TriggerTime)
Keluarkan nama file kustom dalam Aliran Data Pemetaan saat menghasilkan ke satu file dengan tanggal: 'Test_' + toString(currentDate()) + '.csv'

Dalam kasus di atas, empat nama file dinamis dibuat dimulai dengan Test_.

Editor konten dinamis

Editor konten dinamis secara otomatis meloloskan karakter dalam konten Anda saat Anda selesai mengedit. Misalnya, konten berikut di editor konten adalah interpolasi string dengan fungsi ekspresi.

"@{toUpper('myData')}"

Editor konten dinamis mengonversi konten di atas menjadi ekspresi "@{toUpper('myData')}". Hasil dari ekspresi ini adalah untai (karakter) yang diformat yang ditunjukkan di bawah ini.

"MYDATA"

Mengganti karakter khusus

Editor konten dinamis secara otomatis meloloskan karakter seperti kutipan ganda, garis miring terbelakang dalam konten Anda saat Anda selesai mengedit. Ini menyebabkan masalah jika Anda ingin mengganti umpan baris atau tab dengan menggunakan \n, \t dalam fungsi replace(). Anda dapat mengedit konten dinamis Anda dalam tampilan kode untuk menghapus \ tambahan dalam ekspresi, atau Anda dapat mengikuti langkah-langkah di bawah ini untuk mengganti karakter khusus menggunakan bahasa ekspresi:

Pengodean URL terhadap nilai string asli
Ganti string yang dikodekan URL, misalnya, umpan baris (%0A), pengembalian pengangkutan(%0D), tab horizontal(%09).
Pendekodean URL

Misalnya, variabel companyName dengan karakter baris baru dalam nilainya, ekspresi @uriComponentToString(replace(uriComponent(variables('companyName')), '%0A', '')) dapat menghapus karakter baris baru.

Contoso- Corporation

Melarikan diri karakter kutipan tunggal

Fungsi ekspresi menggunakan tanda kutip tunggal untuk parameter nilai string. Gunakan dua tanda kutip tunggal untuk meloloskan ' karakter dalam fungsi string. Misalnya, ekspresi @concat('Baba', '''s ', 'book store') akan mengembalikan hasil di bawah ini.

Baba's book store

Variabel cakupan alur

Variabel sistem ini dapat dirujuk di mana saja dalam alur.

Nama Variabel	Description
@pipeline().DataFactory	ID ruang kerja yang dijalankan alur berjalan di dalam
@pipeline().Pipeline	ID alur
@pipeline().PipelineName	Nama alur
@pipeline().RunId	ID eksekusi alur tertentu
@pipeline().TriggerId	ID pemicu yang memanggil alur
@pipeline().TriggerName	Nama pemicu yang memanggil alur
@pipeline().TriggerTime	Waktu eksekusi pemicu yang memanggil alur. Ini adalah waktu di mana pemicu benar-benar diaktifkan untuk memanggil eksekusi alur, dan mungkin sedikit berbeda dari waktu terjadwal pemicu.
@pipeline().GroupId	ID grup tempat eksekusi alur berada.
@pipeline()?. TriggeredByPipelineName	Nama alur yang memicu eksekusi alur. Berlaku saat eksekusi alur dipicu oleh aktivitas ExecutePipeline. Evaluasi ke Null saat digunakan dalam keadaan lain. Perhatikan tanda tanya setelah @pipeline()
@pipeline()?. TriggeredByPipelineRunId	Jalankan ID alur yang memicu eksekusi alur. Berlaku saat eksekusi alur dipicu oleh aktivitas ExecutePipeline. Evaluasi ke Null saat digunakan dalam keadaan lain. Perhatikan tanda tanya setelah @pipeline()

Nota

Variabel sistem tanggal/waktu terkait pemicu (dalam cakupan alur dan pemicu) mengembalikan tanggal UTC dalam format ISO 8601, misalnya, 2017-06-01T22:20:00.4061448Z.

Functions

Anda dapat memanggil fungsi dalam ekspresi. Bagian berikut ini menyediakan informasi tentang fungsi yang dapat digunakan dalam ekspresi.

Fungsi tanggal

Fungsi tanggal atau waktu	Task
addDays	Tambahkan sejumlah hari ke tanda waktu.
addHours	Tambahkan sejumlah jam ke tanda waktu.
addMinutes	Tambahkan sejumlah menit ke tanda waktu.
addSeconds	Tambahkan sejumlah detik ke tanda waktu.
addToTime	Tambahkan sejumlah unit waktu ke tanda waktu. Lihat juga getFutureTime.
convertFromUtc	Mengonversi tanda waktu dari Universal Time Coordinated (UTC) ke zona waktu target.
convertTimeZone	Konversi tanda waktu dari zona waktu sumber ke zona waktu target.
convertToUtc	Mengonversi tanda waktu dari zona waktu sumber ke Universal Time Coordinated (UTC).
dayOfMonth	Mengembalikan komponen hari dalam sebulan dari tanda waktu.
dayOfWeek	Mengembalikan komponen hari dalam seminggu dari tanda waktu.
dayOfYear	Mengembalikan komponen hari dalam setahun dari tanda waktu.
formatDateTime	Mengembalikan tanda waktu sebagai string dalam format opsional.
getFutureTime	Mengembalikan tanda waktu saat ini ditambah unit waktu yang ditentukan. Lihat juga addToTime.
getPastTime	Mengembalikan tanda waktu saat ini dikurangi unit waktu yang ditentukan. Lihat juga mengurangiFromTime.
startOfDay	Mengembalikan awal hari untuk tanda waktu.
startOfHour	Mengembalikan awal jam untuk tanda waktu.
startOfMonth	Mengembalikan awal bulan untuk tanda waktu.
subtractFromTime	Kurangi sejumlah unit waktu dari tanda waktu. Lihat juga getPastTime.
kutu	`ticks` Mengembalikan nilai properti untuk tanda waktu tertentu.
utcNow	Mengembalikan tanda waktu saat ini sebagai string.

Fungsi String

Untuk bekerja dengan string, Anda dapat menggunakan fungsi string ini dan juga beberapa fungsi koleksi. Fungsi string hanya berfungsi pada string.

Fungsi string	Task
concat	Gabungkan dua string atau lebih, dan kembalikan string gabungan.
endsWith	Periksa apakah string berakhir dengan substring yang ditentukan.
panduan	Buat pengidentifikasi unik global (GUID) sebagai string.
indexOf	Mengembalikan posisi awal untuk substring.
lastIndexOf	Mengembalikan posisi awal untuk kemunculan terakhir substring.
replace	Ganti substring dengan string yang ditentukan, dan kembalikan string yang diperbarui.
belah	Mengembalikan array yang berisi substring, dipisahkan oleh koma, dari string yang lebih besar berdasarkan karakter pemisah tertentu dalam string asli.
startsWith	Periksa apakah string dimulai dengan substring tertentu.
subrangkaian	Mengembalikan karakter dari string, dimulai dari posisi yang ditentukan.
toLower	Mengembalikan string dalam format huruf kecil.
toUpper	Mengembalikan string dalam format huruf besar.
Trim	Hapus spasi putih di awal dan akhir dari string, dan kembalikan string yang diperbarui.

Fungsi pengumpulan

Untuk bekerja dengan koleksi, umumnya array, string, dan terkadang, kamus, Anda dapat menggunakan fungsi koleksi ini.

Fungsi koleksi	Task
mengandung	Periksa apakah koleksi memiliki item tertentu.
kosong	Periksa apakah koleksi kosong.
pertama	Mengembalikan item pertama dari koleksi.
persimpangan	Mengembalikan koleksi yang hanya memiliki item umum di seluruh koleksi yang ditentukan.
ikat	Mengembalikan string yang memiliki semua item dari array, dipisahkan oleh karakter yang ditentukan.
terakhir	Mengembalikan item terakhir dari koleksi.
panjangnya	Mengembalikan jumlah item dalam string atau array.
lewat	Hapus item dari depan koleksi, dan kembalikan semua item lainnya .
ambil	Mengembalikan item dari depan koleksi.
uni	Mengembalikan koleksi yang memiliki semua item dari koleksi yang ditentukan.

Fungsi logika

Fungsi-fungsi ini berguna dalam kondisi, mereka dapat digunakan untuk mengevaluasi semua jenis logika.

Fungsi perbandingan logis	Task
dan	Periksa apakah semua ekspresi benar.
Sama	Periksa apakah kedua nilai tersebut setara.
lebih	Periksa apakah nilai pertama lebih besar dari nilai kedua.
greaterOrEquals	Periksa apakah nilai pertama lebih besar dari atau sama dengan nilai kedua.
if	Periksa apakah ekspresi benar atau salah. Berdasarkan hasilnya, kembalikan nilai yang ditentukan.
kurang	Periksa apakah nilai pertama kurang dari nilai kedua.
lessOrEquals	Periksa apakah nilai pertama kurang dari atau sama dengan nilai kedua.
Tidak	Periksa apakah ekspresi salah.
atau	Periksa apakah setidaknya satu ekspresi benar.

Fungsi konversi

Fungsi-fungsi ini digunakan untuk mengonversi antara masing-masing jenis asli dalam bahasa:

string
bilangan bulat
float
Boolean
Array
Kamus

Fungsi konversi	Task
array	Mengembalikan array dari satu input yang ditentukan. Untuk beberapa input, lihat createArray.
base64	Mengembalikan versi yang dikodekan base64 untuk string.
base64ToBinary	Mengembalikan versi biner untuk string yang dikodekan base64.
base64ToString	Mengembalikan versi string untuk string yang dikodekan base64.
biner	Mengembalikan versi biner untuk nilai input.
bool	Mengembalikan versi Boolean untuk nilai input.
coalesce	Mengembalikan nilai non-null pertama dari satu atau beberapa parameter.
createArray	Mengembalikan array dari beberapa input.
dataUri	Mengembalikan URI data untuk nilai input.
dataUriToBinary	Mengembalikan versi biner untuk URI data.
dataUriToString	Mengembalikan versi string untuk URI data.
decodeBase64	Mengembalikan versi string untuk string yang dikodekan base64.
decodeDataUri	Mengembalikan versi biner untuk URI data.
decodeUriComponent	Mengembalikan string yang menggantikan karakter escape dengan versi yang didekodekan.
encodeUriComponent	Mengembalikan string yang menggantikan karakter URL-tidak aman dengan karakter escape.
float	Mengembalikan angka titik mengambang untuk nilai input.
int	Mengembalikan versi bilangan bulat untuk string.
string	Mengembalikan versi string untuk nilai input.
uriComponent	Mengembalikan versi yang dikodekan URI untuk nilai input dengan mengganti karakter URL yang tidak aman dengan karakter escape.
uriComponentToBinary	Mengembalikan versi biner untuk string yang dikodekan URI.
uriComponentToString	Mengembalikan versi string untuk string yang dikodekan URI.
xml	Mengembalikan versi XML untuk string.
jalur x	Periksa XML untuk simpul atau nilai yang cocok dengan ekspresi XPath (Bahasa Jalur XML), dan kembalikan simpul atau nilai yang cocok.

Fungsi matematika

Fungsi-fungsi ini dapat digunakan untuk salah satu jenis angka: bilangan bulat dan float.

Fungsi matematika	Task
add	Mengembalikan hasil dari menambahkan dua angka.
Div	Mengembalikan hasil dari pembagian dua angka.
Maksimum	Mengembalikan nilai tertinggi dari sekumpulan angka atau array.
mnt	Mengembalikan nilai terendah dari sekumpulan angka atau array.
Mod	Mengembalikan sisa dari pembagian dua angka.
mul	Mengembalikan produk dari mengalikan dua angka.
Rand	Mengembalikan bilangan bulat acak dari rentang tertentu.
lingkup	Mengembalikan array bilangan bulat yang dimulai dari bilangan bulat tertentu.
Sub	Mengembalikan hasil dari mengurangi angka kedua dari angka pertama.

Referensi fungsi

Bagian ini mencantumkan semua fungsi yang tersedia dalam urutan alfabet.

add

Mengembalikan hasil dari menambahkan dua angka.

add(<summand_1>, <summand_2>)

Pengaturan	Diperlukan	Tipe	Description
< >summand_1, <summand_2>	Yes	Bilangan bulat, Float, atau campuran	Angka yang akan ditambahkan

Mengembalikan nilai	Tipe	Description
< jumlah hasil>	Bilangan bulat atau Float	Hasil dari menambahkan angka yang ditentukan

Example

Contoh ini menambahkan angka yang ditentukan:

add(1, 1.5)

Dan mengembalikan hasil ini: 2.5

addDays

Tambahkan sejumlah hari ke tanda waktu.

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

Pengaturan	Diperlukan	Tipe	Description
< Timestamp>	Yes	String	String yang berisi tanda waktu
< Hari>	Yes	Integer	Jumlah hari positif atau negatif untuk ditambahkan
< Format>	Tidak.	String	Penentu format tunggal atau pola format kustom. Format default untuk tanda waktu adalah "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), yang mematuhi ISO 8601 dan mempertahankan informasi zona waktu.

Mengembalikan nilai	Tipe	Description
< tanda waktu yang diperbarui>	String	Tanda waktu ditambah jumlah hari yang ditentukan

Contoh 1

Contoh ini menambahkan 10 hari ke tanda waktu yang ditentukan:

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

Dan mengembalikan hasil ini: "2018-03-25T00:00:0000000Z"

Contoh 2

Contoh ini mengurangi lima hari dari tanda waktu yang ditentukan:

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

Dan mengembalikan hasil ini: "2018-03-10T00:00:0000000Z"

addHours

Tambahkan sejumlah jam ke tanda waktu.

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

Pengaturan	Diperlukan	Tipe	Description
< Timestamp>	Yes	String	String yang berisi tanda waktu
< Jam>	Yes	Integer	Jumlah jam positif atau negatif untuk ditambahkan
< Format>	Tidak.	String	Penentu format tunggal atau pola format kustom. Format default untuk tanda waktu adalah "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), yang mematuhi ISO 8601 dan mempertahankan informasi zona waktu.

Mengembalikan nilai	Tipe	Description
< tanda waktu yang diperbarui>	String	Tanda waktu ditambah jumlah jam yang ditentukan

Contoh 1

Contoh ini menambahkan 10 jam ke tanda waktu yang ditentukan:

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

Dan mengembalikan hasil ini: "2018-03-15T10:00:0000000Z"

Contoh 2

Contoh ini mengurangi lima jam dari tanda waktu yang ditentukan:

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

Dan mengembalikan hasil ini: "2018-03-15T10:00:0000000Z"

addMinutes

Tambahkan sejumlah menit ke tanda waktu.

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

Pengaturan	Diperlukan	Tipe	Description
< Timestamp>	Yes	String	String yang berisi tanda waktu
< Menit>	Yes	Integer	Jumlah menit positif atau negatif untuk ditambahkan
< Format>	Tidak.	String	Penentu format tunggal atau pola format kustom. Format default untuk tanda waktu adalah "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), yang mematuhi ISO 8601 dan mempertahankan informasi zona waktu.

Mengembalikan nilai	Tipe	Description
< tanda waktu yang diperbarui>	String	Tanda waktu ditambah jumlah menit yang ditentukan

Contoh 1

Contoh ini menambahkan 10 menit ke tanda waktu yang ditentukan:

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

Dan mengembalikan hasil ini: "2018-03-15T00:20:00.0000000Z"

Contoh 2

Contoh ini mengurangi lima menit dari tanda waktu yang ditentukan:

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

Dan mengembalikan hasil ini: "2018-03-15T00:15:00.0000000Z"

addSeconds

Tambahkan sejumlah detik ke tanda waktu.

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

Pengaturan	Diperlukan	Tipe	Description
< Timestamp>	Yes	String	String yang berisi tanda waktu
< Detik>	Yes	Integer	Jumlah detik positif atau negatif untuk ditambahkan
< Format>	Tidak.	String	Penentu format tunggal atau pola format kustom. Format default untuk tanda waktu adalah "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), yang mematuhi ISO 8601 dan mempertahankan informasi zona waktu.

Mengembalikan nilai	Tipe	Description
< tanda waktu yang diperbarui>	String	Tanda waktu ditambah jumlah detik yang ditentukan

Contoh 1

Contoh ini menambahkan 10 detik ke tanda waktu yang ditentukan:

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

Dan mengembalikan hasil ini: "2018-03-15T00:00:10.0000000Z"

Contoh 2

Contoh ini mengurangi lima detik ke tanda waktu yang ditentukan:

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

Dan mengembalikan hasil ini: "2018-03-15T00:00:25.0000000Z"

addToTime

Tambahkan sejumlah unit waktu ke tanda waktu. Lihat juga getFutureTime().

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

Pengaturan	Diperlukan	Tipe	Description
< Timestamp>	Yes	String	String yang berisi tanda waktu
< Interval>	Yes	Integer	Jumlah unit waktu yang ditentukan untuk ditambahkan
< satuan waktu>	Yes	String	Unit waktu yang digunakan dengan interval: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
< Format>	Tidak.	String	Penentu format tunggal atau pola format kustom. Format default untuk tanda waktu adalah "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), yang mematuhi ISO 8601 dan mempertahankan informasi zona waktu.

Mengembalikan nilai	Tipe	Description
< tanda waktu yang diperbarui>	String	Tanda waktu ditambah jumlah unit waktu yang ditentukan

Contoh 1

Contoh ini menambahkan satu hari ke tanda waktu yang ditentukan:

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

Dan mengembalikan hasil ini: "2018-01-02T00:00:00.0000000Z"

Contoh 2

Contoh ini menambahkan satu hari ke tanda waktu yang ditentukan:

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

Dan mengembalikan hasilnya menggunakan format "D" opsional: "Tuesday, January 2, 2018"

dan

Periksa apakah kedua ekspresi tersebut benar. Kembalikan true ketika kedua ekspresi benar, atau kembalikan false ketika setidaknya satu ekspresi salah.

and(<expression1>, <expression2>)

Pengaturan	Diperlukan	Tipe	Description
< expression1>, <expression2>	Yes	Boolean	Ekspresi yang akan diperiksa

Mengembalikan nilai	Tipe	Description
BENAR atau SALAH	Boolean	Mengembalikan true saat kedua ekspresi benar. Mengembalikan false ketika setidaknya satu ekspresi salah.

Contoh 1

Contoh-contoh ini memeriksa apakah nilai Boolean yang ditentukan keduanya benar:

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

Dan mengembalikan hasil ini:

Contoh pertama: Kedua ekspresi adalah true, jadi mengembalikan true.
Contoh kedua: Satu ekspresi salah, jadi mengembalikan false.
Contoh ketiga: Kedua ekspresi adalah false, jadi mengembalikan false.

Contoh 2

Contoh-contoh ini memeriksa apakah ekspresi yang ditentukan keduanya benar:

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

Dan mengembalikan hasil ini:

Contoh pertama: Kedua ekspresi adalah true, jadi mengembalikan true.
Contoh kedua: Satu ekspresi salah, jadi mengembalikan false.
Contoh ketiga: Kedua ekspresi adalah false, jadi mengembalikan false.

array

Mengembalikan array dari satu input yang ditentukan. Untuk beberapa input, lihat createArray().

array('<value>')

Pengaturan	Diperlukan	Tipe	Description
< nilai>	Yes	String	String untuk membuat array

Mengembalikan nilai	Tipe	Description
[<nilai>]	Array	Array yang berisi input tunggal yang ditentukan

Example

Contoh ini membuat array dari string "hello":

array('hello')

Dan mengembalikan hasil ini: ["hello"]

base64

Mengembalikan versi yang dikodekan base64 untuk string.

base64('<value>')

Pengaturan	Diperlukan	Tipe	Description
< nilai>	Yes	String	String input

Mengembalikan nilai	Tipe	Description
< base64-string>	String	Versi yang dikodekan base64 untuk string input

Example

Contoh ini mengonversi string "hello" menjadi string yang dikodekan base64:

base64('hello')

Dan mengembalikan hasil ini: "aGVsbG8="

base64ToBinary

Mengembalikan versi biner untuk string yang dikodekan base64.

base64ToBinary('<value>')

Pengaturan	Diperlukan	Tipe	Description
< nilai>	Yes	String	String yang dikodekan base64 untuk dikonversi

Mengembalikan nilai	Tipe	Description
< biner-for-base64-string>	String	Versi biner untuk string yang dikodekan base64

Example

Contoh ini mengonversi string yang dikodekan base64 "aGVsbG8=" menjadi string biner:

base64ToBinary('aGVsbG8=')

Dan mengembalikan hasil ini:

"0110000101000111010101100111001101100010010001110011100000111101"

base64ToString

Mengembalikan versi string untuk string yang dikodekan base64, secara efektif mendekode string base64. Gunakan fungsi ini daripada dekodeBase64(). Meskipun kedua fungsi bekerja dengan cara yang sama, base64ToString() lebih disukai.

base64ToString('<value>')

Pengaturan	Diperlukan	Tipe	Description
< nilai>	Yes	String	String yang dikodekan base64 untuk didekodekan

Mengembalikan nilai	Tipe	Description
< decoded-base64-string>	String	Versi string untuk string yang dikodekan base64

Example

Contoh ini mengonversi string yang dikodekan base64 "aGVsbG8=" menjadi hanya string:

base64ToString('aGVsbG8=')

Dan mengembalikan hasil ini: "hello"

biner

Mengembalikan versi biner untuk string.

binary('<value>')

Pengaturan	Diperlukan	Tipe	Description
< nilai>	Yes	String	String yang akan dikonversi

Mengembalikan nilai	Tipe	Description
< biner-untuk-nilai-input>	String	Versi biner untuk string yang ditentukan

Example

Contoh ini mengonversi string "hello" menjadi string biner:

binary('hello')

Dan mengembalikan hasil ini:

"0110100001100101011011000110110001101111"

bool

Mengembalikan versi Boolean untuk nilai.

bool(<value>)

Pengaturan	Diperlukan	Tipe	Description
< nilai>	Yes	Apa saja	Nilai yang akan dikonversi

Mengembalikan nilai	Tipe	Description
BENAR atau SALAH	Boolean	Versi Boolean untuk nilai yang ditentukan

Example

Contoh-contoh ini mengonversi nilai yang ditentukan menjadi nilai Boolean:

bool(1)
bool(0)

Dan mengembalikan hasil ini:

Contoh pertama: true
Contoh kedua: false

gabungkan

Mengembalikan nilai non-null pertama dari satu atau beberapa parameter. String kosong, array kosong, dan objek kosong tidak null.

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

Pengaturan	Diperlukan	Tipe	Description
< >object_1, <object_2>, ...	Yes	Apa pun, dapat mencampur jenis	Satu atau beberapa item untuk diperiksa null

Mengembalikan nilai	Tipe	Description
< item pertama-non-null>	Apa saja	Item atau nilai pertama yang tidak null. Jika semua parameter null, fungsi ini mengembalikan null.

Example

Contoh-contoh ini mengembalikan nilai non-null pertama dari nilai yang ditentukan, atau null ketika semua nilai null:

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

Dan mengembalikan hasil ini:

Contoh pertama: true
Contoh kedua: "hello"
Contoh ketiga: null

concat

Gabungkan dua string atau lebih, dan kembalikan string gabungan.

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

Pengaturan	Diperlukan	Tipe	Description
< teks1>, <teks2>, ...	Yes	String	Setidaknya dua string untuk digabungkan

Mengembalikan nilai	Tipe	Description
< teks1teks2...>	String	String yang dibuat dari string input gabungan

Example

Contoh ini menggabungkan string "Hello" dan "World":

concat('Hello', 'World')

Dan mengembalikan hasil ini: "HelloWorld"

mengandung

Periksa apakah koleksi memiliki item tertentu. Kembalikan true ketika item ditemukan, atau kembalikan false ketika tidak ditemukan. Fungsi ini peka huruf besar/kecil.

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

Secara khusus, fungsi ini berfungsi pada jenis koleksi ini:

String untuk menemukan substring
Array untuk menemukan nilai
Kamus untuk menemukan kunci

Pengaturan	Diperlukan	Tipe	Description
< koleksi>	Yes	String, Array, atau Kamus	Koleksi yang akan diperiksa
< nilai>	Yes	String, Array, atau Kamus, masing-masing	Item yang akan ditemukan

Mengembalikan nilai	Tipe	Description
BENAR atau SALAH	Boolean	Mengembalikan true saat item ditemukan. Mengembalikan false ketika tidak ditemukan.

Contoh 1

Contoh ini memeriksa string "hello world" untuk substring "world" dan mengembalikan true:

contains('hello world', 'world')

Contoh 2

Contoh ini memeriksa string "hello world" untuk substring "universe" dan mengembalikan false:

contains('hello world', 'universe')

convertFromUtc

Mengonversi tanda waktu dari Universal Time Coordinated (UTC) ke zona waktu target.

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

Pengaturan	Diperlukan	Tipe	Description
< Timestamp>	Yes	String	String yang berisi tanda waktu
< destinationTimeZone>	Yes	String	Nama untuk zona waktu target. Untuk nama zona waktu, lihat Nilai Zona Waktu Microsoft, tetapi Anda mungkin harus menghapus tanda baca apa pun dari nama zona waktu.
< Format>	Tidak.	String	Penentu format tunggal atau pola format kustom. Format default untuk tanda waktu adalah "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), yang mematuhi ISO 8601 dan mempertahankan informasi zona waktu.

Mengembalikan nilai	Tipe	Description
< tanda waktu terkonversi>	String	Tanda waktu dikonversi ke zona waktu target

Contoh 1

Contoh ini mengonversi tanda waktu ke zona waktu yang ditentukan:

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

Dan mengembalikan hasil ini: "2018-01-01T00:00:00Z"

Contoh 2

Contoh ini mengonversi tanda waktu ke zona waktu dan format yang ditentukan:

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

Dan mengembalikan hasil ini: "Monday, January 1, 2018"

convertTimeZone

Konversi tanda waktu dari zona waktu sumber ke zona waktu target.

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

Pengaturan	Diperlukan	Tipe	Description
< Timestamp>	Yes	String	String yang berisi tanda waktu
< sumberZona Waktu>	Yes	String	Nama untuk zona waktu sumber. Untuk nama zona waktu, lihat Nilai Zona Waktu Microsoft, tetapi Anda mungkin harus menghapus tanda baca apa pun dari nama zona waktu.
< destinationTimeZone>	Yes	String	Nama untuk zona waktu target. Untuk nama zona waktu, lihat Nilai Zona Waktu Microsoft, tetapi Anda mungkin harus menghapus tanda baca apa pun dari nama zona waktu.
< Format>	Tidak.	String	Penentu format tunggal atau pola format kustom. Format default untuk tanda waktu adalah "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), yang mematuhi ISO 8601 dan mempertahankan informasi zona waktu.

Mengembalikan nilai	Tipe	Description
< tanda waktu terkonversi>	String	Tanda waktu dikonversi ke zona waktu target

Contoh 1

Contoh ini mengonversi zona waktu sumber ke zona waktu target:

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

Dan mengembalikan hasil ini: "2018-01-01T00:00:00.0000000"

Contoh 2

Contoh ini mengonversi zona waktu ke zona waktu dan format yang ditentukan:

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

Dan mengembalikan hasil ini: "Monday, January 1, 2018"

convertToUtc

Mengonversi tanda waktu dari zona waktu sumber ke Universal Time Coordinated (UTC).

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

Pengaturan	Diperlukan	Tipe	Description
< Timestamp>	Yes	String	String yang berisi tanda waktu
< sumberZona Waktu>	Yes	String	Nama untuk zona waktu sumber. Untuk nama zona waktu, lihat Nilai Zona Waktu Microsoft, tetapi Anda mungkin harus menghapus tanda baca apa pun dari nama zona waktu.
< Format>	Tidak.	String	Penentu format tunggal atau pola format kustom. Format default untuk tanda waktu adalah "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), yang mematuhi ISO 8601 dan mempertahankan informasi zona waktu.

Mengembalikan nilai	Tipe	Description
< tanda waktu terkonversi>	String	Tanda waktu dikonversi ke UTC

Contoh 1

Contoh ini mengonversi tanda waktu ke UTC:

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

Dan mengembalikan hasil ini: "2018-01-01T08:00:00.0000000Z"

Contoh 2

Contoh ini mengonversi tanda waktu ke UTC:

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

Dan mengembalikan hasil ini: "Monday, January 1, 2018"

createArray

Mengembalikan array dari beberapa input. Untuk array input tunggal, lihat array().

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

Pengaturan	Diperlukan	Tipe	Description
< objek1>, <objek2>, ...	Yes	Apa pun, tetapi tidak dicampur	Setidaknya dua item untuk membuat array

Mengembalikan nilai	Tipe	Description
[<objek1>, <objek2>, ...]	Array	Array yang dibuat dari semua item input

Example

Contoh ini membuat array dari input ini:

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

Dan mengembalikan hasil ini: ["h", "e", "l", "l", "o"]

dataUri

Mengembalikan pengidentifikasi sumber daya seragam data (URI) untuk string.

dataUri('<value>')

Pengaturan	Diperlukan	Tipe	Description
< nilai>	Yes	String	String yang akan dikonversi

Mengembalikan nilai	Tipe	Description
< URI data>	String	URI data untuk string input

Example

Contoh ini membuat URI data untuk string "hello":

dataUri('hello')

Dan mengembalikan hasil ini: "data:text/plain;charset=utf-8;base64,aGVsbG8="

dataUriToBinary

Mengembalikan versi biner untuk pengidentifikasi sumber daya seragam data (URI). Gunakan fungsi ini daripada decodeDataUri(). Meskipun kedua fungsi bekerja dengan cara yang sama, dataUriBinary() lebih disukai.

dataUriToBinary('<value>')

Pengaturan	Diperlukan	Tipe	Description
< nilai>	Yes	String	URI data yang akan dikonversi

Mengembalikan nilai	Tipe	Description
< biner-untuk-data-uri>	String	Versi biner untuk URI data

Example

Contoh ini membuat versi biner untuk URI data ini:

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

Dan mengembalikan hasil ini:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

dataUriToString

Mengembalikan versi string untuk pengidentifikasi sumber daya seragam data (URI).

dataUriToString('<value>')

Pengaturan	Diperlukan	Tipe	Description
< nilai>	Yes	String	URI data yang akan dikonversi

Mengembalikan nilai	Tipe	Description
< string-for-data-uri>	String	Versi string untuk URI data

Example

Contoh ini membuat string untuk URI data ini:

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

Dan mengembalikan hasil ini: "hello"

dayOfMonth

Mengembalikan hari dalam sebulan dari tanda waktu.

dayOfMonth('<timestamp>')

Pengaturan	Diperlukan	Tipe	Description
< Timestamp>	Yes	String	String yang berisi tanda waktu

Mengembalikan nilai	Tipe	Description
< hari dalam sebulan>	Integer	Hari dalam sebulan dari tanda waktu yang ditentukan

Example

Contoh ini mengembalikan angka untuk hari dalam sebulan dari tanda waktu ini:

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

Dan mengembalikan hasil ini: 15

hariDalamMinggu

Mengembalikan hari dalam seminggu dari tanda waktu.

dayOfWeek('<timestamp>')

Pengaturan	Diperlukan	Tipe	Description
< Timestamp>	Yes	String	String yang berisi tanda waktu

Mengembalikan nilai	Tipe	Description
< hari dalam seminggu>	Integer	Hari dalam seminggu dari tanda waktu yang ditentukan di mana Hari Minggu adalah 0, Senin adalah 1, dan sebagainya

Example

Contoh ini mengembalikan angka untuk hari dalam seminggu dari tanda waktu ini:

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

Dan mengembalikan hasil ini: 3

dayOfYear

Mengembalikan hari dalam setahun dari tanda waktu.

dayOfYear('<timestamp>')

Pengaturan	Diperlukan	Tipe	Description
< Timestamp>	Yes	String	String yang berisi tanda waktu

Mengembalikan nilai	Tipe	Description
< hari dalam setahun>	Integer	Hari dalam setahun dari tanda waktu yang ditentukan

Example

Contoh ini mengembalikan jumlah hari dalam setahun dari tanda waktu ini:

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

Dan mengembalikan hasil ini: 74

decodeBase64

Mengembalikan versi string untuk string yang dikodekan base64, secara efektif mendekode string base64. Pertimbangkan untuk menggunakan base64ToString() daripada decodeBase64(). Meskipun kedua fungsi bekerja dengan cara yang sama, base64ToString() lebih disukai.

decodeBase64('<value>')

Pengaturan	Diperlukan	Tipe	Description
< nilai>	Yes	String	String yang dikodekan base64 untuk didekodekan

Mengembalikan nilai	Tipe	Description
< decoded-base64-string>	String	Versi string untuk string yang dikodekan base64

Example

Contoh ini membuat string untuk string yang dikodekan base64:

decodeBase64('aGVsbG8=')

Dan mengembalikan hasil ini: "hello"

decodeDataUri

Mengembalikan versi biner untuk pengidentifikasi sumber daya seragam data (URI). Pertimbangkan untuk menggunakan dataUriToBinary(), bukan decodeDataUri(). Meskipun kedua fungsi bekerja dengan cara yang sama, dataUriToBinary() lebih disukai.

decodeDataUri('<value>')

Pengaturan	Diperlukan	Tipe	Description
< nilai>	Yes	String	String URI data yang akan didekode

Mengembalikan nilai	Tipe	Description
< biner-untuk-data-uri>	String	Versi biner untuk string URI data

Example

Contoh ini mengembalikan versi biner untuk URI data ini:

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

Dan mengembalikan hasil ini:

decodeUriComponent

Mengembalikan string yang menggantikan karakter escape dengan versi yang didekodekan.

decodeUriComponent('<value>')

Pengaturan	Diperlukan	Tipe	Description
< nilai>	Yes	String	String dengan karakter escape untuk didekodekan

Mengembalikan nilai	Tipe	Description
< URI yang Didekodekan>	String	String yang diperbarui dengan karakter escape yang didekodekan

Example

Contoh ini menggantikan karakter escape dalam string ini dengan versi yang didekodekan:

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

Dan mengembalikan hasil ini: "https://contoso.com"

div

Mengembalikan hasil bilangan bulat dari pembagian dua angka. Untuk mendapatkan hasil yang tersisa, lihat mod().

div(<dividend>, <divisor>)

Pengaturan	Diperlukan	Tipe	Description
< Dividen>	Yes	Bilangan bulat atau Float	Angka untuk dibagi dengan pembagi
< pembagi>	Yes	Bilangan bulat atau Float	Angka yang membagi dividen, tetapi tidak boleh 0

Mengembalikan nilai	Tipe	Description
< hasil quotient>	Integer	Hasil bilangan bulat dari pembagian angka pertama dengan angka kedua

Example

Kedua contoh membagi angka pertama dengan angka kedua:

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

Dan kembalikan hasil ini: 2

encodeUriComponent

Mengembalikan versi pengidentifikasi sumber daya seragam (URI) yang dikodekan untuk string dengan mengganti karakter URL yang tidak aman dengan karakter escape. Pertimbangkan untuk menggunakan uriComponent(), bukan encodeUriComponent(). Meskipun kedua fungsi bekerja dengan cara yang sama, uriComponent() lebih disukai.

encodeUriComponent('<value>')

Pengaturan	Diperlukan	Tipe	Description
< nilai>	Yes	String	String yang akan dikonversi ke format yang dikodekan URI

Mengembalikan nilai	Tipe	Description
< URI yang Dikodekan>	String	String yang dikodekan URI dengan karakter escape

Example

Contoh ini membuat versi yang dikodekan URI untuk string ini:

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

Dan mengembalikan hasil ini: "http%3A%2F%2Fcontoso.com"

kosong

Periksa apakah koleksi kosong. Kembalikan true saat koleksi kosong, atau kembalikan false saat tidak kosong.

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

Pengaturan	Diperlukan	Tipe	Description
< koleksi>	Yes	String, Array, atau Objek	Koleksi yang akan diperiksa

Mengembalikan nilai	Tipe	Description
BENAR atau SALAH	Boolean	Mengembalikan true saat koleksi kosong. Mengembalikan false ketika tidak kosong.

Example

Contoh-contoh ini memeriksa apakah koleksi yang ditentukan kosong:

empty('')
empty('abc')

Dan mengembalikan hasil ini:

Contoh pertama: Meneruskan string kosong, sehingga fungsi mengembalikan true.
Contoh kedua: Meneruskan string "abc", sehingga fungsi mengembalikan false.

berakhir dengan

Periksa apakah string berakhir dengan substring tertentu. Kembalikan true ketika substring ditemukan, atau kembalikan false ketika tidak ditemukan. Fungsi ini tidak peka huruf besar/kecil.

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

Pengaturan	Diperlukan	Tipe	Description
< Teks>	Yes	String	String yang akan diperiksa
< searchText>	Yes	String	Substring akhir yang akan ditemukan

Mengembalikan nilai	Tipe	Description
BENAR atau SALAH	Boolean	Mengembalikan true saat substring akhir ditemukan. Mengembalikan false ketika tidak ditemukan.

Contoh 1

Contoh ini memeriksa apakah string "halo dunia" berakhir dengan string "dunia":

endsWith('hello world', 'world')

Dan mengembalikan hasil ini: true

Contoh 2

Contoh ini memeriksa apakah string "halo dunia" berakhir dengan string "universe":

endsWith('hello world', 'universe')

Dan mengembalikan hasil ini: false

equals

Periksa apakah kedua nilai, ekspresi, atau objek setara. Kembalikan true ketika keduanya setara, atau kembalikan false saat tidak setara.

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

Pengaturan	Diperlukan	Tipe	Description
< objek1>, <objek2>	Yes	Bermacam-macam	Nilai, ekspresi, atau objek yang akan dibandingkan

Mengembalikan nilai	Tipe	Description
BENAR atau SALAH	Boolean	Mengembalikan true ketika keduanya setara. Mengembalikan false ketika tidak setara.

Example

Contoh-contoh ini memeriksa apakah input yang ditentukan setara.

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

Dan mengembalikan hasil ini:

Contoh pertama: Kedua nilai setara, sehingga fungsi mengembalikan true.
Contoh kedua: Kedua nilai tidak setara, sehingga fungsi mengembalikan false.

pertama

Mengembalikan item pertama dari string atau array.

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

Pengaturan	Diperlukan	Tipe	Description
< koleksi>	Yes	String atau Array	Koleksi tempat menemukan item pertama

Mengembalikan nilai	Tipe	Description
< item koleksi pertama>	Apa saja	Item pertama dalam koleksi

Example

Contoh-contoh ini menemukan item pertama dalam koleksi ini:

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

Dan kembalikan hasil ini:

Contoh pertama: "h"
Contoh kedua: 0

float

Mengonversi versi string untuk angka floating-point menjadi angka titik floating aktual.

float('<value>')

Pengaturan	Diperlukan	Tipe	Description
< nilai>	Yes	String	String yang memiliki angka floating-point yang valid untuk dikonversi

Mengembalikan nilai	Tipe	Description
< nilai mengambang>	Mengapung	Angka floating-point untuk string yang ditentukan

Example

Contoh ini membuat versi string untuk nomor floating-point ini:

float('10.333')

Dan mengembalikan hasil ini: 10.333

formatDateTime

Mengembalikan tanda waktu dalam format yang ditentukan.

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

Pengaturan	Diperlukan	Tipe	Description
< Timestamp>	Yes	String	String yang berisi tanda waktu
< Format>	Tidak.	String	Penentu format tunggal atau pola format kustom. Format default untuk tanda waktu adalah "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), yang mematuhi ISO 8601 dan mempertahankan informasi zona waktu.

Mengembalikan nilai	Tipe	Description
< tanda waktu yang diformat ulang>	String	Tanda waktu yang diperbarui dalam format yang ditentukan

Example

Contoh ini mengonversi tanda waktu ke format yang ditentukan:

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

Dan mengembalikan hasil ini: "2018-03-15T12:00:00"

getFutureTime

Mengembalikan tanda waktu saat ini ditambah unit waktu yang ditentukan.

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

Pengaturan	Diperlukan	Tipe	Description
< Interval>	Yes	Integer	Jumlah unit waktu yang ditentukan untuk ditambahkan
< satuan waktu>	Yes	String	Unit waktu yang digunakan dengan interval: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
< Format>	Tidak.	String	Penentu format tunggal atau pola format kustom. Format default untuk tanda waktu adalah "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), yang mematuhi ISO 8601 dan mempertahankan informasi zona waktu.

Mengembalikan nilai	Tipe	Description
< tanda waktu yang diperbarui>	String	Tanda waktu saat ini ditambah jumlah unit waktu yang ditentukan

Contoh 1

Misalkan tanda waktu saat ini adalah "2018-03-01T00:00:00.0000000Z". Contoh ini menambahkan lima hari ke tanda waktu tersebut:

getFutureTime(5, 'Day')

Dan mengembalikan hasil ini: "2018-03-06T00:00:00.0000000Z"

Contoh 2

Misalkan tanda waktu saat ini adalah "2018-03-01T00:00:00.0000000Z". Contoh ini menambahkan lima hari dan mengonversi hasilnya menjadi format "D":

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

Dan mengembalikan hasil ini: "Tuesday, March 6, 2018"

getPastTime

Mengembalikan tanda waktu saat ini dikurangi unit waktu yang ditentukan.

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

Pengaturan	Diperlukan	Tipe	Description
< Interval>	Yes	Integer	Jumlah unit waktu yang ditentukan untuk dikurangi
< satuan waktu>	Yes	String	Unit waktu yang digunakan dengan interval: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
< Format>	Tidak.	String	Penentu format tunggal atau pola format kustom. Format default untuk tanda waktu adalah "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), yang mematuhi ISO 8601 dan mempertahankan informasi zona waktu.

Mengembalikan nilai	Tipe	Description
< tanda waktu yang diperbarui>	String	Tanda waktu saat ini dikurangi jumlah unit waktu yang ditentukan

Contoh 1

Misalkan tanda waktu saat ini adalah "2018-02-01T00:00:00.0000000Z". Contoh ini mengurangi lima hari dari tanda waktu tersebut:

getPastTime(5, 'Day')

Dan mengembalikan hasil ini: "2018-01-27T00:00:00.0000000Z"

Contoh 2

Misalkan tanda waktu saat ini adalah "2018-02-01T00:00:00.0000000Z". Contoh ini mengurangi lima hari dan mengonversi hasilnya menjadi format "D":

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

Dan mengembalikan hasil ini: "Saturday, January 27, 2018"

lebih

Periksa apakah nilai pertama lebih besar dari nilai kedua. Mengembalikan true ketika nilai pertama lebih banyak, atau mengembalikan false jika kurang.

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

Pengaturan	Diperlukan	Tipe	Description
< nilai>	Yes	Bilangan bulat, Float, atau String	Nilai pertama untuk memeriksa apakah lebih besar dari nilai kedua
< bandingkan Ke>	Yes	Bilangan bulat, Float, atau String, masing-masing	Nilai perbandingan

Mengembalikan nilai	Tipe	Description
BENAR atau SALAH	Boolean	Mengembalikan true ketika nilai pertama lebih besar dari nilai kedua. Mengembalikan false ketika nilai pertama sama dengan atau kurang dari nilai kedua.

Example

Contoh-contoh ini memeriksa apakah nilai pertama lebih besar dari nilai kedua:

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

Dan kembalikan hasil ini:

Contoh pertama: true
Contoh kedua: false

greaterOrEquals

Periksa apakah nilai pertama lebih besar dari atau sama dengan nilai kedua. Mengembalikan true ketika nilai pertama lebih besar atau sama dengan, atau mengembalikan false saat nilai pertama lebih kecil.

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

Pengaturan	Diperlukan	Tipe	Description
< nilai>	Yes	Bilangan bulat, Float, atau String	Nilai pertama untuk memeriksa apakah lebih besar dari atau sama dengan nilai kedua
< bandingkan Ke>	Yes	Bilangan bulat, Float, atau String, masing-masing	Nilai perbandingan

Mengembalikan nilai	Tipe	Description
BENAR atau SALAH	Boolean	Mengembalikan true ketika nilai pertama lebih besar dari atau sama dengan nilai kedua. Mengembalikan false ketika nilai pertama kurang dari nilai kedua.

Example

Contoh-contoh ini memeriksa apakah nilai pertama lebih besar atau sama dengan nilai kedua:

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

Dan kembalikan hasil ini:

Contoh pertama: true
Contoh kedua: false

panduan

Hasilkan pengidentifikasi unik global (GUID) sebagai string, misalnya, "c2ecc88d-88c8-4096-912c-d6f2e2b138ce":

guid()

Selain itu, Anda dapat menentukan format yang berbeda untuk GUID selain format default, "D", yaitu 32 digit yang dipisahkan oleh tanda hubung.

guid('<format>')

Pengaturan	Diperlukan	Tipe	Description
< Format>	Tidak.	String	Penentu format tunggal untuk GUID yang dikembalikan. Secara default, formatnya adalah "D", tetapi Anda dapat menggunakan "N", "D", "B", "P", atau "X".

Mengembalikan nilai	Tipe	Description
< Nilai GUID>	String	GUID yang dihasilkan secara acak

Example

Contoh ini menghasilkan GUID yang sama, tetapi sebagai 32 digit, dipisahkan oleh tanda hubung, dan diapit dalam tanda kurung:

guid('P')

Dan mengembalikan hasil ini: "(c2ecc88d-88c8-4096-912c-d6f2e2b138ce)"

if

Periksa apakah ekspresi benar atau salah. Berdasarkan hasilnya, kembalikan nilai yang ditentukan.

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

Pengaturan	Diperlukan	Tipe	Description
< Ekspresi>	Yes	Boolean	Ekspresi yang akan diperiksa
< nilaiJikaBenar>	Yes	Apa saja	Nilai yang akan dikembalikan saat ekspresi benar
< nilaiJikaSalah>	Yes	Apa saja	Nilai yang akan dikembalikan saat ekspresi salah

Mengembalikan nilai	Tipe	Description
< nilai pengembalian yang ditentukan>	Apa saja	Nilai yang ditentukan yang mengembalikan berdasarkan apakah ekspresi benar atau salah

Example

Contoh ini mengembalikan "yes" karena ekspresi yang ditentukan mengembalikan true. Jika tidak, contoh mengembalikan "no":

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

indexOf

Mengembalikan posisi awal atau nilai indeks untuk substring. Fungsi ini tidak peka huruf besar/kecil, dan indeks dimulai dengan angka 0.

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

Pengaturan	Diperlukan	Tipe	Description
< Teks>	Yes	String	String yang memiliki substring untuk ditemukan
< searchText>	Yes	String	Substring yang akan ditemukan

Mengembalikan nilai	Tipe	Description
< nilai indeks>	Integer	Posisi awal atau nilai indeks untuk substring yang ditentukan. Jika string tidak ditemukan, kembalikan angka -1.

Example

Contoh ini menemukan nilai indeks awal untuk substring "dunia" dalam string "halo dunia":

indexOf('hello world', 'world')

Dan mengembalikan hasil ini: 6

int

Mengembalikan versi bilangan bulat untuk string.

int('<value>')

Pengaturan	Diperlukan	Tipe	Description
< nilai>	Yes	String	String yang akan dikonversi

Mengembalikan nilai	Tipe	Description
< hasil bilangan bulat>	Integer	Versi bilangan bulat untuk string yang ditentukan

Example

Contoh ini membuat versi bilangan bulat untuk string "10":

int('10')

Dan mengembalikan hasil ini: 10

JSON

Mengembalikan nilai atau objek jenis JavaScript Object Notation (JSON) untuk string atau XML.

json('<value>')

Pengaturan	Diperlukan	Tipe	Description
< nilai>	Yes	String atau XML	String atau XML yang akan dikonversi

Mengembalikan nilai	Tipe	Description
< Hasil JSON>	Jenis atau objek asli JSON	Nilai atau objek jenis asli JSON untuk string atau XML yang ditentukan. Jika string null, fungsi mengembalikan objek kosong.

Contoh 1

Contoh ini mengonversi string ini ke nilai JSON:

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

Dan mengembalikan hasil ini: [1, 2, 3]

Contoh 2

Contoh ini mengonversi string ini ke JSON:

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

Dan mengembalikan hasil ini:

{
  "fullName": "Sophia Owen"
}

Contoh 3

Contoh ini mengonversi XML ini ke JSON:

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

Dan mengembalikan hasil ini:

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

persimpangan

Mengembalikan koleksi yang hanya memiliki item umum di seluruh koleksi yang ditentukan. Untuk muncul dalam hasil, item harus muncul di semua koleksi yang diteruskan ke fungsi ini. Jika satu atau beberapa item memiliki nama yang sama, item terakhir dengan nama tersebut muncul di hasilnya.

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

Pengaturan	Diperlukan	Tipe	Description
< koleksi1>, <koleksi2>, ...	Yes	Array atau Object, tetapi tidak keduanya	Koleksi dari tempat Anda hanya menginginkan item umum

Mengembalikan nilai	Tipe	Description
< item umum>	Array atau Objek, masing-masing	Koleksi yang hanya memiliki item umum di seluruh koleksi yang ditentukan

Example

Contoh ini menemukan item umum di seluruh array ini:

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

Dan mengembalikan array hanya dengan item ini: [1, 2]

gabung

Mengembalikan string yang memiliki semua item dari array dan memiliki setiap karakter yang dipisahkan oleh pemisah.

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

Pengaturan	Diperlukan	Tipe	Description
< koleksi>	Yes	Array	Array yang memiliki item untuk digabungkan
< Pembatas>	Yes	String	Pemisah yang muncul di antara setiap karakter dalam string yang dihasilkan

Mengembalikan nilai	Tipe	Description
< karakter1><Pembatas><karakter2><Pembatas>...	String	String yang dihasilkan dibuat dari semua item dalam array yang ditentukan

Example

Contoh ini membuat string dari semua item dalam array ini dengan karakter yang ditentukan sebagai pemisah:

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

Dan mengembalikan hasil ini: "a.b.c"

terakhir

Mengembalikan item terakhir dari koleksi.

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

Pengaturan	Diperlukan	Tipe	Description
< koleksi>	Yes	String atau Array	Kumpulan tempat menemukan item terakhir

Mengembalikan nilai	Tipe	Description
< item koleksi terakhir>	String atau Array, masing-masing	Item terakhir dalam koleksi

Example

Contoh-contoh ini menemukan item terakhir dalam koleksi ini:

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

Dan mengembalikan hasil ini:

Contoh pertama: "d"
Contoh kedua: 3

lastIndexOf

Mengembalikan posisi awal atau nilai indeks untuk kemunculan terakhir substring. Fungsi ini tidak peka huruf besar/kecil, dan indeks dimulai dengan angka 0.

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

Pengaturan	Diperlukan	Tipe	Description
< Teks>	Yes	String	String yang memiliki substring untuk ditemukan
< searchText>	Yes	String	Substring yang akan ditemukan

Mengembalikan nilai	Tipe	Description
< nilai-indeks-akhir>	Integer	Posisi awal atau nilai indeks untuk kemunculan terakhir substring yang ditentukan. Jika string tidak ditemukan, kembalikan angka -1.

Example

Contoh ini menemukan nilai indeks awal untuk kemunculan terakhir substring "dunia" dalam string "halo dunia":

lastIndexOf('hello world', 'world')

Dan mengembalikan hasil ini: 6

length

Mengembalikan jumlah item dalam koleksi.

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

Pengaturan	Diperlukan	Tipe	Description
< koleksi>	Yes	String atau Array	Koleksi dengan item yang akan dihitung

Mengembalikan nilai	Tipe	Description
< panjang atau hitungan>	Integer	Jumlah item dalam koleksi

Example

Contoh-contoh ini menghitung jumlah item dalam koleksi ini:

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

Dan kembalikan hasil ini: 4

kurang

Periksa apakah nilai pertama kurang dari nilai kedua. Mengembalikan true ketika nilai pertama kurang, atau mengembalikan false saat nilai pertama lebih banyak.

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

Pengaturan	Diperlukan	Tipe	Description
< nilai>	Yes	Bilangan bulat, Float, atau String	Nilai pertama untuk memeriksa apakah kurang dari nilai kedua
< bandingkan Ke>	Yes	Bilangan bulat, Float, atau String, masing-masing	Item perbandingan

Mengembalikan nilai	Tipe	Description
BENAR atau SALAH	Boolean	Mengembalikan true ketika nilai pertama kurang dari nilai kedua. Mengembalikan false ketika nilai pertama sama dengan atau lebih besar dari nilai kedua.

Example

Contoh-contoh ini memeriksa apakah nilai pertama kurang dari nilai kedua.

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

Dan kembalikan hasil ini:

Contoh pertama: true
Contoh kedua: false

lessOrEquals

Periksa apakah nilai pertama kurang dari atau sama dengan nilai kedua. Mengembalikan true ketika nilai pertama kurang dari atau sama dengan, atau mengembalikan false saat nilai pertama lebih banyak.

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

Pengaturan	Diperlukan	Tipe	Description
< nilai>	Yes	Bilangan bulat, Float, atau String	Nilai pertama untuk memeriksa apakah kurang dari atau sama dengan nilai kedua
< bandingkan Ke>	Yes	Bilangan bulat, Float, atau String, masing-masing	Item perbandingan

Mengembalikan nilai	Tipe	Description
BENAR atau SALAH	Boolean	Mengembalikan true ketika nilai pertama kurang dari atau sama dengan nilai kedua. Mengembalikan false ketika nilai pertama lebih besar dari nilai kedua.

Example

Contoh-contoh ini memeriksa apakah nilai pertama kurang atau sama dengan nilai kedua.

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

Dan kembalikan hasil ini:

Contoh pertama: true
Contoh kedua: false

max

Mengembalikan nilai tertinggi dari daftar atau array dengan angka yang inklusif di kedua ujungnya.

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

Pengaturan	Diperlukan	Tipe	Description
< nomor1>, <nomor2>, ...	Yes	Bilangan bulat, Float, atau keduanya	Kumpulan angka dari mana Anda menginginkan nilai tertinggi
[<nomor1>, <nomor2>, ...]	Yes	Array - Bilangan bulat, Float, atau keduanya	Array angka dari mana Anda menginginkan nilai tertinggi

Mengembalikan nilai	Tipe	Description
< nilai maks>	Bilangan bulat atau Float	Nilai tertinggi dalam array atau kumpulan angka yang ditentukan

Example

Contoh-contoh ini mendapatkan nilai tertinggi dari kumpulan angka dan array:

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

Dan kembalikan hasil ini: 3

min

Mengembalikan nilai terendah dari sekumpulan angka atau array.

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

Pengaturan	Diperlukan	Tipe	Description
< nomor1>, <nomor2>, ...	Yes	Bilangan bulat, Float, atau keduanya	Kumpulan angka dari mana Anda menginginkan nilai terendah
[<nomor1>, <nomor2>, ...]	Yes	Array - Bilangan bulat, Float, atau keduanya	Array angka dari mana Anda menginginkan nilai terendah

Mengembalikan nilai	Tipe	Description
< nilai min>	Bilangan bulat atau Float	Nilai terendah dalam kumpulan angka yang ditentukan atau array yang ditentukan

Example

Contoh-contoh ini mendapatkan nilai terendah dalam kumpulan angka dan array:

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

Dan kembalikan hasil ini: 1

mod

Mengembalikan sisa dari pembagian dua angka. Untuk mendapatkan hasil bilangan bulat, lihat div().

mod(<dividend>, <divisor>)

Pengaturan	Diperlukan	Tipe	Description
< Dividen>	Yes	Bilangan bulat atau Float	Angka untuk dibagi dengan pembagi
< pembagi>	Yes	Bilangan bulat atau Float	Angka yang membagi dividen, tetapi tidak boleh 0.

Mengembalikan nilai	Tipe	Description
< hasil modulo>	Bilangan bulat atau Float	Sisa dari pembagian angka pertama dengan angka kedua

Example

Contoh ini membagi angka pertama dengan angka kedua:

mod(3, 2)

Dan kembalikan hasil ini: 1

mul

Mengembalikan produk dari mengalikan dua angka.

mul(<multiplicand1>, <multiplicand2>)

Pengaturan	Diperlukan	Tipe	Description
< perkalian1>	Yes	Bilangan bulat atau Float	Angka yang akan dikalikan dengan multiplicand2
< Multiplicand2>	Yes	Bilangan bulat atau Float	Angka yang mengalikan multiplicand1

Mengembalikan nilai	Tipe	Description
< hasil produk>	Bilangan bulat atau Float	Produk dari mengalikan angka pertama dengan angka kedua

Example

Contoh-contoh ini beberapa angka pertama dengan angka kedua:

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

Dan kembalikan hasil ini:

Contoh pertama: 2
Contoh kedua 3

not

Periksa apakah ekspresi salah. Kembalikan true saat ekspresi salah, atau kembalikan false saat true.

not(<expression>)

Pengaturan	Diperlukan	Tipe	Description
< Ekspresi>	Yes	Boolean	Ekspresi yang akan diperiksa

Mengembalikan nilai	Tipe	Description
BENAR atau SALAH	Boolean	Mengembalikan true saat ekspresi salah. Mengembalikan false saat ekspresi benar.

Contoh 1

Contoh-contoh ini memeriksa apakah ekspresi yang ditentukan salah:

not(false)
not(true)

Dan kembalikan hasil ini:

Contoh pertama: Ekspresi adalah false, sehingga fungsi mengembalikan true.
Contoh kedua: Ekspresi adalah true, sehingga fungsi mengembalikan false.

Contoh 2

Contoh-contoh ini memeriksa apakah ekspresi yang ditentukan salah:

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

Dan kembalikan hasil ini:

Contoh pertama: Ekspresi adalah false, sehingga fungsi mengembalikan true.
Contoh kedua: Ekspresi adalah true, sehingga fungsi mengembalikan false.

or

Periksa apakah setidaknya satu ekspresi benar. Mengembalikan true ketika setidaknya satu ekspresi adalah true, atau mengembalikan false saat keduanya false.

or(<expression1>, <expression2>)

Pengaturan	Diperlukan	Tipe	Description
< expression1>, <expression2>	Yes	Boolean	Ekspresi yang akan diperiksa

Mengembalikan nilai	Tipe	Description
BENAR atau SALAH	Boolean	Mengembalikan true ketika setidaknya satu ekspresi adalah true. Mengembalikan false ketika kedua ekspresi salah.

Contoh 1

Contoh-contoh ini memeriksa apakah setidaknya satu ekspresi benar:

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

Dan kembalikan hasil ini:

Contoh pertama: Setidaknya satu ekspresi adalah true, sehingga fungsi mengembalikan true.
Contoh kedua: Kedua ekspresi salah, sehingga fungsi mengembalikan false.

Contoh 2

Contoh-contoh ini memeriksa apakah setidaknya satu ekspresi benar:

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

Dan kembalikan hasil ini:

Contoh pertama: Setidaknya satu ekspresi adalah true, sehingga fungsi mengembalikan true.
Contoh kedua: Kedua ekspresi salah, sehingga fungsi mengembalikan false.

Rand

Mengembalikan bilangan bulat acak dari rentang tertentu, yang hanya inklusif di awal.

rand(<minValue>, <maxValue>)

Pengaturan	Diperlukan	Tipe	Description
< Nilai min>	Yes	Integer	Bilangan bulat terendah dalam rentang
< maxValue>	Yes	Integer	Bilangan bulat yang mengikuti bilangan bulat tertinggi dalam rentang yang dapat dikembalikan fungsi

Mengembalikan nilai	Tipe	Description
< hasil acak>	Integer	Bilangan bulat acak yang dikembalikan dari rentang yang ditentukan

Example

Contoh ini mendapatkan bilangan bulat acak dari rentang yang ditentukan, tidak termasuk nilai maksimum:

rand(1, 5)

Dan mengembalikan salah satu angka ini sebagai hasilnya: 1, , 23, atau4

rentang

Mengembalikan array bilangan bulat yang dimulai dari bilangan bulat tertentu.

range(<startIndex>, <count>)

Pengaturan	Diperlukan	Tipe	Description
< startIndex>	Yes	Integer	Nilai bilangan bulat yang memulai array sebagai item pertama
< hitung>	Yes	Integer	Jumlah bilangan bulat dalam array

Mengembalikan nilai	Tipe	Description
[<hasil rentang>]	Array	Array dengan bilangan bulat dimulai dari indeks yang ditentukan

Example

Contoh ini membuat array bilangan bulat yang dimulai dari indeks yang ditentukan dan memiliki jumlah bilangan bulat yang ditentukan:

range(1, 4)

Dan mengembalikan hasil ini: [1, 2, 3, 4]

ganti

Ganti substring dengan string yang ditentukan, dan kembalikan string hasil. Fungsi ini peka huruf besar/kecil.

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

Pengaturan	Diperlukan	Tipe	Description
< Teks>	Yes	String	String yang memiliki substring untuk diganti
< Teks lama>	Yes	String	Substring yang akan diganti
< Teks baru>	Yes	String	String pengganti

Mengembalikan nilai	Tipe	Description
< teks yang diperbarui>	String	String yang diperbarui setelah mengganti substring Jika substring tidak ditemukan, kembalikan string asli.

Example

Contoh ini menemukan substring "lama" dalam "string lama" dan mengganti "lama" dengan "baru":

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

Dan mengembalikan hasil ini: "the new string"

lompati

Hapus item dari depan koleksi, dan kembalikan semua item lainnya .

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

Pengaturan	Diperlukan	Tipe	Description
< koleksi>	Yes	Array	Koleksi yang itemnya ingin Anda hapus
< hitung>	Yes	Integer	Bilangan bulat positif untuk jumlah item yang akan dihapus di bagian depan

Mengembalikan nilai	Tipe	Description
[<koleksi >]	Array	Koleksi yang diperbarui setelah menghapus item yang ditentukan

Example

Contoh ini menghapus satu item, angka 0, dari depan array yang ditentukan:

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

Dan mengembalikan array ini dengan item yang tersisa: [1,2,3]

belah

Mengembalikan array yang berisi substring, dipisahkan oleh koma, berdasarkan karakter pemisah yang ditentukan dalam string asli.

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

Pengaturan	Diperlukan	Tipe	Description
< Teks>	Yes	String	String yang akan dipisahkan menjadi substring berdasarkan pemisah yang ditentukan dalam string asli
< Pembatas>	Yes	String	Karakter dalam string asli untuk digunakan sebagai pemisah

Mengembalikan nilai	Tipe	Description
[<substring1,substring2><>,...]	Array	Array yang berisi substring dari string asli, dipisahkan oleh koma

Example

Contoh ini membuat array dengan substring dari string yang ditentukan berdasarkan karakter yang ditentukan sebagai pemisah:

split('a_b_c', '_')

Dan mengembalikan array ini sebagai hasilnya: ["a","b","c"]

startOfDay

Mengembalikan awal hari untuk tanda waktu.

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

Pengaturan	Diperlukan	Tipe	Description
< Timestamp>	Yes	String	String yang berisi tanda waktu
< Format>	Tidak.	String	Penentu format tunggal atau pola format kustom. Format default untuk tanda waktu adalah "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), yang mematuhi ISO 8601 dan mempertahankan informasi zona waktu.

Mengembalikan nilai	Tipe	Description
< tanda waktu yang diperbarui>	String	Tanda waktu yang ditentukan tetapi dimulai pada tanda nol jam untuk hari itu

Example

Contoh ini menemukan awal hari untuk tanda waktu ini:

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

Dan mengembalikan hasil ini: "2018-03-15T00:00:00.0000000Z"

startOfHour

Mengembalikan awal jam untuk tanda waktu.

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

Pengaturan	Diperlukan	Tipe	Description
< Timestamp>	Yes	String	String yang berisi tanda waktu
< Format>	Tidak.	String	Penentu format tunggal atau pola format kustom. Format default untuk tanda waktu adalah "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), yang mematuhi ISO 8601 dan mempertahankan informasi zona waktu.

Mengembalikan nilai	Tipe	Description
< tanda waktu yang diperbarui>	String	Tanda waktu yang ditentukan tetapi dimulai pada tanda nol menit untuk jam

Example

Contoh ini menemukan awal jam untuk tanda waktu ini:

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

Dan mengembalikan hasil ini: "2018-03-15T13:00:00.0000000Z"

startOfMonth

Mengembalikan awal bulan untuk tanda waktu.

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

Pengaturan	Diperlukan	Tipe	Description
< Timestamp>	Yes	String	String yang berisi tanda waktu
< Format>	Tidak.	String	Penentu format tunggal atau pola format kustom. Format default untuk tanda waktu adalah "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), yang mematuhi ISO 8601 dan mempertahankan informasi zona waktu.

Mengembalikan nilai	Tipe	Description
< tanda waktu yang diperbarui>	String	Tanda waktu yang ditentukan tetapi dimulai pada hari pertama bulan pada tanda nol jam

Example

Contoh ini mengembalikan awal bulan untuk tanda waktu ini:

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

Dan mengembalikan hasil ini: "2018-03-01T00:00:00.0000000Z"

startsWith (dimulaiDengan)

Periksa apakah string dimulai dengan substring tertentu. Kembalikan true ketika substring ditemukan, atau kembalikan false ketika tidak ditemukan. Fungsi ini tidak peka huruf besar/kecil.

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

Pengaturan	Diperlukan	Tipe	Description
< Teks>	Yes	String	String yang akan diperiksa
< searchText>	Yes	String	String awal untuk ditemukan

Mengembalikan nilai	Tipe	Description
BENAR atau SALAH	Boolean	Mengembalikan true saat substring awal ditemukan. Mengembalikan false ketika tidak ditemukan.

Contoh 1

Contoh ini memeriksa apakah string "halo dunia" dimulai dengan substring "hello":

startsWith('hello world', 'hello')

Dan mengembalikan hasil ini: true

Contoh 2

Contoh ini memeriksa apakah string "halo dunia" dimulai dengan substring "salam":

startsWith('hello world', 'greetings')

Dan mengembalikan hasil ini: false

string

Mengembalikan versi string untuk nilai.

string(<value>)

Pengaturan	Diperlukan	Tipe	Description
< nilai>	Yes	Apa saja	Nilai yang akan dikonversi

Mengembalikan nilai	Tipe	Description
< nilai string>	String	Versi string untuk nilai yang ditentukan

Contoh 1

Contoh ini membuat versi string untuk nomor ini:

string(10)

Dan mengembalikan hasil ini: "10"

Contoh 2

Contoh ini membuat string untuk objek JSON yang ditentukan dan menggunakan karakter garis miring terbalik (\) sebagai karakter escape untuk tanda kutip ganda (").

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

Dan mengembalikan hasil ini: "{ \\"name\\": \\"Sophie Owen\\" }"

Subkategori

Mengembalikan hasil dari mengurangi angka kedua dari angka pertama.

sub(<minuend>, <subtrahend>)

Pengaturan	Diperlukan	Tipe	Description
< minus>	Yes	Bilangan bulat atau Float	Angka dari yang akan dikurangi subtrahend
< Kinurang>	Yes	Bilangan bulat atau Float	Angka yang akan dikurangi dari minuend

Mengembalikan nilai	Tipe	Description
< hasil>	Bilangan bulat atau Float	Hasil dari pengurangan angka kedua dari angka pertama

Example

Contoh ini mengurangi angka kedua dari angka pertama:

sub(10.3, .3)

Dan mengembalikan hasil ini: 10

Substring

Mengembalikan karakter dari string, dimulai dari posisi yang ditentukan, atau indeks. Nilai indeks dimulai dengan angka 0.

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

Pengaturan	Diperlukan	Tipe	Description
< Teks>	Yes	String	String yang karakternya Anda inginkan
< startIndex>	Yes	Integer	Angka positif sama dengan atau lebih besar dari 0 yang ingin Anda gunakan sebagai posisi awal atau nilai indeks
< panjangnya>	Yes	Integer	Jumlah karakter positif yang Anda inginkan di substring

Mengembalikan nilai	Tipe	Description
< hasil substring>	String	Substring dengan jumlah karakter yang ditentukan, dimulai dari posisi indeks yang ditentukan dalam string sumber

Example

Contoh ini membuat substring lima karakter dari string yang ditentukan, mulai dari nilai indeks 6:

substring('hello world', 6, 5)

Dan mengembalikan hasil ini: "world"

subtractFromTime

Kurangi sejumlah unit waktu dari tanda waktu. Lihat juga getPastTime.

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

Pengaturan	Diperlukan	Tipe	Description
< Timestamp>	Yes	String	String yang berisi tanda waktu
< Interval>	Yes	Integer	Jumlah unit waktu yang ditentukan untuk dikurangi
< satuan waktu>	Yes	String	Unit waktu yang digunakan dengan interval: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
< Format>	Tidak.	String	Penentu format tunggal atau pola format kustom. Format default untuk tanda waktu adalah "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), yang mematuhi ISO 8601 dan mempertahankan informasi zona waktu.

Mengembalikan nilai	Tipe	Description
< tanda waktu yang diperbarui>	String	Tanda waktu dikurangi jumlah unit waktu yang ditentukan

Contoh 1

Contoh ini mengurangi satu hari dari tanda waktu ini:

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

Dan mengembalikan hasil ini: "2018-01-01T00:00:00:0000000Z"

Contoh 2

Contoh ini mengurangi satu hari dari tanda waktu ini:

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

Dan mengembalikan hasil ini menggunakan format "D" opsional: "Monday, January, 1, 2018"

ambil

Mengembalikan item dari depan koleksi.

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

Pengaturan	Diperlukan	Tipe	Description
< koleksi>	Yes	String atau Array	Koleksi yang itemnya Anda inginkan
< hitung>	Yes	Integer	Bilangan bulat positif untuk jumlah item yang Anda inginkan dari depan

Mengembalikan nilai	Tipe	Description
< Subset> atau [<subset>]	String atau Array, masing-masing	String atau array yang memiliki jumlah item yang ditentukan yang diambil dari bagian depan koleksi asli

Example

Contoh-contoh ini mendapatkan jumlah item yang ditentukan dari depan koleksi ini:

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

Dan kembalikan hasil ini:

Contoh pertama: "abc"
Contoh kedua: [0, 1, 2]

kutu

ticks Mengembalikan nilai properti untuk tanda waktu tertentu. Tanda centang adalah interval 100 nanodetik.

ticks('<timestamp>')

Pengaturan	Diperlukan	Tipe	Description
< Timestamp>	Yes	String	String untuk tanda waktu

Mengembalikan nilai	Tipe	Description
< nomor centang>	Integer	Jumlah kutu yang telah berlalu sejak 12:00:00 tengah malam, 1 Januari 0001 di kalender Gregorian sejak tanda waktu input

toLower

Mengembalikan string dalam format huruf kecil. Jika karakter dalam string tidak memiliki versi huruf kecil, karakter tersebut tetap tidak berubah dalam string yang dikembalikan.

toLower('<text>')

Pengaturan	Diperlukan	Tipe	Description
< Teks>	Yes	String	String yang akan dikembalikan dalam format huruf kecil

Mengembalikan nilai	Tipe	Description
< teks huruf kecil>	String	String asli dalam format huruf kecil

Example

Contoh ini mengonversi string ini menjadi huruf kecil:

toLower('Hello World')

Dan mengembalikan hasil ini: "hello world"

toUpper

Mengembalikan string dalam format huruf besar. Jika karakter dalam string tidak memiliki versi huruf besar, karakter tersebut tetap tidak berubah dalam string yang dikembalikan.

toUpper('<text>')

Pengaturan	Diperlukan	Tipe	Description
< Teks>	Yes	String	String yang akan dikembalikan dalam format huruf besar

Mengembalikan nilai	Tipe	Description
< teks huruf besar>	String	String asli dalam format huruf besar

Example

Contoh ini mengonversi string ini menjadi huruf besar:

toUpper('Hello World')

Dan mengembalikan hasil ini: "HELLO WORLD"

pangkas

Hapus spasi putih di awal dan akhir dari string, dan kembalikan string yang diperbarui.

trim('<text>')

Pengaturan	Diperlukan	Tipe	Description
< Teks>	Yes	String	String yang memiliki spasi kosong di depan dan di belakang untuk dihapus

Mengembalikan nilai	Tipe	Description
< diperbaruiTeks>	String	Versi yang diperbarui untuk string asli tanpa spasi awal atau akhir

Example

Contoh ini menghapus spasi putih terkemuka dan berikutnya dari string " Halo Dunia ":

trim(' Hello World  ')

Dan mengembalikan hasil ini: "Halo Dunia"

union

Mengembalikan koleksi yang memiliki semua item dari koleksi yang ditentukan. Untuk muncul dalam hasil, item dapat muncul di koleksi apa pun yang diteruskan ke fungsi ini. Jika satu atau beberapa item memiliki nama yang sama, item terakhir dengan nama tersebut muncul di hasilnya.

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

Pengaturan	Diperlukan	Tipe	Description
< koleksi1>, <koleksi2>, ...	Yes	Array atau Object, tetapi tidak keduanya	Koleksi dari tempat Anda menginginkan semua item

Mengembalikan nilai	Tipe	Description
< Koleksi yang diperbarui>	Array atau Objek, masing-masing	Koleksi dengan semua item dari koleksi yang ditentukan - tidak ada duplikat

Example

Contoh ini mendapatkan semua item dari koleksi ini:

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

Dan mengembalikan hasil ini: [1, 2, 3, 10, 101]

uriComponent

Mengembalikan versi pengidentifikasi sumber daya seragam (URI) yang dikodekan untuk string dengan mengganti karakter URL yang tidak aman dengan karakter escape. Gunakan fungsi ini daripada encodeUriComponent(). Meskipun kedua fungsi bekerja dengan cara yang sama, uriComponent() lebih disukai.

uriComponent('<value>')

Pengaturan	Diperlukan	Tipe	Description
< nilai>	Yes	String	String yang akan dikonversi ke format yang dikodekan URI

Mengembalikan nilai	Tipe	Description
< URI yang Dikodekan>	String	String yang dikodekan URI dengan karakter escape

Example

Contoh ini membuat versi yang dikodekan URI untuk string ini:

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

Dan mengembalikan hasil ini: "http%3A%2F%2Fcontoso.com"

uriComponentToBinary

Mengembalikan versi biner untuk komponen pengidentifikasi sumber daya seragam (URI).

uriComponentToBinary('<value>')

Pengaturan	Diperlukan	Tipe	Description
< nilai>	Yes	String	String yang dikodekan URI untuk dikonversi

Mengembalikan nilai	Tipe	Description
< biner-untuk-URI yang dikodekan>	String	Versi biner untuk string yang dikodekan URI. Konten biner dikodekan base64 dan diwakili oleh `$content`.

Example

Contoh ini membuat versi biner untuk string yang dikodekan URI ini:

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

Dan mengembalikan hasil ini:

"001000100110100001110100011101000111000000100101001100 11010000010010010100110010010001100010010100110010010001 10011000110110111101101110011101000110111101110011011011 110010111001100011011011110110110100100010"

uriComponentToString

Mengembalikan versi string untuk string yang dikodekan pengidentifikasi sumber daya seragam (URI), yang secara efektif mendekode string yang dikodekan URI.

uriComponentToString('<value>')

Pengaturan	Diperlukan	Tipe	Description
< nilai>	Yes	String	String yang dikodekan URI untuk didekodekan

Mengembalikan nilai	Tipe	Description
< URI yang Didekodekan>	String	Versi yang didekodekan untuk string yang dikodekan URI

Example

Contoh ini membuat versi string yang didekodekan untuk string yang dikodekan URI ini:

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

Dan mengembalikan hasil ini: "https://contoso.com"

utcNow

Mengembalikan tanda waktu saat ini.

utcNow('<format>')

Secara opsional, Anda dapat menentukan format yang berbeda dengan < parameter format>.

Pengaturan	Diperlukan	Tipe	Description
< Format>	Tidak.	String	Penentu format tunggal atau pola format kustom. Format default untuk tanda waktu adalah "o" (yyyy-MM-ddTHH:mm:ss.fffffffK), yang mematuhi ISO 8601 dan mempertahankan informasi zona waktu.

Mengembalikan nilai	Tipe	Description
< tanda waktu saat ini>	String	Tanggal dan waktu saat ini

Contoh 1

Misalkan hari ini adalah 15 April 2018 pukul 13:00. Contoh ini mendapatkan tanda waktu saat ini:

utcNow()

Dan mengembalikan hasil ini: "2018-04-15T13:00:00.0000000Z"

Contoh 2

Misalkan hari ini adalah 15 April 2018 pukul 13:00. Contoh ini mendapatkan tanda waktu saat ini menggunakan format "D" opsional:

utcNow('D')

Dan mengembalikan hasil ini: "Sunday, April 15, 2018"

xml

Mengembalikan versi XML untuk string yang berisi objek JSON.

xml('<value>')

Pengaturan	Diperlukan	Tipe	Description
< nilai>	Yes	String	String dengan objek JSON untuk dikonversi Objek JSON hanya boleh memiliki satu properti akar, yang tidak dapat menjadi array. Gunakan karakter garis miring terbalik (\) sebagai karakter escape untuk tanda kutip ganda (").

Mengembalikan nilai	Tipe	Description
< versi xml>	Objek	XML yang dikodekan untuk string atau objek JSON yang ditentukan

Contoh 1

Contoh ini membuat versi XML untuk string ini, yang berisi objek JSON:

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

Dan mengembalikan XML hasil ini:

<name>Sophia Owen</name>

Contoh 2

Misalkan Anda memiliki objek JSON ini:

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

Contoh ini membuat XML untuk string yang berisi objek JSON ini:

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

Dan mengembalikan XML hasil ini:

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

jalur x

Periksa XML untuk simpul atau nilai yang cocok dengan ekspresi XPath (Bahasa Jalur XML), dan kembalikan simpul atau nilai yang cocok. Ekspresi XPath, atau hanya "XPath", membantu Anda menavigasi struktur dokumen XML sehingga Anda dapat memilih simpul atau nilai komputasi dalam konten XML.

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

Pengaturan	Diperlukan	Tipe	Description
< Xml>	Yes	Apa saja	String XML untuk mencari simpul atau nilai yang cocok dengan nilai ekspresi XPath
< jalur x>	Yes	Apa saja	Ekspresi XPath digunakan untuk menemukan simpul atau nilai XML yang cocok

Mengembalikan nilai	Tipe	Description
< simpul xml>	XML	Simpul XML saat hanya satu simpul yang cocok dengan ekspresi XPath yang ditentukan
< nilai>	Apa saja	Nilai dari simpul XML jika hanya satu nilai yang cocok dengan ekspresi XPath yang ditentukan
[<xml-node1>, <xml-node2>, ...] -or- [<value1>, <value2>, ...]	Array	Array dengan simpul xml atau nilai yang cocok dengan ekspresi XPath yang ditentukan

Contoh 1

Mengikuti Contoh 1, contoh ini menemukan simpul yang cocok dengan simpul <count></count> dan menambahkan nilai simpul tersebut sum() dengan fungsi :

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

Dan mengembalikan hasil ini: 30

Contoh 2

Untuk contoh ini, kedua ekspresi menemukan simpul yang cocok dengan simpul <location></location> , dalam argumen yang ditentukan, yang menyertakan XML dengan namespace. Ekspresi menggunakan karakter garis miring terbalik (\) sebagai karakter escape untuk tanda kutip ganda (").

Ekspresi 1

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

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

Berikut adalah argumennya:

XML ini, yang mencakup namespace dokumen XML, xmlns="http://contoso.com":

<?xml version="1.0"?> <file xmlns="http://contoso.com"> <location>Paris</location> </file>

Ekspresi XPath di sini:
- /*[name()=\"file\"]/*[name()=\"location\"]
- /*[local-name()=\"file\" and namespace-uri()=\"http://contoso.com\"]/*[local-name()=\"location\"]

Berikut adalah simpul hasil yang cocok dengan simpul <location></location> :

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

Contoh 3

Mengikuti Contoh 3, contoh ini menemukan nilai dalam simpul <location></location> :

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

Dan mengembalikan hasil ini: "Paris"

Nota

Seseorang dapat menambahkan komentar ke ekspresi aliran data, tetapi tidak dalam ekspresi alur.

Evaluasilah ekspresi pipeline Anda sebelum menjalankannya

Anda dapat menggunakan fitur Evaluasi ekspresi di Microsoft Fabric Data Factory untuk menguji dan men-debug ekspresi alur Anda. Anda dapat memeriksa output ekspresi, meninjau komponen individual, dan memvalidasi logika Anda tanpa menjalankan seluruh alur.

Berikut adalah apa yang dapat Anda lakukan dengan fitur ekspresi evaluasi:

Periksa output akhir
Tinjau setiap bagian ekspresi Anda (parameter, variabel, fungsi, variabel sistem)
Masukkan nilai sampel untuk item yang hanya ada saat alur berjalan

Dengan cara ini, Anda dapat mengonfirmasi logika dan pemformatan berfungsi dengan benar sebelum menjadwalkan atau menjalankan alur Anda.

Kapan menggunakan fitur Evaluasi ekspresi

Berikut adalah beberapa cara fitur Ekspresi evaluasi dapat membantu Anda:

Konfirmasi string atau nilai terakhir yang dikembalikan oleh ekspresi Anda (seperti jalur folder bertanggal atau nama file yang diformat)
Periksa apakah parameter dan variabel berfungsi dengan benar dalam ekspresi Anda
Uji kombinasi fungsi (string, tanggal/waktu, matematika) dan lihat hasilnya segera
Berikan input sampel untuk item yang hanya ada selama eksekusi alur aktual (seperti nilai pemicu atau output aktivitas)

Cara menggunakan fitur Evaluasi ekspresi

Buka penyusun ekspresi di rangkaian kerja Anda.
Ketik atau tempelkan ekspresi Anda.
Pilih Evaluasi pernyataan.
Tinjau bagian Nilai dalam tabel yang memperlihatkan setiap bagian ekspresi Anda (parameter, variabel, variabel sistem, fungsi).
Jika ada bagian yang membutuhkan nilai sampel (seperti waktu pemicu atau output aktivitas), ketikkan di bidang Nilai .
Pilih Evaluasi lagi untuk melihat hasil yang diperbarui.

Petunjuk

Panel sering mengisi default untuk parameter dan variabel. Anda dapat menimpanya untuk menguji berbagai skenario.

Batasan saat ini untuk evaluasi ekspresi

Saat ini, evaluasi terjadi sebelum pipeline berjalan. Evaluator tidak tahu apa pun yang terjadi pada runtime atau sesudahnya. Ini tidak menarik ID eksekusi, ID instans pemicu, output aktivitas, atau nilai apa pun yang hanya ada selama eksekusi. Jadi, Anda harus memberikan nilai-nilai ini secara manual.

Apa yang harus dilakukan sebagai gantinya: Di kolom Nilai , ketik nilai sampel untuk mencerminkan data yang Anda harapkan pada runtime (seperti tempelkan JSON tiruan untuk activity('LookupCustomers').output). Ini memungkinkan Anda memvalidasi struktur dan pemformatan ekspresi Anda meskipun alur tidak berjalan.

Merancang ekspresi pipeline dengan Copilot

Penyusun ekspresi alur sekarang dilengkapi dengan Copilot bawaan. Anda dapat mengobrol dengan Copilot secara langsung di penyusun ekspresi, mirip dengan cara Anda berinteraksi dengannya di fitur Data Factory lainnya. Ini berarti Anda bisa mendapatkan bantuan membuat dan memahami ekspresi tanpa meninggalkan ruang kerja Anda.

Saat ini, Copilot membantu Anda:

Menulis ekspresi alur tanpa pengkodian manual
Hindari kesalahan
Bekerja lebih cepat
Membangun alur yang kuat dengan percaya diri

Untuk membuka penyusun ekspresi alur:

Tambahkan aktivitas yang mendukung konten atau ekspresi dinamis.
Di dalam aktivitas, pilih Tampilkan di penyusun ekspresi atau Tambahkan konten dinamis tempat Anda ingin menambahkan ekspresi Anda.
Anda melihat ke pembangun ekspresi alur kerja, di mana Anda dapat menemukan pengalaman "Copilot" sebaris.

Hasilkan ekspresi dengan bahasa alami

Ketik apa yang Anda inginkan di obrolan Copilot. Copilot mengubah permintaan Anda menjadi ekspresi alur.

Misalnya, Anda dapat memasukkan:

Get the current date and time in UTC. Convert the current UTC time to Central Standard Time (CST). Format the converted CST time into a string like 2025/07/10. Finally, concatenate the string "ContosoSales\\" with the formatted date.

Anda dapat memilih untuk Menerima, Membuang, atau Menyegarkan untuk mencoba kembali ekspresi Anda.

Menjelaskan ekspresi dalam bahasa biasa

Copilot memberi Anda penjelasan yang jelas tentang apa yang dilakukan ekspresi pipeline Anda.

Anda dapat memilih Jelaskan ekspresi ini atau minta Copilot di obrolan untuk menjelaskannya.

Berikut adalah contoh ringkasan copilot mungkin menyediakan:

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2025-09-05