Ekspresi dan fungsi di Azure Data Factory dan Azure Synapse Analytics

BERLAKU UNTUK: Azure Data Factory Azure Synapse Analytics

Kiat

Cobalah Data Factory di Microsoft Fabric, solusi analitik all-in-one untuk perusahaan. Microsoft Fabric mencakup semuanya mulai dari pergerakan data hingga ilmu data, analitik real time, kecerdasan bisnis, dan pelaporan. Pelajari cara memulai uji coba baru secara gratis!

Artikel ini memberikan detail tentang ekspresi dan fungsi yang didukung oleh Azure Data Factory dan Azure Synapse Analytics.

Ekspresi

Nilai JSON dalam definisi dapat berupa nilai literal atau ekspresi yang dievaluasi pada waktu runtime. Contohnya:

"name": "value"

atau

"name": "@pipeline().parameters.password"

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

Nilai JSON	Hasil
"parameter"	Karakter 'parameter' dikembalikan.
"parameter[1]"	Karakter 'parameters[1]' itu dikembalikan.
"@@"	String karakter 1 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 dimasukkan dalam @{ ... }. Misalnya: "name" : "First Name: @{pipeline().parameters.firstName} Last Name: @{pipeline().parameters.lastName}"

Dengan menggunakan interpolasi string, hasilnya selalu berupa string. Katakanlah saya telah menentukan myNumber sebagai 42 dan myString sebagai foo:

Nilai JSON	Hasil
"@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: @{pipeline().parameters.myNumber}"	Mengembalikan string Answer is: 42.
"@concat('Jawabannya adalah: ', string(pipeline().parameters.myNumber))"	Mengembalikan string Answer is: 42
"Jawaban adalah: @@{pipeline().parameters.myNumber}"	Mengembalikan string Answer is: @{pipeline().parameters.myNumber}.

Dalam aktivitas alur kontrol seperti aktivitas ForEach, Anda dapat menyediakan larik yang akan diulang untuk item properti dan menggunakan @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) seperti ekspresi untuk melakukan iterasi dari 0 sampai 9 sebanyak sepuluh kali.

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

Contoh

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.

1. Tambahkan Tanggal ke filename: @concat('Test_', formatDateTime(utcnow(), 'yyyy-dd-MM'))

2. Tambahkan DateTime di zona waktu pelanggan : @concat('Test_', convertFromUtc(utcnow(), 'Pacific Standard Time'))

3. Tambahkan Waktu Pemicu : @concat('Test_', pipeline().TriggerTime)

4. Keluarkan nama file khusus dalam Aliran Data Pemetaan saat mengeluarkan ke satu file dengan tanggal : 'Test_' + toString(currentDate()) + '.csv'

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

Editor konten dinamis

Editor konten dinamis secara otomatis meng-escape karakter dalam konten Anda setelah Anda selesai mengedit. Misalnya, konten berikut di editor konten adalah interpolasi string dengan dua fungsi ekspresi.

{ 
  "type": "@{if(equals(1, 2), 'Blob', 'Table' )}",
  "name": "@{toUpper('myData')}"
}

Editor konten dinamis mengonversi konten di atas untuk ekspresi "{ \n \"type\": \"@{if(equals(1, 2), 'Blob', 'Table' )}\",\n \"name\": \"@{toUpper('myData')}\"\n}". Hasil dari ekspresi ini adalah untai (karakter) format JSON yang ditunjukkan di bawah ini.

{
  "type": "Table",
  "name": "MYDATA"
}

Himpunan data dengan parameter

Dalam contoh berikut, BlobDataset mengambil parameter bernama jalur. Nilainya digunakan untuk mengatur nilai untuk properti folderPath dengan menggunakan ekspresi: dataset().path.

{
    "name": "BlobDataset",
    "properties": {
        "type": "AzureBlob",
        "typeProperties": {
            "folderPath": "@dataset().path"
        },
        "linkedServiceName": {
            "referenceName": "AzureStorageLinkedService",
            "type": "LinkedServiceReference"
        },
        "parameters": {
            "path": {
                "type": "String"
            }
        }
    }
}

Alur dengan parameter

Dalam contoh berikut, alur mengambil parameter inputPath dan outputPath. Jalur untuk himpunan data blob yang berparameter diatur menggunakan nilai parameter ini. Sintaks yang digunakan di sini adalah: pipeline().parameters.parametername.

{
    "name": "Adfv2QuickStartPipeline",
    "properties": {
        "activities": [
            {
                "name": "CopyFromBlobToBlob",
                "type": "Copy",
                "inputs": [
                    {
                        "referenceName": "BlobDataset",
                        "parameters": {
                            "path": "@pipeline().parameters.inputPath"
                        },
                        "type": "DatasetReference"
                    }
                ],
                "outputs": [
                    {
                        "referenceName": "BlobDataset",
                        "parameters": {
                            "path": "@pipeline().parameters.outputPath"
                        },
                        "type": "DatasetReference"
                    }
                ],
                "typeProperties": {
                    "source": {
                        "type": "BlobSource"
                    },
                    "sink": {
                        "type": "BlobSink"
                    }
                }
            }
        ],
        "parameters": {
            "inputPath": {
                "type": "String"
            },
            "outputPath": {
                "type": "String"
            }
        }
    }
}

Mengganti karakter khusus

Editor konten dinamis secara otomatis meng-escape karakter seperti kutipan ganda, tanda miring terbalik dalam konten Anda setelah Anda selesai mengedit. Ini menyebabkan masalah jika Anda ingin mengganti umpan baris atau tab dengan menggunakan \n, \t dalam fungsi ganti(). 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:

1. Pengkodean URL terhadap nilai string asli
2. Ganti string berkodekan URL, misalnya, umpan baris (%0A), mengembalikan kursor(%0D), tab horizontal (%09).
3. Dekode URL

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

Contoso-
Corporation

Meloloskan karakter tanda kutip tunggal

