Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
BERLAKU UNTUK: SDK v4
Artikel ini mencantumkan fungsi bawaan yang tersedia yang diurutkan berdasarkan tujuan umumnya. Untuk informasi tentang operator yang digunakan dalam fungsi bawaan dan sintaks ekspresi, lihat Operator.
Ekspresi bawaan dibagi menjadi jenis fungsi berikut:
- String
- Koleksi
- Perbandingan logis
- Konversi
- Matematika
- Tanggal
- Timex
- Penguraian URI
- Manipulasi dan konstruksi objek
- Ekspresi reguler
- Pemeriksaan jenis
Anda juga dapat melihat daftar dalam urutan alfabet.
Fungsi string
Fungsi | Penjelasan |
---|---|
length | Mengembalikan panjang string. |
mengganti | Ganti substring dengan string yang ditentukan dan kembalikan string yang diperbarui. Fungsi ini peka huruf besar/kecil. |
replaceIgnoreCase | Mengganti substring dengan string yang ditentukan, dan mengembalikan string yang diperbarui. Fungsi ini tidak peka huruf besar/kecil. |
belah | Mengembalikan array yang berisi substring berdasarkan pemisah yang ditentukan. |
substring | Mengembalikan karakter dari string. |
ToLower | Mengembalikan string dalam huruf kecil dalam format lokal opsional. |
toUpper | Mengembalikan string dalam huruf besar dalam format lokal opsional. |
trim | Hapus spasi putih di depan dan di belakang dari string. |
addOrdinal | Mengembalikan nomor ordinal dari angka input. |
endsWith | Memeriksa apakah untai (karakter) berakhir dengan substring tertentu. Kembalikan true jika substring ditemukan, atau kembali false jika tidak ditemukan. Fungsi ini tidak peka huruf besar/kecil. |
startsWith | Memeriksa apakah string dimulai dengan substring tertentu. Kembalikan true jika substring ditemukan, atau kembali false jika tidak ditemukan. Fungsi ini tidak peka huruf besar/kecil. |
countWord | Mengembalikan jumlah kata dalam string yang diberikan. |
concat | Gabungkan dua string atau lebih dan kembalikan string yang dihasilkan. |
newGuid | Mengembalikan string Guid baru. |
indexOf | Mengembalikan posisi awal atau nilai indeks substring atau mencari objek yang ditentukan dan mengembalikan indeks berbasis nol dari kemunculan pertama dalam seluruh daftar. Fungsi ini tidak peka huruf besar/kecil, dan indeks dimulai dengan angka 0. |
lastIndexOf | Mengembalikan posisi awal atau nilai indeks dari kemunculan terakhir substring atau mencari objek yang ditentukan dan mengembalikan indeks berbasis nol dari kemunculan terakhir dalam rentang elemen dalam daftar. Fungsi ini tidak peka huruf besar/kecil, dan indeks dimulai dengan angka 0. |
sentenceCase | Kapitalkan huruf pertama kata pertama dalam string dalam format lokal opsional. |
titleCase | Kapitalkan huruf pertama setiap kata dalam string dalam format lokal opsional. |
reverse | Membalikkan urutan elemen dalam string atau array. |
Fungsi pengumpulan
Fungsi | Penjelasan |
---|---|
mengandung | Bekerja untuk menemukan item dalam string, untuk menemukan item dalam array, atau untuk menemukan parameter dalam objek kompleks. Contoh: contains('hello world', 'hello') contains(createArray('1','2'), '1') contains(json("{'foo':'bar'}"), 'foo') |
first | Mengembalikan item pertama dari koleksi. |
join | Mengembalikan string yang memiliki semua item dari larik dan setiap karakternya dipisahkan oleh pemisah. Contoh: join(createArray('a','b'), '.') = "a.b" |
last | Mengembalikan item terakhir dari koleksi. |
count | Mengembalikan jumlah item dalam koleksi. |
foreach | Beroperasi pada setiap elemen dan mengembalikan koleksi baru. |
union | Mengembalikan koleksi yang memiliki semua item dari koleksi yang ditentukan. |
skip | Hapus item dari depan koleksi, dan kembalikan item yang tersisa. |
take | Mengembalikan item dari bagian depan koleksi. |
persimpangan | Mengembalikan koleksi yang hanya memiliki item umum di seluruh koleksi yang ditentukan. |
subArray | Mengembalikan subarray dari posisi awal dan akhir yang ditentukan. Nilai indeks dimulai dengan angka 0. |
pilih | Beroperasi pada setiap elemen dan mengembalikan koleksi baru elemen yang diubah. |
di mana | Filter pada setiap elemen dan kembalikan kumpulan baru elemen yang difilter yang cocok dengan kondisi tertentu. |
sortBy | Urutkan elemen dalam koleksi dalam urutan naik dan mengembalikan koleksi yang diurutkan. |
sortByDescending | Urutkan elemen dalam koleksi dalam urutan menurut dan mengembalikan koleksi yang diurutkan. |
indicesAndValues | Ubah array atau objek menjadi array objek dengan properti indeks dan nilai. |
flatten | Meratakan array ke dalam array dengan nilai non-array. |
unique | Hapus semua duplikat dari array. |
any | Menentukan apakah ada elemen urutan yang memenuhi suatu kondisi. |
all | Tentukan apakah semua elemen urutan memenuhi suatu kondisi. |
reverse | Membalikkan urutan elemen dalam string atau array. |
gabungkan | Menggabungkan beberapa objek atau item JSON dalam array bersama-sama. |
Fungsi perbandingan logika
Fungsi | Penjelasan |
---|---|
dan | Logis dan. Mengembalikan true jika semua ekspresi yang ditentukan dievaluasi ke true. |
setara | Perbandingan sama. Mengembalikan true jika nilai yang ditentukan sama. |
kosong | Periksa apakah target kosong. |
lebih besar | Perbandingan lebih besar dari. Kembalikan true jika nilai pertama lebih banyak, atau kembalikan false jika kurang. |
lebihbesarAtauSetara | Perbandingan lebih besar dari atau sama dengan. Mengembalikan true jika nilai pertama lebih besar atau sama dengan, atau mengembalikan false jika nilai pertama lebih kecil. |
if | Periksa apakah ekspresi itu true atau false. Berdasarkan hasilnya, mengembalikan nilai yang ditentukan. |
kurang | Perbandingan kurang dari operasi. Kembalikan true jika nilai pertama kurang, atau kembalikan false jika nilai pertama lebih banyak. |
kurangAtauSetara | Perbandingan kurang dari atau sama dengan operasi. Mengembalikan true jika nilai pertama kurang dari atau sama dengan, atau mengembalikan false jika nilai pertama lebih banyak. |
Tidak | Operator logis bukan. Kembalikan true jika ekspresi salah, atau kembalikan false jika true. |
atau | Logis atau operasi. Kembalikan true jika setidaknya satu ekspresi benar, atau kembalikan false jika semua salah. |
ada | Mengevaluasi ekspresi untuk kebenaran. |
Fungsi konversi
Fungsi | Penjelasan |
---|---|
float | Mengembalikan representasi titik mengambang dari string yang ditentukan. |
int | Mengembalikan representasi bilangan bulat dari string yang ditentukan. |
tali | Mengembalikan versi string dari nilai yang ditentukan dalam format lokal opsional. |
bool | Mengembalikan representasi Boolean dari string yang ditentukan. |
createArray | Buat array dari beberapa input. |
json | Mengembalikan nilai jenis JavaScript Object Notation (JSON) atau objek string atau XML. |
base64 | Mengembalikan versi string atau byte array yang dikodekan base64. |
base64ToBinary | Mengembalikan versi biner untuk string yang dienkode ke base64. |
base64KeUntai | Mengembalikan versi string dari string yang dikodekan base64. |
biner | Mengembalikan versi biner untuk nilai input. |
dataUri | Mengembalikan URI untuk nilai input. |
dataUriToBinary | Mengembalikan versi biner URI data. |
dataUriToString | Mengembalikan versi string URI data. |
uriComponent | Mengembalikan versi yang dienkode ke URI untuk nilai input dengan mengganti karakter URL yang tidak aman dengan escape character. |
uriComponentToString | Mengembalikan versi string dari string yang dikodekan URI. |
xml | Mengembalikan versi XML dari string. |
formatNumber | Format nilai ke angka terdekat ke jumlah digit pecahan yang ditentukan dan lokal opsional yang ditentukan. |
jsonStringify | Mengembalikan string JSON dari nilai. |
stringOrValue Wrap string interpolation untuk mendapatkan nilai nyata. Misalnya, stringOrValue('${1}') mengembalikan angka 1, sementara stringOrValue('${1} item') mengembalikan string "1 item". |
Fungsi matematika
Fungsi | Penjelasan |
---|---|
abs | Mengembalikan nilai absolut dari angka yang ditentukan. |
penambahan | Matematika dan. Mengembalikan hasil dari menambahkan dua angka (kasus angka murni) atau menggabungkan dua string atau lebih. |
div | Divisi matematika. Kembalikan hasil bilangan bulat dari membagi dua angka. |
max | Mengembalikan nilai terbesar dari koleksi. |
min | Mengembalikan nilai terkecil dari koleksi. |
mod | Mengembalikan sisa dari pembagian dua angka. |
mul | Perkalian matematika. Mengembalikan produk dari perkalian dua angka. |
rand | Mengembalikan angka acak antara nilai min dan maks yang ditentukan. |
sqrt | Mengembalikan akar kuadrat dari angka yang ditentukan. |
sub | Pengurangan matematika. Mengembalikan hasil dari mengurangi angka kedua dari angka pertama. |
sum | Mengembalikan jumlah angka dalam array. |
rentang | Mengembalikan larik bilangan bulat yang dimulai dari bilangan bulat tertentu. |
exp | Mengembalikan eksponensiasi satu angka ke angka lainnya. |
tengah | Mengembalikan jumlah rata-rata array numerik. |
lantai | Mengembalikan nilai integral terbesar kurang dari atau sama dengan angka yang ditentukan. |
ceiling | Mengembalikan nilai integral terkecil yang lebih besar dari atau sama dengan angka yang ditentukan. |
round | Bulatkan nilai ke bilangan bulat terdekat atau ke jumlah digit pecahan yang ditentukan. |
Fungsi tanggal dan waktu
Fungsi | Penjelasan |
---|---|
addDays | Tambahkan sejumlah hari tertentu ke tanda waktu tertentu dalam format lokal opsional. |
addHours | Tambahkan jumlah jam tertentu ke tanda waktu tertentu dalam format lokal opsional. |
addMinutes | Tambahkan jumlah menit tertentu ke tanda waktu tertentu dalam format lokal opsional. |
addSeconds | Tambahkan jumlah detik tertentu ke tanda waktu tertentu. |
dayOfMonth | Mengembalikan hari dalam sebulan untuk tanda waktu atau ekspresi Timex tertentu. |
dayOfWeek | Mengembalikan hari dalam seminggu untuk tanda waktu tertentu. |
dayOfYear | Mengembalikan hari dalam setahun untuk tanda waktu tertentu. |
formatDateTime | Mengembalikan tanda waktu dalam format lokal opsional. |
formatEpoch | Mengembalikan tanda waktu dalam format lokal opsional dari waktu UNIX Epoch (waktu Unix, waktu POSIX). |
formatTicks | Mengembalikan tanda waktu dalam format lokal opsional dari tanda centang. |
subtractFromTime | Kurangi sejumlah unit waktu dari tanda waktu dalam format lokal opsional. |
utcNow | Mengembalikan tanda waktu saat ini dalam format lokal opsional sebagai string. |
dateReadBack | Gunakan pustaka tanggal-waktu untuk memberikan readback tanggal. |
bulan | Mengembalikan bulan tanda waktu yang diberikan. |
date | Mengembalikan tanggal untuk tanda waktu tertentu. |
tahun | Mengembalikan tahun untuk tanda waktu yang diberikan. |
getTimeOfDay | Mengembalikan waktu hari untuk tanda waktu tertentu. |
getFutureTime | Mengembalikan tanda waktu saat ini dalam format lokal opsional ditambah unit waktu yang ditentukan. |
getPastTime | Mengembalikan tanda waktu saat ini dalam format lokal opsional dikurangi unit waktu yang ditentukan. |
addToTime | Tambahkan sejumlah unit waktu ke tanda waktu dalam format lokal opsional. |
convertFromUTC | Mengonversi tanda waktu dalam format lokal opsional dari Universal Time Coordinated (UTC). |
convertToUTC | Mengonversi tanda waktu dalam format lokal opsional ke Universal Time Coordinated (UTC). |
startOfDay | Mengembalikan awal hari untuk tanda waktu dalam format lokal opsional. |
startOfHour | Mengembalikan awal jam untuk tanda waktu dalam format lokal opsional. |
startOfMonth | Mengembalikan awal bulan untuk tanda waktu dalam format lokal opsional. |
ticks | Mengembalikan nilai properti ticks dari tanda waktu tertentu. |
ticksToDays | Mengonversi nilai properti ticks menjadi jumlah hari. |
ticksToHours | Mengonversi nilai properti ticks menjadi jumlah jam. |
ticksToMinutes | Mengonversi nilai properti ticks menjadi jumlah menit. |
dateTimeDiff | Mengembalikan perbedaan dalam tanda waktu antara dua tanda waktu. |
getPreviousViableDate | Mengembalikan tanggal layak sebelumnya dari ekspresi Timex berdasarkan tanggal saat ini dan zona waktu yang ditentukan secara opsional. |
getNextViableDate | Mengembalikan tanggal ekspresi Timex berikutnya yang layak berdasarkan tanggal saat ini dan zona waktu yang ditentukan secara opsional. |
getPreviousViableTime | Mengembalikan waktu yang layak sebelumnya dari ekspresi Timex berdasarkan waktu saat ini dan zona waktu yang ditentukan secara opsional. |
getNextViableTime | Mengembalikan waktu ekspresi Timex berikutnya yang layak berdasarkan waktu saat ini dan zona waktu yang ditentukan secara opsional. |
Fungsi timex
Fungsi | Penjelasan |
---|---|
isPresent | Mengembalikan true jika ekspresi TimexProperty atau Timex mengacu pada saat ini. |
isDuration | Mengembalikan true jika ekspresi TimexProperty atau Timex mengacu pada durasi. |
isTime | Mengembalikan true jika ekspresi TimexProperty atau Timex mengacu pada satu waktu. |
isDate | Mengembalikan true jika ekspresi TimexProperty atau Timex mengacu pada tanggal. |
isTimeRange | Mengembalikan true jika ekspresi TimexProperty atau Timex mengacu pada rentang waktu. |
isDateRange | Mengembalikan true jika ekspresi TimexProperty atau Timex mengacu pada rentang tanggal. |
isDefinite | Mengembalikan true jika ekspresi TimexProperty atau Timex mengacu pada hari yang pasti. |
Menyelesaikan | Mengembalikan string ekspresi TimexProperty atau Timex tertentu jika mengacu pada waktu yang valid. Waktu yang valid berisi jam, menit, dan detik. |
Fungsi penguraian URI
Fungsi | Penjelasan |
---|---|
uriHost | Mengembalikan nilai host pengidentifikasi sumber daya seragam (URI). |
uriPath | Mengembalikan nilai jalur pengidentifikasi sumber daya seragam (URI). |
uriPathAndQuery | Mengembalikan jalur dan nilai kueri untuk pengidentifikasi sumber daya seragam (URI). |
uriPort | Mengembalikan nilai port pengidentifikasi sumber daya seragam (URI). |
uriQuery | Retur0sn nilai kueri pengidentifikasi sumber daya seragam (URI). |
uriScheme | Mengembalikan nilai skema pengidentifikasi sumber daya seragam (URI). |
Manipulasi objek dan fungsi konstruksi
Fungsi | Penjelasan |
---|---|
addProperty | Tambahkan properti dan nilainya, atau pasangan nama-nilai, ke objek JSON dan kembalikan objek yang diperbarui. |
removeProperty | Hapus properti dari objek JSON dan kembalikan objek yang diperbarui. |
setProperty | Atur nilai properti objek JSON dan kembalikan objek yang diperbarui. |
getProperty | Mengembalikan nilai properti atau properti akar tertentu dari objek JSON. |
gabungkan | Mengembalikan nilai non-null pertama dari satu atau beberapa parameter. |
xPath | Memeriksa XML untuk node atau nilai yang cocok dengan ekspresi JalurX (XML Path Language), dan mengembalikan node atau nilai yang cocok. |
jPath | Periksa string JSON atau JSON untuk simpul atau nilai yang cocok dengan ekspresi jalur, dan kembalikan simpul yang cocok. |
setPathToValue | Atur nilai jalur tertentu dan kembalikan nilainya. |
Fungsi ekspresi reguler
Fungsi | Penjelasan |
---|---|
isMatch | Mengembalikan true jika string cocok dengan pola regex umum. |
Fungsi pemeriksaan jenis
Fungsi | Penjelasan |
---|---|
EOL | Mengembalikan teks urutan akhir baris (EOL). |
isInteger | Mengembalikan true jika input yang diberikan adalah bilangan bulat |
isFloat | Mengembalikan true jika input yang diberikan adalah angka titik float |
isBoolean | Mengembalikan true jika input yang diberikan adalah Boolean. |
isArray | Mengembalikan true jika input yang diberikan adalah array. |
isObject | Mengembalikan true jika input yang diberikan adalah objek. |
isDateTime | Mengembalikan true jika input yang diberikan adalah tanda waktu format ISO UTC. |
isString | Mengembalikan true jika input yang diberikan adalah string. |
Fungsi bawaan diurutkan menurut abjad
abs
Mengembalikan nilai absolut dari angka yang ditentukan.
abs(<number>)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<number> | Ya | number | Angka untuk mendapatkan nilai absolut dari |
Nilai hasil | Tipe | Description |
---|---|---|
<result> | number | Hasil dari komputasi nilai absolut. |
Contoh
Contoh-contoh ini menghitung nilai absolut:
abs(3.12134)
abs(-3.12134)
Dan keduanya mengembalikan hasil 3,12134.
tambahkan
Mengembalikan hasil dari menambahkan dua angka atau lebih (kasus angka murni) atau menggabungkan dua string atau lebih (kasus lain).
add(<item1>, <item2>, ...)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<item1>, <item2>,... | Ya | any | item |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<result-sum> | angka atau string | Hasil dari menambahkan angka yang ditentukan atau hasil concat. |
Contoh
Contoh ini menambahkan angka yang ditentukan:
add(1, 1.5)
Dan mengembalikan hasil 2,5.
Contoh ini menggabungkan item yang ditentukan:
add('hello',null)
add('hello','world')
Dan mengembalikan hasilnya
- halo
- helloworld
addDays
Tambahkan sejumlah hari ke tanda waktu dalam format lokal opsional.
addDays('<timestamp>', <days>, '<format>'?, '<locale>'?)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<timestamp> | Ya | string | String yang berisi tanda waktu yang harus berupa format ISO UTC standar YYYY-MM-DDTHH:mm:ss.fffZ |
<days> | Ya | Integer | Jumlah hari positif atau negatif yang akan ditambahkan |
<format> | No | string | Pola format kustom. Format default untuk tanda waktu adalah format ISO UTC, YYYY-MM-DDTHH:mm:ss.fffZ, yang sesuai dengan ISO 8601. |
<lokal> | No | string | Lokal opsional informasi budaya |
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:00.000Z', 10)
Dan mengembalikan hasil 2018-03-25T00:00:00.000Z.
Contoh 2
Contoh ini mengurangi lima hari dari tanda waktu yang ditentukan:
addDays('2018-03-15T00:00:00.000Z', -5)
Dan mengembalikan hasil 2018-03-10T00:00:00.000Z.
Contoh 3
Contoh ini menambahkan 1 hari ke tanda waktu yang ditentukan di lokal de-DE :
addDays('2018-03-15T13:00:00.000Z', 1, '', 'de-dE')
Dan mengembalikan hasil 16.03.18 13:00:00.
addHours
Tambahkan sejumlah jam ke tanda waktu dalam format lokal opsional.
addHours('<timestamp>', <hours>, '<format>'?, '<locale>'?)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<timestamp> | Ya | string | String yang berisi tanda waktu |
<hour>s | Ya | Integer | Jumlah positif atau negatif dari jam yang akan ditambahkan |
<format> | No | string | Pola format kustom. Format default untuk tanda waktu adalah format ISO UTC, YYYY-MM-DDTHH:mm:ss.fffZ, yang sesuai dengan ISO 8601. |
<lokal> | No | string | Lokal opsional informasi budaya |
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:00.000Z', 10)
Dan mengembalikan hasil 2018-03-15T10:00:00.000Z.
Contoh 2
Contoh ini mengurangi lima jam dari tanda waktu yang ditentukan:
addHours('2018-03-15T15:00:00.000Z', -5)
Dan mengembalikan hasil 2018-03-15T10:00:00.000Z.
Contoh 3
Contoh ini menambahkan 2 jam ke tanda waktu yang ditentukan di lokal de-DE :
addHours('2018-03-15T13:00:00.000Z', 2, '', 'de-DE')
Dan mengembalikan hasil 15.03.18 15:00:00.
addMinutes
Tambahkan sejumlah menit ke tanda waktu dalam format lokal opsional.
addMinutes('<timestamp>', <minutes>, '<format>'?, '<locale>'?)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<timestamp> | Ya | string | String yang berisi tanda waktu |
<menit> | Ya | Integer | Jumlah positif atau negatif dari menit yang akan ditambahkan |
<format> | No | string | Pola format kustom. Format default untuk tanda waktu adalah format ISO UTC, YYYY-MM-DDTHH:mm:ss.fffZ, yang sesuai dengan ISO 8601. |
<lokal> | No | string | Lokal opsional informasi budaya |
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:00.000Z', 10)
Dan mengembalikan hasil 2018-03-15T00:20:00.000Z.
Contoh 2
Contoh ini mengurangi lima menit dari tanda waktu yang ditentukan:
addMinutes('2018-03-15T00:20:00.000Z', -5)
Dan mengembalikan hasil 2018-03-15T00:15:00.000Z.
Contoh 3
Contoh ini menambahkan 30 menit ke tanda waktu yang ditentukan di lokal de-DE :
addMinutes('2018-03-15T00:00:00.000Z', 30, '', 'de-DE')
Dan mengembalikan hasil 15.03.18 13:30:00.
addOrdinal
Mengembalikan nomor ordinal dari angka input.
addOrdinal(<number>)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<number> | Ya | Integer | Angka yang akan dikonversi ke angka ordinal |
Nilai hasil | Tipe | Description |
---|---|---|
<result> | string | Nomor ordinal yang dikonversi dari nomor input |
Contoh
addOrdinal(11)
addOrdinal(12)
addOrdinal(13)
addOrdinal(21)
addOrdinal(22)
addOrdinal(23)
Dan masing-masing mengembalikan hasil ini:
- Ke-11
- Ke-12
- Ke-13
- Ke-21
- Ke-22
- Ke-23
addProperty
Menambahkan properti dan nilainya, atau pasangan nilai-nama, ke objek JSON, dan mengembalikan objek yang diperbarui. Jika objek sudah ada pada runtime fungsi akan melemparkan kesalahan.
addProperty('<object>', '<property>', value)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<object> | Ya | object | Objek JSON tempat Anda ingin menambahkan properti |
<property> | Ya | string | Nama properti yang akan ditambahkan |
<value> | Ya | any | Nilai properti |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<updated-object> | object | Objek JSON yang diperbarui setelah menambahkan properti baru |
Contoh
Contoh ini menambahkan properti accountNumber ke objek customerProfile, yang dikonversi ke JSON dengan fungsi json(). Fungsi menetapkan nilai yang dihasilkan oleh fungsi newGuid(), dan mengembalikan objek yang diperbarui:
addProperty(json('customerProfile'), 'accountNumber', newGuid())
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 | Integer | Jumlah positif atau negatif dari detik untuk ditambahkan |
<format> | No | string | Pola format kustom. Format default untuk tanda waktu adalah format ISO UTC, YYYY-MM-DDTHH:mm:ss.fffZ, yang sesuai dengan ISO 8601. |
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:00.000Z', 10)
Dan mengembalikan hasil 2018-03-15T00:00:10.000Z.
Contoh 2
Contoh ini mengurangi lima detik dari tanda waktu yang ditentukan:
addSeconds('2018-03-15T00:00:30.000Z', -5)
Dan mengembalikan hasil 2018-03-15T00:00:25.000Z.
addToTime
Tambahkan sejumlah unit waktu ke tanda waktu dalam format lokal opsional. Lihat juga getFutureTime().
addToTime('<timestamp>', '<interval>', <timeUnit>, '<format>'?, '<locale>'?)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<timestamp> | Ya | string | String yang berisi tanda waktu |
<interval> | Ya | Integer | Jumlah unit waktu yang ditentukan untuk ditambahkan |
<timeUnit> | Ya | string | Unit waktu yang digunakan dengan interval. Unit yang mungkin adalah "Kedua", "Menit", "Jam", "Hari", "Minggu", "Bulan", dan "Tahun". |
<format> | No | string | Pola format kustom. Format default untuk tanda waktu adalah format ISO UTC, YYYY-MM-DDTHH:mm:ss.fffZ, yang sesuai dengan ISO 8601. |
<lokal> | No | string | Lokal opsional informasi budaya |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<updated-timestamp> | string | Tanda waktu ditambah jumlah unit waktu yang ditentukan dengan format tertentu. |
Contoh 1
Contoh ini menambahkan satu hari ke tanda waktu yang ditentukan.
addToTime('2018-01-01T00:00:00.000Z', 1, 'Day')
Dan mengembalikan hasil 2018-01-02T00:00:00.000Z.
Contoh 2
Contoh ini menambahkan dua minggu ke tanda waktu yang ditentukan.
addToTime('2018-01-01T00:00:00.000Z', 2, 'Week', 'MM-DD-YY')
Dan mengembalikan hasil dalam format 'MM-DD-YY' sebagai 01-15-18.
all
Tentukan apakah semua elemen urutan memenuhi suatu kondisi.
all(<sequence>, <item>, <condition>)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<Urutan> | Ya | object | Urutan yang akan dievaluasi. |
<item> | Ya | string | Mengacu pada elemen untuk dievaluasi secara berurutan. |
<kondisi> | Ya | expression | Ekspresi untuk mengevaluasi kondisi. |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
BENAR atau SALAH | Boolean | Mengembalikan true jika semua elemen memenuhi kondisi. Kembalikan false jika setidaknya satu tidak. |
Contoh
Contoh-contoh ini menentukan apakah semua elemen urutan memenuhi kondisi:
all(createArray(1, 'cool'), item, isInteger(item))
all(createArray(1, 2), item => isInteger(item))
Dan kembalikan hasil berikut masing-masing:
- false, karena kedua item dalam urutan bukan bilangan bulat.
- true, karena kedua item dalam urutan adalah bilangan bulat.
dan
Memeriksa apakah semua ekspresi berupa true. Kembalikan true
jika semua ekspresi benar, atau kembalikan false
jika setidaknya satu ekspresi salah.
and(<expression1>, <expression2>, ...)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<ekspresi1>, <ekspresi2>, ... | Ya | Boolean | Ekspresi yang akan diperiksa |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
BENAR atau SALAH | Boolean | Kembalikan true jika semua ekspresi benar. Mengembalikan false jika setidaknya satu ekspresi salah. |
Contoh 1
Contoh-contoh ini memeriksa apakah nilai Boolean yang ditentukan semuanya true:
and(true, true)
and(false, true)
and(false, false)
Dan masing-masing mengembalikan hasil ini:
- Kedua ekspresi benar, sehingga fungsi mengembalikan
true
. - Satu ekspresi salah, sehingga fungsi mengembalikan
false
. - Kedua ekspresi salah, sehingga fungsi mengembalikan
false
.
Contoh 2
Contoh-contoh ini memeriksa apakah ekspresi yang ditentukan semuanya true:
and(equals(1, 1), equals(2, 2))
and(equals(1, 1), equals(1, 2))
and(equals(1, 2), equals(1, 3))
Dan masing-masing mengembalikan hasil ini:
- Kedua ekspresi benar, sehingga fungsi mengembalikan
true
. - Satu ekspresi salah, sehingga fungsi mengembalikan
false
. - Kedua ekspresi salah, sehingga fungsi mengembalikan
false
.
any
Tentukan apakah ada elemen urutan yang memenuhi kondisi.
all(<sequence>, <item>, <condition>)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<Urutan> | Ya | object | Urutan yang akan dievaluasi. |
<item> | Ya | string | Mengacu pada elemen untuk dievaluasi secara berurutan. |
<kondisi> | Ya | expression | Ekspresi untuk mengevaluasi kondisi. |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
BENAR atau SALAH | Boolean | Mengembalikan true jika semua elemen memenuhi kondisi. Kembalikan false jika setidaknya satu tidak. |
Contoh
Contoh-contoh ini menentukan apakah semua elemen urutan memenuhi kondisi:
any(createArray(1, 'cool'), item, isInteger(item))
any(createArray('first', 'cool'), item => isInteger(item))
Dan kembalikan hasil berikut masing-masing:
- true, karena setidaknya satu item dalam urutan adalah bilangan bulat
- false, karena tidak ada item dalam urutan bilangan bulat.
rata-rata
Mengembalikan rata-rata angka array numerik.
average(<numericArray>)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<numericArray> | Ya | array angka | Array input untuk menghitung rata-rata |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<average-of-array> | number | Nilai rata-rata array yang diberikan |
Contoh
Contoh ini menghitung rata-rata array dalam createArray()
:
average(createArray(1,2,3))
Dan mengembalikan hasil 2.
base64
Mengembalikan versi string atau byte array yang dikodekan base64.
base64('<value>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<value> | Ya | string atau byte array | String input |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<base64-string> | string | Versi string input yang dikodekan base64 |
Contoh 1
Contoh ini mengonversi string hello ke string yang dikodekan base64:
base64('hello')
Dan mengembalikan hasil "aGVsbG8=".
Contoh 2
Contoh ini mengambil byteArr
, yang sama dengan new byte[] { 3, 5, 1, 12 }
:
base64('byteArr')
Dan mengembalikan hasil "AwUBDA==".
base64ToBinary
Mengembalikan array biner dari string yang dikodekan 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> | byte array | Versi biner dari string yang dikodekan base64 |
Contoh
Contoh ini mengonversi string yang dikodekan base64 AwUBDA== menjadi string biner:
base64ToBinary('AwUBDA==')
Dan mengembalikan hasil byte baru[] { 3, 5, 1, 12 }.
base64KeUntai
Mengembalikan versi string dari string yang dikodekan base64, secara efektif mendekode string base64.
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 string dari string yang dikodekan base64 |
Contoh
Contoh ini mengonversi string yang dikodekan base64 aGVsbG8= menjadi string yang didekodekan:
base64ToString('aGVsbG8=')
Dan mengembalikan hasilnya halo.
biner
Mengembalikan versi biner string.
binary('<value>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<value> | Ya | string | String yang akan dikonversi |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<binary-for-input-value> | byte array | Versi biner dari string yang ditentukan |
Contoh
Contoh ini mengonversi string hello menjadi string biner:
binary('hello')
Dan mengembalikan hasil byte baru[] { 104, 101, 108, 108, 111 }.
bool
Mengembalikan versi Boolean dari sebuah nilai.
bool(<value>)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<value> | Ya | any | Nilai yang akan dikonversi |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
BENAR atau SALAH | Boolean | Versi Boolean dari nilai yang ditentukan |
Contoh
Contoh-contoh ini mengonversi nilai yang ditentukan ke nilai Boolean:
bool(1)
bool(0)
Dan masing-masing mengembalikan hasil ini:
true
false
ceiling
Mengembalikan nilai integral terbesar kurang dari atau sama dengan angka yang ditentukan.
ceiling('<number>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<number> | Ya | number | Nomor input |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<nilai bilangan bulat> | Integer | Nilai integral terbesar lebih besar dari atau sama dengan angka input |
Contoh
Contoh ini mengembalikan nilai integral terbesar yang kurang dari atau sama dengan angka 10,333:
ceiling(10.333)
Dan mengembalikan bilangan bulat 11.
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 |
---|---|---|---|
<object**1>, <object**2>, ... | Ya | apa pun (jenis campuran dapat diterima) | Satu atau beberapa item untuk diperiksa null-nya |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<first-non-null-item> | any | 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 masing-masing kembali:
true
- halo
- nihil
concat
Gabungkan dua objek atau lebih, dan kembalikan objek gabungan dalam daftar atau string.
concat('<text1>', '<text2>', ...)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<object1>, <object2>, ... | Ya | any | Setidaknya dua objek untuk dikoncat. |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<object1object2...> | string atau daftar | String atau daftar gabungan. Nilai null dilewati. |
Nilai pengembalian yang diharapkan:
- Jika semua item adalah daftar, daftar akan dikembalikan.
- Jika ada item yang bukan daftar, string akan dikembalikan.
- Jika nilai null, nilai akan dilewati dan tidak digabungkan.
Contoh
Contoh ini menggabungkan string Hello dan World:
concat('Hello', 'World')
Dan mengembalikan hasilnya HelloWorld.
Contoh 2
Contoh ini menggabungkan daftar [1,2] dan [3,4]:
concat([1,2],[3,4])
Dan mengembalikan hasil [1,2,3,4].
Contoh 3
Contoh-contoh ini menggabungkan objek dari berbagai jenis:
concat('a', 'b', 1, 2)
concat('a', [1,2])
Dan kembalikan hasil berikut masing-masing:
- String ab12.
- Objek aSystem.Collections.Generic.List 1[System.Object]. Ini tidak dapat dibaca dan terbaik untuk dihindari.
Contoh 4
Contoh-contoh ini menggabungkan objek akan null
:
concat([1,2], null)
concat('a', 1, null)
Dan kembalikan hasil berikut masing-masing:
- Daftar [1,2].
- String a1.
mengandung
Memeriksa apakah koleksi memiliki item tertentu. Kembalikan true
jika item ditemukan, atau kembali false
jika tidak ditemukan. Fungsi ini peka huruf besar/kecil.
contains('<collection>', '<value>')
contains([<collection>], '<value>')
Fungsi ini berfungsi pada jenis koleksi berikut:
- Untai (karakter) untuk menemukan substring
- Larik untuk menemukan nilai
- Kamus untuk menemukan kunci
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<collection> | Ya | string, array, atau kamus | Koleksi yang akan diperiksa |
<value> | Ya | string, array, atau kamus, masing-masing | Item yang akan ditemukan |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
BENAR atau SALAH | Boolean | Mengembalikan true jika item ditemukan. Kembalikan false jika tidak ditemukan. |
Contoh 1
Contoh ini memeriksa string hello world untuk dunia substring:
contains('hello world', 'world')
Dan mengembalikan hasilnya true
.
Contoh 2
Contoh ini memeriksa string hello world untuk alam semesta substring:
contains('hello world', 'universe')
Dan mengembalikan hasilnya false
.
jumlah
Mengembalikan jumlah item dalam koleksi.
count('<collection>')
count([<collection>])
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<collection> | Ya | string atau array | Koleksi dengan item yang akan dihitung |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<length-or-count> | Integer | Jumlah item dalam koleksi |
Contoh:
Contoh ini menghitung jumlah item dalam koleksi ini:
count('abcd')
count(createArray(0, 1, 2, 3))
Dan keduanya mengembalikan hasil 4.
countWord
Mengembalikan jumlah kata dalam string
countWord('<text>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<text> | Ya | string | String yang akan dihitung |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<count> | Integer | Jumlah kata dalam string |
Contoh
Contoh ini menghitung jumlah kata dalam string hello world:
countWord("hello word")
Dan mengembalikan hasil 2.
convertFromUTC
Mengonversi tanda waktu dalam format lokal opsional dari Universal Time Coordinated (UTC) ke zona waktu target.
convertFromUTC('<timestamp>', '<destinationTimeZone>', '<format>'?, '<locale>'?)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<timestamp> | Ya | string | String yang berisi tanda waktu |
<destinationTimeZone> | Ya | string | Nama zona waktu target. Mendukung zona waktu Windows dan IANA. |
<format> | No | string | Pola format kustom. Format default untuk tanda waktu adalah format "o", yyyy-MM-ddTHH:mm:ss.fffffffK, yang sesuai dengan ISO 8601. |
<lokal> | No | string | Lokal opsional informasi budaya |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<converted-timestamp> | string | Tanda waktu yang dikonversi ke zona waktu target |
Contoh:
Contoh-contoh ini mengonversi dari UTC ke Waktu Standar Pasifik:
convertFromUTC('2018-02-02T02:00:00.000Z', 'Pacific Standard Time', 'MM-DD-YY')
convertFromUTC('2018-02-02T02:00:00.000Z', 'Pacific Standard Time')
Dan masing-masing mengembalikan hasil ini:
- 02-01-18
- 2018-01-01T18:00:00.0000000
Contoh 2
Contoh ini mengonversi tanda waktu di lokal en-US dari UTC ke Waktu Standar Pasifik:
convertFromUTC('2018-01-02T02:00:00.000Z', 'Pacific Standard Time', 'D', 'en-US')
Dan mengembalikan hasilnya Senin, 1 Januari 2018.
convertToUTC
Mengonversi tanda waktu dalam format lokal opsional ke Universal Time Coordinated (UTC) dari zona waktu sumber.
convertToUTC('<timestamp>', '<sourceTimeZone>', '<format>'?, '<locale>'?)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<timestamp> | Ya | string | String yang berisi tanda waktu |
<sourceTimeZone> | Ya | string | Nama zona waktu target. Mendukung zona waktu Windows dan IANA. |
<format> | No | string | Pola format kustom. Format default untuk tanda waktu adalah format ISO UTC, YYYY-MM-DDTHH:mm:ss.fffZ, yang sesuai dengan ISO 8601. |
<lokal> | No | string | Lokal opsional informasi budaya |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<converted-timestamp> | string | Tanda waktu yang dikonversi ke zona waktu target |
Contoh
Contoh ini mengonversi tanda waktu ke UTC dari Waktu Standar Pasifik
convertToUTC('01/01/2018 00:00:00', 'Pacific Standard Time')
Dan mengembalikan hasil 2018-01-01T08:00:00.000Z.
Contoh 2
Contoh ini mengonversi tanda waktu di lokal de-DE ke UTC dari Waktu Standar Pasifik:
convertToUTC('01/01/2018 00:00:00', 'Pacific Standard Time', '', 'de-DE')
Dan mengembalikan hasil 01.01.18 08:00:00.
createArray
Mengembalikan larik dari beberapa input.
createArray('<object1>', '<object2>', ...)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<object1>, <object2>, ... | Ya | apa pun, tetapi tidak dicampur | Setidaknya dua item untuk membuat larik |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
[<object1>, <object2>, ...] | array | Larik yang dibuat dari semua item input |
Contoh
Contoh ini membuat array dari input berikut:
createArray('h', 'e', 'l', 'l', 'o')
Dan mengembalikan hasil [h, e, l, l, o].
dataUri
Mengembalikan pengidentifikasi sumber daya seragam data (URI) dari string.
dataUri('<value>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<value> | Ya | string | String yang akan dikonversi |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
[<date-uri>] | string | URI data untuk untai (karakter) input |
Contoh
dataUri('hello')
Mengembalikan data hasil :text/plain; charset=utf-8; base64,aGVsbG8=.
dataUriToBinary
Mengembalikan versi biner pengidentifikasi sumber daya seragam data (URI).
dataUriToBinary('<value>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<value> | Ya | string | URI data yang akan dikonversi |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
[<biner-for-data-uri>] | byte array | Versi biner URI data |
Contoh
Contoh ini membuat versi biner untuk URI data berikut:
dataUriToBinary('aGVsbG8=')
Dan mengembalikan hasil byte baru[] { 97, 71, 86, 115, 98, 71, 56, 61 }.
dataUriToString
Mengembalikan versi string pengidentifikasi sumber daya seragam data (URI).
dataUriToString('<value>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<value> | Ya | string | URI data yang akan dikonversi |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
[<string-for-data-uri>] | string | Versi string URI data |
Contoh
Contoh ini membuat string dari URI data berikut:
dataUriToString('data:text/plain;charset=utf-8;base64,aGVsbG8=')
Dan mengembalikan hasilnya halo.
date
Mengembalikan tanggal tanda waktu yang ditentukan dalam format m/dd/yyyy .
date('<timestramp>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<timestamp> | Ya | string | String yang berisi tanda waktu |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<d>ate | string | Tanggal tanda waktu yang ditentukan |
date('2018-03-15T13:00:00.000Z')
Mengembalikan hasil 3-15-2018.
dateReadBack
Menggunakan pustaka tanggal-waktu untuk memberikan readback tanggal.
dateReadBack('<currentDate>', '<targetDate>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<currentDate> | Ya | string | String yang berisi tanggal saat ini |
<targetDate> | Ya | string | String yang berisi tanggal target |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<tanggal-baca balik> | string | Readback antara tanggal saat ini dan tanggal target |
Contoh 1
dateReadBack('2018-03-15T13:00:00.000Z', '2018-03-16T13:00:00.000Z')
Mengembalikan hasilnya besok.
dateTimeDiff
Mengembalikan perbedaan dalam tanda waktu antara dua tanda waktu.
dateTimeDiff('<timestamp1>', '<timestamp2>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<tanda waktu1> | Ya | string | String tanda waktu pertama yang dibandingkan |
<tanda waktu2> | Ya | string | String tanda waktu kedua untuk dibandingkan |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<ticks> | number | Perbedaan kutu antara dua tanda waktu |
Contoh 1
Contoh ini mengembalikan perbedaan dalam tanda waktu antara dua tanda waktu:
dateTimeDiff('2019-01-01T08:00:00.000Z','2018-01-01T08:00:00.000Z')
Dan mengembalikan angka 31536000000000.
Contoh 2
Contoh ini mengembalikan perbedaan dalam tanda waktu antara dua tanda waktu:
dateTimeDiff('2018-01-01T08:00:00.000Z', '2019-01-01T08:00:00.000Z')
Mengembalikan hasil -315360000000000. Nilainya adalah angka negatif.
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> | Integer | Hari dalam bulan dari tanda waktu yang ditentukan |
Contoh
Contoh ini mengembalikan angka untuk hari dalam sebulan dari tanda waktu berikut:
dayOfMonth('2018-03-15T13:27:36Z')
Dan mengembalikan hasil 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> | Integer | Hari dalam seminggu dari tanda waktu yang ditentukan. Minggu adalah 0, Senin adalah 1, dan sebagainya. |
Contoh
Contoh ini mengembalikan angka untuk hari dalam seminggu dari tanda waktu berikut:
dayOfWeek('2018-03-15T13:27:36Z')
Dan mengembalikan hasil 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> | Integer | Hari dalam tahun dari tanda waktu yang ditentukan |
Contoh
Contoh ini mengembalikan jumlah hari dalam setahun dari tanda waktu berikut:
dayOfYear('2018-03-15T13:27:36Z')
Dan mengembalikan hasil 74.
div
Kembalikan hasil bilangan bulat dari membagi dua angka. Untuk mengembalikan sisanya, lihat mod().
div(<dividend>, <divisor>)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<dividend> | Ya | number | Angka yang dibagi menurut pembagi |
<divisor> | Ya | number | Angka yang membagi dividen. Tidak bisa 0. |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<quotient-result> | number | Hasil dari pembagian angka pertama dengan angka kedua |
Contoh
Kedua contoh membagi angka pertama dengan angka kedua:
div(10, 5)
div(11, 5)
Dan mengembalikan hasil 2.
Ada beberapa kesenjangan antara Javascript dan .NET SDK. Misalnya, ekspresi berikut akan mengembalikan hasil yang berbeda di Javascript dan .NET SDK:
Jika salah satu parameter adalah float, hasilnya juga akan menjadi FLOAT dengan .NET SDK.
Contoh
div(11.2, 2)
Mengembalikan hasil 5,6.
Jika salah satu parameter adalah float, hasilnya akan menjadi INT dengan Javascript SDK.
Contoh
div(11.2, 2)
Mengembalikan hasil 5.
Solusi untuk Javascript untuk menyimpan sejumlah tempat desimal dalam hasil adalah dengan menggunakan ekspresi tersebut. Misalnya, untuk menyimpan 3 tempat desimal:
float(concat(string(div(a, b)),'.',string(mod(div(a*1000, b), 1000))))
kosong
Periksa apakah instans kosong. Kembalikan true
jika input kosong.
Kosong berarti:
- input null atau tidak ditentukan
- input adalah string null atau kosong
- input adalah koleksi ukuran nol
- input adalah objek tanpa properti.
empty('<instance>')
empty([<instance>])
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<Sebagai contoh> | Ya | any | Instans yang akan diperiksa |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
BENAR atau SALAH | Boolean | Kembalikan true saat instans kosong. |
Contoh
Contoh-contoh ini memeriksa apakah instans yang ditentukan kosong:
empty('')
empty('abc')
empty([1])
empty(null)
Dan mengembalikan hasil ini masing-masing:
- Meneruskan string kosong, sehingga fungsi mengembalikan
true
. - Meneruskan string abc, sehingga fungsi mengembalikan
false
. - Meneruskan koleksi dengan satu item, sehingga fungsi mengembalikan
false
. - Meneruskan objek null, sehingga fungsi mengembalikan
true
.
endsWith
Memeriksa apakah untai (karakter) berakhir dengan substring tertentu. Kembalikan true
jika substring ditemukan, atau kembali false
jika 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 | Kembalikan true saat substring akhir ditemukan. Mengembalikan false jika tidak ditemukan |
Contoh 1
Contoh ini memeriksa apakah string hello world berakhir dengan dunia string:
endsWith('hello world', 'world')
Dan mengembalikan hasilnya true
.
Contoh 2
Contoh ini memeriksa apakah string hello world berakhir dengan string universe:
endsWith('hello world', 'universe')
Dan mengembalikan hasilnya false
.
EOL
Mengembalikan teks urutan akhir baris (EOL).
EOL()
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<IsOSPlatform> | string | Kembalikan \r\n di Windows dan \n di Mac dan Linux. |
Contoh
Contoh ini memeriksa akhir teks urutan baris:
EOL()
Dan mengembalikan string berikut:
- Windows: \r\n
- Mac atau Linux: \n
setara
Memeriksa apakah kedua nilai, ekspresi, atau objek bersifat setara. Kembalikan true
jika keduanya setara, atau kembalikan false
jika tidak setara.
equals('<object1>', '<object2>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<object1>, <object2> | Ya | any | Nilai, ekspresi, atau objek yang akan dibandingkan |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
BENAR atau SALAH | Boolean | Mengembalikan true ketika keduanya setara. Kembalikan false jika tidak setara. |
Contoh
Contoh-contoh ini memeriksa apakah input yang ditentukan setara:
equals(true, 1)
equals('abc', 'abcd')
Dan mengembalikan hasil ini masing-masing:
- Kedua nilai tersebut setara, sehingga fungsi mengembalikan
true
. - Kedua nilai tidak setara, sehingga fungsi mengembalikan
false
.
ada
Mengevaluasi ekspresi kebenaran.
exists(expression)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
expression | Ya | expression | Ekspresi untuk mengevaluasi kebenaran |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<benar atau salah> | Boolean | Hasil evaluasi ekspresi |
Contoh
Contoh ini mengevaluasi kebenaran dari foo = {"bar":"value"}
:
exists(foo.bar)
exists(foo.bar2)
Dan mengembalikan hasil ini masing-masing:
true
false
exp
Mengembalikan eksponensiasi satu angka ke angka lainnya.
exp(realNumber, exponentNumber)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
realNumber | Ya | number | Bilangan riil untuk menghitung eksponen |
exponentNumber | Ya | number | Nomor eksponen |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<result-exp> | number | Hasil dari eksponen komputasi realNumber |
Contoh
Contoh ini menghitung eksponen:
exp(2, 2)
Dan mengembalikan hasil 4.
pertama
Mengembalikan item pertama dari untai (karakter) atau larik.
first('<collection>')
first([<collection>])
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<collection> | Ya | string atau array | Koleksi untuk menemukan item pertama |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<first-collection-item> | any | Item pertama dalam koleksi |
Contoh
Contoh-contoh ini menemukan item pertama dalam koleksi berikut:
first('hello')
first(createArray(0, 1, 2))
Dan mengembalikan hasil ini masing-masing:
- h
- 0
flatten
Meratakan array ke dalam nilai non-array. Anda dapat secara opsional mengatur kedalaman maksimum untuk meratakan.
flatten([<collection>], '<depth>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<collection> | Ya | array | Koleksi yang akan diratakan |
<dalam> | No | number | Kedalaman maksimum untuk meratakan. Defaultnya adalah infinity. |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<koleksi baru> | array | Koleksi baru yang elemennya telah diratakan ke non-array ke kedalaman yang ditentukan |
Contoh 1
Contoh THis meratakan array berikut:
flatten(createArray(1, createArray(2), createArray(createArray(3, 4), createArray(5, 6)))
Dan mengembalikan hasil [1, 2, 3, 4, 5, 6].
Contoh 2
Contoh ini meratakan array ke kedalaman 1:
flatten(createArray(1, createArray(2), createArray(createArray(3, 4), createArray(5, 6)), 1)
Dan mengembalikan hasil [1, 2, [3, 4], [5, 6]].
float
Konversikan versi string dari angka floating-point menjadi angka floating-point. Anda hanya dapat menggunakan fungsi ini saat meneruskan parameter kustom ke aplikasi, seperti aplikasi logika. Pengecualian akan dilemparkan jika string tidak dapat dikonversi ke float.
float('<value>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<value> | Ya | string | String yang memiliki angka floating-point yang valid untuk dikonversi ke |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<float-value> | float | Jumlah titik mengambang dari string yang ditentukan |
Contoh
Contoh ini mengonversi versi float dari string:
float('10.333')
Dan mengembalikan float 10,333.
floor
Mengembalikan nilai integral terbesar kurang dari atau sama dengan angka yang ditentukan.
floor('<number>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<number> | Ya | number | Nomor input |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<nilai bilangan bulat> | Integer | Nilai integral terbesar kurang dari atau sama dengan angka input |
Contoh
Contoh ini menghitung nilai lantai angka 10,333:
floor(10.333)
Dan mengembalikan bilangan bulat 10.
foreach
Beroperasi pada setiap elemen dan mengembalikan koleksi baru.
foreach([<collection/instance>], <iteratorName>, <function>)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<koleksi/instans> | Ya | array atau objek | Koleksi dengan item |
<iteratorName> | Ya | nama iterator | Item kunci fungsi panah |
<fungsi> | Ya | expression | Fungsi yang berisi iteratorName |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<koleksi baru> | array | Koleksi baru di mana setiap elemen telah dievaluasi oleh fungsi |
Contoh 1
Contoh ini menghasilkan koleksi baru:
foreach(createArray(0, 1, 2, 3), x, x + 1)
Dan mengembalikan hasil [1, 2, 3, 4].
Contoh 2
Contoh-contoh ini menghasilkan koleksi baru:
foreach(json("{'name': 'jack', 'age': '15'}"), x, concat(x.key, ':', x.value))
foreach(json("{'name': 'jack', 'age': '15'}"), x=> concat(x.key, ':', x.value))
Dan kembalikan hasil ['name:jack', 'age:15']. Perhatikan bahwa ekspresi kedua adalah ekspresi lambda, yang menurut beberapa orang lebih mudah dibaca.
formatDateTime
Mengembalikan tanda waktu dalam format lokal opsional.
formatDateTime('<timestamp>', '<format>'?, '<locale>'?)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<timestamp> | Ya | string | String yang berisi tanda waktu |
<format> | No | string | Pola format kustom. Format default untuk tanda waktu adalah format ISO UTC, YYYY-MM-DDTHH:mm:ss.fffZ, yang sesuai dengan ISO 8601. |
<lokal> | No | string | Lokal opsional informasi budaya |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<reformatted-timestamp> | string | Tanda waktu yang diperbarui dalam format yang ditentukan |
Contoh 1
Contoh ini mengonversi tanda waktu ke format yang ditentukan:
formatDateTime('03/15/2018 12:00:00', 'yyyy-MM-ddTHH:mm:ss')
Dan mengembalikan hasil 2018-03-15T12:00:00.
Contoh 2
Contoh ini mengonversi tanda waktu di lokal de-DE :
formatDateTime('2018-03-15', '', 'de-DE')
Dan mengembalikan hasil 15.03.18 00:00:00.
formatEpoch
Mengembalikan tanda waktu dalam format lokal opsional dalam format yang ditentukan dari waktu UNIX (juga dikenal sebagai waktu Epoch, waktu POSIX, waktu UNIX Epoch).
formatEpoch('<epoch>', '<format>'?, '<locale>'?)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<zaman> | Ya | number | Nomor epoch |
<format> | No | string | Pola format kustom. Format default untuk tanda waktu adalah format ISO UTC, YYYY-MM-DDTHH:mm:ss.fffZ, yang sesuai dengan ISO 8601. |
<lokal> | No | string | Lokal opsional informasi budaya |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<reformatted-timestamp> | string | Tanda waktu yang diperbarui dalam format yang ditentukan |
Contoh
Contoh ini mengonversi tanda waktu Unix ke format yang ditentukan:
formatEpoch(1521118800, 'yyyy-MM-ddTHH:mm:ss.fffZ)'
Dan mengembalikan hasil 2018-03-15T12:00:00.000Z.
Contoh
Contoh ini mengonversi tanda waktu Unix di lokal de-DE :
formatEpoch(1521118800, '', 'de-DE')
Dan mengembalikan hasil 15.03.18 13:00:00.
formatNumber
Format nilai ke jumlah digit pecahan yang ditentukan dan lokal opsional yang ditentukan.
formatNumber('<number>', '<precision-digits>', '<locale>'?)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<number> | Ya | number | Nomor input |
<digit presisi> | Ya | Integer | Jumlah digit pecahan yang ditentukan |
<lokal> | No | string | Lokal opsional informasi budaya |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<return-value> | number | Nilai pengembalian input yang diformat pada jumlah digit pecahan tertentu dan lokal tertentu |
Contoh 1
Contoh ini memformat angka 10,333 hingga 2 digit pecahan:
formatNumber(10.333, 2)
Dan mengembalikan string 10.33.
Contoh 2
Contoh-contoh ini memformat angka ke jumlah digit tertentu dalam lokal en-AS :
formatNumber(12.123, 2, 'en-US')
formatNumber(1.551, 2, 'en-US')
formatNumber(12.123, 4, 'en-US')
Dan kembalikan hasil berikut masing-masing:
- 12.12
- 1.55
- 12.1230
formatTicks
Mengembalikan tanda waktu dalam format lokal opsional dalam format yang ditentukan dari tanda centang.
formatTicks('<ticks>', '<format>'?, '<locale>'?)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<zaman> | Ya | angka (atau bigint dalam JavaScript) | Nomor tanda centang |
<format> | No | string | Pola format kustom. Format default untuk tanda waktu adalah format ISO UTC, YYYY-MM-DDTHH:mm:ss.fffZ, yang sesuai dengan ISO 8601. |
<lokal> | No | string | Lokal opsional informasi budaya |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<reformatted-timestamp> | string | Tanda waktu yang diperbarui dalam format yang ditentukan |
Contoh 1
Contoh ini mengonversi tanda centang ke format yang ditentukan:
formatTicks(637243624200000000, 'yyyy-MM-ddTHH:mm:ss.fffZ')
Dan mengembalikan hasil 2020-05-06T11:47:00.000Z.
Contoh 2
Contoh ini mengonversi tanda centang ke format yang ditentukan dalam lokal de-DE :
formatTicks(637243624200000000, '', 'de-DE')
Dan mengembalikan hasil 06.05.20 11:47:00.
getFutureTime
Mengembalikan tanda waktu saat ini dalam format lokal opsional ditambah unit waktu yang ditentukan.
getFutureTime(<interval>, <timeUnit>, '<format>'?, '<locale>'?)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<interval> | Ya | Integer | Jumlah unit waktu tertentu yang akan ditambahkan |
<timeUnit> | Ya | string | Unit waktu yang digunakan dengan interval. Unit yang mungkin adalah "Kedua", "Menit", "Jam", "Hari", "Minggu", "Bulan", dan "Tahun". |
<format> | No | string | Pola format kustom. Format default untuk tanda waktu adalah format ISO UTC, YYYY-MM-DDTHH:mm:ss.fffZ, yang sesuai dengan ISO 8601. |
<lokal> | No | string | Lokal opsional informasi budaya |
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 2019-03-01T00:00:00.000Z. Contoh di bawah ini menambahkan lima hari ke tanda waktu tersebut:
getFutureTime(2, 'Week')
Dan mengembalikan hasil 2019-03-15T00:00:00.000Z.
Contoh 2
Misalkan tanda waktu saat ini adalah 2018-03-01T00:00:00.000Z. Contoh di bawah ini menambahkan lima hari ke tanda waktu dan mengonversi hasilnya ke format MM-DD-YY :
getFutureTime(5, 'Day', 'MM-DD-YY')
Dan mengembalikan hasil 03-06-18.
Contoh 3
Misalkan tanda waktu saat ini adalah 2020-05-01T00:00:00.000Z dan lokalnya de-DE. Contoh di bawah ini menambahkan 1 hari ke tanda waktu:
getFutureTime(1,'Day', '', 'de-DE')
Dan mengembalikan hasil 02.05.20 00:00:00.
getNextViableDate
Mengembalikan tanggal ekspresi Timex berikutnya yang layak berdasarkan tanggal saat ini dan zona waktu yang ditentukan secara opsional.
getNextViableDate(<timexString>, <timezone>?)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<timexString> | Ya | string | String Timex tanggal untuk dievaluasi. |
<zona waktu> | No | string | Zona waktu opsional. |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<nextViableTime> | string | Tanggal berikutnya yang layak. |
Contoh
Katakanlah tanggalnya adalah 2020-06-12 dan waktu saat ini adalah 15:42:21.
Contoh-contoh ini mengevaluasi string Timex untuk tanggal layak berikutnya berdasarkan tanggal dan waktu di atas:
getPreviousViableDate("XXXX-12-20", "America/Los_Angeles")
getPreviousViableDate("XXXX-02-29")
Dan kembalikan string berikut masing-masing:
- 2020-12-20
- 2024-02-29
getNextViableTime
Mengembalikan waktu ekspresi Timex berikutnya yang layak berdasarkan waktu saat ini dan zona waktu yang ditentukan secara opsional.
getNextViableTime(<timexString>, <timezone>?)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<timexString> | Ya | string | String Timex dari waktu untuk dievaluasi. |
<zona waktu> | No | string | Zona waktu opsional. |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<nextViableTime> | string | Waktu berikutnya yang layak. |
Contoh
Katakanlah tanggalnya adalah 2020-06-12 dan waktu saat ini adalah 15:42:21.
Contoh-contoh ini mengevaluasi string Timex untuk waktu yang layak berikutnya berdasarkan tanggal dan waktu di atas:
getNextViableTime("TXX:12:14", "Asia/Tokyo")
getNextViableTime("TXX:52:14")
Dan kembalikan string berikut masing-masing:
- T16:12:14
- T15:52:14
getPastTime
Mengembalikan tanda waktu saat ini dikurangi unit waktu yang ditentukan.
getPastTime(<interval>, <timeUnit>, '<format>'?)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<interval> | Ya | Integer | Jumlah unit waktu tertentu yang akan dikurangi |
<timeUnit> | Ya | string | Unit waktu yang digunakan dengan interval. Unit yang mungkin adalah "Kedua", "Menit", "Jam", "Hari", "Minggu", "Bulan", dan "Tahun". |
<format> | No | string | Pola format kustom. Format default untuk tanda waktu adalah format ISO UTC, YYYY-MM-DDTHH:mm:ss.fffZ, yang sesuai dengan ISO 8601. |
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.000Z. Contoh ini mengurangi lima hari dari tanda waktu yang ditentukan:
getPastTime(5, 'Day')
Dan mengembalikan hasil 2019-01-27T00:00:00.000Z.
Contoh 2
Misalkan tanda waktu saat ini adalah 2018-03-01T00:00:00.000Z. Contoh ini mengurangi lima hari ke tanda waktu dalam format MM-DD-YY :
getPastTime(5, 'Day', 'MM-DD-YY')
Dan mengembalikan hasil 02-26-18.
Contoh 3
Misalkan tanda waktu saat ini adalah 2020-05-01T00:00:00.000Z dan lokalnya de-DE. Contoh di bawah ini mengurangi 1 hari dari tanda waktu:
getPastTime(1,'Day', '', 'de-DE')
Dan mengembalikan hasil 31.04.20 00:00:00.
getPreviousViableDate
Mengembalikan tanggal layak sebelumnya dari ekspresi Timex berdasarkan tanggal saat ini dan zona waktu yang ditentukan secara opsional.
getPreviousViableDate(<timexString>, <timezone>?)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<timexString> | Ya | string | String Timex tanggal untuk dievaluasi. |
<zona waktu> | No | string | Zona waktu opsional. |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<previousViableDate> | string | Tanggal sebelumnya layak. |
Contoh
Katakanlah tanggalnya adalah 2020-06-12 dan waktu saat ini adalah 15:42:21.
Contoh-contoh ini mengevaluasi string Timex untuk tanggal layak sebelumnya berdasarkan tanggal dan waktu di atas:
getPreviousViableDate("XXXX-12-20", "Eastern Standard Time")
getPreviousViableDate("XXXX-02-29")
Dan kembalikan string berikut masing-masing:
- 2019-12-20
- 2020-02-29
getPreviousViableTime
Mengembalikan waktu yang layak sebelumnya dari ekspresi Timex berdasarkan tanggal saat ini dan zona waktu yang ditentukan secara opsional.
getPreviousViableTime(<timexString>, <timezone>?)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<timexString> | Ya | string | String Timex dari waktu untuk dievaluasi. |
<zona waktu> | No | string | Zona waktu opsional. |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<previousViableTime> | string | Waktu yang layak sebelumnya. |
Contoh
Katakanlah tanggalnya adalah 2020-06-12 dan waktu saat ini adalah 15:42:21.
Contoh-contoh ini mengevaluasi string Timex untuk waktu yang layak sebelumnya berdasarkan tanggal dan waktu di atas:
getPreviousViableTime("TXX:52:14")
getPreviousViableTime("TXX:12:14", 'Europe/London')
Dan kembalikan string berikut masing-masing:
- T14:52:14
- T15:12:14
getProperty
Mengembalikan nilai properti tertentu atau properti akar dari objek JSON.
Mengembalikan nilai properti tertentu
getProperty(<JSONObject>, '<propertyName>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<JSONObject> | Ya | object | Objek JSON yang berisi properti dan nilai. |
<propertyName> | No | string | Nama properti opsional untuk mengakses nilai. |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
value | string | Nilai properti yang ditentukan dalam objek JSON. |
Contoh
Katakanlah Anda memiliki objek JSON berikut:
{
"a:b" : "a:b value",
"c":
{
"d": "d key"
}
}
Contoh ini mengambil properti tertentu dari objek JSON di atas:
getProperty({"a:b": "value"}, 'a:b')
getProperty(c, 'd')
Dan kembalikan string berikut masing-masing:
- nilai a:b
- kunci d
Mengembalikan properti akar
getProperty('<propertyName>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<propertyName> | Ya | string | Nama properti opsional untuk mengakses nilai dari cakupan memori akar. |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
value | string | Nilai properti akar dalam objek JSON. |
Contoh
Katakanlah Anda memiliki objek JSON berikut:
{
"a:b" : "a:b value",
"c":
{
"d": "d key"
}
}
Contoh ini mengambil properti akar dari objek JSON di atas:
getProperty("a:b")
Dan mengembalikan nilai string a:b.
getTimeOfDay
Mengembalikan waktu hari untuk tanda waktu tertentu.
getTimeOfDay('<timestamp>')
Waktu yang dikembalikan adalah salah satu string berikut:
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<timestamp> | Ya | string | String yang berisi tanda waktu yang ditentukan |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<waktu dalam sehari> | string | Waktu hari untuk tanda waktu yang ditentukan |
Tercantum di bawah ini adalah string yang terkait dengan waktu hari ini:
Waktu hari | Tanda Waktu |
---|---|
Tengah malam | 12:00 |
Pagi | 12:01AM – 11:59PM |
Siang | 12:00 |
Malam | 18:00 – 22:00 |
malam | 10:01PM – 11:59PM |
Contoh
getTimeOfDay('2018-03-15T08:00:00.000Z')
Mengembalikan hasil pagi.
lebih besar
Memeriksa apakah nilai pertama lebih besar dari nilai kedua. Kembalikan true
jika nilai pertama lebih banyak, atau kembalikan false
jika kurang.
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 jika nilai pertama lebih besar dari nilai kedua. Mengembalikan false jika 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 berikut masing-masing:
true
false
lebihbesarAtauSetara
Memeriksa apakah nilai pertama lebih besar dari atau sama dengan nilai kedua. Mengembalikan true
saat nilai pertama lebih besar atau sama dengan, atau mengembalikan false
jika 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 jika nilai pertama lebih besar dari atau sama dengan nilai kedua. Mengembalikan false jika 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 kembalikan hasil berikut masing-masing:
true
false
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 | any | Nilai yang akan dikembalikan jika ekspresinya benar |
<valueIfFalse> | Ya | any | Nilai yang akan dikembalikan jika ekspresi salah |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<specified-return-value> | any | Nilai yang ditentukan yang mengembalikan berdasarkan apakah ekspresi adalah true atau false |
Contoh
Contoh ini mengevaluasi apakah equals(1,1)
benar:
if(equals(1, 1), 'yes', 'no')
Dan mengembalikan ya karena ekspresi yang ditentukan mengembalikan true
. Jika tidak, contoh mengembalikan tidak.
indexOf
Mengembalikan posisi awal atau nilai indeks substring. Fungsi ini tidak peka huruf besar/kecil, dan indeks dimulai dengan angka 0.
indexOf('<text>', '<searchText>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<text> | Ya | string atau array | String yang memiliki substring untuk dicari |
<searchText> | Ya | string | Substring untuk dicari |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<index-value> | Integer | Posisi awal atau nilai indeks substring yang ditentukan. |
Jika string tidak ditemukan, kembalikan angka -1. |
Contoh 1
Contoh ini menemukan nilai indeks awal dari dunia substring di dunia halo string:
indexOf('hello world', 'world')
Dan mengembalikan hasil 6.
Contoh 2
Contoh ini menemukan nilai indeks awal dari substring def dalam array ['abc', 'def', 'ghi']:
indexOf(createArray('abc', 'def', 'ghi'), 'def')
Dan mengembalikan hasil 1.
indicesAndValues
Ubah array atau objek menjadi array objek dengan indeks (indeks saat ini) dan properti nilai. Untuk array, indeks adalah posisi dalam array. Untuk objek, ini adalah kunci untuk nilai .
indicesAndValues('<collection or object>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<koleksi atau objek> | Ya | array atau objek | Array atau objek asli |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<collection> | array | Array baru. Setiap item memiliki dua properti: indeks dengan posisi dalam array atau kunci untuk objek, dan nilai yang sesuai. |
Contoh 1
Katakanlah Anda memiliki daftar { item: ["nol", "satu", "dua"] }. Fungsi berikut mengambil daftar tersebut:
indicesAndValues(items)
Dan mengembalikan daftar baru:
[
{
index: 0,
value: 'zero'
},
{
index: 1,
value: 'one'
},
{
index: 2,
value: 'two'
}
]
Contoh 2
Katakanlah Anda memiliki daftar { item: ["nol", "satu", "dua"] }. Fungsi berikut mengambil daftar tersebut:
where(indicesAndValues(items), elt, elt.index >= 1)
Dan mengembalikan daftar baru:
[
{
index: 1,
value: 'one'
},
{
index: 2,
value: 'two'
}
]
Contoh 3
Katakanlah Anda memiliki daftar { item: ["nol", "satu", "dua"] }. Fungsi berikut mengambil daftar tersebut:
join(foreach(indicesAndValues(items), item, item.value), ',')
Dan mengembalikan hasil nol, satu,dua. Ekspresi ini memiliki efek yang sama dengan join(items, ',').
Contoh 4
Katakanlah Anda memiliki objek { pengguna: {name: 'jack', age: 20} }. Fungsi berikut mengambil objek tersebut:
indicesAndValues(user)
Dan mengembalikan objek baru:
[
{
index: 'name',
value: 'jack'
},
{
index: 'age',
value: 20
}
]
int
Mengembalikan versi bilangan bulat dari string. Pengecualian akan dilemparkan jika string tidak dapat dikonversi menjadi bilangan bulat.
int('<value>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<value> | Ya | string | String yang akan dikonversi |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<integer-result> | Integer | Versi bilangan bulat dari string yang ditentukan |
Contoh
Contoh ini membuat versi bilangan bulat untuk string 10:
int('10')
Dan mengembalikan hasilnya sebagai bilangan bulat 10.
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 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 berikut:
intersection(createArray(1, 2, 3), createArray(101, 2, 1, 10), createArray(6, 8, 1, 2))
Dan mengembalikan array hanya dengan item [1, 2].
isArray
Mengembalikan true
jika input yang diberikan adalah array.
isArray('<input>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<input> | Ya | any | Input yang akan diuji |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<Hasil Boolean> | Boolean | Mengembalikan true jika input tertentu adalah array, atau mengembalikan false jika bukan array. |
Contoh
Contoh berikut memeriksa apakah input adalah array:
isArray('hello')
isArray(createArray('hello', 'world'))
Dan kembalikan hasil berikut masing-masing:
- Input adalah string, sehingga fungsi mengembalikan
false
. - Input adalah array, sehingga fungsi mengembalikan
true
.
isBoolean
Mengembalikan true
jika input yang diberikan adalah Boolean.
isBoolean('<input>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<input> | Ya | any | Input yang akan diuji |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<Hasil Boolean> | Boolean | Mengembalikan true jika input yang diberikan adalah Boolean, atau mengembalikan false jika bukan Boolean. |
Contoh
Contoh berikut memeriksa apakah input adalah Boolean:
isBoolean('hello')
isBoolean(32 > 16)
Dan kembalikan hasil berikut masing-masing:
- Input adalah string, sehingga fungsi mengembalikan
false
. - Input adalah Boolean, sehingga fungsi mengembalikan
true
.
isDate
Mengembalikan true
jika ekspresi TimexProperty atau Timex tertentu mengacu pada tanggal yang valid. Tanggal yang valid berisi bulan dan dayOfMonth, atau berisi dayOfWeek.
isDate('<input>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<input> | Ya | objek atau string | Input objek TimexProperty atau string ekspresi Timex. |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<boolean-result> | Boolean | Mengembalikan true jika input mengacu pada tanggal yang valid, atau mengembalikan false jika tanggal tidak valid. |
Contoh
Contoh-contoh ini memeriksa apakah input berikut adalah tanggal yang valid:
isDate('2020-12')
isDate('xxxx-12-21')
Dan kembalikan hasil berikut:
false
true
isDateRange
Mengembalikan true
jika ekspresi TimexProperty atau Timex tertentu mengacu pada rentang tanggal yang valid.
isDateRange('<input>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<input> | Ya | objek atau string | Objek TimexProperty input string ekspresi Timex. |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<boolean-result> | Boolean | Mengembalikan true jika input yang diberikan mengacu pada rentang tanggal yang valid, atau mengembalikan false jika bukan rentang tanggal yang valid. |
Contoh
Contoh-contoh ini memeriksa apakah input berikut adalah rentang tanggal yang valid:
isDateRange('PT30M')
isDateRange('2012-02')
Dan kembalikan hasil berikut:
false
true
isDateTime
Mengembalikan true
jika input tertentu adalah string tanda waktu UTC ISO (YYYY-MM-DDTHH:mm:ss.fffZ).
isDateTime('<input>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<input> | Ya | any | Input yang akan diuji |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<Hasil Boolean> | Boolean | Mengembalikan true jika input yang diberikan adalah string tanda waktu format ISO UTC, atau mengembalikan false jika bukan string tanda waktu format ISO UTC. |
Contoh
Contoh berikut memeriksa apakah input adalah string format ISO UTC:
isDateTime('hello world!')
isDateTime('2019-03-01T00:00:00.000Z')
Dan kembalikan hasil berikut masing-masing:
- Input adalah string, sehingga fungsi mengembalikan
false
. - Input adalah string format ISO UTC, sehingga fungsi mengembalikan
true
.
isDefinite
Mengembalikan true
jika ekspresi TimexProperty atau Timex tertentu mengacu pada tanggal yang valid. Tanggal yang valid berisi tahun, bulan, dan dayOfMonth.
isDefinite('<input>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<input> | Ya | objek atau string | Objek TimexProperty input string ekspresi Timex. |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<boolean-result> | Boolean | Mengembalikan true jika input yang diberikan mengacu pada tanggal lengkap yang valid, atau mengembalikan false jika tidak merujuk ke tanggal lengkap yang valid. |
Contoh
Misalkan ada objek TimexProperty validFullDate = timexProperty baru("2020-02-20") dan Now
properti diatur ke true
. Contoh berikut memeriksa apakah objek merujuk tanggal lengkap yang valid:
isDefinite('xxxx-12-21')
isDefinite(validFullDate)
Dan kembalikan hasil berikut masing-masing:
false
true
isDuration
Mengembalikan true
jika ekspresi TimexProperty atau Timex tertentu mengacu pada durasi yang valid.
isDuration('<input>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<input> | Ya | objek atau string | Objek TimexProperty input string ekspresi Timex. |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<boolean-result> | Boolean | Kembalikan true jika input mengacu pada durasi yang valid, atau mengembalikan false jika input tidak merujuk ke durasi yang valid. |
Contoh
Contoh di bawah ini memeriksa apakah input berikut mengacu pada durasi yang valid:
isDuration('PT30M')
isDuration('2012-02')
Dan kembalikan hasil berikut masing-masing:
true
false
isFloat
Mengembalikan true
jika input yang diberikan adalah angka floating-point. Karena perataan antara C#dan JavaScript, angka dengan residu non-nol modulo 1-nya akan diperlakukan sebagai angka floating-point.
isFloat('<input>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<input> | Ya | any | Input yang akan diuji |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<Hasil Boolean> | Boolean | Mengembalikan true jika input yang diberikan adalah angka floating-point, atau mengembalikan false jika input bukan angka floating-point. |
Contoh
Contoh berikut memeriksa apakah input adalah angka floating-point:
isFloat('hello world!')
isFloat(1.0)
isFloat(12.01)
Dan kembalikan hasil berikut masing-masing:
- Input adalah string, sehingga fungsi mengembalikan
false
. - Input memiliki modulo yang sama dengan 0, sehingga fungsi mengembalikan
false
. - Input adalah angka floating-point, sehingga fungsi mengembalikan
true
.
isInteger
Mengembalikan true
jika input yang diberikan adalah angka bilangan bulat. Karena perataan antara C# dan JavaScript, angka dengan residu nol modulo 1 akan diperlakukan sebagai angka bilangan bulat.
isInteger('<input>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<input> | Ya | any | Input yang akan diuji |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<Hasil Boolean> | Boolean | Apakah input adalah bilangan bulat |
Contoh
Contoh berikut memeriksa apakah input adalah bilangan bulat:
isInteger('hello world!')
isInteger(1.0)
isInteger(12)
Dan kembalikan hasil berikut masing-masing:
- Input adalah string, sehingga fungsi mengembalikan
false
. - Input memiliki modulo yang sama dengan 0, sehingga fungsi mengembalikan
true
. - Input adalah bilangan bulat, sehingga fungsi mengembalikan
true
.
isMatch
Mengembalikan true
jika string tertentu cocok dengan pola ekspresi reguler tertentu.
isMatch('<target**string>', '<pattern>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<target**string> | Ya | string | String yang akan dicocokkan |
<pola> | Ya | string | Pola ekspresi reguler |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<Hasil Boolean> | Boolean | Mengembalikan true jika string tertentu cocok dengan pola ekspresi reguler umum, atau mengembalikan false jika tidak cocok dengan pola. |
Contoh
Contoh berikut memeriksa apakah input cocok dengan pola ekspresi reguler yang ditentukan:
isMatch('ab', '^[a-z]{1,2}$')
isMatch('FUTURE', '(?i)fortune|future')
isMatch('12abc34', '([0-9]+)([a-z]+)([0-9]+)')
isMatch('abacaxc', 'ab.*?c')
Dan mengembalikan hasil true
yang sama .
isObject
Mengembalikan true
jika input tertentu adalah objek kompleks atau mengembalikan false
jika itu adalah objek primitif. Objek primitif termasuk string, angka, dan Boolean; jenis kompleks, seperti kelas, berisi properti.
isObject('<input>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<input> | Ya | any | Input yang akan diuji |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<Hasil Boolean> | Boolean | Mengembalikan true jika input tertentu adalah objek kompleks, atau mengembalikan false jika itu adalah objek primitif. |
Contoh
Contoh berikut memeriksa apakah input yang diberikan adalah objek:
isObject('hello world!')
isObject({userName: "Sam"})
Dan kembalikan hasil berikut masing-masing:
- Input adalah string, sehingga fungsi mengembalikan
false
. - Input adalah objek, sehingga fungsi mengembalikan
true
.
isPresent
Mengembalikan true
jika ekspresi TimexProperty atau Timex tertentu mengacu pada saat ini.
isPresent('<input>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<input> | Ya | objek atau string | Objek TimexProperty input string ekspresi Timex |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<boolean-result> | Boolean | Kembalikan true jika input mengacu pada saat ini, atau mengembalikan false jika tidak merujuk ke saat ini. |
Contoh Misalkan kita memiliki objek TimexProperty validNow = timexProperty() baru { Now = true } dan atur Now
properti ke true
. Contoh di bawah ini memeriksa apakah input berikut mengacu pada saat ini:
isPresent('PT30M')
isPresent(validNow)
Dan kembalikan hasil berikut masing-masing:
false
true
isString
Mengembalikan true
jika input yang diberikan adalah string.
isString('<input>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<input> | Ya | any | Input yang akan diuji |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<Hasil Boolean> | Boolean | Mengembalikan true jika input yang diberikan adalah string, atau mengembalikan false jika bukan string. |
Contoh
Contoh berikut memeriksa apakah input yang diberikan adalah string:
isString('hello world!')
isString(3.14)
Dan kembalikan hasil berikut masing-masing:
- Input adalah string, sehingga fungsi mengembalikan
true
. - Input adalah float, sehingga fungsi mengembalikan
false
.
isTime
Mengembalikan true
jika ekspresi TimexProperty atau Timex tertentu mengacu pada waktu yang valid. Waktu yang valid berisi jam, menit, dan detik.
isTime('<input>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<input> | Ya | objek atau string | Objek TimexProperty input string ekspresi Timex |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<boolean-result> | Boolean | Kembalikan true jika input mengacu pada waktu yang valid, atau mengembalikan false jika tidak merujuk ke waktu yang valid.. |
Contoh
Contoh-contoh ini memeriksa apakah input berikut mengacu pada waktu yang valid:
isTime('PT30M')
isTime('2012-02-21T12:30:45')
Dan kembalikan hasil berikut masing-masing:
false
true
isTimeRange
Mengembalikan true
jika ekspresi TimexProperty atau Timex tertentu mengacu pada rentang waktu yang valid Rentang waktu yang valid berisi partOfDay.
isTime('<input>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<input> | Ya | objek atau string | Objek TimexProperty input string ekspresi Timex. |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<boolean-result> | Boolean | Mengembalikan true jika input mengacu pada rentang waktu yang valid, atau mengembalikan false jika tidak merujuk ke rentang waktu yang valid. |
Contoh
Misalkan kita memiliki objek TimexProperty validTimeRange = timexProperty() baru { PartOfDay = "morning" } dan atur Now
properti ke true
. Contoh-contoh ini memeriksa apakah input berikut adalah rentang waktu yang valid:
isTimeRange('PT30M')
isTimeRange(validTimeRange)
Dan kembalikan hasil berikut masing-masing:
false
true
join
Mengembalikan string yang memiliki semua item dari array, dengan setiap karakter 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 a.b.c.
jPath
Periksa string JSON atau JSON untuk simpul atau nilai yang cocok dengan ekspresi jalur, dan kembalikan simpul yang cocok.
jPath(<json>, '<path>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<json> | Ya | any | Objek atau string JSON untuk mencari simpul atau nilai yang cocok dengan nilai ekspresi jalur |
<jalan> | Ya | any | Ekspresi jalur yang digunakan untuk menemukan node atau nilai JSON yang cocok |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
[ <json-node>] | array | Daftar simpul atau nilai JSON yang cocok dengan ekspresi jalur yang ditentukan |
Contoh C#
Katakanlah Anda memiliki JSON berikut:
{
"Stores": [
"Lambton Quay",
"Willis Street"
],
"Manufacturers": [
{
"Name": "Acme Co",
"Products": [
{
"Name": "Anvil",
"Price": 50
}
]
},
{
"Name": "Contoso",
"Products": [
{
"Name": "Elbow Grease",
"Price": 99.95
},
{
"Name": "Headlight Fluid",
"Price": 4
}
]
}
]
}
Ekspresi jalur adalah $.. Produk[?( @. Harga >= 50)]. Nama
jPath(jsonStr, path)
Dan mengembalikan hasil ["Anvil", "Grease Siku"].
Contoh JavaScript
Katakanlah Anda memiliki JSON berikut:
{
"automobiles": [
{
"maker": "Nissan",
"model": "Teana",
"year": 2011
},
{
"maker": "Honda",
"model": "Jazz",
"year": 2010
},
{
"maker": "Honda",
"model": "Civic",
"year": 2007
},
{
"maker": "Toyota",
"model": "Yaris",
"year": 2008
},
{
"maker": "Honda",
"model": "Accord",
"year": 2011
}
],
"motorcycles": [
{
"maker": "Honda",
"model": "ST1300",
"year": 2012
}
]
}
Ekspresi jalur adalah .automobiles{.maker === "Honda" && .year > 2009}.model.
jPath(jsonStr, path)
Dan mengembalikan hasil ['Jazz', 'Accord'].
json
Mengembalikan nilai jenis JavaScript Object Notation (JSON) atau objek 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> | string | Objek JSON yang dihasilkan dibuat dari string atau XML yang ditentukan. |
Contoh 1
Contoh ini mengonversi string ke JSON:
json('{"fullName": "Sophia Owen"}')
Dan mengembalikan hasilnya:
{
"fullName": "Sophia Owen"
}
Contoh 2
Contoh ini mengonversi XML ke JSON:
json(xml('<?xml version="1.0"?> <root> <person id='1'> <name>Sophia Owen</name> <occupation>Engineer</occupation> </person> </root>'))
Dan mengembalikan hasilnya:
{
"?xml": { "@version": "1.0" },
"root": {
"person": [ {
"@id": "1",
"name": "Sophia Owen",
"occupation": "Engineer"
} ]
}
}
jsonStringify
Mengembalikan string JSON dari nilai.
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<value> | Ya | object | Objek yang akan dikonversi ke string JSON |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<Hasil-JSON> | string | String JSON yang dihasilkan. |
Contoh
Contoh-contoh ini menunjukkan objek yang dikonversi ke string JSON:
jsonStringify(null)
jsonStringify({a:'b'})
Dan kembalikan hasil string berikut masing-masing:
- nihil
- {"a":"b"}
terakhir
Mengembalikan item terakhir dari koleksi.
last('<collection>')
last([<collection>])
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<collection> | Ya | string atau array | Koleksi 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 berikut masing-masing:
- d
- 3
lastIndexOf
Mengembalikan posisi awal atau nilai indeks dari 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 atau array | String yang memiliki substring untuk dicari |
<searchText> | Ya | string | Substring untuk dicari |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<ending-index-value> | Integer | Posisi awal atau nilai indeks dari kemunculan terakhir substring yang ditentukan. Jika string tidak ditemukan, kembalikan angka -1. |
Contoh 1
Contoh ini menemukan nilai indeks awal dari kemunculan terakhir dunia substring dalam string hello world:
lastIndexOf('hello world', 'world')
Dan mengembalikan hasil 6.
Contoh 2
Contoh ini menemukan nilai indeks awal dari kemunculan terakhir substring def dalam array ['abc', 'def', 'ghi', 'def'].
lastIndexOf(createArray('abc', 'def', 'ghi', 'def'), 'def')
Dan mengembalikan hasil 3.
length
Mengembalikan panjang string.
length('<str>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<Str> | Ya | string | String yang akan dihitung panjangnya |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<length> | Integer | Panjang string ini |
Contoh
Contoh-contoh ini mendapatkan panjang string:
length('hello')
length('hello world')
Dan mengembalikan hasil berikut masing-masing:
- 5
- 11
kurang
Periksa apakah nilai pertama kurang dari nilai kedua. Kembalikan true
jika nilai pertama kurang, atau kembalikan false
jika nilai pertama lebih banyak.
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 jika nilai pertama kurang dari nilai kedua. Mengembalikan false jika 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 kembalikan hasil berikut masing-masing:
true
false
lessOrEquals
Memeriksa apakah nilai pertama kurang dari atau sama dengan nilai kedua. Mengembalikan true
jika nilai pertama kurang dari atau sama dengan, atau mengembalikan false
jika 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 jika nilai pertama kurang dari atau sama dengan nilai kedua. Mengembalikan false jika nilai pertama lebih besar dari nilai kedua. |
Contoh
Contoh-contoh ini memeriksa apakah nilai pertama kurang dari atau sama dengan nilai kedua.
lessOrEquals(10, 10)
lessOrEquals('apply', 'apple')
Dan kembalikan hasil berikut masing-masing:
true
false
maks
Mengembalikan nilai tertinggi dari daftar atau array. Daftar atau array inklusif di kedua ujungnya.
max(<number1>, <number2>, ...)
max([<number1>, <number2>, ...])
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<number1>, <number2>, ... | Ya | number | Kumpulan angka yang Anda ingin nilai tertingginya |
[<number1>, <number2>, ...] | Ya | array angka | Array angka yang Anda inginkan nilai tertingginya |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<max-value> | number | 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 3.
gabungkan
Menggabungkan beberapa objek JSON atau array objek bersama-sama.
merge(<json1>, <json2>, ...)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<json1>, <json2>, ... | Ya | objek atau array | Kumpulan objek atau array JSON untuk digabungkan bersama-sama. |
Nilai hasil | Tipe | Description |
---|---|---|
<result> | object | Objek JSON gabungan atau objek array gabungan. |
Contoh
Katakanlah Anda memiliki objek JSON berikut:
json1 = @"{
'FirstName': 'John',
'LastName': 'Smith',
'Enabled': false,
'Roles': [ 'User' ]
}"
json2 =@"{
'Enabled': true,
'Roles': [ 'User', 'Admin' ]
}"
Contoh ini menggabungkan objek JSON:
string(merge(json(json1), json(json2)))
Dan mengembalikan objek yang dihasilkan {"FirstName":"John","LastName":"Smith","Enabled":true,"Roles":["User","Admin"]}.
Katakanlah Anda ingin menggabungkan objek dan daftar objek bersama-sama. Contoh berikut menggabungkan objek JSON dan array objek:
merge({k1:'v1'}, [{k2:'v2'}, {k3: 'v3'}], {k4:'v4'})
Dan mengembalikan objek { "k1": "v1", "k2": "v2", "k3": "v3", "k4": "v4" }.
mnt
Mengembalikan nilai terendah dari sekumpulan angka atau larik.
min(<number1>, <number2>, ...)
min([<number1>, <number2>, ...])
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<number1>, <number2>, ... | Ya | number | Kumpulan angka yang anda inginkan nilai terendahnya |
[<number1>, <number2>, ...] | Ya | array angka | Array angka yang anda inginkan nilai terendahnya |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<min-value> | number | Nilai terendah dalam array atau kumpulan angka 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 1.
mod
Mengembalikan sisa dari pembagian dua angka. Untuk mendapatkan hasil bilangan bulat, lihat div().
mod(<dividend>, <divisor>)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<dividend> | Ya | number | Angka yang dibagi menurut pembagi |
<divisor> | Ya | number | Angka yang membagi dividen. Tidak bisa 0. |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<modulo-result> | number | Sisa dari membagi angka pertama dengan angka kedua |
Contoh
Contoh ini membagi angka pertama dengan angka kedua:
mod(3, 2)
Dan mengembalikan hasil 1.
month
Mengembalikan bulan tanda waktu yang ditentukan.
month('<timestamp>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<timestamp> | Ya | string | String yang berisi tanda waktu |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<angka dalam sebulan> | Integer | Jumlah bulan dalam tanda waktu yang ditentukan |
Contoh
month('2018-03-15T13:01:00.000Z')
Dan mengembalikan hasil 3.
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 kembalikan hasil berikut masing-masing:
- 2
- 3
newGuid
Mengembalikan string Guid baru.
newGuid()
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<Guid-string> | string | String Guid baru, panjangnya adalah 36 dan terlihat seperti xxxxxxxx-xxxx-4xxx-yxxx-xxxxx |
Contoh
newGuid()
Dan mengembalikan hasil yang mengikuti format xxxxxxxxx-xxxx-4xxx-yxxx-xxxxxxx.
not
Periksa apakah ekspresi itu false. Kembalikan true
jika ekspresi salah, atau kembalikan false
jika true.
not(<expression>)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<expression> | Ya | Boolean | Ekspresi yang akan diperiksa |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
BENAR atau SALAH | Boolean | Mengembalikan true jika ekspresi salah. Kembalikan false jika ekspresinya benar. |
Contoh 1
Contoh-contoh ini memeriksa apakah ekspresi yang ditentukan false:
not(false)
not(true)
Dan kembalikan hasil berikut masing-masing:
- Ekspresinya false, sehingga fungsi mengembalikan
true
. - Ekspresinya benar, sehingga fungsi mengembalikan
false
.
Contoh 2
Contoh-contoh ini memeriksa apakah ekspresi yang ditentukan false:
not(equals(1, 2))
not(equals(1, 1))
Dan kembalikan hasil berikut masing-masing:
- Ekspresinya false, sehingga fungsi mengembalikan
true
. - Ekspresinya benar, sehingga fungsi mengembalikan
false
.
or
Memeriksa apakah setidaknya satu ekspresi true. Kembalikan true
jika setidaknya satu ekspresi benar, atau kembalikan false
jika semua salah.
or(<expression1>, <expression2>, ...)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<ekspresi1>, <ekspresi2>, ... | Ya | Boolean | Ekspresi yang akan diperiksa |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
BENAR atau SALAH | Boolean | Mengembalikan true jika setidaknya satu ekspresi adalah true. Kembalikan false jika semua ekspresi salah. |
Contoh 1
Contoh berikut memeriksa apakah setidaknya satu ekspresi adalah true:
or(true, false)
or(false, false)
Dan kembalikan hasil berikut masing-masing:
- Setidaknya satu ekspresi benar, sehingga fungsi mengembalikan
true
. - Kedua ekspresi salah, 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 kembalikan hasil berikut masing-masing:
- Setidaknya satu ekspresi benar, sehingga fungsi mengembalikan
true
. - Kedua ekspresi salah, 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 | Integer | Bilangan bulat terendah dalam rentang |
<maxValue> | Ya | Integer | Bilangan bulat yang mengikuti bilangan bulat tertinggi dalam rentang yang dapat dikembalikan fungsi |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<random-result> | Integer | Bilangan bulat acak yang dikembalikan dari rentang yang ditentukan |
Contoh
Contoh ini mendapatkan bilangan bulat acak dari rentang yang ditentukan, tidak termasuk nilai maksimum:
rand(1, 5)
Dan mengembalikan 1, 2, 3, atau 4 sebagai hasilnya.
rentang
Mengembalikan larik bilangan bulat yang dimulai dari bilangan bulat tertentu.
range(<startIndex>, <count>)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<startIndex> | Ya | Integer | Nilai bilangan bulat yang memulai array sebagai item pertama |
<count> | Ya | Integer | Jumlah bilangan bulat dalam array |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<hasil rentang> | Integer | Array dengan bilangan bulat dimulai dari indeks yang ditentukan |
Contoh
Contoh ini membuat array bilangan bulat yang dimulai dari indeks 1 yang ditentukan dan memiliki jumlah bilangan bulat yang ditentukan sebagai 4:
range(1, 4)
Dan mengembalikan hasil [1, 2, 3, 4].
removeProperty
Menghapus properti dari objek dan mengembalikan objek yang diperbarui.
removeProperty(<object>, '<property>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<object> | Ya | object | Objek JSON tempat Anda ingin menghapus properti |
<property> | Ya | string | Nama properti yang akan dihapus |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<updated-object> | object | Objek JSON yang diperbarui tanpa properti yang ditentukan |
Contoh
Contoh ini menghapus accountLocation
properti dari customerProfile
objek, yang dikonversi ke JSON dengan fungsi json(), dan mengembalikan objek yang diperbarui:
removeProperty(json('customerProfile'), 'accountLocation')
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, fungsi mengembalikan string asli. |
Contoh 1
Contoh ini menemukan substring lama dalam string lama dan mengganti yang lama dengan yang baru:
replace('the old string', 'old', 'new')
Hasilnya adalah string string baru.
Contoh 2
Saat berhadapan dengan karakter escape, mesin ekspresi menangani unescape untuk Anda. Fungsi ini menggantikan string dengan karakter escape.
replace('hello\"', '\"', '\n')
replace('hello\n', '\n', '\\\\')
@"replace('hello\\', '\\', '\\\\')"
@"replace('hello\n', '\n', '\\\\')"
Dan mengembalikan hasil berikut masing-masing:
- hello\n
- Halo\\
- @"hello\\"
- @"hello\\"
replaceIgnoreCase
Ganti substring dengan string yang ditentukan, dan kembalikan string hasil. Fungsi ini tidak peka huruf besar/kecil.
replaceIgnoreCase('<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 string asli. |
Contoh
Contoh ini menemukan substring lama dalam string string lama dan mengganti yang lama dengan yang baru:
replace('the old string', 'old', 'new')
Dan mengembalikan hasil string baru.
resolve
Mengembalikan string ekspresi TimexProperty atau Timex tertentu jika mengacu pada waktu yang valid. Waktu yang valid berisi jam, menit, dan detik.
resolve('<timestamp')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<timestamp> | Ya | string | String yang berisi tanda waktu. |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<return> | string | String ekspresi TimexProperty atau Timex yang dievaluasi. |
Contoh
Contoh-contoh ini menunjukkan apakah string yang diberikan mengacu pada waktu yang valid:
resolve(T14)
resolve(2020-12-20)
resolve(2020-12-20T14:20)
Dan mengembalikan hasil berikut masing-masing:
- 14:00:00
- 2020-12-20
- 2020-12-20 14:20:00
reverse
Membalikkan urutan elemen dalam string atau array.
reverse(<value>)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<value> | Ya | string atau array | String ke array untuk dibalik. |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<return> | string atau array | Elemen terbalik dari string atau array. |
Contoh
Contoh-contoh ini membalikkan elemen string atau array:
reverse(hello)
reverse(concat(hello,world))
Dan mengembalikan nilai berikut masing-masing:
- String olleh. - String dlrowolleh.
round
Bulatkan nilai ke bilangan bulat terdekat atau ke jumlah digit pecahan yang ditentukan.
round('<number>', '<precision-digits>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<number> | Ya | number | Nomor input |
<digit presisi> | No | Integer | Jumlah digit pecahan yang ditentukan. Defaultnya adalah 0. |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<return-value> | number | Nilai pengembalian input yang dibulatkan pada jumlah digit pecahan tertentu |
Contoh 1
Contoh ini membulatkan angka 10.333:
round(10.333)
Dan mengembalikan angka 10.
Contoh 2
Contoh ini membulatkan angka 10,3313 hingga 2 digit pecahan:
round(10.3313, 2)
Dan mengembalikan angka 10,33.
select
Beroperasi pada setiap elemen dan mengembalikan koleksi baru elemen yang diubah.
select([<collection/instance>], <iteratorName>, <function>)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<koleksi/instans> | Ya | array | Koleksi dengan item |
<iteratorName> | Ya | nama iterator | Item kunci |
<fungsi> | Ya | expression | Fungsi Th yang dapat berisi iteratorName |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<koleksi baru> | array | Koleksi baru di mana setiap elemen telah dievaluasi dengan fungsi |
Contoh 1
Contoh ini menghasilkan koleksi baru:
select(createArray(0, 1, 2, 3), x, x + 1)
Dan mengembalikan hasil [1, 2, 3, 4].
Contoh 2
Contoh-contoh ini menghasilkan koleksi baru:
select(json("{'name': 'jack', 'age': '15'}"), x, concat(x.key, ':', x.value))
select(json("{'name': 'jack', 'age': '15'}"), x=> concat(x.key, ':', x.value))
Dan kembalikan hasil ['name:jack', 'age:15']. Perhatikan bahwa ekspresi kedua adalah ekspresi lambda, yang menurut beberapa orang lebih mudah dibaca.
sentenceCase
Kapitalkan huruf pertama kata pertama dalam string dalam format lokal opsional.
sentenceCase('<text>', '<locale>'?)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<text> | Ya | string | String asli |
<lokal> | No | string | Lokal opsional informasi budaya |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
string hasil | string | Mengembalikan hasil kasus kalimat |
Contoh 1
Contoh-contoh ini memanfaatkan huruf pertama dalam string:
sentenceCase('a')
sentenceCase('abc def')
sentenceCase('aBC dEF')
Dan kembalikan hasil berikut masing-masing:
- A
- Def Abc
- Def Abc
Contoh 2
Contoh-contoh ini memanfaatkan huruf pertama dalam string dalam format lokal yang ditentukan:
sentenceCase('a', 'fr-FR')
sentenceCase('abc', 'en-US')
sentenceCase('aBC', 'fr-FR')
Dan kembalikan hasil berikut masing-masing:
- A
- Abc
- Abc
setPathToValue
Ambil nilai properti yang ditentukan dari objek JSON.
setPathToValue(<path>, <value>)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<Jalur> | Ya | object | Jalur yang ingin Anda atur |
<value> | Ya | object | Nilai yang ingin Anda atur ke jalur |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
value | object | Nilai diatur |
Contoh 1
Contoh di bawah ini mengatur nilai 1 ke jalur:
setPathToValue(path.x, 1)
Dan mengembalikan hasil 1. path.x
diatur ke 1.
Contoh 2
Contoh di bawah ini menetapkan nilai:
setPathToValue(path.array[0], 7) + path.array[0]
Dan mengembalikan hasil 14.
setProperty
Atur nilai properti objek dan kembalikan objek yang diperbarui. Untuk menambahkan properti baru, gunakan fungsi ini atau fungsi addProperty().
setProperty(<object>, '<property>', <value>)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<object> | Ya | object | Objek JSON tempat Anda ingin mengatur properti |
<property> | Ya | string | Nama properti yang akan diatur |
<value> | Ya | any | Nilai yang akan ditetapkan untuk properti yang ditentukan |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<updated-object> | object | Objek JSON yang diperbarui yang propertinya Anda tetapkan |
Contoh
Contoh ini mengatur accountNumber
properti pada objek, yang dikonversi customerProfile
ke JSON dengan fungsi json(). Fungsi menetapkan nilai yang dihasilkan oleh fungsi newGuid(), dan mengembalikan objek JSON yang diperbarui:
setProperty(json('customerProfile'), 'accountNumber', newGuid())
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 | Integer | Bilangan bulat positif untuk jumlah item yang akan dihapus di bagian depan |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<updatedCollection> | array | Koleksi yang diperbarui setelah menghapus item yang ditentukan |
Contoh
Contoh ini menghapus satu item, angka 1, dari depan array yang ditentukan:
skip(createArray(0, 1, 2, 3), 1)
Dan mengembalikan array dengan item yang tersisa: [1,2,3].
sortBy
Urutkan elemen dalam koleksi dalam urutan naik dan mengembalikan koleksi yang diurutkan.
sortBy([<collection>], '<property>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<collection> | Ya | string atau array | Koleksi yang akan diurutkan |
<property> | No | string | Urutkan menurut properti spesifik elemen objek ini dalam koleksi jika diatur |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<koleksi baru> | array | Koleksi baru yang elemennya telah diurutkan |
Contoh 1
Contoh ini menghasilkan pengurutan koleksi berikut:
sortBy(createArray(1, 2, 0, 3))
Dan mengembalikan hasilnya [0, 1, 2, 3].
Contoh 2
Misalkan Anda memiliki koleksi berikut:
{
'nestedItems': [
{'x': 2},
{'x': 1},
{'x': 3}
]
}
Contoh ini menghasilkan koleksi baru yang diurutkan berdasarkan properti objek x
sortBy(nestedItems, 'x')
Dan mengembalikan hasilnya:
{
'nestedItems': [
{'x': 1},
{'x': 2},
{'x': 3}
]
}
sortByDescending
Urutkan elemen dalam koleksi dalam urutan menurut, dan mengembalikan koleksi yang diurutkan.
sortBy([<collection>], '<property>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<collection> | Ya | string atau array | Koleksi yang akan diurutkan |
<property> | No | string | Urutkan menurut properti spesifik elemen objek ini dalam koleksi jika diatur |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<koleksi baru> | array | Koleksi baru yang elemennya telah diurutkan |
Contoh 1
Contoh ini menghasilkan koleksi baru yang diurutkan:
sortByDescending(createArray(1, 2, 0, 3))
Dan mengembalikan hasil [3, 2, 1, 0].
Contoh 2
Misalkan Anda memiliki koleksi berikut:
{
'nestedItems': [
{'x': 2},
{'x': 1},
{'x': 3}
]
}
Contoh ini menghasilkan koleksi baru yang diurutkan berdasarkan properti objek x :
sortByDescending(nestedItems, 'x')
Dan mengembalikan hasil ini:
{
'nestedItems': [
{'x': 3},
{'x': 2},
{'x': 1}
]
}
belah
Mengembalikan array yang berisi substring, dipisahkan dengan koma, berdasarkan karakter pemisah yang ditentukan dalam string asli.
split('<text>', '<delimiter>'?)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<text> | Ya | string | String untuk dipisahkan menjadi substring berdasarkan pemisah yang ditentukan dalam string asli. Jika teks adalah nilai null, teks akan diambil sebagai string kosong. |
<delimiter> | No | string | Karakter dalam string asli untuk digunakan sebagai pemisah. Jika tidak ada pemisah yang disediakan atau pemisah adalah nilai null, nilai default akan menjadi string kosong. |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
[<substring1>,<substring2>,...] | array | Array yang berisi substring dari string asli, dipisahkan oleh koma |
Contoh
Contoh-contoh ini membuat array dengan substring dari string yang ditentukan berdasarkan karakter pemisah yang ditentukan:
split('a**b**c', '**')
split('hello', '')
split('', 'e')
split('', '')
split('hello')
Dan mengembalikan array berikut sebagai hasilnya masing-masing:
- ["a", "b", "c"]
- ["h", "e", "l", "l", "o"]
- [""], [ ]
- ["h", "e", "l", "l", "o"]
sqrt
Mengembalikan akar kuadrat dari angka yang ditentukan.
sqrt(<number>)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<number> | Ya | number | Angka untuk mendapatkan akar kuadrat dari |
Nilai hasil | Tipe | Description |
---|---|---|
<result> | number | Hasil dari komputasi akar kuadrat. |
Contoh
Contoh-contoh ini menghitung akar kuadrat dari angka yang ditentukan:
sqrt(9)
sqrt(0)
Dan kembalikan hasil berikut masing-masing:
- 3
- 0
startOfDay
Mengembalikan awal hari untuk tanda waktu dalam format lokal opsional.
startOfDay('<timestamp>', '<format>'?, '<locale>'?)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<timestamp> | Ya | string | String yang berisi tanda waktu |
<format> | No | string | Pola format kustom. Format default untuk tanda waktu adalah format ISO UTC, YYYY-MM-DDTHH:mm:ss.fffZ, yang sesuai dengan ISO 8601. |
<lokal> | No | string | Lokal opsional informasi budaya |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
'<updated-timestamp>' | string | Tanda waktu yang ditentukan dimulai pada tanda nol jam untuk hari itu |
Contoh 1
Contoh ini menemukan awal hari:
startOfDay('2018-03-15T13:30:30.000Z')
Dan mengembalikan hasil 2018-03-15T00:00:00.000Z.
Contoh 2
Contoh ini menemukan awal hari dengan lokal fr-FR:
startOfDay('2018-03-15T13:30:30.000Z', '', 'fr-FR')
Dan mengembalikan hasil 15/03/2018 00:00:00.
startOfHour
Mengembalikan awal jam untuk tanda waktu dalam format lokal opsional.
startOfHour('<timestamp>', '<format>'?, '<locale>'?)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<timestamp> | Ya | string | String yang berisi tanda waktu |
<format> | No | string | Pola format kustom. Format default untuk tanda waktu adalah format ISO UTC, YYYY-MM-DDTHH:mm:ss.fffZ, yang sesuai dengan ISO 8601. |
<lokal> | No | string | Lokal opsional informasi budaya |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
'<updated-timestamp>' | string | Tanda waktu yang ditentukan dimulai pada tanda nol menit untuk hari itu |
Contoh 1
Contoh ini menemukan awal jam:
startOfHour('2018-03-15T13:30:30.000Z')
Dan mengembalikan hasil 2018-03-15T13:00:00.000Z.
Contoh 2
Contoh ini menemukan awal jam dengan lokal fr-FR:
startOfHour('2018-03-15T13:30:30.000Z', '', 'fr-FR')
Dan mengembalikan hasil 15/03/2018 13:00:00.
startOfMonth
Mengembalikan awal bulan untuk tanda waktu dalam format lokal opsional.
startOfMonth('<timestamp>', '<format>'?, '<locale>'?)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<timestamp> | Ya | string | String yang berisi tanda waktu |
<format> | No | string | Pola format kustom. Format default untuk tanda waktu adalah format ISO UTC, YYYY-MM-DDTHH:mm:ss.fffZ, yang sesuai dengan ISO 8601. |
<lokal> | No | string | Lokal opsional informasi budaya |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
'<updated-timestamp>' | string | Tanda waktu yang ditentukan dimulai pada hari pertama bulan pada tanda nol jam |
Contoh 1
Contoh ini menemukan awal bulan:
startOfMonth('2018-03-15T13:30:30.000Z')
Dan mengembalikan hasil 2018-03-01T00:00:00.000Z.
Contoh 2
Contoh ini menemukan awal bulan dengan lokal fr-FR:
startOfMonth('2018-03-15T13:30:30.000Z', '', 'fr-FR')
Dan mengembalikan hasil 01/03/2018 00:00:00.
startsWith
Memeriksa apakah string dimulai dengan substring tertentu. Kembalikan true
jika substring ditemukan, atau kembali false
jika 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 | Substring awal yang akan ditemukan |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
BENAR atau SALAH | Boolean | Mengembalikan true jika substring awal ditemukan. Mengembalikan false jika tidak ditemukan |
Contoh 1
Contoh ini memeriksa apakah string hello world dimulai dengan string hello:
startsWith('hello world', 'hello')
Dan mengembalikan hasilnya true
.
Contoh 2
Contoh ini memeriksa apakah string hello world dimulai dengan sapaan string:
startsWith('hello world', 'greeting')
Dan mengembalikan hasilnya false
.
string
Mengembalikan versi string dari nilai dalam format lokal opsional.
string(<value>, '<locale>'?)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<value> | Ya | any | Nilai yang akan dikonversi |
<lokal> | No | string | Lokal opsional informasi budaya |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<string-value> | string | Versi string dari nilai yang ditentukan |
Contoh 1
Contoh ini membuat versi string dari angka 10:
string(10)
Dan mengembalikan hasil string 10.
Contoh 2
Contoh ini membuat string untuk objek JSON yang ditentukan dan menggunakan karakter garis miring terbalik,\\ sebagai karakter escape untuk karakter tanda kutip ganda, ".
string( { "name": "Sophie Owen" } )
Dan mengembalikan hasil { "name": "Sophie Owen" }
Contoh 3
Contoh ini membuat versi string dari angka 10 dalam lokal tertentu:
string(100.1, 'fr-FR')
string(100.1, 'en-US')
Dan mengembalikan string berikut masing-masing:
- 100,1
- 100.1
stringOrValue
Bungkus interpolasi string untuk mendapatkan nilai nyata. Misalnya, stringOrValue('${1}')
mengembalikan angka 1, sementara stringOrValue('${1} item')
mengembalikan string "1 item".
stringOrValue(<string>)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<tali> | Ya | string | String untuk mendapatkan nilai nyata dari. |
Nilai hasil | Tipe | Description |
---|---|---|
<result> | any | Hasil dari mendapatkan nilai nyata dari string yang ditentukan. |
Contoh
Contoh-contoh ini mendapatkan nilai nyata dari string:
stringOrValue('${one}')
stringOrValue('${one} item')
Dan kembalikan hasil berikut masing-masing:
- Angka 1.0.
- Item string 1.
sub
Mengembalikan hasil dari mengurangi angka kedua dari angka pertama.
sub(<minuend>, <subtrahend>)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<minuend> | Ya | number | Angka untuk mengurangi subtrahend |
<subtrahend> | Ya | number | Angka yang akan dikurangi dari minuend |
Nilai hasil | Tipe | Description |
---|---|---|
<result> | number | Hasil dari mengurangi angka kedua dari angka pertama |
Contoh
Contoh ini mengurangi angka kedua dari angka pertama:
sub(10.3, .3)
Dan mengembalikan hasil 10.
subArray
Mengembalikan subarray dari posisi awal dan akhir yang ditentukan. Nilai indeks dimulai dengan angka 0.
subArray(<Array>, <startIndex>, <endIndex>)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<array> | Ya | array | Array untuk membuat subarray dari |
<startIndex> | Ya | Integer | Angka positif sama dengan atau lebih besar dari 0 untuk digunakan sebagai posisi awal atau nilai indeks |
<endIndex> | Ya | Integer | Angka positif sama dengan atau lebih besar dari 0 untuk digunakan sebagai posisi akhir atau nilai indeks |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<hasil subarray> | array | Subarray dengan jumlah item yang ditentukan, dimulai dari posisi indeks yang ditentukan dalam string sumber |
Contoh
Contoh ini membuat subarray dari array yang ditentukan:
subArray(createArray('H','e','l','l','o'), 2, 5)
Dan mengembalikan hasil ["l", "l", "o"].
substring
Mengembalikan karakter dari string, dimulai dari posisi atau indeks yang ditentukan. Nilai indeks dimulai dengan angka 0.
substring('<text>', <startIndex>, <length>)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<text> | Ya | string | String untuk membuat substring dari |
<startIndex> | Ya | Integer | Angka positif sama dengan atau lebih besar dari 0 subarray untuk digunakan sebagai posisi awal atau nilai indeks |
<length> | Ya | Integer | Jumlah positif subarray karakter dalam 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 dunia hasil.
subtractFromTime
Kurangi sejumlah unit waktu dari tanda waktu dalam format lokal opsional. Lihat juga getPastTime().
subtractFromTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?, '<locale>'?)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<timestamp> | Ya | string | String yang berisi tanda waktu |
<interval> | Ya | Integer | Jumlah unit waktu yang ditentukan untuk dikurangi |
<timeUnit> | Ya | string | Unit waktu yang digunakan dengan interval. Unit yang mungkin adalah "Kedua", "Menit", "Jam", "Hari", "Minggu", "Bulan", dan "Tahun". |
<format> | No | string | Pola format kustom. Format default untuk tanda waktu adalah format ISO UTC, YYYY-MM-DDTHH:mm:ss.fffZ, yang sesuai dengan ISO 8601. |
<lokal> | No | string | Lokal opsional informasi budaya |
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 berikut:
subtractFromTime('2018-01-02T00:00.000Z', 1, 'Day')
Dan mengembalikan hasil 2018-01-01T00:00:00.000Z.
Contoh 2
Contoh ini mengurangi satu hari dari tanda waktu menggunakan format D :
subtractFromTime('2018-01-02T00:00.000Z', 1, 'Day', 'D')
Dan mengembalikan hasilnya Senin, Januari, 1, 2018.
Contoh 3
Contoh ini mengurangi 1 jam dari tanda waktu di lokal de-DE :
subtractFromTime('2018-03-15T13:00:00.000Z', 1, 'Hour', '', 'de-DE')
Dan mengembalikan hasil 15.03.18 12:00:00.
sum
Mengembalikan hasil dari menambahkan angka dalam daftar.
sum([<list of numbers>])
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
[<daftar angka>] | Ya | array angka | Angka yang akan ditambahkan |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<result-sum> | number | Hasil dari menambahkan angka yang ditentukan |
Contoh
Contoh ini menambahkan angka yang ditentukan:
sum(createArray(1, 1.5))
Dan mengembalikan hasil 2,5.
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 | Integer | 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 kembalikan hasil berikut masing-masing:
- Abc
- [0, 1, 2]
ticks
Mengembalikan nilai properti ticks dari 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 (bigint dalam JavaScript) | Jumlah tanda centang sejak tanda waktu yang ditentukan |
Contoh
Contoh ini mengonversi tanda waktu ke properti ticks-nya:
ticks('2018-01-01T08:00:00.000Z')
Dan mengembalikan hasil 636503904000000000.
ticksToDays
Mengonversi nilai properti ticks menjadi jumlah hari.
ticksToDays('ticks')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<ticks> | Ya | Integer | Nilai properti ticks untuk dikonversi |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<jumlah hari> | number | Jumlah hari yang dikonversi dari nilai properti ticks |
Contoh
Contoh ini mengonversi nilai properti ticks menjadi sejumlah hari:
ticksToDays(2193385800000000)
Dan mengembalikan angka 2538.64097222.
ticksToHours
Mengonversi nilai properti ticks menjadi jumlah jam.
ticksToHours('ticks')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<ticks> | Ya | Bilangan bulat | Nilai properti ticks untuk dikonversi |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<jumlah jam> | number | Jumlah jam yang dikonversi dari nilai properti ticks |
Contoh
Contoh ini mengonversi nilai properti ticks menjadi sejumlah jam:
ticksToHours(2193385800000000)
Dan mengembalikan angka 60927.38333333331.
ticksToMinutes
Mengonversi nilai properti ticks menjadi jumlah menit.
ticksToMinutes('ticks')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<ticks> | Ya | Integer | Nilai properti ticks untuk dikonversi |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<jumlah menit> | number | Jumlah menit yang dikonversi dari nilai properti ticks |
Contoh
Contoh ini mengonversi nilai properti ticks menjadi sejumlah menit:
ticksToMinutes(2193385800000000)
Dan mengembalikan angka 3655643.0185.
titleCase
Kapitalkan huruf pertama setiap kata dalam string dalam format lokal opsional.
titleCase('<text>', '<locale>'?)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<text> | Ya | string | String asli |
<lokal> | No | string | Lokal opsional informasi budaya |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
string hasil | string | Hasil kasus judul |
Contoh 1
Contoh-contoh ini memanfaatkan huruf pertama dari setiap kata dalam string:
titleCase('a')
titleCase('abc def')
titleCase('aBC dEF')
Dan kembalikan hasil berikut masing-masing:
- A
- Abc Def
- Abc Def
Contoh 2
Contoh-contoh ini memanfaatkan huruf pertama dalam string dalam format en-US :
titleCase('a', 'en-US')
titleCase('aBC dEF', 'en-US')
Dan kembalikan hasil berikut masing-masing:
- A
- Abc Def
toLower
Mengembalikan string dalam huruf kecil dalam format lokal opsional. Jika karakter dalam string tidak memiliki versi huruf kecil, karakter tersebut tetap tidak berubah dalam string yang ditampilkan.
toLower('<text>', '<locale>'?)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<text> | Ya | string | String yang akan ditampilkan dalam format huruf kecil |
<lokal> | No | string | Lokal opsional informasi budaya |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<lowercase-text> | string | String asli dalam format huruf kecil |
Contoh 1
Contoh ini mengonversi string menjadi huruf kecil:
toLower('Hello World')
Dan mengembalikan hasilnya halo dunia.
Contoh 2
Contoh ini mengonversi string menjadi huruf kecil dalam format fr-FR :
toUpper('Hello World', 'fr-FR')
Dan mengembalikan hasilnya halo dunia.
toUpper
Mengembalikan string dalam huruf besar dalam format lokal opsional. Jika karakter dalam string tidak memiliki versi huruf besar, karakter tersebut tetap tidak berubah dalam string yang ditampilkan.
toUpper('<text>', '<locale>'?)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<text> | Ya | string | String yang akan ditampilkan dalam format huruf besar |
<lokal> | No | string | Lokal opsional informasi budaya |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<uppercase-text> | string | String asli dalam format huruf besar |
Contoh 1
Contoh ini mengonversi string menjadi huruf besar:
toUpper('Hello World')
Dan mengembalikan hasilNYA HELLO WORLD.
Contoh 2
Contoh ini mengonversi string menjadi huruf besar dalam format fr-FR :
toUpper('Hello World', 'fr-FR')
Dan mengembalikan hasilNYA 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 kosong di depan dan di belakang dari string " Halo Dunia ":
trim(' Hello World ')
Dan mengembalikan hasil yang dipangkas Halo Dunia.
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. Tidak ada duplikat yang ditambahkan. |
Contoh
Contoh ini mendapatkan semua item dari koleksi berikut:
union(createArray(1, 2, 3), createArray(1, 2, 10, 101))
Dan mengembalikan hasil [1, 2, 3, 10, 101].
unique
Hapus semua duplikat dari array.
unique([<collection>])
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<collection> | Ya | array | Koleksi yang akan dimodifikasi |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<koleksi baru> | array | Koleksi baru dengan elemen duplikat dihapus |
Contoh 1
Contoh ini menghapus elemen duplikat dari array berikut:
unique(createArray(1, 2, 1))
Dan mengembalikan hasil [1, 2].
uriComponent
Mengembalikan versi biner komponen pengidentifikasi sumber daya seragam (URI).
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 string yang dikodekan URI:
uriComponent('https://contoso.com')
Dan mengembalikan hasil http%3A%2F%2Fcontoso.com.
uriComponentToString
Mengembalikan versi string dari string yang dikodekan pengidentifikasi sumber daya seragam (URI), yang secara efektif mendekode string yang dikodekan URI.
uriComponentToString('<value>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<value> | Ya | string | String yang berkodekan URI untuk dikonversi |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<binary-for-encoded-uri> | string | Versi terdekode untuk string berkodekan URI |
Contoh
Contoh ini membuat versi string yang didekodekan dari string yang dikodekan URI:
uriComponentToString('http%3A%2F%2Fcontoso.com')
Dan mengembalikan hasilnya https://contoso.com
.
uriHost
Mengembalikan nilai host pengidentifikasi sumber daya terpadu (URI).
uriHost('<uri>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
< uri> | Ya | string | URI yang nilai hostnya Anda inginkan |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<host-value> | string | Nilai host dari URI yang ditentukan |
Contoh
Contoh ini menemukan nilai host dari URI berikut:
uriHost('https://www.localhost.com:8080')
Dan mengembalikan hasilnya www.localhost.com
.
uriPath
Mengembalikan nilai jalur pengidentifikasi sumber daya terpadu (URI).
uriPath('<uri>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
< uri> | Ya | string | URI yang nilai jalurnya Anda inginkan |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<path-value> | string | Nilai jalur URI yang ditentukan |
Contoh
Contoh ini menemukan nilai jalur dari URI berikut:
uriPath('http://www.contoso.com/catalog/shownew.htm?date=today')
Dan mengembalikan hasil /catalog/shownew.htm.
uriPathAndQuery
Mengembalikan jalur dan nilai kueri pengidentifikasi sumber daya terpadu (URI).
uriPathAndQuery('<uri>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
< uri> | Ya | string | URI yang jalur dan nilai kuerinya Anda inginkan |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<path-query-value> | string | Jalur dan nilai kueri dari URI yang ditentukan |
Contoh
Contoh ini menemukan jalur dan nilai kueri dari URI berikut:
uriPathAndQuery('http://www.contoso.com/catalog/shownew.htm?date=today')
Dan mengembalikan hasil /catalog/shownew.htm?date=today.
uriPort
Mengembalikan nilai port pengidentifikasi sumber daya terpadu (URI).
uriPort('<uri>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
< uri> | Ya | string | URI yang nilai jalurnya Anda inginkan |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<port-value> | string | Nilai port dari URI yang ditentukan |
Contoh
Contoh ini menemukan nilai port dari URI berikut:
uriPort('http://www.localhost:8080')
Dan mengembalikan hasil 8080.
uriQuery
Mengembalikan nilai kueri pengidentifikasi sumber daya terpadu (URI).
uriQuery('<uri>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
< uri> | Ya | string | URI yang nilai kuerinya Anda inginkan |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<query-value> | string | Nilai kueri dari URI yang ditentukan |
Contoh
Contoh ini menemukan nilai kueri dari URI berikut:
uriQuery('http://www.contoso.com/catalog/shownew.htm?date=today')
Dan mengembalikan hasil ?date=today.
uriScheme
Mengembalikan nilai skema pengidentifikasi sumber daya terpadu (URI).
uriScheme('<uri>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
< uri> | Ya | string | URI yang nilai kuerinya Anda inginkan |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<scheme-value> | string | Nilai skema URI yang ditentukan |
Contoh
Contoh ini menemukan nilai skema URI berikut:
uriQuery('http://www.contoso.com/catalog/shownew.htm?date=today')
Dan mengembalikan hasil http.
utcNow
Mengembalikan tanda waktu saat ini dalam format lokal opsional sebagai string.
utcNow('<format>', '<locale>'?)
Secara opsional, Anda dapat menentukan format yang berbeda dengan parameter <format>.
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<format> | No | string | Pola format kustom. Format default untuk tanda waktu adalah format ISO UTC, YYYY-MM-DDTHH:mm:ss.fffZ, yang sesuai dengan ISO 8601. |
<lokal> | No | string | Lokal opsional informasi budaya |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<current-timestamp> | string | Tanggal dan waktu saat ini |
Contoh 1
Misalkan tanggalnya adalah 15 April 2018 pukul 13.00. Contoh ini mendapatkan tanda waktu:
utcNow()
Dan mengembalikan hasil 2018-04-15T13:00:00.000Z.
Contoh 2
Misalkan tanggalnya adalah 15 April 2018 pukul 13.00. Contoh ini mendapatkan tanda waktu saat ini menggunakan format D opsional:
utcNow('D')
Dan mengembalikan hasilnya Minggu, 15 April 2018.
Contoh 3
Misalkan tanggalnya adalah 15 April 2018 pukul 13.00. Contoh ini mendapatkan tanda waktu saat ini menggunakan lokal de-DE :
utcNow('', 'de-DE')
Dan mengembalikan hasil 15.04.18 13:00:00.
lokasi
Filter pada setiap elemen dan kembalikan koleksi baru elemen yang difilter yang cocok dengan kondisi tertentu.
where([<collection/instance>], <iteratorName>, <function>)
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<koleksi/instans> | Ya | array | Koleksi dengan item |
<iteratorName> | Ya | nama iterator | Item kunci |
<fungsi> | Ya | expression | Fungsi kondisi yang digunakan untuk memfilter item |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<koleksi baru/objek baru> | array/objek | Koleksi baru yang telah difilter setiap elemen dengan fungsi |
Contoh 1
Contoh ini menghasilkan koleksi baru:
where(createArray(0, 1, 2, 3), x, x > 1)
Dan mengembalikan hasil [2, 3].
Contoh 2
Contoh-contoh ini menghasilkan koleksi baru:
where(json("{'name': 'jack', 'age': '15'}"), x, x.value == 'jack')
where(json("{'name': 'jack', 'age': '15'}"), x=> x.value == 'jack')
Dan kembalikan hasil ['name:jack', 'age:15']. Perhatikan bahwa ekspresi kedua adalah ekspresi lambda, yang menurut beberapa orang lebih mudah dibaca.
xml
Mengembalikan versi XML dari 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 \ sebagai karakter escape untuk tanda kutip ganda ("). |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<xml-version> | object | XML yang dikodekan untuk string atau objek JSON yang ditentukan |
Contoh 1
Contoh ini membuat versi XML untuk string, yang berisi objek JSON:
xml(json('{ \"name\": \"Sophia Owen\" }'))
Dan mengembalikan XML hasil:
<name>Sophia Owen</name>
Contoh 2
Misalkan Anda memiliki person
objek JSON, terlihat di bawah ini:
{
"person": {
"name": "Sophia Owen",
"city": "Seattle"
}
}
Contoh ini membuat XML dari string yang berisi objek JSON ini:
xml(json('{\"person\": {\"name\": \"Sophia Owen\", \"city\": \"Seattle\"}}'))
Dan mengembalikan XML hasil:
<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 (disebut sebagai XPath) membantu Anda menavigasi struktur dokumen XML sehingga Anda dapat memilih simpul atau nilai komputasi dalam konten XML.
xPath('<xml>', '<xpath>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<xml> | Ya | any | String XML untuk mencari node atau nilai yang cocok dengan nilai ekspresi JalurX |
<xPath> | Ya | any | 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> | any | 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
Contoh ini menemukan simpul yang cocok dengan simpul <name></name>
dalam argumen yang ditentukan, dan mengembalikan array dengan nilai simpul tersebut:
xPath(items, '/produce/item/name')
Argumen menyertakan string item , yang berisi XML ini:
"<?xml version="1.0"?> <produce> <item> <name>Gala</name> <type>apple</type> <count>20</count> </item> <item> <name>Honeycrisp</name> <type>apple</type> <count>10</count> </item> </produce>"
Berikut adalah array yang dihasilkan dengan simpul yang cocok <name></name>
:
[ <name>Gala</name>, <name>Honeycrisp</name> ]
Contoh 2
Contoh berikut 1, contoh ini menemukan simpul yang cocok dengan <count></count>
simpul dan menambahkan nilai simpul tersebut dengan fungsi sum():
xPath(xml(parameters('items')), 'sum(/produce/item/count)')
Dan mengembalikan hasil 30.
tahun
Mengembalikan tahun tanda waktu yang ditentukan.
year('<timestamp>')
Parameter | Wajib | Tipe | Deskripsi |
---|---|---|---|
<timestamp> | Ya | string | String yang berisi tanda waktu |
Nilai hasil | Tipe | Deskripsi |
---|---|---|
<tahun> | Integer | Tahun dalam tanda waktu yang ditentukan |
Contoh
Contoh ini mengevaluasi tanda waktu untuk tahun ini:
year('2018-03-15T00:00:00.000Z')
Dan mengembalikan hasil 2018.