Ekspresi dan fungsi di Azure Data Factory dan Azure Synapse Analytics

Artikel
04/08/2024

BERLAKU UNTUK:Azure Data Factory Azure Synapse Analytics

Tip

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.

Expressions

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

"name": "value"

"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 'parameter[1]' dikembalikan.
"@@"	String karakter 1 yang berisi '@' ditampilkan.
" @"	String karakter 2 yang berisi ' @' ditampilkan.

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

Gunakan interpolasi untai (karakter), maka hasilnya selalu berupa untai (karakter). Katakanlah saya telah menentukan myNumber sebagai 42 dan myString sebagai foo:

Nilai JSON	Hasil
"@pipeline().parameters.myString"	Mengembalikan `foo` sebagai untai (karakter).
"@{pipeline().parameters.myString}"	Mengembalikan `foo` sebagai untai (karakter).
"@pipeline().parameters.myNumber"	Mengembalikan `42` sebagai angka.
"@{pipeline().parameters.myNumber}"	Mengembalikan `42` sebagai untai (karakter).
"Jawabannya: @{pipeline().parameters.myNumber}"	Mengembalikan untai (karakter) `Answer is: 42`.
"@concat('Answer is: ', string(pipeline().parameters.myNumber))"	Mengembalikan untai (karakter) `Answer is: 42`
"Jawaban adalah: @@{pipeline().parameters.myNumber}"	Mengembalikan untai (karakter) `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) ekspresi suka untuk melakukan iterasi sepuluh kali dimulai dengan 0 berakhiran dengan 9.

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.

Tambahkan Tanggal ke filename: @concat('Test_', formatDateTime(utcnow(), 'yyyy-dd-MM'))
Tambahkan DateTime di zona waktu pelanggan : @concat('Test_', convertFromUtc(utcnow(), 'Pacific Standard Time'))
Tambahkan Waktu Pemicu : @concat('Test_', pipeline().TriggerTime)
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 untai (karakter) 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 \ ekstra dalam ekspresi, atau Anda dapat mengikuti langkah-langkah di bawah ini untuk mengganti karakter khusus menggunakan bahasa ekspresi:

Pengkodean URL terhadap nilai untai (karakter) asli
Ganti untai (karakter) berkodekan URL, misalnya, umpan baris (%0A), kembali ke awal(%0D), tab horizontal(%09).
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

Meng-escape karakter kutipan tunggal

Fungsi ekspresi menggunakan kutipan tunggal untuk parameter nilai untai (karakter). 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

Tutorial

Tutorial ini memandu Anda untuk meneruskan parameter antara alur dan aktivitas serta di antara 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	Menambahkan beberapa hari ke tanda waktu.
addHours	Menambahkan beberapa jam ke tanda waktu.
addMinutes	Menambahkan beberapa 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 untai 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	Mengembalikan awal jam untuk tanda 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	Mengembalikan tanda waktu saat ini sebagai string.

Fungsi string

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

Fungsi string	Tugas
concat	Gabungkan dua untai (karakter) atau lebih, dan kembalikan untai (karakter) gabungan.
endsWith	Memeriksa apakah string berakhir dengan substring yang ditentukan.
Guid	Membuat pengidentifikasi unik global (GUID) sebagai string.
indexOf	Mengembalikan posisi awal untuk substring.
lastIndexOf	Mengembalikan posisi awal untuk kemunculan terakhir substring.
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.
substring	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

Jika ingin menggunakan koleksi, umumnya larik, string, dan terkadang, kamus, Anda dapat menggunakan fungsi koleksi ini.

Fungsi koleksi	Tugas
mengandung	Memeriksa apakah koleksi memiliki item tertentu.
kosong	Memeriksa apakah koleksi kosong.
first	Mengembalikan item pertama dari koleksi.
persimpangan	Mengembalikan koleksi yang hanya memiliki item umum di seluruh koleksi yang ditentukan.
join	Mengembalikan string yang memiliki semua item dari larik, dipisahkan oleh karakter yang ditentukan.
last	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	Memeriksa apakah semua ekspresi berupa true.
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.
if	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 ekspresi true.

Fungsi konversi

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

string
Integer
float
Boolean
larik
dictionaries

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.
base64KeUntai	Mengembalikan versi string untuk string yang dienkode ke base64.
biner	Mengembalikan versi biner untuk nilai input.
bool	Mengembalikan versi Boolean untuk nilai input.
gabungkan	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 versi string untuk string yang dienkode ke base64.
decodeDataUri	Mengembalikan versi biner untuk URI data.
decodeUriComponen	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.
tali	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 untuk string yang dienkode ke URI.
xml	Mengembalikan versi XML untuk string.
xpath	Memeriksa XML untuk node atau nilai yang cocok dengan ekspresi JalurX (XML Path Language), dan mengembalikan node atau nilai yang cocok.

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.
min	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.

tambahkan

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 hasil	Tipe	Deskripsi
<result-sum>	Bilangan bulat atau Float	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 beberapa hari ke tanda waktu.

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

Parameter	Wajib	Tipe	Deskripsi
<timestamp>	Ya	String	String yang berisi tanda waktu
<days>	Ya	Bilangan bulat	Jumlah hari positif atau negatif yang akan ditambahkan
<format>	No	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 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 beberapa jam ke tanda waktu.

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

Parameter	Wajib	Tipe	Deskripsi
<timestamp>	Ya	String	String yang berisi tanda waktu
<hour>s	Ya	Bilangan bulat	Jumlah positif atau negatif dari jam yang akan ditambahkan
<format>	No	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

Menambahkan beberapa menit ke tanda waktu.

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

Parameter	Wajib	Tipe	Deskripsi
<timestamp>	Ya	String	String yang berisi tanda waktu
<menit>	Ya	Bilangan bulat	Jumlah positif atau negatif dari menit yang akan ditambahkan
<format>	No	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 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 positif atau negatif dari detik untuk ditambahkan
<format>	No	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 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>	No	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"

dan

Periksa apakah semua 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 hasil	Tipe	Deskripsi
BENAR atau SALAH	Boolean	Kembalikan true ketika kedua ekspresi itu true. Mengembalikan false ketika setidaknya satu ekspresi false.

Contoh 1

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

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 adalah false, 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 adalah false, jadi mengembalikan false.
Contoh ketiga: Kedua ekspresi adalah false, jadi mengembalikan false.

array

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

array('<value>')

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

Nilai hasil	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
<value>	Ya	String	String input

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
<value>	Ya	String	String yang dienkode ke base64 yang akan dikonversi

Nilai hasil	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"

base64KeUntai

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

base64ToString('<value>')

Parameter	Wajib	Tipe	Deskripsi
<value>	Ya	String	Untai (karakter) dikodekan base64 yang akan didekode

Nilai hasil	Tipe	Deskripsi
<decoded-base64-string>	String	Versi untai untuk untai (karakter) yang dikodekan base64

Contoh

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

base64ToString('aGVsbG8=')

Dan mengembalikan hasil ini: "hello"

biner

Mengembalikan versi biner untuk untai (karakter).

binary('<value>')

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

Nilai hasil	Tipe	Deskripsi
<binary-for-input-value>	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

Kembalikan versi Boolean untuk nilai.

bool(<value>)

Parameter	Wajib	Tipe	Deskripsi
<value>	Ya	Mana pun	Nilai yang akan dikonversi

Nilai hasil	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 ini:

Contoh pertama: true
Contoh kedua: false

gabungkan

Mengembalikan nilai non-null pertama dari satu atau beberapa parameter. Untai (karakter) kosong, larik 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
<first-non-null-item>	Mana pun	Item atau nilai pertama yang bukan null. Jika semua parameter null, fungsi ini akan mengembalikan null.

Contoh

Contoh berikut mengembalikan nilai pertama bukan null dari nilai yang ditentukan, atau null saat 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 untai (karakter) atau lebih, dan kembalikan untai (karakter) gabungan.

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

Parameter	Wajib	Tipe	Deskripsi
<text1>, <text2>, ...	Ya	String	Minimal dua untai (karakter) yang akan digabungkan

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

Contoh

Contoh ini menggabungkan untai (karakter) "Hello" dan "World":

concat('Hello', 'World')

Dan mengembalikan hasil ini: "HelloWorld"

mengandung

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

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

Secara khusus, fungsi ini bekerja pada jenis koleksi ini:

Untai (karakter) untuk menemukan substring
Larik untuk menemukan nilai
Kamus untuk menemukan kunci

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

Nilai hasil	Tipe	Deskripsi
BENAR atau SALAH	Boolean	Mengembalikan true saat item ditemukan. Mengembalikan false ketika tidak ditemukan.

Contoh 1

Contoh ini memeriksa untai (karakter) "hello world" untuk substring "world" dan mengembalikan true:

contains('hello world', 'world')

Contoh 2

Contoh ini memeriksa untai (karakter) "hello world" untuk substring "universe" dan mengembalikan true:

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 untuk 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>	No	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 untuk 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>	No	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 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>	No	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 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 hasil	Tipe	Deskripsi
[<object1>, <object2>, ...]	Array	Larik yang dibuat dari semua item input

Contoh

Contoh ini membuat larik dari input berikut:

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

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

dataUri

Mengembalikan pengidentifikasi sumber daya seragam (URI) data untuk untai (karakter).

dataUri('<value>')

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

Nilai hasil	Tipe	Deskripsi
<data-uri>	String	URI data untuk untai (karakter) 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
<value>	Ya	String	URI data yang akan dikonversi

Nilai hasil	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 untai (karakter) untuk pengidentifikasi sumber daya seragam (URI) data.

dataUriToString('<value>')

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

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

Contoh

Contoh ini membuat untai (karakter) 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
<day-of-month>	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 bulan dari tanda waktu.

dayOfWeek('<timestamp>')

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

Nilai hasil	Tipe	Deskripsi
<day-of-week>	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 hasil	Tipe	Deskripsi
<day-of-year>	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

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

decodeBase64('<value>')

Parameter	Wajib	Tipe	Deskripsi
<value>	Ya	String	Untai (karakter) dikodekan base64 yang akan didekode

Nilai hasil	Tipe	Deskripsi
<decoded-base64-string>	String	Versi untai untuk untai (karakter) yang dikodekan base64

Contoh

Contoh ini membuat untai (karakter) untuk yang berkodekan 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
<value>	Ya	String	Untai (karakter) URI data yang akan didekode

Nilai hasil	Tipe	Deskripsi
<binary-for-data-uri>	String	Versi biner untuk untai (karakter) 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:

decodeUriComponen

Mengembalikan string yang menggantikan escape character dengan versi yang didekodekan.

decodeUriComponent('<value>')

Parameter	Wajib	Tipe	Deskripsi
<value>	Ya	String	Untai (karakter) dengan karakter escape yang akan didekode

Nilai hasil	Tipe	Deskripsi
<decoded-uri>	String	Untai (karakter) yang diperbarui dengan karakter escape 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 yang dibagi menurut pembagi
<divisor>	Ya	Bilangan bulat atau Float	Angka yang membagi dividen. Nilai pembavis nol menyebabkan kesalahan saat runtime.

Nilai hasil	Tipe	Deskripsi
<quotient-result>	Bilangan bulat atau Float	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 yang dikodekan pengidentifikasi sumber daya seragam (URI) untuk untai (karakter) 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>')

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

Nilai hasil	Tipe	Deskripsi
<encoded-uri>	String	String yang berkodekan 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"

kosong

Memeriksa apakah koleksi kosong. Mengembalikan true saat koleksi kosong, atau mengembalikan false saat menemukan isi.

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

Parameter	Wajib	Tipe	Deskripsi
<collection>	Ya	Untai (karakter), Larik, atau Objek	Koleksi yang akan diperiksa

Nilai hasil	Tipe	Deskripsi
BENAR atau SALAH	Boolean	Mengembalikan true saat koleksi kosong. Mengembalikan false menemukan isi.

Contoh

Contoh berikut memeriksa apakah koleksi yang ditentukan kosong:

empty('')
empty('abc')

Dan mengembalikan hasil ini:

Contoh pertama: Meneruskan untai (karakter) kosong, sehingga fungsi ini mengembalikan true.
Contoh kedua: Meneruskan untai (karakter) "abc", sehingga fungsi ini mengembalikan false.

endsWith

Memeriksa apakah untai (karakter) berakhir dengan substring tertentu. Mengembalikan benar saat substring ditemukan, atau salah saat subsring tidak ditemukan. Fungsi ini tidak peka 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 hasil	Tipe	Deskripsi
BENAR atau SALAH	Boolean	Mengembalikan true saat substring akhir ditemukan. Mengembalikan false ketika tidak ditemukan.

Contoh 1

Contoh ini memeriksa apakah untai (karakter) "hello world" diakhiri oleh untai (karakter) "world":

endsWith('hello world', 'world')

Dan mengembalikan hasil ini: true

Contoh 2

Contoh ini memeriksa apakah untai (karakter) "hello world" diakhiri oleh untai "universe":

endsWith('hello world', 'universe')

Dan mengembalikan hasil ini: false

setara

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 hasil	Tipe	Deskripsi
BENAR atau SALAH	Boolean	Mengembalikan true 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.

pertama

Mengembalikan item pertama dari untai (karakter) atau larik.

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>	Mana pun	Item pertama dalam koleksi

Contoh

Contoh ini menemukan item pertama dalam koleksi berikut:

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

Dan mengembalikan hasil ini:

Contoh pertama: "h"
Contoh kedua: 0

float

Mengonversi versi untai (karakter) untuk angka titik floating menjadi angka titik floating aktual.

float('<value>')

Parameter	Wajib	Tipe	Deskripsi
<value>	Ya	String	Untai (karakter) yang memiliki jumlah titik floating yang valid untuk dikonversi

Nilai hasil	Tipe	Deskripsi
<float-value>	Float	Jumlah titik floating untuk untai (karakter) yang ditentukan

Contoh

Contoh ini membuat versi untai (karakter) untuk jumlah titik floating berikut:

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>	No	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
<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>	No	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 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>	No	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"

lebih besar

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

Contoh pertama: true
Contoh kedua: false

lebihbesarAtauSetara

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
<value>	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 hasil	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>	No	String	Penentu format tunggal untuk GUID yang dikembalikan. Secara default, formatnya adalah "D", tetapi Anda dapat menggunakan "N", "D", "B", "P", atau "X".

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

Contoh

Contoh berikut menghasilkan GUID yang sama, tetapi karena 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 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
<valueIfTrue>	Ya	Mana pun	Nilai yang akan dikembalikan saat ekspresi true
<valueIfFalse>	Ya	Mana pun	Nilai yang akan dikembalikan saat ekspresi false

Nilai hasil	Tipe	Deskripsi
<specified-return-value>	Mana pun	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
<index-value>	Bilangan bulat	Mengembalikan posisi awal 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
<value>	Ya	String	String yang akan dikonversi

Nilai hasil	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
<value>	Ya	String atau XML	Strilng atau XML untuk 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 untai (karakter) null, fungsi mengembalikan untai 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"
      } ]
   }
}

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 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 tempat Anda hanya menginginkan item umum

Nilai hasil	Tipe	Deskripsi
<common-items>	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 yang memiliki item untuk digabung
<delimiter>	Ya	String	Pemisah yang muncul di antara setiap karakter dalam string yang dihasilkan

Nilai hasil	Tipe	Deskripsi
<char1><pembatas><char2><pembatas>...	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"

terakhir

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

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

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

Nilai hasil	Tipe	Deskripsi
<ending-index-value>	Bilangan bulat	Mengembalikan posisi awal atau nilai indeks untuk kemunculan terakhir 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 yang akan dihitung

Nilai hasil	Tipe	Deskripsi
<length-or-count>	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

kurang

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
<value>	Ya	Bilangan bulat, Float, atau String	Nilai pertama untuk diperiksa apakah lebih kecil dari nilai kedua
<compareTo>	Ya	Bilangan bulat, Float, atau String masing-masing	Item 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')

Dan mengembalikan 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
<value>	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	Item perbandingan

Nilai hasil	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

maks

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

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 hasil	Tipe	Deskripsi
<max-value>	Bilangan bulat atau Float	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

mnt

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 hasil	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 Float	Angka yang dibagi menurut pembagi
<divisor>	Ya	Bilangan bulat atau Float	Angka yang membagi dividen. Nilai pembavis nol menyebabkan kesalahan saat runtime.

Nilai hasil	Tipe	Deskripsi
<modulo-result>	Bilangan bulat atau Float	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 produk dari perkalian dua angka.

mul(<multiplicand1>, <multiplicand2>)

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

Nilai hasil	Tipe	Deskripsi
<product-result>	Bilangan bulat atau Float	Produk dari mengalikan 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 saat ekspresi false, atau kembalikan false saat true.

not(<expression>)

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

Nilai hasil	Tipe	Deskripsi
BENAR atau SALAH	Boolean	Mengembalikan true saat ekspresi false. Mengembalikan false saat ekspresi tersebut true.

Contoh 1

Contoh-contoh ini memeriksa apakah ekspresi yang ditentukan false:

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

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

Dan 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 ekspresi true. Kembalikan true ketika setidaknya 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 true ketika setidaknya satu ekspresi adalah true. Mengembalikan false ketika kedua ekspresi adalah false.

Contoh 1

Contoh berikut memeriksa apakah setidaknya satu ekspresi adalah true:

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

Dan 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 adalah true:

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

Dan mengembalikan hasil ini:

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 mengikuti bilangan bulat tertinggi dalam rentang yang dapat dikembalikan 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

rentang

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

mengganti

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

belah

Pisahkan string pada setiap kemunculan pemisah tertentu, mengembalikan substring yang dihasilkan sebagai elemen array. Pemisah biasanya merupakan satu karakter, tetapi pemisah multicharacter 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 hasil	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 tanda waktu.

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

Parameter	Wajib	Tipe	Deskripsi
<timestamp>	Ya	String	String yang berisi tanda waktu
<format>	No	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 yang ditentukan tetapi dimulai pada jam yang dijadwalkan 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>	No	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 yang ditentukan tetapi dimulai pada menit yang dijadwalkan 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>	No	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 yang ditentukan tetapi dimulai pada hari pertama bulan ini pada jam yang dijadwalkan

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 hasil	Tipe	Deskripsi
BENAR atau SALAH	Boolean	Mengembalikan benar ketika substring awal ditemukan. Mengembalikan 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 "halo dunia dimulai dengan substring "salam":

startsWith('hello world', 'greetings')

Dan mengembalikan hasil ini: false

string

Mengembalikan versi string untuk nilai.

string(<value>)

Parameter	Wajib	Tipe	Deskripsi
<value>	Ya	Mana pun	Nilai yang akan dikonversi

Nilai hasil	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 Float	Angka untuk mengurangi subtrahend
<subtrahend>	Ya	Bilangan bulat atau Float	Angka yang akan dikurangi dari minuend

Nilai hasil	Tipe	Description
<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 hasil	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

Mengurangi jumlah unit waktu dari tanda 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>	No	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 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 koleksi.

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 depan

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 mendapatkan jumlah item yang ditentukan dari bagian depan koleksi ini:

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

Dan mengembalikan 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 hasil	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 ditampilkan dalam format huruf kecil

Nilai hasil	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 ditampilkan dalam format huruf besar

Nilai hasil	Tipe	Deskripsi
<uppercase-text>	String	String 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 berisi spasi kosong awal dan akhir untuk dihapus

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

penyatuan

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 tempat Anda menginginkan semua item

Nilai hasil	Tipe	Deskripsi
<updatedCollection>	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 dikodekan pengidentifikasi sumber daya seragam (URI) untuk untai (karakter) dengan mengganti karakter URL yang tidak aman dengan karakter escape. Gunakan fungsi ini, bukan encodeUriComponent(). Meskipun kedua fungsi bekerja dengan cara yang sama, uriComponent() lebih disukai.

uriComponent('<value>')

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

Nilai hasil	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 untuk pengidentifikasi sumber daya seragam (URI).

uriComponentToBinary('<value>')

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

Nilai hasil	Tipe	Deskripsi
<binary-for-encoded-uri>	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
<value>	Ya	String	String yang berkodekan URI untuk dikonversi

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>	No	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
<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
<value>	Ya	String	String dengan 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 hasil	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 node atau nilai yang cocok dengan ekspresi JalurX (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	Mana pun	String XML untuk mencari node atau nilai yang cocok dengan nilai ekspresi JalurX
<xpath>	Ya	Mana pun	Ekspresi JalurX digunakan untuk menemukan node atau nilai XML yang cocok

Nilai hasil	Tipe	Deskripsi
<xml-node>	XML	Sebuah node XML ketika hanya satu node yang cocok dengan ekspresi JalurX yang ditentukan
<value>	Mana pun	Nilai dari node XML ketika hanya satu nilai yang cocok dengan ekspresi JalurX yang ditentukan
[<xml-node1>, <xml-node2>, ...] -or- [<value1>, <value2>, ...]	Array	Array dengan node XML atau nilai yang cocok dengan ekspresi JalurX yang ditentukan

Contoh 1

Mengikuti Contoh 1, contoh ini menemukan simpul yang cocok <count></count> dengan simpul dan menambahkan nilai simpul tersebut dengan sum() 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 layanan. 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 layanan dokumen XML, xmlns="http://contoso.com":

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

Ekspresi JalurX 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.

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