Fungsi ekspresi dalam alur menggunakan tanda kutip tunggal (') untuk mengelilingi parameter nilai string. Gunakan dua karakter kutipan tunggal secara berurutan dalam ekspresi string jalur untuk menyertakan tanda kutip tunggal. Berikut adalah contoh: ekspresi @concat('Here is a double quote character: ". ', 'And here is a single quote character all within the same string: ''.') akan mengembalikan hasil berikut:

Here is a double quote character: ". And here is a single quote character all within the same string: '.

Namun, dalam ekspresi aliran data, sintaks ini tidak didukung. Sebaliknya, ekspresi aliran data dapat dikelilingi oleh tanda kutip tunggal atau ganda. Sertakan teks yang memerlukan tanda kutip tunggal dalam tanda kutip ganda, dan teks yang memerlukan tanda kutip ganda dalam tanda kutip tunggal, dalam fungsi string. Jika Anda memerlukan string yang berisi tanda kutip tunggal dan ganda, Anda dapat menggunakan concat() untuk menggabungkan dua substring yang masing-masing berisi tanda kutip tunggal atau tanda kutip ganda. Aliran data yang setara dengan contoh ekspresi alur sebelumnya adalah concat('Here is a double quote character: ". ', "And here is a single quote character all within the same string: '."). Dalam aliran data, ekspresi tersebut akan mengembalikan hasil yang sama dengan contoh sebelumnya untuk ekspresi alur.

Tutorial

Tutorial ini memandu Anda bagaimana cara meneruskan parameter antara pipeline dan aktivitas serta antar aktivitas. Tutorial ini secara khusus menunjukkan langkah-langkah untuk Data Factory Azure meskipun langkah-langkah untuk ruang kerja Synapse hampir setara tetapi dengan antarmuka pengguna yang sedikit berbeda.

Fungsi

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

Fungsi tanggal

Fungsi tanggal atau waktu	Tugas
addDays	Tambahkan sejumlah hari ke cap waktu.
addHours	Tambahkan sejumlah jam ke stempel waktu.
addMinutes	Menambahkan sejumlah menit ke tanda waktu.
addSeconds	Menambahkan beberapa detik ke tanda waktu.
addToTime	Menambahkan sejumlah unit waktu ke tanda waktu. Lihat juga getFutureTime.
convertFromUtc	Mengonversi tanda waktu dari Universal Time Coordinated (UTC) ke zona waktu target.
convertTimeZone	Mengonversi 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 satu bulan 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 teks 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 subtractFromTime.
startOfDay	Mengembalikan awal hari untuk tanda waktu.
startOfHour	Kembalikan awal jam untuk cap waktu.
startOfMonth	Mengembalikan awal bulan untuk tanda waktu.
subtractFromTime	Mengurangi jumlah unit waktu dari tanda waktu. Lihat juga getPastTime.
ticks	Mengembalikan nilai properti ticks untuk tanda waktu tertentu.
utcNow	Kembalikan tanda waktu saat ini sebagai string.

Fungsi string

Jika ingin menggunakan string, Anda dapat menggunakan fungsi string ini dan juga beberapa fungsi koleksi. Fungsi-fungsi string hanya bekerja pada string.

Fungsi string	Tugas
concat	Gabungkan dua string atau lebih, dan hasilkan string gabungan.
berakhirDengan	Periksa apakah sebuah string diakhiri dengan substring tertentu.
guid	Menghasilkan pengidentifikasi unik global (GUID) dalam bentuk string.
indexOf	Mengembalikan posisi awal untuk substring.
lastIndexOf	Mengembalikan posisi permulaan untuk kemunculan terakhir dari suatu subrangkaian teks.
mengganti	Mengganti substring dengan string yang ditentukan, dan mengembalikan string yang diperbarui.
belah	Pisahkan string pada setiap kemunculan pemisah tertentu, mengembalikan substring yang dihasilkan sebagai elemen array.
startsWith	Memeriksa apakah string dimulai dengan substring tertentu.
subrangkaian	Mengembalikan karakter dari string, dimulai dari posisi yang ditentukan.
toLower	Mengembalikan untai (karakter) dalam format huruf kecil.
toUpper	Mengembalikan string dalam format huruf besar.
trim	Menghapus spasi di depan dan di belakang pada string, dan mengembalikan string yang diperbarui.

Fungsi pengumpulan

Untuk bekerja dengan koleksi data, umumnya berupa larik, string, dan terkadang kamus, Anda dapat menggunakan fungsi-fungsi koleksi ini.

Fungsi pengumpulan	Tugas
mengandung	Memeriksa apakah koleksi memiliki item tertentu.
kosong	Memeriksa apakah suatu koleksi kosong.
pertama	Mengembalikan item pertama dari koleksi.
persimpangan	Mengembalikan koleksi yang hanya berisi item umum dari koleksi yang ditentukan.
join	Mengembalikan string yang memiliki semua item dari larik, dipisahkan oleh karakter yang ditentukan.
terakhir	Mengembalikan item terakhir dari koleksi.
length	Mengembalikan jumlah item dalam string atau larik.
skip	Menghapus item dari depan koleksi, dan mengembalikan semua item lainnya.
take	Mengembalikan item dari bagian depan koleksi.
union	Mengembalikan koleksi yang memiliki semua item dari koleksi yang ditentukan.

Fungsi logika

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

Fungsi perbandingan logika	Tugas
dan	Periksa apakah semua ekspresi benar.
setara	Memeriksa apakah kedua nilai tersebut setara.
lebih besar	Memeriksa apakah nilai pertama lebih besar dari nilai kedua.
lebihbesarAtauSetara	Memeriksa apakah nilai pertama lebih besar dari atau sama dengan nilai kedua.
jika	Periksa apakah ekspresi itu true atau false. Berdasarkan hasilnya, mengembalikan nilai yang ditentukan.
kurang	Periksa apakah nilai pertama kurang dari nilai kedua.
kurangAtauSetara	Memeriksa apakah nilai pertama kurang dari atau sama dengan nilai kedua.
Tidak	Periksa apakah ekspresi itu false.
atau	Memeriksa apakah setidaknya satu pernyataan benar.

Fungsi konversi

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

• string
• Bilangan bulat
• mengapung
• Boolean
• larik
• kamus

Fungsi konversi	Tugas
array	Mengembalikan larik dari satu input yang ditentukan. Untuk beberapa input, lihat createArray.
base64	Mengembalikan versi yang dienkode ke base64 untuk string.
base64ToBinary	Mengembalikan versi biner untuk string yang dienkode ke base64.
base64ToString	Mengembalikan versi string untuk string yang dienkode ke base64.
biner	Mengembalikan versi biner untuk nilai input.
bool	Mengembalikan versi Boolean untuk nilai input.
menyatu	Mengembalikan nilai non-null pertama dari satu atau beberapa parameter.
createArray	Mengembalikan larik 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 representasi string untuk string yang dienkode ke base64.
decodeDataUri	Mengembalikan versi biner untuk URI data.
decodeUriComponent	Mengembalikan string yang menggantikan escape character dengan versi yang didekodekan.
decodeUriComponent	Mengembalikan string yang menggantikan karakter URL yang tidak aman dengan escape character.
float	Mengembalikan angka titik mengambang untuk nilai input.
int	Mengembalikan versi bilangan bulat untuk string.
json	Mengembalikan nilai jenis JavaScript Object Notation (JSON) atau objek untuk string atau XML.
string	Mengembalikan versi string untuk nilai input.
uriComponent	Mengembalikan versi yang dienkode ke URI untuk nilai input dengan mengganti karakter URL yang tidak aman dengan escape character.
uriComponentToBinary	Mengembalikan versi biner untuk string yang dienkode ke URI.
uriComponentToString	Mengembalikan versi string dari string yang telah dienkode ke URI.
xml	Mengembalikan versi XML untuk string.
xpath	Memeriksa XML apakah terdapat node atau nilai yang sesuai dengan ekspresi XPath dan menghasilkan node atau nilai tersebut.

Fungsi matematika

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

Fungsi matematika	Tugas
penambahan	Mengembalikan hasil dari penjumlahan dua angka.
div	Mengembalikan hasil dari pembagian satu angka dengan angka lain.
max	Mengembalikan nilai tertinggi dari sekumpulan angka atau larik.
mnt	Mengembalikan nilai terendah dari sekumpulan angka atau larik.
mod	Mengembalikan sisa dari pembagian satu angka dengan angka lain.
mul	Mengembalikan produk dari perkalian dua angka.
rand	Mengembalikan bilangan bulat acak dari rentang tertentu.
rentang	Mengembalikan larik bilangan bulat yang dimulai dari bilangan bulat tertentu.
sub	Mengembalikan hasil dari pengurangan satu angka dari angka lain.

Referensi fungsi

Bagian ini mencantumkan semua fungsi yang tersedia dalam urutan alfabet.

add

Mengembalikan hasil dari penjumlahan dua angka.

add(<summand_1>, <summand_2>)

Parameter	Wajib	Tipe	Deskripsi
< summand_1>, <summand_2>	Ya	Bilangan bulat, Mengambang, atau Campuran	Angka yang akan ditambahkan

Nilai kembalian	Tipe	Deskripsi
< result-sum>	Bilangan bulat atau bilangan riil	Hasil dari menambahkan angka yang ditentukan

Contoh

Contoh ini menambahkan angka yang ditentukan:

add(1, 1.5)

Dan mengembalikan hasil ini: 2.5

addDays

Menambahkan sejumlah hari ke stempel waktu.

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

Parameter	Wajib	Tipe	Deskripsi
< timestamp>	Ya	String	String yang berisi tanda waktu
< hari>	Ya	Bilangan bulat	Jumlah hari positif atau negatif yang akan 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 sesuai dengan ISO 8601 dan mempertahankan informasi zona waktu.

Nilai balik	Tipe	Deskripsi
< updated-timestamp>	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

Menambahkan sejumlah jam ke timestamp.

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

Parameter	Wajib	Tipe	Deskripsi
< timestamp>	Ya	String	String yang berisi tanda waktu
< hour>s	Ya	Bilangan bulat	Jumlah jam positif atau negatif yang akan 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 sesuai dengan ISO 8601 dan mempertahankan informasi zona waktu.

Nilai hasil	Tipe	Deskripsi
< updated-timestamp>	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 cap waktu.

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

Parameter	Wajib	Tipe	Deskripsi
< timestamp>	Ya	String	String yang berisi tanda waktu
< menit>	Ya	Bilangan bulat	Jumlah menit positif atau negatif yang akan 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 sesuai dengan ISO 8601 dan mempertahankan informasi zona waktu.

Nilai pengembalian	Tipe	Deskripsi
< updated-timestamp>	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

Menambahkan beberapa detik ke tanda waktu.

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

Parameter	Wajib	Tipe	Deskripsi
< timestamp>	Ya	String	String yang berisi tanda waktu
< seconds>	Ya	Bilangan bulat	Jumlah detik yang 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 sesuai dengan ISO 8601 dan mempertahankan informasi zona waktu.

Nilai pengembalian	Tipe	Deskripsi
< updated-timestamp>	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 dari tanda waktu yang ditentukan:

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

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

addToTime

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

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

Parameter	Wajib	Tipe	Deskripsi
< timestamp>	Ya	String	String yang berisi tanda waktu
< interval>	Ya	Bilangan bulat	Jumlah unit waktu yang ditentukan untuk ditambahkan
< timeUnit>	Ya	String	Unit waktu yang akan 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 sesuai dengan ISO 8601 dan mempertahankan informasi zona waktu.

Nilai hasil	Tipe	Deskripsi
< updated-timestamp>	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 hasil menggunakan format "D" opsional: "Tuesday, January 2, 2018"

and

Periksa apakah kedua ekspresi true. Kembalikan true saat kedua ekspresi tersebut true, atau kembalikan false bila setidaknya satu ekspresi adalah false.

and(<expression1>, <expression2>)

Parameter	Wajib	Tipe	Deskripsi
< expression1>, <expression2>	Ya	Boolean	Ekspresi yang akan diperiksa

Nilai pengembalian	Tipe	Deskripsi
BENAR atau SALAH	Boolean	Kembalikan benar ketika kedua kalimat tersebut benar. Mengembalikan "false" ketika setidaknya satu pernyataan "false".

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 berikut:

• Contoh pertama: Kedua ekspresi adalah true, jadi mengembalikan true.
• Contoh kedua: Satu ekspresi bernilai false, sehingga 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-hasil berikut:

• 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 sebuah larik dari input yang telah ditentukan. Untuk beberapa input, lihat createArray().

array('<value>')

Parameter	Wajib	Tipe	Deskripsi
< nilai>	Ya	String	String untuk membuat array

Nilai balikan	Tipe	Deskripsi
[<nilai>]	Array	Array yang berisi input tunggal yang ditentukan

Contoh

Contoh ini membuat larik dari string "hello":

array('hello')

Dan mengembalikan hasil ini: ["hello"]

base64

Mengembalikan versi yang dienkode ke base64 untuk string.

base64('<value>')

Parameter	Wajib	Tipe	Deskripsi
< nilai>	Ya	String	String masukan

Nilai hasil	Tipe	Deskripsi
< base64-string>	String	Versi dienkode ke base64 untuk string input

Contoh

Contoh ini mengonversi string "hello" ke string yang dienkode ke base64:

base64('hello')

Dan mengembalikan hasil ini: "aGVsbG8="

base64ToBinary

Mengembalikan versi biner untuk string yang dienkode ke base64.

base64ToBinary('<value>')

Parameter	Wajib	Tipe	Deskripsi
< nilai>	Ya	String	String yang dienkode ke base64 yang akan dikonversi

Nilai kembalian	Tipe	Deskripsi
< binary-for-base64-string>	String	Versi biner untuk string yang dienkode ke base64

Contoh

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

base64ToBinary('aGVsbG8=')

Dan mengembalikan hasil ini:

"0110000101000111010101100111001101100010010001110011100000111101"

base64KeString

Mengembalikan versi string dari string yang dikodekan base64, yang efektif mendekode string base64 tersebut. Gunakan fungsi ini alih-alih dekodeBase64(). Meskipun kedua fungsi bekerja dengan cara yang sama, base64ToString() lebih disukai.

base64ToString('<value>')

Parameter	Wajib	Tipe	Deskripsi
< nilai>	Ya	String	String yang dikodekan base64 untuk didekodekan

Nilai kembalian	Tipe	Deskripsi
< decoded-base64-string>	String	Versi string untuk string yang dikodekan base64

Contoh

Contoh ini mengonversi untai (karakter) yang dikodekan base64 "aGVsbG8=" menjadi untai (karakter) saja:

base64ToString('aGVsbG8=')

Dan mengembalikan hasil ini: "hello"

binary

Mengembalikan versi biner dari string.

binary('<value>')

Parameter	Wajib	Tipe	Deskripsi
< nilai>	Ya	String	String yang akan dikonversi

Nilai balikan	Tipe	Deskripsi
< biner-untuk-nilai-masukan>	String	Versi biner untuk untai (karakter) yang ditentukan

Contoh

Contoh ini mengonversi untai (karakter) "hello" ke untai (karakter) biner:

binary('hello')

Dan mengembalikan hasil ini:

"0110100001100101011011000110110001101111"

bool

Mengembalikan representasi Boolean dari suatu nilai.

bool(<value>)

Parameter	Wajib	Tipe	Deskripsi
< nilai>	Ya	Apa saja	Nilai yang akan dikonversi

Nilai balik	Tipe	Deskripsi
BENAR atau SALAH	Boolean	Versi Boolean untuk nilai yang ditentukan

Contoh

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

bool(1)
bool(0)

Dan mengembalikan hasil-hasil berikut:

• Contoh pertama: true
• Contoh kedua: false

coalesce

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

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

Parameter	Wajib	Tipe	Deskripsi
< objek_1>, <objek_2>, ...	Ya	Apa saja, dapat berupa campuran jenis	Satu atau beberapa item untuk diperiksa null-nya

Nilai hasil	Tipe	Deskripsi
< elemen-pertama-bukan-null>	Apa saja	Item atau nilai pertama yang bukan null. Jika semua parameter null, fungsi ini akan mengembalikan null.

Contoh

Contoh berikut ini mengembalikan nilai bukan null pertama dari nilai-nilai yang ditentukan, atau null jika semua nilai adalah 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 atau lebih string, dan kembalikan string gabungan.

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

Parameter	Wajib	Tipe	Deskripsi
< text1>, <text2>, ...	Ya	String	Minimal dua string untuk digabungkan

Nilai hasil	Tipe	Deskripsi
< text1text2...>	String	Untai yang dibuat dari gabungan untai input

Contoh

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

concat('Hello', 'World')

Dan mengembalikan hasil ini: "HelloWorld"

contains

Memeriksa apakah koleksi memiliki item tertentu. Mengembalikan true saat item ditemukan atau kembalikan false saat tidak ditemukan. Fungsi ini sensitif terhadap huruf besar/kecil.

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

Secara khusus, fungsi ini bekerja pada jenis koleksi ini:

• Sebuah teks untuk menemukan subteks
• Larik untuk menemukan nilai
• Kamus untuk menemukan kunci

Parameter	Wajib	Tipe	Deskripsi
< collection>	Ya	String, Larik, atau Kamus	Koleksi yang akan diperiksa
< nilai>	Ya	Untai (karakter), Larik, atau Kamus, masing-masing	Item yang akan ditemukan

Nilai pengembalian	Tipe	Deskripsi
BENAR atau SALAH	Boolean	Mengembalikan status benar ketika item ditemukan. Mengembalikan nilai salah jika tidak ditemukan.

Contoh 1

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

contains('hello world', 'world')

Contoh 2

Contoh ini memeriksa teks "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>'?)

Parameter	Wajib	Tipe	Deskripsi
< timestamp>	Ya	String	String yang berisi tanda waktu
< destinationTimeZone>	Ya	String	Nama zona waktu target. Untuk nama zona waktu, lihat Nilai Zona Waktu Microsoft, tetapi Anda mungkin harus menghapus semua tanda baca 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 sesuai dengan ISO 8601 dan mempertahankan informasi zona waktu.

Nilai hasil	Tipe	Deskripsi
< converted-timestamp>	String	Tanda waktu yang 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 format dan zona waktu yang ditentukan:

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

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

convertTimeZone

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

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

Parameter	Wajib	Tipe	Deskripsi
< timestamp>	Ya	String	String yang berisi tanda waktu
< sourceTimeZone>	Ya	String	Nama untuk zona waktu sumber. Untuk nama zona waktu, lihat Nilai Zona Waktu Microsoft, tetapi Anda mungkin harus menghapus semua tanda baca dari nama zona waktu.
< destinationTimeZone>	Ya	String	Nama zona waktu target. Untuk nama zona waktu, lihat Nilai Zona Waktu Microsoft, tetapi Anda mungkin harus menghapus semua tanda baca 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 sesuai dengan ISO 8601 dan mempertahankan informasi zona waktu.

Nilai pengembalian	Tipe	Deskripsi
< converted-timestamp>	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>'?)

Parameter	Wajib	Tipe	Deskripsi
< timestamp>	Ya	String	String yang berisi tanda waktu
< sourceTimeZone>	Ya	String	Nama untuk zona waktu sumber. Untuk nama zona waktu, lihat Nilai Zona Waktu Microsoft, tetapi Anda mungkin harus menghapus semua tanda baca 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 sesuai dengan ISO 8601 dan mempertahankan informasi zona waktu.

Nilai pengembalian	Tipe	Deskripsi
< converted-timestamp>	String	Tanda waktu yang 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 larik dari beberapa input. Untuk larik input tunggal, lihat array().

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

Parameter	Wajib	Tipe	Deskripsi
< object1>, <object2>, ...	Ya	Apa saja, tetapi bukan campuran	Setidaknya dua item untuk membuat larik

Nilai yang dikembalikan	Tipe	Deskripsi
[<object1>, <object2>, ...]	Array	Larik yang dibuat dari semua item input

Contoh

Contoh ini membuat array dari masukan berikut:

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

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

dataUri

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

dataUri('<value>')

Parameter	Wajib	Tipe	Deskripsi
< nilai>	Ya	String	String yang akan dikonversi

Nilai yang dikembalikan	Tipe	Deskripsi
< data-uri>	String	URI data untuk string input

Contoh

Contoh ini membuat URI data untuk untai (karakter) "hello":

dataUri('hello')

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

dataUriToBinary

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

dataUriToBinary('<value>')

Parameter	Wajib	Tipe	Deskripsi
< nilai>	Ya	String	URI data yang akan dikonversi

Nilai kembalian	Tipe	Deskripsi
< binary-for-data-uri>	String	Versi biner untuk URI data

Contoh

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 pengenal sumber daya seragam (URI) data.

dataUriToString('<value>')

Parameter	Wajib	Tipe	Deskripsi
< nilai>	Ya	String	URI data yang akan dikonversi

Nilai hasil	Tipe	Deskripsi
< string-for-data-uri>	String	Versi untai untuk URI data

Contoh

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 bulan dari sebuah tanda waktu.

dayOfMonth('<timestamp>')

Parameter	Wajib	Tipe	Deskripsi
< timestamp>	Ya	String	String yang berisi tanda waktu

Nilai hasil	Tipe	Deskripsi
< hari-bulan>	Bilangan bulat	Hari dalam bulan dari tanda waktu yang ditentukan

Contoh

Contoh ini mengembalikan nomor hari dalam bulan dari tanda waktu ini:

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

Dan mengembalikan hasil ini: 15

dayOfWeek

Mengembalikan hari dalam minggu dari tanda waktu.

dayOfWeek('<timestamp>')

Parameter	Wajib	Tipe	Deskripsi
< timestamp>	Ya	String	String yang berisi tanda waktu

Nilai hasil	Tipe	Deskripsi
< hari dalam minggu>	Bilangan bulat	Hari dalam minggu dari tanda waktu yang ditentukan, dengan Minggu adalah 0, Senin adalah 1, dan seterusnya

Contoh

Contoh ini mengembalikan nomor hari dalam minggu dari tanda waktu ini:

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

Dan mengembalikan hasil ini: 3

dayOfYear

Mengembalikan hari dalam tahun dari sebuah tanda waktu.

dayOfYear('<timestamp>')

Parameter	Wajib	Tipe	Deskripsi
< timestamp>	Ya	String	String yang berisi tanda waktu

Nilai pengembalian	Tipe	Deskripsi
< hari-dalam-tahun>	Bilangan bulat	Hari dalam tahun dari tanda waktu yang ditentukan

Contoh

Contoh ini mengembalikan nomor hari dalam bulan dari tanda waktu ini:

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

Dan mengembalikan hasil ini: 74

decodeBase64

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

decodeBase64('<value>')

Parameter	Wajib	Tipe	Deskripsi
< nilai>	Ya	String	String yang dikodekan base64 untuk didekode

Nilai pengembalian	Tipe	Deskripsi
< decoded-base64-string>	String	Versi teks untuk string yang dikodekan base64

Contoh

Contoh ini membuat string untuk string yang dikodekan dalam base64.

decodeBase64('aGVsbG8=')

Dan mengembalikan hasil ini: "hello"

decodeDataUri

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

decodeDataUri('<value>')

Parameter	Wajib	Tipe	Deskripsi
< nilai>	Ya	String	Untai (karakter) URI data yang akan didekode

Nilai balik	Tipe	Deskripsi
< binary-for-data-uri>	String	Versi biner untuk string URI data

Contoh

Contoh ini mengembalikan versi biner untuk URI data ini:

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

Dan mengembalikan hasil ini:

"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"

decodeUriComponent

Mengembalikan string yang menggantikan escape character dengan versi yang didekodekan.

decodeUriComponent('<value>')

Parameter	Wajib	Tipe	Deskripsi
< nilai>	Ya	String	String dengan karakter escape untuk didekode

Nilai pengembalian	Tipe	Deskripsi
< decoded-uri>	String	String yang diperbarui dengan karakter pelolosan yang didekode

Contoh

Contoh ini menggantikan karakter escape dalam untai (karakter) ini dengan versi yang didekode:

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

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

div

Mengembalikan hasil pembagian satu angka dengan angka lain.

div(<dividend>, <divisor>)

Jenis pengembalian fungsi yang tepat tergantung pada jenis parameternya — lihat contoh untuk detailnya.

Parameter	Wajib	Tipe	Deskripsi
< dividend>	Ya	Bilangan bulat atau Float	Angka untuk dibagi dengan pembagi
< divisor>	Ya	Bilangan bulat atau Float	Angka yang membagi dividen. Nilai pembavis nol menyebabkan kesalahan saat runtime.

Nilai pengembalian	Tipe	Deskripsi
< quotient-result>	Bilangan bulat atau desimal	Hasil pembagian angka pertama dengan angka kedua

Contoh 1

Contoh-contoh ini membagi angka 9 dengan 2:

div(9, 2.0)
div(9.0, 2)
div(9.0, 2.0)

Dan semua mengembalikan hasil ini: 4.5

Contoh 2

Contoh ini juga membagi angka 9 dengan 2, tetapi karena kedua parameter adalah bilangan bulat sisanya dibuang (pembagian bilangan bulat):

div(9, 2)

Ekspresi mengembalikan hasil 4. Untuk mendapatkan nilai sisanya, gunakan fungsi mod().

encodeUriComponent

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

encodeUriComponent('<value>')

Parameter	Wajib	Tipe	Deskripsi
< nilai>	Ya	String	String untuk dikonversi ke format berkodekan URI

Nilai hasil	Tipe	Deskripsi
< encoded-uri>	String	String terkode URI dengan karakter escape

Contoh

Contoh ini membuat versi berkodekan URI untuk string ini:

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

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

empty

Periksa apakah koleksi itu kosong. Mengembalikan true ketika koleksi kosong, atau mengembalikan false ketika tidak kosong.

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

Parameter	Wajib	Tipe	Deskripsi
< collection>	Ya	String, Array, atau Objek	Koleksi yang akan diperiksa

Nilai kembalian	Tipe	Deskripsi
BENAR atau SALAH	Boolean	Mengembalikan true saat koleksi kosong. Kembalikan false ketika tidak kosong.

Contoh

Contoh berikut 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 parameter "abc", sehingga fungsi mengembalikan false.

endsWith

Periksa apakah sebuah string diakhiri dengan substring tertentu. Mengembalikan benar saat substring ditemukan, atau salah saat subsring tidak ditemukan. Fungsi ini tidak peka terhadap huruf besar/kecil.

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

Parameter	Wajib	Tipe	Deskripsi
< text>	Ya	String	String yang akan diperiksa
< searchText>	Ya	String	Substring akhir yang akan ditemukan

Nilai balik	Tipe	Deskripsi
BENAR atau SALAH	Boolean	Mengembalikan true saat substring akhir ditemukan. Mengembalikan false jika tidak ditemukan.

Contoh 1

Contoh ini memeriksa apakah string "hello world" berakhir dengan string "world":

endsWith('hello world', 'world')

Dan mengembalikan hasil ini: true

Contoh 2

Contoh ini memeriksa apakah teks "hello world" diakhiri dengan teks "universe":

endsWith('hello world', 'universe')

Dan mengembalikan hasil ini: false

equals

Memeriksa apakah kedua nilai, ekspresi, atau objek bersifat setara. Mengembalikan true saat keduanya setara, atau mengembalikan false saat tidak setara.

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

Parameter	Wajib	Tipe	Deskripsi
< object1>, <object2>	Ya	Bermacam-macam	Nilai, ekspresi, atau objek yang akan dibandingkan

Nilai kembalian	Tipe	Deskripsi
BENAR atau SALAH	Boolean	Mengembalikan benar ketika keduanya setara. Mengembalikan false ketika tidak setara.

Contoh

Contoh berikut 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 pertama: Kedua nilai tidak setara, sehingga fungsi mengembalikan false.

first

Mengembalikan item pertama dari string atau array.

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

Parameter	Wajib	Tipe	Deskripsi
< collection>	Ya	String atau Array	Koleksi tempat item pertama ditemukan

Nilai hasil	Tipe	Deskripsi
< first-collection-item>	Apa saja	Item pertama dalam koleksi

Contoh

Contoh-contoh ini menemukan item pertama dalam koleksi-koleksi berikut:

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

Mengembalikan hasil ini:

• Contoh pertama: "h"
• Contoh kedua: 0

float

Mengonversi string angka dengan format bilangan titik mengambang menjadi bilangan titik mengambang yang sesungguhnya.

float('<value>')

Parameter	Wajib	Tipe	Deskripsi
< nilai>	Ya	String	String yang memiliki bilangan titik mengambang yang valid untuk dikonversi

Nilai kembalian	Tipe	Deskripsi
< float-value>	Mengapung	Bilangan floating-point untuk string yang ditentukan

Contoh

Contoh ini membuat versi string untuk angka floating-point ini.

float('10.333')

Dan mengembalikan hasil ini: 10.333

formatDateTime

Mengembalikan tanda waktu dalam format yang ditentukan.

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

Parameter	Wajib	Tipe	Deskripsi
< timestamp>	Ya	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 sesuai dengan ISO 8601 dan mempertahankan informasi zona waktu.

Nilai pengembalian	Tipe	Deskripsi
< reformatted-timestamp>	String	Tanda waktu yang diperbarui dalam format yang ditentukan

Contoh

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

Parameter	Wajib	Tipe	Deskripsi
< interval>	Ya	Bilangan bulat	Jumlah unit waktu yang ditentukan untuk ditambahkan
< timeUnit>	Ya	String	Unit waktu yang akan 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 sesuai dengan ISO 8601 dan mempertahankan informasi zona waktu.

Nilai Balikan	Tipe	Deskripsi
< updated-timestamp>	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 ke 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>?)

