Azure Data Factory ve Azure Synapse Analytics
Uygulama hedefi:
Azure SYNAPSE Analytics 'i Azure Data Factory
Bu makalede, Azure Data Factory ve Azure Synapse Analytics.
İfadeler
Tanımda JSON değerleri değişmez değer veya çalışma zamanında değerlendirilen ifadeler olabilir. Örnek:
"name": "value"
veya
"name": "@pipeline().parameters.password"
İfadeler bir JSON dizesi değerinde herhangi bir yerde görünebilir ve her zaman başka bir JSON değeriyle sonuçlandırabilirsiniz. JSON değeri bir ifade ise, işareti kaldırılarak ifadenin gövdesi ayıklanır ( @ ). ile başlayan bir değişmez dize gerekli @ ise, kullanılarak bu dizenin kaç olması @ @ gerekir. Aşağıdaki örneklerde ifadelerin nasıl değerlendirildiklerine ilişkin bilgiler verilmiştir.
| JSON değeri | Sonuç |
|---|---|
| "parameters" | 'parameters' karakterleri döndürülür. |
| "parameters[1]" | 'parameters[1]' karakterleri döndürülür. |
| "@@" | '' içeren bir 1 @ karakter dizesi döndürülür. |
| " @" | '' içeren 2 @ karakterlik bir dize döndürülür. |
İfadeler, ifadelerin içinde sarmalanmış olduğu dize ilişkilendirmesi adlı bir özellik kullanılarak dizelerin içinde de @{ ... } görünebilir. Örnek: "name" : "First Name: @{pipeline().parameters.firstName} Last Name: @{pipeline().parameters.lastName}"
Dize ilişkilendirmesi kullanılarak sonuç her zaman bir dize olur. ve olarak myNumber 42 tanımlandığıma myString foo göre:
| JSON değeri | Sonuç |
|---|---|
| " @ pipeline().parameters.myString" | Dize foo olarak döndürür. |
| " @ {pipeline().parameters.myString}" | Dize foo olarak döndürür. |
| " @ pipeline().parameters.myNumber" | sayı 42 olarak döndürür. |
| " @ {pipeline().parameters.myNumber}" | dize 42 olarak döndürür. |
| "Yanıt: @{pipeline().parameters.myNumber}" | dizesini Answer is: 42 döndürür. |
| " @ concat('Answer is: ', string(pipeline().parameters.myNumber))" | Dizeyi döndürür Answer is: 42 |
| "Yanıt: @ @ {pipeline().parameters.myNumber}" | dizesini Answer is: @{pipeline().parameters.myNumber} döndürür. |
ForEach etkinliği gibi denetim akışı etkinliklerde, özellik öğeleri için tekrarlama için bir dizi s sağlama ve ForEach etkinliğinde tek bir numaralama üzerinde tekrarlama () işlevini @item kullanabilirsiniz. Örneğin, öğeler bir dizi ise: [1, 2, 3], () ilk yinelemede @item 1, ikinci yinelemede 2 ve üçüncü yinelemede 3 döndürür. 0 ile biten ve 9 ile biten on kez yinelerken ifade gibi @range (0,10) da kullanabilirsiniz.
Etkinliğin @activity çıkışını yakalamak ve kararlar almak için ('etkinlik adı') kullanabilirsiniz. Web1 adlı bir web etkinliğini düşünün. İlk etkinliğin çıkışını ikincinin gövdesine yerleştirmek için ifade genellikle şöyle @activity görünür: ('Web1').output veya ('Web1').output.data veya ilk etkinliğin çıkışının nasıl olduğu bağlı olarak benzer @activity bir şey.
Örnekler
Karmaşık ifade örneği
Aşağıdaki örnekte, etkinlik çıkışının derin bir alt alanına başvurulan karmaşık bir örnek gösterilmiştir. Bir alt alan olarak değerlendirilen bir işlem hattı parametresine başvuru yapmak için etkinlik çıkışının bir parçası olarak dot(.) işleci (alt alan1 ve alt alan2 gibi) yerine [] söz dizimi kullanın.
@activity('*activityName*').output.*subfield1*.*subfield2*[pipeline().parameters.*subfield3*].*subfield4*
Dosyaları dinamik olarak oluşturmak ve adlandırmak yaygın bir desendir. Şimdi birkaç dinamik dosya adlandırma örneğine bakalım.
Dosya adının sonuna Tarih ekleme:
@concat('Test_', formatDateTime(utcnow(), 'yyyy-dd-MM'))DateTime'ı müşteri saat dilimine ekleme:
@concat('Test_', convertFromUtc(utcnow(), 'Pacific Standard Time'))Tetikleyici Süresi Ekleme:
@concat('Test_', pipeline().TriggerTime)Tarihe sahip tek bir dosyaya çıkış Flow eşleme verisi içinde özel bir dosya adı çıktısı:
'Test_' + toString(currentDate()) + '.csv'
Yukarıdaki durumlarda, dosya adı ile başlayarak 4 dinamik Test_.
Dinamik içerik düzenleyicisi
Düzenlemeyi tamamlarken dinamik içerik düzenleyicisi içeriğinizin karakterlerini otomatik olarak kaçış karakteri olarak kullanır. Örneğin, içerik düzenleyicisinde aşağıdaki içerik, iki ifade işlevine sahip bir dize ilişkilendirmesidir.
{
"type": "@{if(equals(1, 2), 'Blob', 'Table' )}",
"name": "@{toUpper('myData')}"
}
Dinamik içerik düzenleyicisi, yukarıdaki içeriği ifadeye "{ \n \"type\": \"@{if(equals(1, 2), 'Blob', 'Table' )}\",\n \"name\": \"@{toUpper('myData')}\"\n}" dönüştürür. Bu ifadenin sonucu aşağıda gösteren bir JSON biçim dizesidir.
{
"type": "Table",
"name": "MYDATA"
}
Parametresi olan bir veri kümesi
Aşağıdaki örnekte, BlobDataset path adlı bir parametre alır. değeri, ifadesi kullanılarak folderPath özelliği için bir değer ayarlamak için kullanılır: dataset().path .
{
"name": "BlobDataset",
"properties": {
"type": "AzureBlob",
"typeProperties": {
"folderPath": "@dataset().path"
},
"linkedServiceName": {
"referenceName": "AzureStorageLinkedService",
"type": "LinkedServiceReference"
},
"parameters": {
"path": {
"type": "String"
}
}
}
}
Parametresi olan işlem hattı
Aşağıdaki örnekte işlem hattı inputPath ve outputPath parametrelerini alır. Parametreli blob veri kümesi yolu, bu parametrelerin değerleri kullanılarak ayarlanır. Burada kullanılan söz dizimi şu şekildedir: pipeline().parameters.parametername .
{
"name": "Adfv2QuickStartPipeline",
"properties": {
"activities": [
{
"name": "CopyFromBlobToBlob",
"type": "Copy",
"inputs": [
{
"referenceName": "BlobDataset",
"parameters": {
"path": "@pipeline().parameters.inputPath"
},
"type": "DatasetReference"
}
],
"outputs": [
{
"referenceName": "BlobDataset",
"parameters": {
"path": "@pipeline().parameters.outputPath"
},
"type": "DatasetReference"
}
],
"typeProperties": {
"source": {
"type": "BlobSource"
},
"sink": {
"type": "BlobSink"
}
}
}
],
"parameters": {
"inputPath": {
"type": "String"
},
"outputPath": {
"type": "String"
}
}
}
}
Özel karakterleri değiştirme
Dinamik içerik düzenleyicisi, düzenlemeyi tamamlarken içeriğinize çift tırnak, ters eğik çizgi gibi karakterleri otomatik olarak kaçış karakteri olarak kullanır. Bu, satır beslemesini veya sekmesini replace() **** işlevinde \t\nkullanarak değiştirmek için soruna neden olur. İfadedeki fazladan \ ifadesini kaldırmak için kod görünümünde dinamik içeriğinizi düzenleyebilir veya ifade dilini kullanarak özel karakterleri değiştirmek için aşağıdaki adımları takip edebilirsiniz:
- Özgün dize değerine göre URL kodlaması
- URL ile kodlanmış dizeyi (örneğin, satır besleme (%0A), satır başı (%0D), yatay sekme(%09) değiştirin.
- URL kodunu çözme
Örneğin, değeri yeni satır karakteri olan companyName değişkeni, ifadesi @uriComponentToString(replace(uriComponent(variables('companyName')), '%0A', '')) yeni satır karakterini kaldırabilir.
Contoso-
Corporation
Tek tırnak karakteri kaçışı
İfade işlevleri, dize değeri parametreleri için tek tırnak kullanır. Dize işlevlerinde bir ' karakterine kaçış karakteri olarak iki tek tırnak kullanın. Örneğin, ifade @concat('Baba', '''s ', 'book store') aşağıdaki sonucu geri dönecektir.
Baba's book store
Öğretici
Bu öğreticide, hem işlem hattı ile etkinlik arasında hem de etkinlikler arasında parametrelerin nasıl geçeceği size yol gösterir. Öğreticide synapse çalışma alanına yönelik adımlar Azure Data Factory ancak biraz farklı bir kullanıcı arabirimine sahip olsa da, öğretici özellikle bir çalışma alanı için adımları gösterir.
İşlevler
İfadelerin içindeki işlevleri çağırabilirsiniz. Aşağıdaki bölümlerde, bir ifadede kullanılmaktadır işlevleri hakkında bilgi sağlar.
Tarih işlevleri
| Tarih veya saat işlevi | Görev |
|---|---|
| Adddays | Bir zaman damgasına birkaç gün ekleyin. |
| Addhours | Zaman damgasına birkaç saat ekleyin. |
| Addminutes | Zaman damgasına birkaç dakika ekleyin. |
| Addseconds | Zaman damgasına birkaç saniye ekleyin. |
| addToTime | Bir zaman damgasına birkaç zaman birimi ekleyin. Ayrıca bkz. getFutureTime. |
| convertFromUtc | Zaman damgasını Evrensel Saat Eşgüdümli (UTC) 'den hedef saat dilimine dönüştür. |
| convertTimeZone | Zaman damgasını kaynak saat diliminden hedef saat dilimine dönüştür. |
| convertToUtc | Bir zaman damgasını kaynak saat diliminden Eşgüdümli Evrensel Saat'e (UTC) dönüştür. |
| dayOfMonth | Bir zaman damgasından ayın günü bileşenini iade eder. |
| Dayofweek | Bir zaman damgasından haftanın günü bileşenini iade eder. |
| Dayofyear | Bir zaman damgasından yılın günü bileşenini iade eder. |
| formatDateTime | Zaman damgasını isteğe bağlı biçimde bir dize olarak döndürür. |
| getFutureTime | Geçerli zaman damgasını ve belirtilen zaman birimlerini iade. Ayrıca bkz. addToTime. |
| getPastTime | Geçerli zaman damgasını belirtilen zaman birimlerini eksi olarak iade. Ayrıca bkz. subtractFromTime. |
| startOfDay | Bir zaman damgası için günün başlangıcını geri döner. |
| startOfHour | Bir zaman damgası için saat başlangıcını geri döner. |
| startOfMonth | Bir zaman damgası için ayın başlangıcını iade. |
| subtractFromTime | Bir zaman damgasından bir dizi zaman birimi çıkarma. Ayrıca bkz. getPastTime. |
| Ticks | Belirtilen ticks bir zaman damgası için özellik değerini dönüş. |
| utcNow | Geçerli zaman damgasını dize olarak döndürür. |
Dize işlevleri
Dizelerle çalışmak için bu dize işlevlerini ve bazı koleksiyon işlevlerini kullanabilirsiniz. Dize işlevleri yalnızca dizeler üzerinde çalışır.
| Dize işlevi | Görev |
|---|---|
| Concat | İki veya daha fazla dizeyi birleştirin ve birleşik dizeyi döndürür. |
| Endswith | Bir dizenin belirtilen alt dizeyle bitip bitip bitmeyeceklerini kontrol edin. |
| guid | Dize olarak genel olarak benzersiz bir tanımlayıcı (GUID) oluşturma. |
| ındexof | Bir alt dize için başlangıç konumunu geri getirin. |
| Lastındexof | Bir alt dizenin son oluşumunun başlangıç konumunu geri getirin. |
| Değiştirmek | Bir alt dizeyi belirtilen dizeyle değiştirin ve güncelleştirilmiş dizeyi döndürür. |
| Split | Özgün dizede belirtilen sınırlayıcı karakterine göre daha büyük bir dizeden virgülle ayrılmış alt dizeler içeren bir dizi döndürür. |
| Startswith | Bir dizenin belirli bir alt dizeyle başlatıp başlamay olmadığını kontrol edin. |
| Dize | Belirtilen konumdan başlayarak bir dizeden karakterler döndürür. |
| Tolower | Bir dizeyi küçük harf biçiminde döndürür. |
| Toupper | Büyük harf biçiminde bir dize döndürür. |
| Döşeme | Bir dizeden öndeki ve sonda boşluk kaldırır ve güncelleştirilmiş dizeyi döndürür. |
Koleksiyon işlevleri
Koleksiyonlar, genellikle diziler, dizeler ve bazen sözlükler ile çalışmak için bu koleksiyon işlevlerini kullanabilirsiniz.
| Koleksiyon işlevi | Görev |
|---|---|
| Içerir | Bir koleksiyonun belirli bir öğeye sahip olup olmadığını kontrol edin. |
| empty | Bir koleksiyonun boş olup olmadığını kontrol edin. |
| Ilk | Bir koleksiyondan ilk öğeyi iade. |
| Kesişim | Belirtilen koleksiyonlar arasında yalnızca ortak öğelere sahip bir koleksiyon dönüş. |
| Katılın | Belirtilen karakterle ayrılmış bir dizideki tüm öğeleri içeren bir dize döndürür. |
| Son | Bir koleksiyondan son öğeyi iade. |
| length | Bir dize veya dizideki öğe sayısını döndürür. |
| Atlamak | Bir koleksiyonun önünden öğeleri kaldırın ve diğer tüm öğeleri geri döner. |
| take | Bir koleksiyonun önünden öğeleri iade. |
| Birliği | Belirtilen koleksiyonlardan tüm öğeleri olan bir koleksiyon dönüş. |
Mantıksal işlevler
Bu işlevler koşulların içinde yararlıdır ve herhangi bir mantık türünü değerlendirmek için kullanılabilir.
| Mantıksal karşılaştırma işlevi | Görev |
|---|---|
| and | Tüm ifadelerin doğru olup olmadığını kontrol edin. |
| Eşit -tir | her iki değerin de eşdeğer olup olmadığını kontrol edin. |
| büyüktür | İlk değerin ikinci değerden büyük olup olmadığını kontrol edin. |
| greaterOrEquals | İlk değerin ikinci değere eşit veya ondan büyük olup olmadığını kontrol edin. |
| kullandıysanız | İfadenin true veya false olduğunu denetleyin. Sonuca göre belirtilen değeri döndürün. |
| büyüktür | İlk değerin ikinci değerden küçük olup olmadığını kontrol edin. |
| lessOrEquals | İlk değerin ikinci değere eşit veya ondan küçük olup olmadığını kontrol edin. |
| başlatılmadı | İfadenin yanlış olup olmadığını denetleyin. |
| veya | En az bir ifadenin doğru olup olmadığını denetleyin. |
Dönüşüm işlevleri
Bu işlevler, dildeki yerel türlerin her biri arasında dönüştürme yapmak için kullanılır:
- string
- tamsayı
- float
- boolean
- dizi
- sözlüğü
| Dönüştürme işlevi | Görev |
|---|---|
| array | Belirtilen tek bir girdiden bir dizi döndürür. Birden çok giriş için bkz. Createarray. |
| base64 | Bir dize için Base64 kodlamalı sürüm döndürün. |
| base64ToBinary | Base64 ile kodlanmış bir dize için ikili sürümü döndürün. |
| base64ToString | Base64 ile kodlanmış bir dize için dize sürümünü döndürün. |
| ý | Bir giriş değeri için ikili sürümü döndürün. |
| bool | Bir giriş değeri için Boole sürümü döndürün. |
| Coalesce | Bir veya daha fazla parametreden null olmayan ilk değeri döndürün. |
| createArray | Birden çok girişe bir dizi döndürün. |
| dataUri | Giriş değeri için veri URI 'sini döndürün. |
| dataUriToBinary | Bir veri URI 'SI için ikili sürümü döndürün. |
| dataUriToString | Bir veri URI 'SI için dize sürümünü döndürün. |
| decodeBase64 | Base64 ile kodlanmış bir dize için dize sürümünü döndürün. |
| decodeDataUri | Bir veri URI 'SI için ikili sürümü döndürün. |
| decodeURIComponent | Kaçış karakterlerinin kodunu çözülmüş sürümlerle değiştiren bir dize döndürür. |
| encodeURIComponent | URL-güvenli olmayan karakterlerin yerine kaçış karakterleri içeren bir dize döndürür. |
| float | Giriş değeri için bir kayan nokta numarası döndürür. |
| int | Bir dize için tamsayı sürümünü döndürün. |
| nesnesinde | Bir dize veya XML için JavaScript Nesne Gösterimi (JSON) türü değerini veya nesnesini döndürün. |
| string | Bir giriş değeri için dize sürümünü döndürün. |
| URIComponent | URL-güvenli olmayan karakterleri kaçış karakterleriyle değiştirerek, bir giriş değeri için URI kodlu sürümü döndürün. |
| Urıonenttobinary | URI kodlamalı dize için ikili sürümü döndürün. |
| Urıonenttostring | URI kodlamalı dize için dize sürümünü döndürün. |
| 'sini | Bir dize için XML sürümünü döndürün. |
| XPath | XML 'yi bir XPath (XML Path Language) ifadesiyle eşleşen düğümler veya değerler için denetleyin ve eşleşen düğümleri veya değerleri döndürün. |
Matematik işlevleri
Bu işlevler, iki tür numara için kullanılabilir: tamsayılar ve float.
| Math işlevi | Görev |
|---|---|
| add | İki sayı eklemenin sonucunu döndürür. |
| div | İki sayının bölünme sonucunu döndürür. |
| Biçimlendir | Sayı veya dizi kümesinden en yüksek değeri döndürün. |
| dk | Sayı veya dizi kümesinden en düşük değeri döndürün. |
| alma | İki sayıdan ayırarak kalanı döndürün. |
| MUL | Ürünü iki sayıdan çarpmadan döndürün. |
| ran | Belirtilen aralıktan rastgele bir tamsayı döndürür. |
| aralığı | Belirtilen tamsayıdan başlayan bir tamsayı dizisi döndürür. |
| alt | İkinci sayının ilk sayıdan çıkarılmadan elde edilen sonucu döndürür. |
İşlev başvurusu
Bu bölüm, tüm kullanılabilir işlevleri alfabetik sırayla listeler.
add
İki sayı eklemenin sonucunu döndürür.
add(<summand_1>, <summand_2>)
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <summand_1>, <summand_2> | Yes | Integer, float veya Mixed | Eklenecek numaralar |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <Sonuç-toplam> | Tamsayı veya kayan | Belirtilen sayıları eklemenin sonucu |
Örnek
Bu örnek, belirtilen sayıları ekler:
add(1, 1.5)
Ve şu sonucu döndürür: 2.5
addDays
Zaman damgasına bir gün sayısı ekleyin.
addDays('<timestamp>', <days>, '<format>'?)
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <ilişkin> | Evet | Dize | Zaman damgasını içeren dize |
| <miş> | Yes | Tamsayı | Eklenecek gün sayısının pozitif veya negatif sayısı |
| <formatını> | Hayır | Dize | Tek bir biçim belirticisi veya bir özel biçim desenininolması. Zaman damgası için varsayılan biçim, ıso 8601 ile uyumlu olan ve saat dilimi bilgilerini koruyan "o" (yyyy-mm-ddTHH: mm: ss: gönderildiğinde fffffffK biçiminde) şeklindedir. |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <güncelleştirilmiş-zaman damgası> | Dize | Zaman damgası artı belirtilen gün sayısı |
Örnek 1
Bu örnek, belirtilen zaman damgasına 10 gün ekler:
addDays('2018-03-15T13:00:00Z', 10)
Ve şu sonucu döndürür: "2018-03-25T00:00:0000000Z"
Örnek 2
Bu örnek, belirtilen zaman damgasından beş gün çıkartır:
addDays('2018-03-15T00:00:00Z', -5)
Ve şu sonucu döndürür: "2018-03-10T00:00:0000000Z"
addHours
Zaman damgasına bir saat sayısı ekleyin.
addHours('<timestamp>', <hours>, '<format>'?)
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <ilişkin> | Evet | Dize | Zaman damgasını içeren dize |
| <saatlerinin> | Yes | Tamsayı | Eklenecek saatlerin pozitif veya negatif sayısı |
| <formatını> | Hayır | Dize | Tek bir biçim belirticisi veya bir özel biçim desenininolması. Zaman damgası için varsayılan biçim, ıso 8601 ile uyumlu olan ve saat dilimi bilgilerini koruyan "o" (yyyy-mm-ddTHH: mm: ss: gönderildiğinde fffffffK biçiminde) şeklindedir. |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <güncelleştirilmiş-zaman damgası> | Dize | Zaman damgası artı belirtilen saat sayısı |
Örnek 1
Bu örnek, belirtilen zaman damgasına 10 saat ekler:
addHours('2018-03-15T00:00:00Z', 10)
Ve şu sonucu döndürür: "2018-03-15T10:00:0000000Z"
Örnek 2
Bu örnek, belirtilen zaman damgasından beş saati çıkarır:
addHours('2018-03-15T15:00:00Z', -5)
Ve şu sonucu döndürür: "2018-03-15T10:00:0000000Z"
addMinutes
Zaman damgasına bir dakika sayısı ekleyin.
addMinutes('<timestamp>', <minutes>, '<format>'?)
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <ilişkin> | Evet | Dize | Zaman damgasını içeren dize |
| <dakika> | Yes | Tamsayı | Eklenecek pozitif veya negatif dakika sayısı |
| <formatını> | Hayır | Dize | Tek bir biçim belirticisi veya bir özel biçim desenininolması. Zaman damgası için varsayılan biçim, ıso 8601 ile uyumlu olan ve saat dilimi bilgilerini koruyan "o" (yyyy-mm-ddTHH: mm: ss: gönderildiğinde fffffffK biçiminde) şeklindedir. |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <güncelleştirilmiş-zaman damgası> | Dize | Zaman damgası artı belirtilen dakika sayısı |
Örnek 1
Bu örnek, belirtilen zaman damgasına 10 dakika ekler:
addMinutes('2018-03-15T00:10:00Z', 10)
Ve şu sonucu döndürür: "2018-03-15T00:20:00.0000000Z"
Örnek 2
Bu örnek, belirtilen zaman damgasından beş dakika çıkarır:
addMinutes('2018-03-15T00:20:00Z', -5)
Ve şu sonucu döndürür: "2018-03-15T00:15:00.0000000Z"
addSeconds
Zaman damgasına bir saniye sayısı ekleyin.
addSeconds('<timestamp>', <seconds>, '<format>'?)
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <ilişkin> | Evet | Dize | Zaman damgasını içeren dize |
| <saniyeden> | Yes | Tamsayı | Eklenecek pozitif veya negatif saniye sayısı |
| <formatını> | Hayır | Dize | Tek bir biçim belirticisi veya bir özel biçim desenininolması. Zaman damgası için varsayılan biçim, ıso 8601 ile uyumlu olan ve saat dilimi bilgilerini koruyan "o" (yyyy-mm-ddTHH: mm: ss: gönderildiğinde fffffffK biçiminde) şeklindedir. |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <güncelleştirilmiş-zaman damgası> | Dize | Zaman damgası artı belirtilen saniye sayısı |
Örnek 1
Bu örnek, belirtilen zaman damgasına 10 saniye ekler:
addSeconds('2018-03-15T00:00:00Z', 10)
Ve şu sonucu döndürür: "2018-03-15T00:00:10.0000000Z"
Örnek 2
Bu örnek, beş saniyeyi belirtilen zaman damgasına çıkartır:
addSeconds('2018-03-15T00:00:30Z', -5)
Ve şu sonucu döndürür: "2018-03-15T00:00:25.0000000Z"
addToTime
Zaman damgasına bir dizi zaman birimi ekleyin. Ayrıca bkz. Getfuturetime ().
addToTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <ilişkin> | Evet | Dize | Zaman damgasını içeren dize |
| <aralığında> | Yes | Tamsayı | Eklenecek belirtilen zaman birimi sayısı |
| <timeUnit> | Evet | Dize | Aralık ile kullanılacak zaman birimi: "saniye", "dakika", "saat", "gün", "hafta", "ay", "yıl" |
| <formatını> | Hayır | Dize | Tek bir biçim belirticisi veya bir özel biçim desenininolması. Zaman damgası için varsayılan biçim, ıso 8601 ile uyumlu olan ve saat dilimi bilgilerini koruyan "o" (yyyy-mm-ddTHH: mm: ss: gönderildiğinde fffffffK biçiminde) şeklindedir. |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <güncelleştirilmiş-zaman damgası> | Dize | Zaman damgası artı belirtilen zaman birimi sayısı |
Örnek 1
Bu örnek, belirtilen zaman damgasına bir gün ekler:
addToTime('2018-01-01T00:00:00Z', 1, 'Day')
Ve şu sonucu döndürür: "2018-01-02T00:00:00.0000000Z"
Örnek 2
Bu örnek, belirtilen zaman damgasına bir gün ekler:
addToTime('2018-01-01T00:00:00Z', 1, 'Day', 'D')
Ve isteğe bağlı "D" biçimini kullanarak sonucu döndürür: "Tuesday, January 2, 2018"
ve
Her iki ifadenin de doğru olup olmadığını denetleyin. Her iki ifade de true olduğunda true, en az bir ifade false olduğunda false döndürün.
and(<expression1>, <expression2>)
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <ifade1>, <İfade2> | Yes | Boole | Denetlenecek ifadeler |
| Döndürülen değer | Tür | Description |
|---|---|---|
| true veya false | Boole | Her iki ifade de true olduğunda true döndürün. En az bir ifade false olduğunda false döndürün. |
Örnek 1
Bu örnekler, belirtilen Boolean değerlerinin her ikisinin de doğru olup olmadığını denetler:
and(true, true)
and(false, true)
and(false, false)
Ve şu sonuçları döndürür:
- İlk örnek: her Iki ifade de true, bu nedenle döndürüyor
true. - İkinci örnek: bir ifade false 'dur, bu nedenle döndürür
false. - Üçüncü örnek: her Iki ifade de false 'dur, bu nedenle döndürür
false.
Örnek 2
Bu örnekler, belirtilen ifadelerin her ikisinin de doğru olup olmadığını kontrol edin:
and(equals(1, 1), equals(2, 2))
and(equals(1, 1), equals(1, 2))
and(equals(1, 2), equals(1, 3))
Ve şu sonuçları döndürür:
- İlk örnek: Her iki ifade de doğrudur, bu nedenle
truedöndürür. - İkinci örnek: Bir ifade false olduğu için
falsedöndürür. - Üçüncü örnek: Her iki ifade de false olduğu için
falsedöndürür.
array
Belirtilen tek bir girişten dizi döndürür. Birden çok giriş için bkz. createArray().
array('<value>')
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Değer> | Evet | Dize | Dizi oluşturmak için dize |
| Döndürülen değer | Tür | Description |
|---|---|---|
| [<değer>] | Dizi | Belirtilen tek girişi içeren bir dizi |
Örnek
Bu örnek, "hello" dizesinde bir dizi oluşturur:
array('hello')
Ve şu sonucu döndürür: ["hello"]
base64
Bir dize için base64 ile kodlanmış sürümü döndürür.
base64('<value>')
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Değer> | Evet | Dize | Giriş dizesi |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <base64-string> | Dize | Giriş dizesi için base64 ile kodlanmış sürüm |
Örnek
Bu örnek, "hello" dizesini base64 ile kodlanmış bir dizeye dönüştürür:
base64('hello')
Ve şu sonucu döndürür: "aGVsbG8="
base64ToBinary
base64 ile kodlanmış dize için ikili sürümü döndürür.
base64ToBinary('<value>')
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Değer> | Evet | Dize | Dönüştürülecek base64 ile kodlanmış dize |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <binary-for-base64-string> | Dize | base64 ile kodlanmış dizenin ikili sürümü |
Örnek
Bu örnek , "aGVsbG8=" base64 ile kodlanmış dizeyi bir ikili dizeye dönüştürür:
base64ToBinary('aGVsbG8=')
Ve şu sonucu döndürür:
"0110000101000111010101100111001101100010010001110011100000111101"
base64ToString
base64 ile kodlanmış dizenin dize sürümünü döndürür ve base64 dizesini etkili bir şekilde kodlar.
decodeBase64() yerine bu işlevi kullanın.
Her iki işlev de aynı şekilde çalışsa da base64ToString() tercih edilir.
base64ToString('<value>')
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Değer> | Evet | Dize | Kod çözme için base64 ile kodlanmış dize |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <decoded-base64-string> | Dize | base64 ile kodlanmış dizenin dize sürümü |
Örnek
Bu örnek, "aGVsbG8=" base64 ile kodlanmış dizeyi yalnızca bir dizeye dönüştürür:
base64ToString('aGVsbG8=')
Ve şu sonucu döndürür: "hello"
ikili
Bir dize için ikili sürümü döndürür.
binary('<value>')
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Değer> | Evet | Dize | Dönüştürülecek dize |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <binary-for-input-value> | Dize | Belirtilen dize için ikili sürüm |
Örnek
Bu örnek, "Hello" dizesini ikili dizeye dönüştürür:
binary('hello')
Ve şu sonucu döndürür:
"0110100001100101011011000110110001101111"
bool
Bir değer için Boolean sürümünü döndürün.
bool(<value>)
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <deeri> | Yes | Herhangi biri | Dönüştürülecek değer |
| Döndürülen değer | Tür | Description |
|---|---|---|
| true veya false | Boole | Belirtilen değer için Boolean sürümü |
Örnek
Bu örnekler, belirtilen değerleri Boole değerlerine dönüştürür:
bool(1)
bool(0)
Ve şu sonuçları döndürür:
- İlk örnek:
true - İkinci örnek:
false
Coalesce
Bir veya daha fazla parametreden null olmayan ilk değeri döndürün. Boş dizeler, boş diziler ve boş nesneler null değil.
coalesce(<object_1>, <object_2>, ...)
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <object_1>, <object_2>,... | Yes | Herhangi biri, türleri karıştırabilirler | Null denetlenecek bir veya daha fazla öğe |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <ilk-null olmayan öğe> | Herhangi biri | Null olmayan ilk öğe veya değer. Tüm parametreler null ise, bu işlev null değerini döndürür. |
Örnek
Bu örnekler, belirtilen değerlerden null olmayan ilk değeri veya tüm değerler null olduğunda null değerini döndürür:
coalesce(null, true, false)
coalesce(null, 'hello', 'world')
coalesce(null, null, null)
Ve şu sonuçları döndürür:
- İlk örnek:
true - İkinci örnek:
"hello" - Üçüncü örnek:
null
concat
İki veya daha fazla dizeyi birleştirin ve Birleşik dizeyi döndürün.
concat('<text1>', '<text2>', ...)
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <metin1>, <Metin2>,... | Evet | Dize | Birleştirilecek en az iki dize |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <text1text2...> | Dize | Birleşik giriş dizelerinden oluşturulan dize |
Örnek
Bu örnek, "Hello" ve "World" dizelerini birleştirir:
concat('Hello', 'World')
Ve şu sonucu döndürür: "HelloWorld"
contains
Bir koleksiyonun belirli bir öğeye sahip olup olmadığını denetleyin. Öğe bulunduğunda true, bulunamazsa false döndürün. Bu işlev, büyük/küçük harfe duyarlıdır.
contains('<collection>', '<value>')
contains([<collection>], '<value>')
Özellikle, bu işlev bu koleksiyon türleri üzerinde çalışır:
- Alt dize bulmak için bir dize
- Bir değer bulmak için bir dizi
- Anahtar bulmak için bir Sözlük
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <koleksiyon> | Yes | Dize, dizi veya sözlük | Denetlenecek koleksiyon |
| <deeri> | Yes | Sırasıyla dize, dizi veya sözlük | Bulunacak öğe |
| Döndürülen değer | Tür | Description |
|---|---|---|
| true veya false | Boole | Öğe bulunduğunda true döndürün. Bulunamadığında false döndürün. |
Örnek 1
Bu örnek, "World" alt dizesi için "Hello World" dizesini denetler ve true değerini döndürür:
contains('hello world', 'world')
Örnek 2
Bu örnek, "Universe" alt dizesi için "Hello World" dizesini denetler ve false döndürür:
contains('hello world', 'universe')
Convertfromulc
Evrensel Saat (UTC) zaman damgasını hedef saat dilimine dönüştürür.
convertFromUtc('<timestamp>', '<destinationTimeZone>', '<format>'?)
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <ilişkin> | Evet | Dize | Zaman damgasını içeren dize |
| <destinationTimeZone> | Evet | Dize | Hedef saat diliminin adı. Saat dilimi adları için bkz. Microsoft saat dilimi Dizin değerleri, ancak saat dilimi adından noktalama işaretlerini kaldırmanız gerekebilir. |
| <formatını> | Hayır | Dize | Tek bir biçim belirticisi veya bir özel biçim desenininolması. Zaman damgası için varsayılan biçim, ıso 8601 ile uyumlu olan ve saat dilimi bilgilerini koruyan "o" (yyyy-mm-ddTHH: mm: ss: gönderildiğinde fffffffK biçiminde) şeklindedir. |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <dönüştürülmüş-zaman damgası> | Dize | Zaman damgası hedef saat dilimine dönüştürüldü |
Örnek 1
Bu örnek, bir zaman damgasını belirtilen saat dilimine dönüştürür:
convertFromUtc('2018-01-01T08:00:00.0000000Z', 'Pacific Standard Time')
Ve şu sonucu döndürür: "2018-01-01T00:00:00Z"
Örnek 2
Bu örnek, bir zaman damgasını belirtilen saat dilimine ve biçime dönüştürür:
convertFromUtc('2018-01-01T08:00:00.0000000Z', 'Pacific Standard Time', 'D')
Ve şu sonucu döndürür: "Monday, January 1, 2018"
convertTimeZone
Kaynak saat dilimindeki bir zaman damgasını hedef saat dilimine dönüştürür.
convertTimeZone('<timestamp>', '<sourceTimeZone>', '<destinationTimeZone>', '<format>'?)
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <ilişkin> | Evet | Dize | Zaman damgasını içeren dize |
| <sourceTimeZone> | Evet | Dize | Kaynak saat diliminin adı. Saat dilimi adları için bkz. Microsoft saat dilimi Dizin değerleri, ancak saat dilimi adından noktalama işaretlerini kaldırmanız gerekebilir. |
| <destinationTimeZone> | Evet | Dize | Hedef saat diliminin adı. Saat dilimi adları için bkz. Microsoft saat dilimi Dizin değerleri, ancak saat dilimi adından noktalama işaretlerini kaldırmanız gerekebilir. |
| <formatını> | Hayır | Dize | Tek bir biçim belirticisi veya bir özel biçim desenininolması. Zaman damgası için varsayılan biçim, ıso 8601 ile uyumlu olan ve saat dilimi bilgilerini koruyan "o" (yyyy-mm-ddTHH: mm: ss: gönderildiğinde fffffffK biçiminde) şeklindedir. |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <dönüştürülmüş-zaman damgası> | Dize | Zaman damgası hedef saat dilimine dönüştürüldü |
Örnek 1
Bu örnek, kaynak saat dilimini hedef saat dilimine dönüştürür:
convertTimeZone('2018-01-01T08:00:00.0000000Z', 'UTC', 'Pacific Standard Time')
Ve şu sonucu döndürür: "2018-01-01T00:00:00.0000000"
Örnek 2
Bu örnek, saat dilimini belirtilen saat dilimine ve biçime dönüştürür:
convertTimeZone('2018-01-01T08:00:00.0000000Z', 'UTC', 'Pacific Standard Time', 'D')
Ve şu sonucu döndürür: "Monday, January 1, 2018"
convertToUtc
Kaynak saat diliminden bir zaman damgasını Eşgüdümlü Evrensel Saat (UTC) olarak dönüştürür.
convertToUtc('<timestamp>', '<sourceTimeZone>', '<format>'?)
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <ilişkin> | Evet | Dize | Zaman damgasını içeren dize |
| <sourceTimeZone> | Evet | Dize | Kaynak saat diliminin adı. Saat dilimi adları için bkz. Microsoft saat dilimi Dizin değerleri, ancak saat dilimi adından noktalama işaretlerini kaldırmanız gerekebilir. |
| <formatını> | Hayır | Dize | Tek bir biçim belirticisi veya bir özel biçim desenininolması. Zaman damgası için varsayılan biçim, ıso 8601 ile uyumlu olan ve saat dilimi bilgilerini koruyan "o" (yyyy-mm-ddTHH: mm: ss: gönderildiğinde fffffffK biçiminde) şeklindedir. |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <dönüştürülmüş-zaman damgası> | Dize | Zaman damgası UTC 'ye dönüştürüldü |
Örnek 1
Bu örnek, bir zaman damgasını UTC 'ye dönüştürür:
convertToUtc('01/01/2018 00:00:00', 'Pacific Standard Time')
Ve şu sonucu döndürür: "2018-01-01T08:00:00.0000000Z"
Örnek 2
Bu örnek, bir zaman damgasını UTC 'ye dönüştürür:
convertToUtc('01/01/2018 00:00:00', 'Pacific Standard Time', 'D')
Ve şu sonucu döndürür: "Monday, January 1, 2018"
createArray
Birden çok girişten dizi döndürür. Tek giriş dizileri için bkz. array().
createArray('<object1>', '<object2>', ...)
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <object1>, <object2>, ... | Yes | Herhangi bir ama karışık değil | Diziyi oluşturmak için en az iki öğe |
| Döndürülen değer | Tür | Description |
|---|---|---|
| [<object1>, <object2>, ...] | Dizi | Tüm giriş öğelerinden oluşturulan dizi |
Örnek
Bu örnek, şu girişlerden bir dizi oluşturur:
createArray('h', 'e', 'l', 'l', 'o')
Ve şu sonucu döndürür: ["h", "e", "l", "l", "o"]
dataUri
Bir dize için veri tekdüdüzi kaynak tanımlayıcısı (URI) döndürür.
dataUri('<value>')
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Değer> | Evet | Dize | Dönüştürülecek dize |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <data-uri> | Dize | Giriş dizesi için veri URI'si |
Örnek
Bu örnek, "hello" dizesi için bir veri URI'sini oluşturur:
dataUri('hello')
Ve şu sonucu döndürür: "data:text/plain;charset=utf-8;base64,aGVsbG8="
dataUriToBinary
Veri tekdüdüdü kaynak tanımlayıcısı (URI) için ikili sürümü iade edin.
decodeDataUri() yerine bu işlevi kullanın.
Her iki işlev de aynı şekilde çalışsa da dataUriBinary() tercih edilir.
dataUriToBinary('<value>')
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Değer> | Evet | Dize | Dönüştürülecek veri URI'si |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <binary-for-data-uri> | Dize | Veri URI'si için ikili sürüm |
Örnek
Bu örnek, bu veri URI'si için bir ikili sürüm oluşturur:
dataUriToBinary('data:text/plain;charset=utf-8;base64,aGVsbG8=')
Ve şu sonucu döndürür:
"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"
dataUriToString
Veri tekdüzi kaynak tanımlayıcısı (URI) için dize sürümünü döndürür.
dataUriToString('<value>')
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Değer> | Evet | Dize | Dönüştürülecek veri URI'si |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <string-for-data-uri> | Dize | Veri URI'sini dize sürümü |
Örnek
Bu örnek, bu veri URI'si için bir dize oluşturur:
dataUriToString('data:text/plain;charset=utf-8;base64,aGVsbG8=')
Ve şu sonucu döndürür: "hello"
dayOfMonth
Bir zaman damgasından ayın günü geri döner.
dayOfMonth('<timestamp>')
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Zaman damgası> | Evet | Dize | Zaman damgasını içeren dize |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <ayın günü> | Tamsayı | Belirtilen zaman damgasından ayın günü |
Örnek
Bu örnek, bu zaman damgasından ayın günü için sayı döndürür:
dayOfMonth('2018-03-15T13:27:36Z')
Ve şu sonucu döndürür: 15
Dayofweek
Bir zaman damgasından haftanın günü geri döner.
dayOfWeek('<timestamp>')
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Zaman damgası> | Evet | Dize | Zaman damgasını içeren dize |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <haftanın günü> | Tamsayı | Pazar'ın 0, Pazartesi'nin 1 olduğu belirtilen zaman damgasından haftanın günü ve bu şekilde devam ediyor |
Örnek
Bu örnek, bu zaman damgasından haftanın günü için sayı döndürür:
dayOfWeek('2018-03-15T13:27:36Z')
Ve şu sonucu döndürür: 3
Dayofyear
Bir zaman damgasından yılın günü geri döner.
dayOfYear('<timestamp>')
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Zaman damgası> | Evet | Dize | Zaman damgasını içeren dize |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <yılın günü> | Tamsayı | Belirtilen zaman damgasından yılın günü |
Örnek
Bu örnek, bu zaman damgasından yılın günü sayısını döndürür:
dayOfYear('2018-03-15T13:27:36Z')
Ve şu sonucu döndürür: 74
decodeBase64
base64 ile kodlanmış dizenin dize sürümünü döndürür ve base64 dizesini etkili bir şekilde kodlar.
yerine base64ToString() kullanmayı decodeBase64() düşünün.
Her iki işlev de aynı şekilde çalışsa da base64ToString() tercih edilir.
decodeBase64('<value>')
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Değer> | Evet | Dize | Kod çözme için base64 ile kodlanmış dize |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <decoded-base64-string> | Dize | base64 ile kodlanmış dizenin dize sürümü |
Örnek
Bu örnek base64 kodlanmış dize için bir dize oluşturur:
decodeBase64('aGVsbG8=')
Ve şu sonucu döndürür: "hello"
decodeDataUri
Veri tekdüdüdü kaynak tanımlayıcısı (URI) için ikili sürümü iade edin.
yerine dataUriToBinary()kullanmayı göz önünde decodeDataUri() bulundurabilirsiniz.
Her iki işlev de aynı şekilde çalışsa da dataUriToBinary() tercih edilir.
decodeDataUri('<value>')
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Değer> | Evet | Dize | Kodu çözülen veri URI'sı dizesi |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <binary-for-data-uri> | Dize | Veri URI dizesi için ikili sürüm |
Örnek
Bu örnek, bu veri URI'si için ikili sürümü döndürür:
decodeDataUri('data:text/plain;charset=utf-8;base64,aGVsbG8=')
Ve şu sonucu döndürür:
"01100100011000010111010001100001001110100111010001100101011110000111010000101111011100000 1101100011000010110100101101110001110110110001101101000011000010111001001110011011001010111 0100001111010111010101110100011001100010110100111000001110110110001001100001011100110110010 10011011000110100001011000110000101000111010101100111001101100010010001110011100000111101"
decodeUriComponent
Kaçış karakterlerini kodu çözülen sürümlerle değiştiren bir dize döndürür.
decodeUriComponent('<value>')
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Değer> | Evet | Dize | Kodu çözülen kaçış karakterleri içeren dize |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <decoded-uri> | Dize | Kodu çözülen kaçış karakterleriyle güncelleştirilmiş dize |
Örnek
Bu örnek, bu dizedeki kaçış karakterlerinin yerini kodu çözülen sürümlerle değiştirir:
decodeUriComponent('http%3A%2F%2Fcontoso.com')
Ve şu sonucu döndürür: "https://contoso.com"
div
İki saya bölünerek tamsayı sonucu döndürür. Kalan sonucu almak için bkz. mod().
div(<dividend>, <divisor>)
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Temettü> | Yes | Tamsayı veya Kayan | Bölene bölünen sayı |
| <Bölen> | Yes | Tamsayı veya Kayan | Kar paylarını bölen ancak 0 olamaz olan sayı |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <quotient-result> | Tamsayı | tamsayı sonucu, ilk slanın ikinci sayıya bölünmesi sonucu |
Örnek
Her iki örnek de ilk s numarayı ikinci sayıya böler:
div(10, 5)
div(11, 5)
Ve şu sonucu geri getir: 2
encodeUriComponent
URL'nin güvenli olmayan karakterlerini kaçış karakterleriyle değiştirerek bir dize için tekdüzi kaynak tanımlayıcısı (URI) ile kodlanmış bir sürüm döndürür.
yerine uriComponent()kullanmayı encodeUriComponent() düşünün.
Her iki işlev de aynı şekilde çalışsa da uriComponent() tercih edilir.
encodeUriComponent('<value>')
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Değer> | Evet | Dize | URI ile kodlanmış biçime dönüştürülecek dize |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <encoded-uri> | Dize | Kaçış karakterleriyle URI ile kodlanmış dize |
Örnek
Bu örnek, bu dize için URI ile kodlanmış bir sürüm oluşturur:
encodeUriComponent('https://contoso.com')
Ve şu sonucu döndürür: "http%3A%2F%2Fcontoso.com"
empty
Bir koleksiyonun boş olup olmadığını kontrol edin. Koleksiyon boş olduğunda true, boş değilken false döndürür.
empty('<collection>')
empty([<collection>])
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Koleksiyon> | Yes | Dize, Dizi veya Nesne | Kontrol etmek için koleksiyon |
| Döndürülen değer | Tür | Description |
|---|---|---|
| true veya false | Boole | Koleksiyon boş olduğunda true olarak döner. Boş değilken false döndürür. |
Örnek
Bu örnekler, belirtilen koleksiyonların boş olup olmadığını kontrol edin:
empty('')
empty('abc')
Ve şu sonuçları döndürür:
- İlk örnek: Boş bir dizeyi geçtiğinden işlev
truedöndürür. - İkinci örnek: "abc" dizesini geçtiği için işlevi
falsedöndürür.
endsWith
Bir dizenin belirli bir alt dizeyle bitip bitip bitmeyeceklerini kontrol edin. Alt dize bulunduysa true, bulunamadıysa false döndürür. Bu işlev büyük/büyük/büyük harfe duyarlı değildir.
endsWith('<text>', '<searchText>')
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Metin> | Evet | Dize | Kontrol etmek için dize |
| <searchText> | Evet | Dize | Bulmak için bitiş alt dize |
| Döndürülen değer | Tür | Description |
|---|---|---|
| true veya false | Boole | Bitiş alt dizesi bulunduysa true olarak geri döner. Bulunamadıklarda false döndürür. |
Örnek 1
Bu örnek, "hello world" dizesinin "world" dizesiyle bitip bit olmadığını denetler:
endsWith('hello world', 'world')
Ve şu sonucu döndürür: true
Örnek 2
Bu örnek, "hello world" dizesinin "universe" dizesiyle bitip bitip bit olmadığını denetler:
endsWith('hello world', 'universe')
Ve şu sonucu döndürür: false
equals
Değerlerin, ifadelerin veya nesnelerin eşdeğer olup olmadığını kontrol edin. Her ikisi de eşdeğer olduğunda true, eşdeğer değilken false döndürür.
equals('<object1>', '<object2>')
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <object1>, <object2> | Yes | Çeşitli | Karşılaştıracağız değerler, ifadeler veya nesneler |
| Döndürülen değer | Tür | Description |
|---|---|---|
| true veya false | Boole | Her ikisi de eşdeğer olduğunda true değerine döner. Eşdeğer değilken false döndürür. |
Örnek
Bu örnekler, belirtilen girişlerin eşdeğer olup olmadığını kontrol eder.
equals(true, 1)
equals('abc', 'abcd')
Ve şu sonuçları döndürür:
- İlk örnek: Her iki değer de eşdeğerdir, bu nedenle işlevi
truedöndürür. - İkinci örnek: Her iki değer de eşdeğer değildir, bu nedenle işlevi
falsedöndürür.
Ilk
Bir dizeden veya diziden ilk öğeyi döndürür.
first('<collection>')
first([<collection>])
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Koleksiyon> | Yes | Dize veya Dizi | İlk öğenin bulun yer olduğu koleksiyon |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <first-collection-item> | Herhangi biri | Koleksiyonda ilk öğe |
Örnek
Bu örnekler, bu koleksiyonlarda ilk öğeyi bulur:
first('hello')
first(createArray(0, 1, 2))
Ve şu sonuçları geri getir:
- İlk örnek:
"h" - İkinci örnek:
0
float
Kayan nokta numarası için bir dize sürümünü gerçek bir kayan nokta numarasına dönüştür.
float('<value>')
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Değer> | Evet | Dize | Dönüştürülecek geçerli bir kayan nokta numarasına sahip dize |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <float-value> | Float | Belirtilen dize için kayan nokta numarası |
Örnek
Bu örnek, bu kayan nokta numarası için bir dize sürümü oluşturur:
float('10.333')
Ve şu sonucu döndürür: 10.333
formatDateTime
Belirtilen biçimde bir zaman damgası dönüş.
formatDateTime('<timestamp>', '<format>'?)
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Zaman damgası> | Evet | Dize | Zaman damgasını içeren dize |
| <Biçim> | Hayır | Dize | Tek biçimli bir belirleyici veya özel biçim deseni. Zaman damgasının varsayılan biçimi iso 8601 ile uyumlu olan ve saat dilimi bilgilerini koruyan "o" (yyyy-MM-ddTHH:mm:ss:fffffffK) biçimidir. |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <reformatted-timestamp> | Dize | Güncelleştirilmiş zaman damgası belirtilen biçimde |
Örnek
Bu örnek bir zaman damgasını belirtilen biçime dönüştürür:
formatDateTime('03/15/2018 12:00:00', 'yyyy-MM-ddTHH:mm:ss')
Ve şu sonucu döndürür: "2018-03-15T12:00:00"
getFutureTime
Geçerli zaman damgasını ve belirtilen zaman birimlerini iade.
getFutureTime(<interval>, <timeUnit>, <format>?)
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Aralığı> | Yes | Tamsayı | Eklemek istediğiniz zaman birimi sayısı |
| <timeUnit> | Evet | Dize | Aralıkla birlikte kullanım zamanı birimi:"Second", "Minute", "Hour", "Day", "Week", "Month", "Year" |
| <Biçim> | Hayır | Dize | Tek biçimli bir belirleyici veya özel biçim deseni. Zaman damgasının varsayılan biçimi iso 8601 ile uyumlu olan ve saat dilimi bilgilerini koruyan "o" (yyyy-MM-ddTHH:mm:ss:fffffffK) biçimidir. |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <güncelleştirilmiş zaman damgası> | Dize | Geçerli zaman damgası ve belirtilen zaman birimi sayısı |
Örnek 1
Geçerli zaman damgasının "2018-03-01T00:00:00.0000000Z" olduğunu varsayalım. Bu örnek, bu zaman damgasına beş gün ekler:
getFutureTime(5, 'Day')
Ve şu sonucu döndürür: "2018-03-06T00:00:00.0000000Z"
Örnek 2
Geçerli zaman damgasının "2018-03-01T00:00:00.0000000Z" olduğunu varsayalım. Bu örnek beş gün ekler ve sonucu "D" biçimine dönüştürür:
getFutureTime(5, 'Day', 'D')
Ve şu sonucu döndürür: "Tuesday, March 6, 2018"
getPastTime
Geçerli zaman damgasını belirtilen zaman birimlerini eksi olarak iade.
getPastTime(<interval>, <timeUnit>, <format>?)
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Aralığı> | Yes | Tamsayı | Çıkaracak belirtilen zaman birimi sayısı |
| <timeUnit> | Evet | Dize | Aralıkla birlikte kullanım zamanı birimi:"Second", "Minute", "Hour", "Day", "Week", "Month", "Year" |
| <Biçim> | Hayır | Dize | Tek biçimli bir belirleyici veya özel biçim deseni. Zaman damgasının varsayılan biçimi iso 8601 ile uyumlu olan ve saat dilimi bilgilerini koruyan "o" (yyyy-MM-ddTHH:mm:ss:fffffffK) biçimidir. |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <güncelleştirilmiş zaman damgası> | Dize | Geçerli zaman damgası eksi belirtilen zaman birimi sayısı |
Örnek 1
Geçerli zaman damgasının "2018-02-01T00:00:00.0000000Z" olduğunu varsayalım. Bu örnek, bu zaman damgasından beş gün çıkarır:
getPastTime(5, 'Day')
Ve şu sonucu döndürür: "2018-01-27T00:00:00.0000000Z"
Örnek 2
Geçerli zaman damgasının "2018-02-01T00:00:00.0000000Z" olduğunu varsayalım. Bu örnek beş günü çıkarır ve sonucu "D" biçimine dönüştürür:
getPastTime(5, 'Day', 'D')
Ve şu sonucu döndürür: "Saturday, January 27, 2018"
büyüktür
İlk değerin ikinci değerden büyük olup olmadığını kontrol edin. İlk değer daha fazla olduğunda true, daha az olduğunda false döndürür.
greater(<value>, <compareTo>)
greater('<value>', '<compareTo>')
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Değer> | Yes | Tamsayı, Kayan Sayı veya Dize | İkinci değerden büyük olup olmadığını kontrol etmek için ilk değer |
| <compareTo> | Yes | Sırasıyla Tamsayı, Kayan Sayı veya Dize | Karşılaştırma değeri |
| Döndürülen değer | Tür | Description |
|---|---|---|
| true veya false | Boole | İlk değer ikinci değerden büyük olduğunda true değerini verir. İlk değer ikinci değere eşit veya ikinci değerden küçük olduğunda false döndürür. |
Örnek
Bu örnekler, ilk değerin ikinci değerden büyük olup olmadığını kontrol edin:
greater(10, 5)
greater('apple', 'banana')
Ve şu sonuçları geri getir:
- İlk örnek:
true - İkinci örnek:
false
greaterOrEquals
İlk değerin ikinci değerden büyük veya ikinci değere eşit olup olmadığını kontrol edin. İlk değer daha büyük veya eşit olduğunda true, ilk değer daha küçük olduğunda false döndürür.
greaterOrEquals(<value>, <compareTo>)
greaterOrEquals('<value>', '<compareTo>')
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Değer> | Yes | Tamsayı, Kayan Sayı veya Dize | İkinci değerden büyük veya ikinci değere eşit olup olmadığını denetlemeye yönelik ilk değer |
| <compareTo> | Yes | Sırasıyla Tamsayı, Kayan Sayı veya Dize | Karşılaştırma değeri |
| Döndürülen değer | Tür | Description |
|---|---|---|
| true veya false | Boole | İlk değer ikinci değerden büyük veya ikinci değere eşit olduğunda true değerini verir. İlk değer ikinci değerden küçük olduğunda false döndürür. |
Örnek
Bu örnekler, ilk değerin ikinci değerden büyük veya buna eşit olup olmadığını kontrol edin:
greaterOrEquals(5, 5)
greaterOrEquals('apple', 'banana')
Ve şu sonuçları geri getir:
- İlk örnek:
true - İkinci örnek:
false
guid
Dize olarak genel olarak benzersiz bir tanımlayıcı (GUID) oluşturma, örneğin, "c2ecc88d-88c8-4096-912c-d6f2e2b138ce":
guid()
Ayrıca GUID için varsayılan biçim olan "D" dışında, kısa çizgilerle ayrılmış 32 basamaktan farklı bir biçim belirtebilirsiniz.
guid('<format>')
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Biçim> | Hayır | Dize | Döndürülen GUID için tek biçimli bir belirleyici. Varsayılan olarak biçim "D" şeklindedir ancak "N", "D", "B", "P" veya "X" kullanabilirsiniz. |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <GUID değeri> | Dize | Rastgele oluşturulan GUID |
Örnek
Bu örnek, tirelerle ayrılmış ve parantez içine alınmış 32 basamakla aynı GUID'i üretir:
guid('P')
Ve şu sonucu döndürür: "(c2ecc88d-88c8-4096-912c-d6f2e2b138ce)"
if
Bir ifadenin true veya false olup olmadığını kontrol edin. Sonucu temel alarak, belirtilen bir değer geri döner.
if(<expression>, <valueIfTrue>, <valueIfFalse>)
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Ifa -de> | Yes | Boole | Kontrol etmek için ifade |
| <valueIfTrue> | Yes | Herhangi biri | İfade true olduğunda dönüş değeri |
| <valueIfFalse> | Yes | Herhangi biri | İfade false olduğunda dönüş değeri |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <specified-return-value> | Herhangi biri | İfadenin true veya false olup olmadığını temel alarak döndüren belirtilen değer |
Örnek
Belirtilen ifade "yes" true döndür olduğundan bu örnek döndürür.
Aksi takdirde, örnek "no" döndürür:
if(equals(1, 1), 'yes', 'no')
ındexof
Bir alt dize için başlangıç konumunu veya dizin değerini geri getirin. Bu işlev büyük/büyük/büyük harfe duyarlı değildir ve dizinler 0 sayısıyla başlar.
indexOf('<text>', '<searchText>')
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Metin> | Evet | Dize | Bulun gereken alt dizeye sahip dize |
| <searchText> | Evet | Dize | Buluna alt dize |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <index-value> | Tamsayı | Belirtilen alt dize için başlangıç konumu veya dizin değeri. Dize bulunamasa -1 sayısını döndürür. |
Örnek
Bu örnek, "hello world" dizesinde "world" alt dizesinin başlangıç dizin değerini bulur:
indexOf('hello world', 'world')
Ve şu sonucu döndürür: 6
int
Bir dizenin tamsayı sürümünü döndürür.
int('<value>')
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Değer> | Evet | Dize | Dönüştürülecek dize |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <integer-result> | Tamsayı | Belirtilen dizenin tamsayı sürümü |
Örnek
Bu örnek, "10" dizesi için bir tamsayı sürümü oluşturur:
int('10')
Ve şu sonucu döndürür: 10
json
Bir dize JavaScript Nesne Gösterimi XML için JavaScript Nesne Gösterimi (JSON) türü değerini veya nesnesini döndürür.
json('<value>')
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Değer> | Yes | Dize veya XML | Dönüştürülecek dize veya XML |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <JSON sonucu> | JSON yerel türü veya nesnesi | Belirtilen dize veya XML için JSON yerel türü değeri veya nesnesi. Dize null ise işlev boş bir nesne döndürür. |
Örnek 1
Bu örnek, bu dizeyi JSON değerine dönüştürür:
json('[1, 2, 3]')
Ve şu sonucu döndürür: [1, 2, 3]
Örnek 2
Bu örnek, bu dizeyi JSON'a dönüştürür:
json('{"fullName": "Sophia Owen"}')
Ve şu sonucu döndürür:
{
"fullName": "Sophia Owen"
}
Örnek 3
Bu örnek bu XML'i JSON'a dönüştürür:
json(xml('<?xml version="1.0"?> <root> <person id='1'> <name>Sophia Owen</name> <occupation>Engineer</occupation> </person> </root>'))
Ve şu sonucu döndürür:
{
"?xml": { "@version": "1.0" },
"root": {
"person": [ {
"@id": "1",
"name": "Sophia Owen",
"occupation": "Engineer"
} ]
}
}
Kesişim
Belirtilen koleksiyonlar arasında yalnızca ortak öğelere sahip bir koleksiyon dönüş. Sonuçta görünmesi için bir öğenin bu işleve geçirilen tüm koleksiyonlarda görünmesi gerekir. Bir veya daha fazla öğe aynı adı sahipse, sonuçta bu adla son öğe görünür.
intersection([<collection1>], [<collection2>], ...)
intersection('<collection1>', '<collection2>', ...)
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <collection1>, <collection2>, ... | Yes | Dizi veya Nesne, ancak ikisini birden değil | Yalnızca ortak öğeleri istediğiniz koleksiyonlar |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <ortak öğeler> | Sırasıyla Dizi veya Nesne | Belirtilen koleksiyonlar arasında yalnızca ortak öğelere sahip bir koleksiyon |
Örnek
Bu örnek, bu diziler genelinde ortak öğeleri bulur:
intersection(createArray(1, 2, 3), createArray(101, 2, 1, 10), createArray(6, 8, 1, 2))
Ve yalnızca şu öğelere sahip bir dizi döndürür: [1, 2]
join
Bir dizideki tüm öğeleri içeren ve bir sınırlayıcı ile ayrılmış her karaktere sahip bir dize döndürür.
join([<collection>], '<delimiter>')
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Koleksiyon> | Yes | Dizi | Katılmaları gereken öğeleri içeren dizi |
| <Sınırlayıcı> | Evet | Dize | Elde edilen dizedeki her karakter arasında görünen ayırıcı |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <char1 >< sınırlayıcı >< char2 >< sınırlayıcı>... | Dize | Belirtilen dizideki tüm öğelerden oluşturulan sonuç dizesi |
Örnek
Bu örnek, bu dizideki tüm öğelerden sınırlayıcı olarak belirtilen karakterle bir dize oluşturur:
join(createArray('a', 'b', 'c'), '.')
Ve şu sonucu döndürür: "a.b.c"
Son
Bir koleksiyondan son öğeyi iade.
last('<collection>')
last([<collection>])
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Koleksiyon> | Yes | Dize veya Dizi | Son öğenin bulun yer olduğu koleksiyon |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <last-collection-item> | Sırasıyla Dize veya Dizi | Koleksiyonda son öğe |
Örnek
Bu örnekler, bu koleksiyonlarda son öğeyi bulur:
last('abcd')
last(createArray(0, 1, 2, 3))
Ve şu sonuçları döndürür:
- İlk örnek:
"d" - İkinci örnek:
3
Lastındexof
Bir alt dizenin son oluşum için başlangıç konumunu veya dizin değerini geri getirin. Bu işlev büyük/büyük/büyük harfe duyarlı değildir ve dizinler 0 sayısıyla başlar.
lastIndexOf('<text>', '<searchText>')
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Metin> | Evet | Dize | Bulun gereken alt dizeye sahip dize |
| <searchText> | Evet | Dize | Buluna alt dize |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <ending-index-value> | Tamsayı | Belirtilen alt dizenin son oluşumunun başlangıç konumu veya dizin değeri. Dize bulunamasa -1 sayısını döndürür. |
Örnek
Bu örnek, "hello world" dizesinde "world" alt dizesinin son oluşumunun başlangıç dizin değerini bulur:
lastIndexOf('hello world', 'world')
Ve şu sonucu döndürür: 6
length
Bir koleksiyondaki öğe sayısını iade.
length('<collection>')
length([<collection>])
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Koleksiyon> | Yes | Dize veya Dizi | Saymak istediğiniz öğeleri olan koleksiyon |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <uzunluk veya sayı> | Tamsayı | Koleksiyondaki öğe sayısı |
Örnek
Bu örnekler, bu koleksiyonlarda yer alan öğe sayısını sayar:
length('abcd')
length(createArray(0, 1, 2, 3))
Ve şu sonucu geri getir: 4
daha az
İlk değerin ikinci değerden küçük olup olmadığını kontrol edin. İlk değer daha küçük olduğunda true, ilk değer daha fazla olduğunda false döndürür.
less(<value>, <compareTo>)
less('<value>', '<compareTo>')
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Değer> | Yes | Tamsayı, Kayan Sayı veya Dize | İkinci değerden küçük olup olmadığını kontrol etmek için ilk değer |
| <compareTo> | Yes | Sırasıyla Tamsayı, Kayan Sayı veya Dize | Karşılaştırma öğesi |
| Döndürülen değer | Tür | Description |
|---|---|---|
| true veya false | Boole | İlk değer ikinci değerden küçük olduğunda true değerini verir. İlk değer ikinci değere eşit veya ikinci değerden büyük olduğunda false döndürür. |
Örnek
Bu örnekler, ilk değerin ikinci değerden küçük olup olmadığını kontrol edin.
less(5, 10)
less('banana', 'apple')
Ve şu sonuçları geri getir:
- İlk örnek:
true - İkinci örnek:
false
lessOrEquals
İlk değerin ikinci değerden küçük veya ikinci değere eşit olup olmadığını kontrol edin. İlk değer küçük veya eşit olduğunda true, ilk değer daha fazla olduğunda false döndürür.
lessOrEquals(<value>, <compareTo>)
lessOrEquals('<value>', '<compareTo>')
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Değer> | Yes | Tamsayı, Kayan Sayı veya Dize | İkinci değerden küçük veya ikinci değere eşit olup olmadığını denetlemeye yönelik ilk değer |
| <compareTo> | Yes | Sırasıyla Tamsayı, Kayan Sayı veya Dize | Karşılaştırma öğesi |
| Döndürülen değer | Tür | Description |
|---|---|---|
| true veya false | Boole | İlk değer ikinci değerden küçük veya ikinci değere eşit olduğunda true değerini verir. İlk değer ikinci değerden büyük olduğunda false döndürür. |
Örnek
Bu örnekler, ilk değerin ikinci değerden küçük veya eşit olup olmadığını kontrol edin.
lessOrEquals(10, 10)
lessOrEquals('apply', 'apple')
Ve şu sonuçları geri getir:
- İlk örnek:
true - İkinci örnek:
false
max
Bir liste veya diziden her iki uçta da dahil olan sayılarla en yüksek değeri döndürür.
max(<number1>, <number2>, ...)
max([<number1>, <number2>, ...])
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <number1>, <number2>, ... | Yes | Tamsayı, Kayan sayı veya her ikisi | En yüksek değeri istediğiniz sayı kümesi |
| [<number1>, <number2>, ...] | Yes | Dizi - Tamsayı, Kayan sayı veya her ikisi | En yüksek değeri istediğiniz sayı dizisi |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <max-value> | Tamsayı veya Kayan | Belirtilen dizide veya sayı kümesinde en yüksek değer |
Örnek
Bu örnekler sayı kümesinden ve diziden en yüksek değeri verir:
max(1, 2, 3)
max(createArray(1, 2, 3))
Ve şu sonucu geri getir: 3
dk
Bir sayı kümesinden veya diziden en düşük değeri döndürür.
min(<number1>, <number2>, ...)
min([<number1>, <number2>, ...])
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <number1>, <number2>, ... | Yes | Tamsayı, Kayan sayı veya her ikisi | En düşük değeri istediğiniz sayı kümesi |
| [<number1>, <number2>, ...] | Yes | Dizi - Tamsayı, Kayan sayı veya her ikisi | En düşük değeri istediğiniz sayı dizisi |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <min-value> | Tamsayı veya Kayan | Belirtilen sayı veya belirtilen dizi kümesinde en düşük değer |
Örnek
Bu örnekler sayı kümesinde ve dizide en düşük değeri verir:
min(1, 2, 3)
min(createArray(1, 2, 3))
Ve şu sonucu geri getir: 1
mod
İki sayının bölünmesi ile kalan bölümü geri döner. Tamsayı sonucu almak için bkz. div().
mod(<dividend>, <divisor>)
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Temettü> | Yes | Tamsayı veya Kayan | Bölene bölünen sayı |
| <Bölen> | Yes | Tamsayı veya Kayan | kar paylarını bölen ancak 0 olamaz. |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <modulo-result> | Tamsayı veya Kayan | İlk s numarayı ikinci sayıya bölmenin kalan bölümü |
Örnek
Bu örnek ilk s numarayı ikinci sayıya böler:
mod(3, 2)
Ve şu sonucu geri getir: 1
Mul
Ürünü iki sayın çarpımlarından geri dönüş.
mul(<multiplicand1>, <multiplicand2>)
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <multiplicand1> | Yes | Tamsayı veya Kayan | Multiplicand2 ile çarpılan sayı |
| <multiplicand2> | Yes | Tamsayı veya Kayan | Multiplicand1'in katları olan sayı |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <product-result> | Tamsayı veya Kayan | Ürün, birinci slanın ikinci sayıyla çarpımlarından |
Örnek
Bu örnekler ikinci sayıya göre birinci s numarayı birden çok kez kullanabilir:
mul(1, 2)
mul(1.5, 2)
Ve şu sonuçları geri getir:
- İlk örnek:
2 - İkinci örnek
3
not
Bir ifadenin false olup olmadığını kontrol edin. İfade false olduğunda true, true olduğunda false döndürür.
not(<expression>)
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Ifa -de> | Yes | Boole | Kontrol etmek için ifade |
| Döndürülen değer | Tür | Description |
|---|---|---|
| true veya false | Boole | İfade false olduğunda true döndürür. İfade true olduğunda false döndürür. |
Örnek 1
Bu örnekler, belirtilen ifadelerin false olup olmadığını kontrol edin:
not(false)
not(true)
Ve şu sonuçları geri getir:
- İlk örnek: İfade false olduğu için işlevi
truedöndürür. - İkinci örnek: İfade true olduğu için işlevi
falsedöndürür.
Örnek 2
Bu örnekler, belirtilen ifadelerin false olup olmadığını kontrol edin:
not(equals(1, 2))
not(equals(1, 1))
Ve şu sonuçları geri getir:
- İlk örnek: İfade false olduğu için işlevi
truedöndürür. - İkinci örnek: İfade true olduğu için işlevi
falsedöndürür.
veya
En az bir ifadenin true olup olmadığını kontrol edin. En az bir ifade true olduğunda true, her ikisi de false olduğunda false döndürür.
or(<expression1>, <expression2>)
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <expression1>, <ifadesi2> | Yes | Boole | Kontrol etmek için ifadeler |
| Döndürülen değer | Tür | Description |
|---|---|---|
| true veya false | Boole | En az bir ifade true olduğunda true dönüş. Her iki ifade de false olduğunda false döndürür. |
Örnek 1
Bu örnekler en az bir ifadenin doğru olup olmadığını kontrol edin:
or(true, false)
or(false, false)
Ve şu sonuçları geri getir:
- İlk örnek: En az bir ifade true olduğu için işlevi
truedöndürür. - İkinci örnek: her iki ifade de false şeklindedir, bu nedenle işlevi
falsedöndürür.
Örnek 2
Bu örnekler en az bir ifadenin doğru olup olmadığını kontrol edin:
or(equals(1, 1), equals(1, 2))
or(equals(1, 2), equals(1, 3))
Ve şu sonuçları geri getir:
- İlk örnek: En az bir ifade true olduğu için işlevi
truedöndürür. - İkinci örnek: her iki ifade de false şeklindedir, bu nedenle işlevi
falsedöndürür.
rand
Belirtilen aralıktan rastgele bir tamsayı döndürür ve bu yalnızca başlangıç ucunda kapsayıcıdır.
rand(<minValue>, <maxValue>)
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Minvalue> | Yes | Tamsayı | Aralıkta en düşük tamsayı |
| <Maxvalue> | Yes | Tamsayı | İşlevin döntt olduğu aralıkta en yüksek tamsayıyı izleyen tamsayı |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <rastgele sonuç> | Tamsayı | Belirtilen aralıktan döndürülen rastgele tamsayı |
Örnek
Bu örnek, maksimum değeri hariç tutarak belirtilen aralıktan rastgele bir tamsayı alır:
rand(1, 5)
Sonuç olarak şu sayılardan birini döndürür: 1 , 2 , 3 veya 4
aralık
Belirtilen tamsayıdan başlayan bir tamsayı dizisi döndürür.
range(<startIndex>, <count>)
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Startındex> | Yes | Tamsayı | Diziyi ilk öğe olarak başlatan bir tamsayı değeri |
| <Sayısı> | Yes | Tamsayı | Dizide tamsayı sayısı |
| Döndürülen değer | Tür | Description |
|---|---|---|
| [<-sonuç>] | Dizi | Belirtilen dizinden başlayarak tamsayılar içeren dizi |
Örnek
Bu örnek, belirtilen dizinden başlayan ve belirtilen sayıda tamsayıya sahip bir tamsayı dizisi oluşturur:
range(1, 4)
Ve şu sonucu döndürür: [1, 2, 3, 4]
Değiştirmek
Bir alt dizeyi belirtilen dizeyle değiştirin ve sonuç dizesini döndürür. Bu işlev büyük/büyük/büyük harfe duyarlıdır.
replace('<text>', '<oldText>', '<newText>')
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Metin> | Evet | Dize | Değiştirilen alt dizeye sahip dize |
| <oldText> | Evet | Dize | Değiştirilen alt dize |
| <newText> | Evet | Dize | Değiştirme dizesi |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <güncelleştirilmiş-metin> | Dize | Alt dize değiştirildikten sonra güncelleştirilmiş dize Alt dize bulunamazsa, özgün dizeyi döndürün. |
Örnek
Bu örnek "eski" dizesinde "eski" alt dizesini bulur ve "Old" öğesini "New" ile değiştirir:
replace('the old string', 'old', 'new')
Ve şu sonucu döndürür: "the new string"
Atla
Öğeleri bir koleksiyonun önünden kaldırın ve diğer tüm öğeleri döndürün.
skip([<collection>], <count>)
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <koleksiyon> | Yes | Dizi | Öğelerini kaldırmak istediğiniz koleksiyon |
| <biriktirme> | Yes | Tamsayı | En önünde kaldırılacak öğe sayısı için pozitif bir tamsayı |
| Döndürülen değer | Tür | Description |
|---|---|---|
| [<güncelleştirilmiş-koleksiyon>] | Dizi | Belirtilen öğeler kaldırıldıktan sonra güncelleştirilmiş koleksiyon |
Örnek
Bu örnek, belirtilen dizinin önüne 0 olan bir öğeyi, 0 sayısını kaldırır:
skip(createArray(0, 1, 2, 3), 1)
Ve bu diziyi kalan öğelerle birlikte döndürür: [1,2,3]
split
Özgün dizedeki belirtilen sınırlayıcı karaktere göre virgülle ayırarak alt dizeler içeren bir dizi döndürür.
split('<text>', '<delimiter>')
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <metinleri> | Evet | Dize | Özgün dizedeki belirtilen sınırlayıcıya göre alt dizelerdeki ayrı olacak dize |
| <ayırıcı> | Evet | Dize | Ayırıcı olarak kullanılacak özgün dizedeki karakter |
| Döndürülen değer | Tür | Description |
|---|---|---|
| [<substring1>, <substring2>,...] | Dizi | Virgülle ayırarak orijinal dizeden alt dizeler içeren bir dizi |
Örnek
Bu örnek, belirtilen karakteri sınırlayıcı olarak belirtilen dizeden alt dizeler içeren bir dizi oluşturur:
split('a_b_c', '_')
Ve sonuç olarak bu diziyi döndürür: ["a","b","c"]
startOfDay
Zaman damgası için günün başlangıcını döndürür.
startOfDay('<timestamp>', '<format>'?)
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <ilişkin> | Evet | Dize | Zaman damgasını içeren dize |
| <formatını> | Hayır | Dize | Tek bir biçim belirticisi veya bir özel biçim desenininolması. Zaman damgası için varsayılan biçim, ıso 8601 ile uyumlu olan ve saat dilimi bilgilerini koruyan "o" (yyyy-mm-ddTHH: mm: ss: gönderildiğinde fffffffK biçiminde) şeklindedir. |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <güncelleştirilmiş-zaman damgası> | Dize | Belirtilen zaman damgası, ancak günün sıfır saat işaretiyle başlıyor |
Örnek
Bu örnek, bu zaman damgası için günün başlangıcını bulur:
startOfDay('2018-03-15T13:30:30Z')
Ve şu sonucu döndürür: "2018-03-15T00:00:00.0000000Z"
Saat başı
Zaman damgası için saatin başlangıcını döndürür.
startOfHour('<timestamp>', '<format>'?)
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <ilişkin> | Evet | Dize | Zaman damgasını içeren dize |
| <formatını> | Hayır | Dize | Tek bir biçim belirticisi veya bir özel biçim desenininolması. Zaman damgası için varsayılan biçim, ıso 8601 ile uyumlu olan ve saat dilimi bilgilerini koruyan "o" (yyyy-mm-ddTHH: mm: ss: gönderildiğinde fffffffK biçiminde) şeklindedir. |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <güncelleştirilmiş-zaman damgası> | Dize | Belirtilen zaman damgası, ancak saat için sıfır dakikalık işaretten başlayarak |
Örnek
Bu örnek, bu zaman damgası için saat başlangıcını bulur:
startOfHour('2018-03-15T13:30:30Z')
Ve şu sonucu döndürür: "2018-03-15T13:00:00.0000000Z"
startOfMonth
Bir zaman damgası için ayın başlangıcını iade.
startOfMonth('<timestamp>', '<format>'?)
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Zaman damgası> | Evet | Dize | Zaman damgasını içeren dize |
| <Biçim> | Hayır | Dize | Tek biçimli bir belirleyici veya özel biçim deseni. Zaman damgasının varsayılan biçimi iso 8601 ile uyumlu olan ve saat dilimi bilgilerini koruyan "o" (yyyy-MM-ddTHH:mm:ss:fffffffK) biçimidir. |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <güncelleştirilmiş zaman damgası> | Dize | Belirtilen zaman damgası ancak sıfır saat işaretiyle ayın ilk gününden başlayarak |
Örnek
Bu örnek, bu zaman damgası için ayın başlangıcını döndürür:
startOfMonth('2018-03-15T13:30:30Z')
Ve şu sonucu döndürür: "2018-03-01T00:00:00.0000000Z"
startsWith
Bir dizenin belirli bir alt dizeyle başlatıp başlamay olmadığını kontrol edin. Alt dize bulunduysa true, bulunamadıysa false döndürür. Bu işlev büyük/büyük/büyük harfe duyarlı değildir.
startsWith('<text>', '<searchText>')
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Metin> | Evet | Dize | Kontrol etmek için dize |
| <searchText> | Evet | Dize | Bulmak için başlangıç dizesi |
| Döndürülen değer | Tür | Description |
|---|---|---|
| true veya false | Boole | Başlangıç alt dizesi bulunduysa true'ya geri döner. Bulunamadıklarda false döndürür. |
Örnek 1
Bu örnek, "hello world" dizesinin "hello" alt dizesiyle başlatıp başlamay olmadığını denetler:
startsWith('hello world', 'hello')
Ve şu sonucu döndürür: true
Örnek 2
Bu örnek, "hello world" dizesinin "greetings" alt dizesiyle başlatıp başlamay olmadığını denetler:
startsWith('hello world', 'greetings')
Ve şu sonucu döndürür: false
string
Bir değer için dize sürümünü döndürür.
string(<value>)
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Değer> | Yes | Herhangi biri | Dönüştürülecek değer |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <string-value> | Dize | Belirtilen değer için dize sürümü |
Örnek 1
Bu örnek, bu numara için dize sürümünü oluşturur:
string(10)
Ve şu sonucu döndürür: "10"
Örnek 2
Bu örnek, belirtilen JSON nesnesi için bir dize oluşturur ve çift tırnak işareti (") için kaçış karakteri olarak ters eğik çizgi karakterini \ () kullanır.
string( { "name": "Sophie Owen" } )
Ve şu sonucu döndürür: "{ \\"name\\": \\"Sophie Owen\\" }"
Alt
birinci sayıdan ikinci slanın çıkararak elde edilen sonucu geri döner.
sub(<minuend>, <subtrahend>)
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <minuend> | Yes | Tamsayı veya Kayan | Alt değerin çıkarılama sayısı |
| <Subtrahend> | Yes | Tamsayı veya Kayan | Minuend'den çıkarıla sayı |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <Sonuç> | Tamsayı veya Kayan | İlk sayıdan ikinci s sayı çıkararak elde edilen sonuç |
Örnek
Bu örnek, ikinci s numarayı ilk sayıdan çıkarır:
sub(10.3, .3)
Ve şu sonucu döndürür: 10
Dize
Belirtilen konumdan veya dizinden başlayarak bir dizeden karakterler döndürür. Dizin değerleri 0 sayısıyla başlar.
substring('<text>', <startIndex>, <length>)
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Metin> | Evet | Dize | Karakterlerini istediğiniz dize |
| <Startındex> | Yes | Tamsayı | Başlangıç konumu veya dizin değeri olarak kullanmak istediğiniz 0'a eşit veya 0'dan büyük pozitif bir sayı |
| <Uzun -luğu> | Yes | Tamsayı | Alt dizede istediğiniz pozitif karakter sayısı |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <substring-result> | Dize | Kaynak dizede belirtilen dizin konumundan başlayarak belirtilen sayıda karakter içeren bir alt dize |
Örnek
Bu örnek, belirtilen dizeden 6 dizin değerinden başlayarak beş karakterli bir alt dize oluşturur:
substring('hello world', 6, 5)
Ve şu sonucu döndürür: "world"
subtractFromTime
Bir zaman damgasından bir dizi zaman birimi çıkarma. Ayrıca bkz. getPastTime.
subtractFromTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Zaman damgası> | Evet | Dize | Zaman damgasını içeren dize |
| <Aralığı> | Yes | Tamsayı | Çıkaracak belirtilen zaman birimi sayısı |
| <timeUnit> | Evet | Dize | Aralıkla birlikte kullanım zamanı birimi:"Second", "Minute", "Hour", "Day", "Week", "Month", "Year" |
| <Biçim> | Hayır | Dize | Tek biçimli bir belirleyici veya özel biçim deseni. Zaman damgasının varsayılan biçimi iso 8601 ile uyumlu olan ve saat dilimi bilgilerini koruyan "o" (yyyy-MM-ddTHH:mm:ss:fffffffK) biçimidir. |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <güncelleştirilmiş zaman damgası> | Dize | Zaman damgası eksi belirtilen zaman birimi sayısı |
Örnek 1
Bu örnek, bu zaman damgasından bir gün çıkarır:
subtractFromTime('2018-01-02T00:00:00Z', 1, 'Day')
Ve şu sonucu döndürür: "2018-01-01T00:00:00:0000000Z"
Örnek 2
Bu örnek, bu zaman damgasından bir gün çıkarır:
subtractFromTime('2018-01-02T00:00:00Z', 1, 'Day', 'D')
Ve isteğe bağlı "D" biçimini kullanarak bu sonucu döndürür: "Monday, January, 1, 2018"
take
Bir koleksiyonun önünden öğeleri iade.
take('<collection>', <count>)
take([<collection>], <count>)
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Koleksiyon> | Yes | Dize veya Dizi | Öğelerini istediğiniz koleksiyon |
| <Sayısı> | Yes | Tamsayı | Önden istediğiniz öğe sayısı için pozitif bir tamsayı |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <alt> veya [<alt kümesi>] | Sırasıyla Dize veya Dizi | Özgün koleksiyonun önünden alınan belirtilen öğe sayısına sahip bir dize veya dizi |
Örnek
Bu örnekler, bu koleksiyonların önünden belirtilen öğe sayısını almaktadır:
take('abcde', 3)
take(createArray(0, 1, 2, 3, 4), 3)
Ve şu sonuçları geri getir:
- İlk örnek:
"abc" - İkinci örnek:
[0, 1, 2]
Ticks
Belirtilen ticks bir zaman damgası için özellik değerini dönüş.
Değer işareti 100 nanosaniyelik bir aralık.
ticks('<timestamp>')
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Zaman damgası> | Evet | Dize | Bir zaman damgasının dizesi |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <ticks-number> | Tamsayı | Belirtilen zaman damgasından bu yana geçen tık sayısı |
Tolower
Bir dizeyi küçük harf biçiminde döndürür. Dizedeki bir karakterin küçük harfli sürümü yoksa, bu karakter döndürülen dizede değişmeden kalır.
toLower('<text>')
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Metin> | Evet | Dize | Küçük harf biçiminde dönüş yapmak için dize |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <küçük harfli metin> | Dize | Özgün dize küçük harf biçiminde |
Örnek
Bu örnek, bu dizeyi küçük harfe dönüştürür:
toLower('Hello World')
Ve şu sonucu döndürür: "hello world"
Toupper
Büyük harf biçiminde bir dize döndürür. Dizedeki bir karakterin büyük harfli sürümü yoksa, bu karakter döndürülen dizede değişmeden kalır.
toUpper('<text>')
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Metin> | Evet | Dize | Büyük harf biçiminde dönüş yapmak için dize |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <büyük harfli metin> | Dize | Özgün dize büyük harf biçiminde |
Örnek
Bu örnek, bu dizeyi büyük harfe dönüştürür:
toUpper('Hello World')
Ve şu sonucu döndürür: "HELLO WORLD"
Döşeme
Bir dizeden öndeki ve sonda boşluk kaldırır ve güncelleştirilmiş dizeyi döndürür.
trim('<text>')
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Metin> | Evet | Dize | Kaldır için baştaki ve sonda boşluk olan dize |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <updatedText> | Dize | Baştaki veya sonda boşluk olmadan özgün dize için güncelleştirilmiş bir sürüm |
Örnek
Bu örnek , " dizesinde baştaki ve sonda yer alan boşluğu Merhaba Dünya kaldırır:
trim(' Hello World ')
Ve şu sonucu döndürür: "Hello World"
birleşim
Belirtilen koleksiyonlardan tüm öğeleri olan bir koleksiyon dönüş. Sonuçta görünmesi için, bir öğe bu işleve geçirilen herhangi bir koleksiyonda görünebilir. Bir veya daha fazla öğe aynı adı sahipse, sonuçta bu adla son öğe görünür.
union('<collection1>', '<collection2>', ...)
union([<collection1>], [<collection2>], ...)
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <collection1>, <collection2>, ... | Yes | Dizi veya Nesne, ancak ikisini birden değil | Tüm öğeleri istediğiniz koleksiyonlar |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <updatedCollection> | Sırasıyla Dizi veya Nesne | Belirtilen koleksiyonlardan tüm öğeleri olan bir koleksiyon - yineleme yok |
Örnek
Bu örnek, bu koleksiyonlardan tüm öğeleri alır:
union(createArray(1, 2, 3), createArray(1, 2, 10, 101))
Ve şu sonucu döndürür: [1, 2, 3, 10, 101]
uriComponent
URL'nin güvenli olmayan karakterlerini kaçış karakterleriyle değiştirerek bir dize için tekdüzi kaynak tanımlayıcısı (URI) ile kodlanmış bir sürüm döndürür.
encodeUriComponent() yerine bu işlevi kullanın.
Her iki işlev de aynı şekilde çalışsa da uriComponent() tercih edilir.
uriComponent('<value>')
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <Değer> | Evet | Dize | URI ile kodlanmış biçime dönüştürülecek dize |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <kodlanmış URI> | Dize | Kaçış karakterleri içeren URI kodlamalı dize |
Örnek
Bu örnek, bu dize için URI kodlu bir sürüm oluşturur:
uriComponent('https://contoso.com')
Ve şu sonucu döndürür: "http%3A%2F%2Fcontoso.com"
Urıonenttobinary
Tekdüzen Kaynak tanımlayıcısı (URI) bileşeni için ikili sürüm döndürün.
uriComponentToBinary('<value>')
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <deeri> | Evet | Dize | Dönüştürülecek URI kodlamalı dize |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <ikili-for-Encoded-URI> | Dize | URI kodlamalı dize için ikili sürüm. İkili içerik Base64 kodlandı ve tarafından temsil edilir $content . |
Örnek
Bu örnek, URI kodlamalı bu dize için ikili sürüm oluşturur:
uriComponentToBinary('http%3A%2F%2Fcontoso.com')
Ve şu sonucu döndürür:
"001000100110100001110100011101000111000000100101001100 11010000010010010100110010010001100010010100110010010001 10011000110110111101101110011101000110111101110011011011 110010111001100011011011110110110100100010"
Urıonenttostring
Tekdüzen Kaynak tanımlayıcısı (URI) kodlu bir dize için dize sürümünü döndürün, URI kodlu dizeyi etkin bir şekilde çözerek.
uriComponentToString('<value>')
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <deeri> | Evet | Dize | Kodu çözülecek URI kodlamalı dize |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <kodu çözülmüş-URI> | Dize | URI kodlamalı dize için kodu çözülmüş sürüm |
Örnek
Bu örnek, bu URI kodlu dize için kodu çözülmüş dize sürümünü oluşturur:
uriComponentToString('http%3A%2F%2Fcontoso.com')
Ve şu sonucu döndürür: "https://contoso.com"
utcNow
Geçerli zaman damgasını döndürür.
utcNow('<format>')
İsteğe bağlı olarak, <format> parametresiyle farklı bir biçim belirtebilirsiniz.
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <formatını> | Hayır | Dize | Tek bir biçim belirticisi veya bir özel biçim desenininolması. Zaman damgası için varsayılan biçim, ıso 8601 ile uyumlu olan ve saat dilimi bilgilerini koruyan "o" (yyyy-mm-ddTHH: mm: ss: gönderildiğinde fffffffK biçiminde) şeklindedir. |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <geçerli zaman damgası> | Dize | Geçerli tarih ve saat |
Örnek 1
Bugünün 15 Nisan 2018, 1:00:00 PM 'de olduğunu varsayalım. Bu örnekte geçerli zaman damgası alınır:
utcNow()
Ve şu sonucu döndürür: "2018-04-15T13:00:00.0000000Z"
Örnek 2
Bugünün 15 Nisan 2018, 1:00:00 PM 'de olduğunu varsayalım. Bu örnekte, isteğe bağlı "D" biçimini kullanarak geçerli zaman damgası alınır:
utcNow('D')
Ve şu sonucu döndürür: "Sunday, April 15, 2018"
xml
JSON nesnesi içeren bir dize için XML sürümünü döndürün.
xml('<value>')
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <deeri> | Evet | Dize | Dönüştürülecek JSON nesnesine sahip dize JSON nesnesinin yalnızca bir root özelliği olmalıdır ve bu bir dizi olamaz. |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <XML-sürümü> | Nesne | Belirtilen dize veya JSON nesnesi için kodlanmış XML |
Örnek 1
Bu örnek, bu dize için bir JSON nesnesi içeren XML sürümünü oluşturur:
xml(json('{ \"name\": \"Sophia Owen\" }'))
Ve bu sonuç XML 'sini döndürür:
<name>Sophia Owen</name>
Örnek 2
Bu JSON nesnesine sahip olduğunuzu varsayalım:
{
"person": {
"name": "Sophia Owen",
"city": "Seattle"
}
}
Bu örnek, bu JSON nesnesini içeren bir dize için XML oluşturur:
xml(json('{\"person\": {\"name\": \"Sophia Owen\", \"city\": \"Seattle\"}}'))
Ve bu sonuç XML 'sini döndürür:
<person>
<name>Sophia Owen</name>
<city>Seattle</city>
<person>
XPath
XML 'yi bir XPath (XML Path Language) ifadesiyle eşleşen düğümler veya değerler için denetleyin ve eşleşen düğümleri veya değerleri döndürün. Bir XPath ifadesi veya yalnızca "XPath", XML içeriğindeki düğümleri veya işlem değerlerini seçebilmeniz için bir XML belge yapısında gezinmenize yardımcı olur.
xpath('<xml>', '<xpath>')
| Parametre | Gerekli | Tür | Description |
|---|---|---|---|
| <'sini> | Yes | Herhangi biri | Bir XPath ifadesi değeriyle eşleşen düğümleri veya değerleri aramak için XML dizesi |
| <XPath> | Yes | Herhangi biri | Eşleşen XML düğümlerini veya değerlerini bulmak için kullanılan XPath ifadesi |
| Döndürülen değer | Tür | Description |
|---|---|---|
| <XML düğümü> | XML | Belirtilen XPath ifadesiyle yalnızca tek bir düğüm eşleştiğinde bir XML düğümü |
| <deeri> | Herhangi biri | Belirtilen XPath ifadesiyle yalnızca tek bir değer eşleştiğinde bir XML düğümündeki değer |
| [<XML-düğüm1>, <xml-Düğüm2>,...] -veya- [<değer1>, <değer2>,...] | Dizi | XML düğümleri veya belirtilen XPath ifadesiyle eşleşen değerler içeren bir dizi |
Örnek 1
Örnek 1 ' den sonra bu örnek, düğüm ile eşleşen düğümleri bulur <count></count> ve bu düğüm değerlerini sum() işlevle ekler:
xpath(xml(parameters('items')), 'sum(/produce/item/count)')
Ve şu sonucu döndürür: 30
Örnek 2
Bu örnekte her iki ifade de <location></location> , bir ad alanı Ile xml içeren belirtilen bağımsız değişkenlerde düğümle eşleşen düğümleri bulur. İfadeler, \ çift tırnak işareti (") için kaçış karakteri olarak ters eğik çizgi karakterini () kullanır.
İfade 1
xpath(xml(body('Http')), '/*[name()=\"file\"]/*[name()=\"location\"]')İfade 2
xpath(xml(body('Http')), '/*[local-name()=\"file\" and namespace-uri()=\"http://contoso.com\"]/*[local-name()=\"location\"]')
Bağımsız değişkenler şunlardır:
XML belgesi ad alanını içeren bu XML
xmlns="http://contoso.com":<?xml version="1.0"?> <file xmlns="http://contoso.com"> <location>Paris</location> </file>Burada XPath ifadesi:
/*[name()=\"file\"]/*[name()=\"location\"]/*[local-name()=\"file\" and namespace-uri()=\"http://contoso.com\"]/*[local-name()=\"location\"]
Düğüm ile eşleşen sonuç düğümü aşağıdadır <location></location> :
<location xmlns="https://contoso.com">Paris</location>
Örnek 3
Örnek 3 ' te aşağıdaki örnekte, bu örnek düğümündeki değeri bulur <location></location> :
xpath(xml(body('Http')), 'string(/*[name()=\"file\"]/*[name()=\"location\"])')
Ve şu sonucu döndürür: "Paris"
Sonraki adımlar
İfadelerde kullanabileceğiniz sistem değişkenlerinin listesi için bkz. Sistem değişkenleri.