Parameter	Wajib	Tipe	Deskripsi
< interval>	Ya	Bilangan bulat	Jumlah unit waktu yang ditentukan untuk dikurangi
< timeUnit>	Ya	String	Unit waktu yang akan 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 sesuai dengan ISO 8601 dan mempertahankan informasi zona waktu.

Nilai hasil	Tipe	Deskripsi
< updated-timestamp>	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 yang ditentukan:

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 ke format "D":

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

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

greater

Memeriksa apakah nilai pertama lebih besar dari nilai kedua. Mengembalikan true saat nilai pertama lebih besar, atau mengembalikan false saat lebih kecil.

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

Parameter	Wajib	Tipe	Deskripsi
< nilai>	Ya	Bilangan bulat, Float, atau String	Nilai pertama untuk diperiksa apakah lebih besar dari nilai kedua
< compareTo>	Ya	Bilangan bulat, Float, atau String masing-masing	Nilai perbandingan

Nilai hasil	Tipe	Deskripsi
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.

Contoh

Contoh berikut memeriksa apakah nilai pertama lebih besar dari nilai kedua:

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

Dan kembalikan hasil-hasil ini:

• Contoh pertama: true
• Contoh kedua: false

greaterOrEquals

Memeriksa apakah nilai pertama lebih besar dari atau sama dengan nilai kedua. Kembalikan true ketika nilai pertama lebih besar atau sama, atau kembalikan false saat nilai pertama lebih kecil.

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

Parameter	Wajib	Tipe	Deskripsi
< nilai>	Ya	Bilangan bulat, Float, atau String	Nilai pertama untuk diperiksa apakah lebih besar dari atau sama dengan nilai kedua
< compareTo>	Ya	Bilangan bulat, Float, atau String masing-masing	Nilai perbandingan

Nilai yang dikembalikan	Tipe	Deskripsi
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.

Contoh

Contoh berikut memeriksa apakah nilai pertama lebih besar dari atau sama dengan nilai kedua:

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

Dan mengembalikan hasil ini:

• Contoh pertama: true
• Contoh kedua: false

guid

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

guid()

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

guid('<format>')

Parameter	Wajib	Tipe	Deskripsi
< 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".

Nilai kembalian	Tipe	Deskripsi
< Nilai GUID>	String	GUID yang dihasilkan secara acak

Contoh

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

guid('P')

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

if

Periksa apakah ekspresi itu true atau false. Berdasarkan hasilnya, mengembalikan nilai yang ditentukan.

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

Parameter	Wajib	Tipe	Deskripsi
< expression>	Ya	Boolean	Ekspresi yang akan diperiksa
< nilaiJikaBenar>	Ya	Apa saja	Nilai yang akan dikembalikan ketika ekspresi tersebut adalah True
< nilaiJikaSalah>	Ya	Apa saja	Nilai yang akan dikembalikan saat ekspresi salah

Nilai yang dikembalikan	Tipe	Deskripsi
< nilai-balik-spesifik>	Apapun	Nilai yang ditentukan yang kembali berdasarkan apakah ekspresi tersebut true atau false

Contoh

Contoh ini mengembalikan "yes" karena ekspresi yang ditentukan mengembalikan true. Jika tidak, contoh berikut 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>')

Parameter	Wajib	Tipe	Deskripsi
< text>	Ya	String	String yang memiliki substring untuk dicari
< searchText>	Ya	String	Substring untuk dicari

Nilai hasil	Tipe	Deskripsi
< nilai-indeks>	Bilangan bulat	Posisi mulai atau nilai indeks untuk substring yang ditentukan. Jika untai (karakter) tidak ditemukan, kembalikan angka -1.

Contoh

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

Parameter	Wajib	Tipe	Deskripsi
< nilai>	Ya	String	String yang akan dikonversi

Nilai kembalian	Tipe	Deskripsi
< integer-result>	Bilangan bulat	Versi bilangan bulat untuk string yang ditentukan

Contoh

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

int('10')

Dan mengembalikan hasil ini: 10

json

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

json('<value>')

Parameter	Wajib	Tipe	Deskripsi
< nilai>	Ya	String atau XML	String atau XML yang akan dikonversi

Nilai hasil	Tipe	Deskripsi
< Hasil-JSON>	Jenis atau objek asli JSON	Nilai tipe asli JSON atau objek untuk untai (karakter) atau XML yang ditentukan. Jika string bernilai null, fungsi mengembalikan objek kosong.

Contoh 1

Contoh ini mengonversi untai (karakter) ke nilai JSON:

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

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

Contoh 2

Contoh ini mengonversi untai (karakter) ke nilai 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"
      } ]
   }
}

intersection

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 akan muncul dalam hasilnya.

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

Parameter	Wajib	Tipe	Deskripsi
< collection1>, <collection2>, ...	Ya	Array atau Objek, tetapi tidak keduanya	Koleksi dari mana Anda menginginkan hanya item-item umum

Nilai balik	Tipe	Deskripsi
< barang-umum>	Array atau Objek, masing-masing	Koleksi yang hanya memiliki item umum di seluruh koleksi yang ditentukan

Contoh

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 dengan hanya item ini: [1, 2]

join

Mengembalikan string yang memiliki semua item dari larik dan setiap karakternya dipisahkan oleh pemisah.

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

Parameter	Wajib	Tipe	Deskripsi
< collection>	Ya	Array	Array dengan item-item yang akan digabungkan
< delimiter>	Ya	String	Pemisah yang muncul di antara setiap karakter dalam string yang dihasilkan

Nilai balik	Tipe	Deskripsi
< char1><delimiter><char2><delimiter>...	String	String yang dihasilkan dibuat dari semua item dalam array yang ditentukan

Contoh

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"

last

Mengembalikan item terakhir dari koleksi.

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

Parameter	Wajib	Tipe	Deskripsi
< collection>	Ya	String atau Array	Koleksi tempat untuk menemukan item terakhir

Nilai hasil	Tipe	Deskripsi
< last-collection-item>	String atau Array, masing-masing	Item terakhir dalam koleksi

Contoh

Berikut adalah contoh yang menemukan elemen 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 dari kemunculan terakhir sebuah substring. Fungsi ini tidak peka huruf besar/kecil, dan indeks dimulai dengan angka 0.

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

Parameter	Wajib	Tipe	Deskripsi
< text>	Ya	String	String yang memiliki substring untuk dicari
< searchText>	Ya	String	Sub-string yang akan dicari

Nilai hasil	Tipe	Deskripsi
< nilai-indeks-akhir>	Bilangan bulat	Posisi awal atau nilai indeks untuk kemunculan terakhir dari substring yang ditentukan. Jika untai (karakter) tidak ditemukan, kembalikan angka -1.

Contoh

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

Parameter	Wajib	Tipe	Deskripsi
< collection>	Ya	String atau Array	Koleksi dengan item-item yang akan dihitung

Nilai hasil	Tipe	Deskripsi
< panjang-atau-jumlah>	Bilangan bulat	Jumlah item dalam koleksi

Contoh

Contoh ini menghitung jumlah item dalam koleksi ini:

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

Dan mengembalikan hasil ini: 4

less

Periksa apakah nilai pertama kurang dari nilai kedua. Kembalikan true saat nilai pertama lebih kecil, atau kembalikan false saat nilai pertama lebih besar.

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

Parameter	Wajib	Tipe	Deskripsi
< nilai>	Ya	Bilangan bulat, Float, atau String	Nilai pertama untuk diperiksa apakah lebih kecil dari nilai kedua
< compareTo>	Ya	Integer, Float, atau String secara berturut-turut	Elemen perbandingan

Nilai hasil	Tipe	Deskripsi
BENAR atau SALAH	Boolean	Mengembalikan true ketika nilai pertama lebih kecil dari nilai kedua. Mengembalikan false ketika nilai pertama sama dengan atau lebih besar dari nilai kedua.

Contoh

Contoh berikut memeriksa apakah nilai pertama lebih kecil dari nilai kedua.

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

Mengembalikan hasil-hasil ini:

• Contoh pertama: true
• Contoh kedua: false

lessOrEquals

Memeriksa apakah nilai pertama kurang dari atau sama dengan nilai kedua. Kembalikan true saat nilai pertama kurang dari atau sama, atau kembalikan false saat nilai pertama lebih banyak.

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

Parameter	Wajib	Tipe	Deskripsi
< nilai>	Ya	Bilangan bulat, Float, atau String	Nilai pertama yang akan diperiksa apakah lebih kecil atau sama dengan nilai kedua
< compareTo>	Ya	Bilangan bulat, Float, atau String masing-masing	Elemen perbandingan

Nilai pengembalian	Tipe	Deskripsi
BENAR atau SALAH	Boolean	Mengembalikan true ketika nilai pertama lebih kecil dari atau sama dengan nilai kedua. Mengembalikan false ketika nilai pertama lebih besar dari nilai kedua.

Contoh

Contoh berikut memeriksa apakah nilai pertama kurang dari atau sama dengan nilai kedua.

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

Dan mengembalikan hasil ini:

• Contoh pertama: true
• Contoh kedua: false

max

Mengembalikan nilai tertinggi dari daftar atau array dengan angka yang termasuk di dalamnya pada kedua ujung.

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

Parameter	Wajib	Tipe	Deskripsi
< number1>, <number2>, ...	Ya	Bilangan bulat, Float, atau keduanya	Kumpulan angka yang Anda ingin nilai tertingginya
[<number1>, <number2>, ...]	Ya	Array - Bilangan bulat, Float, atau keduanya	Array angka yang Anda inginkan nilai tertingginya

Nilai pengembalian	Tipe	Deskripsi
< max-value>	Bilangan bulat atau bilangan riil	Nilai tertinggi dalam array atau kumpulan angka yang ditentukan

Contoh

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

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

Dan mengembalikan hasil ini: 3

min

Mengembalikan nilai terendah dari sekumpulan angka atau larik.

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

Parameter	Wajib	Tipe	Deskripsi
< number1>, <number2>, ...	Ya	Bilangan bulat, Float, atau keduanya	Kumpulan angka yang anda inginkan nilai terendahnya
[<number1>, <number2>, ...]	Ya	Array - Bilangan bulat, Float, atau keduanya	Array angka yang anda inginkan nilai terendahnya

Nilai yang dikembalikan	Tipe	Deskripsi
< min-value>	Bilangan bulat atau Float	Nilai terendah dalam kumpulan angka atau array yang ditentukan

Contoh

Contoh ini mendapatkan nilai terendah dalam kumpulan angka dan array:

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

Dan mengembalikan hasil ini: 1

mod

Mengembalikan sisa dari pembagian satu angka dengan angka lain. Untuk pembagian bilangan bulat, lihat div().

mod(<dividend>, <divisor>)

Parameter	Wajib	Tipe	Deskripsi
< dividend>	Ya	Bilangan bulat atau Bilangan riil	Angka yang dibagi menurut pembagi
< divisor>	Ya	Bilangan bulat atau Bilangan riil	Angka yang membagi dividen. Nilai pembavis nol menyebabkan kesalahan saat runtime.

Nilai hasil	Tipe	Deskripsi
< modulo-result>	Bilangan bulat atau Pecahan	Sisa dari membagi angka pertama dengan angka kedua

Contoh

Contoh ini menghitung sisa ketika angka pertama dibagi dengan angka kedua:

mod(3, 2)

Dan mengembalikan hasil ini: 1

mul

Mengembalikan hasil dari perkalian dua angka.

mul(<multiplicand1>, <multiplicand2>)

Parameter	Wajib	Tipe	Deskripsi
< multiplicand1>	Ya	Bilangan bulat atau Bilangan pecahan (Float)	Angka untuk dikalikan dengan multiplicand2
< multiplicand2>	Ya	Bilangan bulat atau Float	Angka yang mengalikan multiplicand1

Nilai pengembalian	Tipe	Deskripsi
< product-result>	Bilangan bulat atau bilangan pecahan	Hasil dari perkalian angka pertama dengan angka kedua

Contoh

Contoh-contoh ini mengalikan angka pertama dengan angka kedua:

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

Dan mengembalikan hasil ini:

• Contoh pertama: 2
• Contoh kedua 3

not

Periksa apakah ekspresi itu false. Kembalikan true ketika ekspresi bernilai false, atau kembalikan false ketika bernilai true.

not(<expression>)

Parameter	Wajib	Tipe	Deskripsi
< expression>	Ya	Boolean	Ekspresi yang akan diperiksa

Nilai hasil	Tipe	Deskripsi
BENAR atau SALAH	Boolean	Mengembalikan benar ketika ekspresi salah. Kembalikan nilai false ketika ekspresi tersebut bernilai true.

Contoh 1

Contoh-contoh ini memeriksa apakah ekspresi yang ditentukan salah.

not(false)
not(true)

Dan mengembalikan 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))

Lalu mengembalikan hasil ini:

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

or

Memeriksa apakah setidaknya satu pernyataan benar. Kembalikan true ketika minimal satu ekspresi true, atau kembalikan false saat keduanya false.

or(<expression1>, <expression2>)

Parameter	Wajib	Tipe	Deskripsi
< expression1>, <expression2>	Ya	Boolean	Ekspresi yang akan diperiksa

Nilai hasil	Tipe	Deskripsi
BENAR atau SALAH	Boolean	Mengembalikan nilai benar ketika setidaknya satu ekspresi bernilai benar. Mengembalikan false jika kedua ekspresi bernilai false.

Contoh 1

Contoh berikut memeriksa apakah setidaknya satu pernyataan adalah benar:

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

Serta mengembalikan hasil ini:

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

Contoh 2

Contoh berikut memeriksa apakah setidaknya satu ekspresi benar:

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

Mengembalikan hasil berikut:

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

rand

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

rand(<minValue>, <maxValue>)

Parameter	Wajib	Tipe	Deskripsi
< minValue>	Ya	Bilangan bulat	Bilangan bulat terendah dalam rentang
< maxValue>	Ya	Bilangan bulat	Bilangan bulat yang muncul setelah bilangan bulat tertinggi dalam rentang yang dapat dikembalikan oleh fungsi

Nilai hasil	Tipe	Deskripsi
< random-result>	Bilangan bulat	Bilangan bulat acak yang dikembalikan dari rentang yang ditentukan. Perhatikan bahwa setiap pemanggilan rand() akan menghasilkan hasil yang unik, yang berarti bahwa nilai yang Anda amati dalam pemantauan output mungkin tidak sama pada waktu proses aktual.

Contoh

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, 2, 3, atau 4

range

Mengembalikan larik bilangan bulat yang dimulai dari bilangan bulat tertentu.

range(<startIndex>, <count>)

Parameter	Wajib	Tipe	Deskripsi
< startIndex>	Ya	Bilangan bulat	Nilai bilangan bulat yang memulai array sebagai item pertama
< count>	Ya	Bilangan bulat	Jumlah bilangan bulat dalam array

Nilai kembalian	Tipe	Deskripsi
[<hasil-rentang>]	Array	Array dengan bilangan bulat dimulai dari indeks yang ditentukan

Contoh

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]

replace

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

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

Parameter	Wajib	Tipe	Deskripsi
< text>	Ya	String	String yang memiliki substring yang akan diganti
< oldText>	Ya	String	Substring yang akan diganti
< newText>	Ya	String	String pengganti

Nilai yang dikembalikan	Tipe	Deskripsi
< updated-text>	String	String yang diperbarui setelah mengganti substring Jika substring tidak ditemukan, kembalikan untai string asli.

Contoh

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"

skip

Menghapus item dari depan koleksi, dan mengembalikan semua item lainnya.

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

Parameter	Wajib	Tipe	Deskripsi
< collection>	Ya	Array	Koleksi yang itemnya ingin Anda hapus
< count>	Ya	Bilangan bulat	Bilangan bulat positif untuk jumlah item yang akan dihapus di bagian depan

Nilai kembalian	Tipe	Deskripsi
[<koleksi-terkini>]	Array	Koleksi yang diperbarui setelah menghapus item yang ditentukan

Contoh

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]

split

Pisahkan string pada setiap kemunculan pemisah tertentu, mengembalikan substring yang dihasilkan sebagai elemen array. Pemisah biasanya merupakan satu karakter, tetapi pemisah multi-karakter didukung.

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

Parameter	Wajib	Tipe	Deskripsi
< text>	Ya	String	String yang akan dipisahkan menjadi substring
< delimiter>	Ya	String	String yang akan digunakan sebagai pemisah

Nilai balik	Tipe	Deskripsi
[<substring1>,<substring2>,...]	Array	Array yang berisi substring string asli

Contoh

Contoh ini mengembalikan array yang berisi substring string "a_b_c" berdasarkan pemisah "_":

split('a_b_c', '_')

Array yang dikembalikan adalah: ["a","b","c"]

startOfDay

Mengembalikan awal hari untuk cap waktu.

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

Parameter	Wajib	Tipe	Deskripsi
< timestamp>	Ya	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 sesuai dengan ISO 8601 dan mempertahankan informasi zona waktu.

Nilai kembalian	Tipe	Deskripsi
< updated-timestamp>	String	Tanda waktu yang ditentukan tetapi dimulai pada pukul nol untuk hari itu

Contoh

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

Parameter	Wajib	Tipe	Deskripsi
< timestamp>	Ya	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 sesuai dengan ISO 8601 dan mempertahankan informasi zona waktu.

Nilai kembalian	Tipe	Deskripsi
< updated-timestamp>	String	Tanda waktu yang ditentukan tetapi dimulai pada menit ke nol untuk jam itu

Contoh

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

Parameter	Wajib	Tipe	Deskripsi
< timestamp>	Ya	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 sesuai dengan ISO 8601 dan mempertahankan informasi zona waktu.

Nilai kembalian	Tipe	Deskripsi
< updated-timestamp>	String	Tanda waktu yang ditentukan tetapi dimulai pada hari pertama bulan pada pukul nol.

Contoh

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

Memeriksa apakah string dimulai dengan substring tertentu. Mengembalikan benar saat substring ditemukan, atau salah saat subsring tidak ditemukan. Fungsi ini tidak peka huruf besar/kecil.

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

Parameter	Wajib	Tipe	Deskripsi
< text>	Ya	String	String yang akan diperiksa
< searchText>	Ya	String	String awal yang akan ditemukan

Nilai kembalian	Tipe	Deskripsi
BENAR atau SALAH	Boolean	Mengembalikan nilai benar ketika substring awal ditemukan. Mengembalikan nilai false ketika tidak ditemukan.

Contoh 1

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

startsWith('hello world', 'hello')

Dan mengembalikan hasil ini: true

Contoh 2

Contoh ini memeriksa apakah string "hello world" dimulai dengan substring "salam".

startsWith('hello world', 'greetings')

Dan mengembalikan hasil ini: false

string

Mengembalikan nilai dalam bentuk string.

string(<value>)

Parameter	Wajib	Tipe	Deskripsi
< nilai>	Ya	Apa saja	Nilai yang akan dikonversi

Nilai kembalian	Tipe	Deskripsi
< string-value>	String	Versi untai (karakter) 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\\" }"

sub

Mengembalikan hasil dari pengurangan satu angka dari angka lain.

sub(<minuend>, <subtrahend>)

Parameter	Wajib	Tipe	Deskripsi
< minuend>	Ya	Bilangan bulat atau Bilangan pecahan	Angka dari mana subtrahend akan dikurangkan
< subtrahend>	Ya	Bilangan bulat atau bilangan pecahan	Angka yang akan dikurangi dari minuend

Nilai hasil	Tipe	Deskripsi
< result>	Bilangan bulat atau Float	Hasil dari mengurangi angka kedua dari angka pertama

Contoh

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

Parameter	Wajib	Tipe	Deskripsi
< text>	Ya	String	String yang karakternya Anda inginkan
< startIndex>	Ya	Bilangan bulat	Angka positif sama dengan atau lebih besar dari 0 yang ingin Anda gunakan sebagai posisi awal atau nilai indeks
< length>	Ya	Bilangan bulat	Sejumlah karakter positif yang Anda inginkan di substring

Nilai pengembalian	Tipe	Deskripsi
< substring-result>	String	Substring dengan jumlah karakter yang ditentukan, dimulai dari posisi indeks yang ditentukan dalam string sumber

Contoh

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

substring('hello world', 6, 5)

Dan mengembalikan hasil ini: "world"

subtractFromTime

Kurangi sejumlah unit waktu dari sebuah cap waktu. Lihat juga getPastTime.

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

Parameter	Wajib	Tipe	Deskripsi
< timestamp>	Ya	String	String yang berisi tanda waktu
< interval>	Ya	Bilangan bulat	Jumlah unit waktu yang ditentukan untuk dikurangi
< timeUnit>	Ya	String	Unit waktu yang akan 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 sesuai dengan ISO 8601 dan mempertahankan informasi zona waktu.

Nilai pengembalian	Tipe	Deskripsi
< updated-timestamp>	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"

take

Mengembalikan item dari bagian depan kumpulan.

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

Parameter	Wajib	Tipe	Deskripsi
< collection>	Ya	String atau Array	Koleksi yang itemnya Anda inginkan
< count>	Ya	Bilangan bulat	Bilangan bulat positif untuk jumlah item yang Anda inginkan dari awal

Nilai hasil	Tipe	Deskripsi
< subset> atau [<subset>]	String atau Array, masing-masing	String atau array yang memiliki jumlah item tertentu yang diambil dari bagian depan koleksi asli

Contoh

Contoh-contoh ini mengambil jumlah item yang ditentukan dari awal koleksi ini.

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

Kemudian kembalikan hasil-hasil ini:

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

ticks

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

ticks('<timestamp>')

Parameter	Wajib	Tipe	Deskripsi
< timestamp>	Ya	String	String untuk tanda waktu

Nilai Kembalian	Tipe	Deskripsi
< ticks-number>	Bilangan bulat	Jumlah tanda centang yang telah berlalu sejak 24.00, 1 Januari 0001 dalam kalender Gregorian sejak stempel waktu input

toLower

Mengembalikan untai (karakter) dalam format huruf kecil. Jika karakter dalam string tidak memiliki versi huruf kecil, karakter tersebut tetap tidak berubah dalam string yang ditampilkan.

toLower('<text>')

Parameter	Wajib	Tipe	Deskripsi
< text>	Ya	String	String yang akan dikembalikan dalam format huruf kecil

Nilai balik	Tipe	Deskripsi
< lowercase-text>	String	String asli dalam format huruf kecil

Contoh

Contoh ini mengubah 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 ditampilkan.

toUpper('<text>')

Parameter	Wajib	Tipe	Deskripsi
< text>	Ya	String	String yang akan dikembalikan dalam format huruf besar

Nilai hasil	Tipe	Deskripsi
< uppercase-text>	String	Teks asli dalam format huruf besar

Contoh

Contoh ini mengubah string ini menjadi huruf besar:

toUpper('Hello World')

Dan mengembalikan hasil ini: "HELLO WORLD"

trim

Menghapus spasi di depan dan di belakang pada string, dan mengembalikan string yang diperbarui.

trim('<text>')

Parameter	Wajib	Tipe	Deskripsi
< text>	Ya	String	String yang memiliki spasi kosong di awal dan akhir yang harus dihapus

Nilai pengembalian	Tipe	Deskripsi
< teks yang diperbarui>	String	Versi terbaru untuk string asli tanpa spasi kosong di bagian depan atau belakang

Contoh

Contoh ini menghapus spasi putih awal dan akhir dari string " Halo Dunia ":

trim(' Hello World  ')

Dan mengembalikan hasil ini: "Hello World"

union

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

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

Parameter	Wajib	Tipe	Deskripsi
< collection1>, <collection2>, ...	Ya	Array atau Objek, tetapi tidak keduanya	Koleksi di mana Anda ingin semua barang

Nilai pengembalian	Tipe	Deskripsi
< koleksiDiperbarui>	Array atau Objek, masing-masing	Koleksi dengan semua item dari koleksi yang ditentukan - tanpa duplikat

Contoh

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 yang telah dikodekan dari penanda sumber daya seragam (URI) untuk string dengan mengganti karakter URL yang tidak aman dengan karakter pelolosan. Gunakan fungsi ini, bukan encodeUriComponent(). Meskipun kedua fungsi bekerja dengan cara yang sama, uriComponent() lebih disukai.

uriComponent('<value>')

Parameter	Wajib	Tipe	Deskripsi
< nilai>	Ya	string	String untuk dikonversi ke format berkodekan URI

Nilai balikan	Tipe	Deskripsi
< encoded-uri>	String	String yang berkodekan URI dengan karakter escape

Contoh

Contoh ini membuat versi berkodekan URI untuk string ini:

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

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

uriComponentToBinary

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

uriComponentToBinary('<value>')

Parameter	Wajib	Tipe	Deskripsi
< nilai>	Ya	String	String yang dikodekan dalam URI untuk dikonversi

Nilai pengembalian	Tipe	Deskripsi
< biner-untuk-uri-terkode>	String	Versi biner untuk string berkodekan URI. Konten biner berkodekan base64 dan diwakili oleh $content.

Contoh

Contoh ini membuat versi biner untuk string berkodekan 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 berkodekan URI.

uriComponentToString('<value>')

Parameter	Wajib	Tipe	Deskripsi
< nilai>	Ya	String	String yang berenkode URI untuk didekode

Nilai hasil	Tipe	Deskripsi
< decoded-uri>	String	Versi terdekode untuk string berkodekan URI

Contoh

Contoh ini membuat versi terdekode untuk string berkodekan 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>.

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

Nilai pengembalian	Tipe	Deskripsi
< current-timestamp>	String	Tanggal dan waktu saat ini

Contoh 1

Misalkan hari ini tanggal 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 tanggal 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>')

Parameter	Wajib	Tipe	Deskripsi
< nilai>	Ya	String	String yang berisi objek JSON untuk dikonversi Objek JSON hanya boleh memiliki satu properti root, yang tidak boleh berupa array. Gunakan karakter garis miring terbalik (\) sebagai karakter escape untuk tanda kutip ganda (").

Nilai kembalian	Tipe	Deskripsi
< xml-version>	Objek	XML yang dikodekan untuk string atau objek JSON yang ditentukan

Contoh 1

Contoh ini membuat versi XML untuk untai (karakter) ini, yang berisi objek JSON:

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

Dan mengembalikan hasil XML 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 hasil XML ini:

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

xpath

Memeriksa XML untuk menemukan node atau nilai yang sesuai dengan ekspresi XPath (XML Path Language), dan mengembalikan node atau nilai yang cocok. Ekspresi XPath, atau hanya "JalurX", membantu Anda menavigasi struktur dokumen XML sehingga Anda bisa memilih node atau menghitung nilai dalam konten XML.

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

Parameter	Wajib	Tipe	Deskripsi
< xml>	Ya	Apapun	String XML untuk mencari node atau nilai yang cocok dengan nilai ekspresi XPath
< xpath>	Ya	Apa saja	Ekspresi XPath digunakan untuk menemukan node atau nilai XML yang cocok

Nilai hasil	Tipe	Deskripsi
< xml-node>	XML	Sebuah node XML ketika hanya ada satu node yang cocok dengan ekspresi XPath yang ditentukan
< nilai>	Apa saja	Nilai dari node XML ketika hanya satu nilai yang cocok dengan ekspresi XPath yang ditentukan
[<xml-node1>, <xml-node2>, ...] -or- [<value1>, <value2>, ...]	Array	Array dengan node 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 dengan fungsi sum().

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 suatu namespace. Ekspresi menggunakan karakter garis miring terbalik (\) sebagai karakter escape untuk tanda kutip ganda (").

• Ekspresi 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\"]')

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 node hasil yang cocok dengan node <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"

Catatan

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

Konten terkait

Untuk daftar variabel sistem yang dapat Anda gunakan dalam ekspresi, lihat Variabel sistem.