Azure Data Factory ve Azure Synapse Analytics'teki ifadeler ve işlevler

  • Makale

UYGULANANLAR: Azure Data Factory Azure Synapse Analytics

İpucu

Kuruluşlar için hepsi bir arada analiz çözümü olan Microsoft Fabric'te Data Factory'yi deneyin. Microsoft Fabric , veri taşımadan veri bilimine, gerçek zamanlı analize, iş zekasına ve raporlamaya kadar her şeyi kapsar. Yeni bir deneme sürümünü ücretsiz olarak başlatmayı öğrenin!

Bu makalede Azure Data Factory ve Azure Synapse Analytics tarafından desteklenen ifadeler ve işlevler hakkında ayrıntılar sağlanır.

İfadeler

Tanımdaki JSON değerleri değişmez değer veya çalışma zamanında değerlendirilen ifadeler olabilir. Örneğin:

"name": "value"

veya

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

İfadeler JSON dize değerinin herhangi bir yerinde görünebilir ve her zaman başka bir JSON değeriyle sonuçlanabilir. JSON değeri bir ifadeyse, ifadenin gövdesi at-sign (@) kaldırılarak ayıklanır. @ile başlayan bir değişmez değer dizesi gerekiyorsa, @@ kullanılarak kaçışı yapılmalıdır. Aşağıdaki örneklerde ifadelerin nasıl değerlendirıldığı gösterilmektedir.

JSON değeri Sonuç
"parametreler" 'parameters' karakterleri döndürülür.
"parameters[1]" 'parameters[1]' karakterleri döndürülür.
"@@" '@' içeren 1 karakterlik bir dize döndürülür.
" @" '@' içeren 2 karakterlik bir dize döndürülür.

İfadeler, ifadelerin içinde sarmalandığı dize ilişkilendirmesi adlı bir özellik kullanılarak dizelerin içinde @{ ... }de görüntülenebilir. Örneğin: "name" : "First Name: @{pipeline().parameters.firstName} Last Name: @{pipeline().parameters.lastName}"

Dize ilişkilendirmesi kullanıldığında sonuç her zaman bir dizedir. ve myStringfooolarak 42 tanımlandığımı myNumber varsayalım:

JSON değeri Sonuç
"@pipeline().parameters.myString" Dize olarak döndürür foo .
"@{pipeline().parameters.myString}" Dize olarak döndürür foo .
"@pipeline().parameters.myNumber" Sayı olarak döndürür42.
"@{pipeline().parameters.myNumber}" Dize olarak döndürür42.
"Yanıt: @{pipeline().parameters.myNumber}" dizesini Answer is: 42döndürür.
"@concat('Answer is: ', string(pipeline().parameters.myNumber))" Dizeyi verir Answer is: 42
"Yanıt: @@{pipeline().parameters.myNumber}" dizesini Answer is: @{pipeline().parameters.myNumber}döndürür.

ForEach etkinliği gibi denetim akışı etkinliklerinde, özellik öğeleri için yinelenecek bir dizi sağlayabilir ve ForEach etkinliğindeki tek bir numaralandırmayı yinelemek için kullanabilirsiniz @item() . Örneğin, öğeler bir diziyse: [1, 2, 3], ilk yinelemede 1, @item() ikinci yinelemede 2 ve üçüncü yinelemede 3 döndürür. 0 ile başlayan ve 9 ile biten on kez yinelemek için like ifadesini de kullanabilirsiniz @range(0,10) .

Etkinliğin çıkışını yakalamak ve kararlar almak için 'etkinlik adı') kullanabilirsiniz @activity(. Web1 adlı bir web etkinliğini göz önünde bulundurun. İlk etkinliğin çıkışını ikincinin gövdesine yerleştirmek için ifade genellikle şöyle görünür: @activity('Web1').output veya @activity('Web1').output.data veya ilk etkinliğin çıktısının nasıl göründüğüne bağlı olarak benzer bir şey.

Örnekler

Karmaşık ifade örneği

Aşağıdaki örnekte, etkinlik çıkışının derin bir alt alanına başvuran karmaşık bir örnek gösterilmektedir. Bir alt alanı değerlendiren bir işlem hattı parametresine başvurmak için, etkinlik çıkışının parçası olarak nokta(.) işleci yerine [] söz dizimini kullanın (alt alan1 ve alt alan2 gibi).

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

Dosyaları dinamik olarak oluşturmak ve adlandırmak yaygın bir düzendir. Birkaç dinamik dosya adlandırma örneğini inceleyelim.

  1. Dosya adına Tarih Ekle: @concat('Test_', formatDateTime(utcnow(), 'yyyy-dd-MM'))

  2. Müşteri saat diliminde DateTime ekleme: @concat('Test_', convertFromUtc(utcnow(), 'Pacific Standard Time'))

  3. Ekleme Tetikleyici Zamanı : @concat('Test_', pipeline().TriggerTime)

  4. Tarihe sahip tek bir dosyaya çıkış yaparken Eşleme Veri Akışı özel bir dosya adı çıktısı verme:'Test_' + toString(currentDate()) + '.csv'

Yukarıdaki durumlarda, Test_ ile başlayarak 4 dinamik dosya adı oluşturulur.

Dinamik içerik düzenleyicisi

Dinamik içerik düzenleyicisi, düzenlemeyi bitirdiğinizde içeriğinizdeki karakterleri otomatik olarak çıkarı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 belirtilen 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 bir işlem hattı

Aşağıdaki örnekte işlem hattı inputPath ve outputPath parametrelerini alır. Parametreli blob veri kümesinin yolu, bu parametrelerin değerleri kullanılarak ayarlanır. Burada kullanılan söz dizimi: 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 bitirdiğinizde içeriğinizde çift tırnak, ters eğik çizgi gibi karakterleri otomatik olarak çıkarır. Satır akışını veya sekmeyi replace() işlevinde \n, \t kullanarak değiştirmek istiyorsanız bu sorunlara neden olur. İfadedeki fazladan \ öğesini 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ı izleyebilirsiniz:

  1. Özgün dize değerine karşı URL kodlaması
  2. URL ile kodlanmış dizeyi değiştirin; örneğin, satır besleme (%0A), satır başı(%0D), yatay sekme(%09).
  3. URL kodunu çözme

Örneğin, değerinde yeni satır karakteri olan companyName değişkeni, ifade @uriComponentToString(replace(uriComponent(variables('companyName')), '%0A', '')) yeni satır karakterini kaldırabilir.

Contoso-
Corporation

Tek tırnak karakterinden kaçış

İfade işlevleri, dize değeri parametreleri için tek tırnak kullanır. Dize işlevlerindeki bir ' karakterden kaçmak için iki tek tırnak kullanın. Örneğin, ifade @concat('Baba', '''s ', 'book store') aşağıdaki sonucu döndürür.

Baba's book store

Öğretici

Bu öğreticide , işlem hattı ve etkinlik arasında ve etkinlikler arasında parametreleri geçirme adımları gösterilir. Synapse çalışma alanı için adımlar neredeyse eşdeğer olsa da, biraz farklı bir kullanıcı arabirimine sahip olsa da, öğretici özellikle Azure Data Factory adımlarını gösterir.

İşlevler

İfadeler içinde işlevleri çağırabilirsiniz. Aşağıdaki bölümlerde bir ifadede kullanılabilecek işlevler hakkında bilgi sağlanır.

Tarih işlevleri

Tarih veya saat işlevi Görev
Adddays 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 Zaman damgasına bir dizi zaman birimi ekleyin. Ayrıca bkz. getFutureTime.
convertFromUtc Zaman damgasını Evrensel Saat Eşgüdümlü (UTC) saat diliminden hedef saat dilimine dönüştürün.
convertTimeZone Bir zaman damgasını kaynak saat diliminden hedef saat dilimine dönüştürün.
convertToUtc Zaman damgasını kaynak saat diliminden Evrensel Saat Eşgüdümlü (UTC) saatine dönüştürün.
dayOfMonth Bir zaman damgasından ayın gününü döndürür.
Dayofweek Bir zaman damgasından haftanın günü bileşenini döndürür.
Dayofyear Bir zaman damgasından yılın günü bileşenini döndürür.
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 döndürür. Ayrıca bkz. addToTime.
getPastTime Geçerli zaman damgasını eksi belirtilen zaman birimlerini döndürür. Ayrıca bkz. subtractFromTime.
startOfDay Zaman damgası için günün başlangıcını döndürür.
startOfHour Zaman damgası için saatin başlangıcını döndürür.
startOfMonth Zaman damgası için ayın başlangıcını döndürür.
subtractFromTime Zaman damgasından bir dizi zaman birimini çıkarın. Ayrıca bkz. getPastTime.
Ticks ticks Belirtilen bir zaman damgası için özellik değerini döndürür.
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 dizelerde çalışır.

Dize işlevi Görev
Concat İki veya daha fazla dizeyi birleştirin ve birleştirilmiş dizeyi döndürin.
Endswith Bir dizenin belirtilen alt dizeyle bitip bitmediğini denetleyin.
Guıd Dize olarak genel olarak benzersiz bir tanımlayıcı (GUID) oluşturun.
ındexof Alt dize için başlangıç konumunu döndürür.
Lastındexof Bir alt dizenin son oluşumu için başlangıç konumunu döndürür.
replace Bir alt dizeyi belirtilen dizeyle değiştirin ve güncelleştirilmiş dizeyi döndürin.
split Belirtilen sınırlayıcının her oluşumunda bir dizeyi bölerek sonuçta elde edilen alt dizeleri bir dizinin öğeleri olarak döndürür.
Startswith Dizenin belirli bir alt dizeyle başlayıp başlamadığını denetleyin.
Dize Belirtilen konumdan başlayarak dizedeki karakterleri döndürür.
Tolower Küçük harf biçiminde bir dize döndürür.
Toupper Büyük harf biçiminde bir dize döndürür.
Döşeme Bir dizeden baştaki ve sondaki boşluğu kaldırın ve güncelleştirilmiş dizeyi döndürin.

Koleksiyon işlevleri

Koleksiyonlar, genel olarak diziler, dizeler ve bazen sözlüklerle çalışmak için bu koleksiyon işlevlerini kullanabilirsiniz.

Collection işlevi Görev
Içerir Koleksiyonun belirli bir öğeye sahip olup olmadığını denetleyin.
empty Bir koleksiyonun boş olup olmadığını denetleyin.
Ilk Koleksiyondaki ilk öğeyi döndürür.
Kesişim Belirtilen koleksiyonlar arasında yalnızca ortak öğeleri içeren bir koleksiyon döndürür.
join Belirtilen karakterle ayrılmış bir dizideki tüm öğeleri içeren bir dize döndürür.
Son Koleksiyondaki son öğeyi döndürür.
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 döndürin.
al Bir koleksiyonun önünden öğeleri döndürme.
Birliği Belirtilen koleksiyonlardan tüm öğeleri içeren bir koleksiyon döndürür.

Mantıksal işlevler

Bu işlevler koşulların içinde yararlıdır, 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ı denetleyin.
equals Her iki değerin de eşdeğer olup olmadığını denetleyin.
greater İlk değerin ikinci değerden büyük olup olmadığını denetleyin.
greaterOrEquals İlk değerin ikinci değerden büyük veya buna eşit olup olmadığını denetleyin.
eğer İfadenin doğru mu yoksa yanlış mı olduğunu denetleyin. Sonucu temel alarak, belirtilen değeri döndürür.
less İlk değerin ikinci değerden küçük olup olmadığını denetleyin.
lessOrEquals İlk değerin ikinci değerden küçük veya buna eşit olup olmadığını denetleyin.
not İfadenin false olup olmadığını denetleyin.
veya En az bir ifadenin doğru olup olmadığını denetleyin.

Dönüştürme işlevleri

Bu işlevler, dildeki yerel türlerin her biri arasında dönüştürme yapmak için kullanılır:

  • Dize
  • integer
  • kayan noktalı sayı
  • boolean
  • Dizi
  • Sözlük
Dönüştürme işlevi Görev
Dizi Belirtilen tek bir girişten dizi döndürür. Birden çok giriş için bkz . createArray.
base64 Bir dize için base64 ile kodlanmış sürümü döndürür.
base64ToBinary Base64 ile kodlanmış bir dizenin ikili sürümünü döndürür.
base64ToString Base64 ile kodlanmış bir dize için dize sürümünü döndürür.
Ikili Giriş değeri için ikili sürümü döndürür.
bool Giriş değeri için Boole sürümünü döndürür.
Coalesce Bir veya daha fazla parametreden ilk null olmayan değeri döndürür.
createArray Birden çok girişten bir dizi döndürür.
dataUri Giriş değeri için veri URI'sini döndürür.
dataUriToBinary Veri URI'sinin ikili sürümünü döndürür.
dataUriToString Veri URI'sinin dize sürümünü döndürür.
decodeBase64 Base64 ile kodlanmış bir dize için dize sürümünü döndürür.
decodeDataUri Veri URI'sinin ikili sürümünü döndürür.
decodeUriComponent Kaçış karakterlerini kodu çözülen sürümlerle değiştiren bir dize döndürür.
encodeUriComponent URL güvensiz karakterleri kaçış karakterleriyle değiştiren bir dize döndürür.
float Giriş değeri için kayan nokta numarası döndürür.
int Bir dize için tamsayı sürümünü döndürür.
Json Bir dize veya XML için JavaScript Nesne Gösterimi (JSON) türü değerini veya nesnesini döndürür.
string Giriş değeri için dize sürümünü döndürür.
uriComponent URL güvenli olmayan karakterleri kaçış karakterleriyle değiştirerek giriş değeri için URI ile kodlanmış sürümü döndür.
uriComponentToBinary URI ile kodlanmış bir dize için ikili sürümü döndürür.
uriComponentToString URI ile kodlanmış bir dize için dize sürümünü döndürür.
xml Bir dize için XML sürümünü döndürür.
Xpath XML'de XPath (XML Yol Dili) ifadesiyle eşleşen düğümleri veya değerleri denetleyin ve eşleşen düğümleri veya değerleri döndürin.

Matematik İşlevleri

Bu işlevler her iki sayı türü için de kullanılabilir: tamsayılar ve kayan sayılar.

Matematik işlevi Görev
add İki sayı ekleyerek sonucu döndürür.
div Bir sayıyı başka bir sayıya bölerek sonucu döndürür.
Max Bir sayı veya dizi kümesinden en yüksek değeri döndürür.
Dk Bir sayı veya dizi kümesinden en düşük değeri döndürür.
mod Bir sayıyı başka bir sayıya bölmeden kalan değeri döndürür.
Mul Ürünü iki sayının çarpımından döndür.
rand Belirtilen aralıktan rastgele bir tamsayı döndürür.
aralık Belirtilen bir tamsayıdan başlayan bir tamsayı dizisi döndürür.
Alt Bir sayıyı başka bir numaradan çıkarmaktan elde edilen sonucu döndürür.

İşlev başvurusu

Bu bölümde tüm kullanılabilir işlevler alfabetik sırada listelenmektedir.

add

İki sayı ekleyerek sonucu döndürür.

add(<summand_1>, <summand_2>)
Parametre Zorunlu Türü Açıklama
<>summand_1, <summand_2> Yes Tamsayı, Kayan veya karışık Eklenecek sayılar
Dönüş değeri Type Açıklama
<sonuç-toplam> Tamsayı veya Kayan Nokta Belirtilen sayıların eklenmesinden elde edilen sonuç

Örnek

Bu örnek belirtilen sayıları ekler:

add(1, 1.5)

Ve şu sonucu döndürür: 2.5

Adddays

Zaman damgasına birkaç gün ekleyin.

addDays('<timestamp>', <days>, '<format>'?)
Parametre Zorunlu Türü Açıklama
<Zaman damgası> Yes String Zaman damgasını içeren dize
<Gün> Yes Tamsayı Eklenecek pozitif veya negatif gün sayısı
<format> Hayır String Tek biçim tanımlayıcısı 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önüş değeri Type Açıklama
<güncelleştirilmiş zaman damgası> String Zaman damgası ve 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 çıkarır:

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

Ve şu sonucu döndürür: "2018-03-10T00:00:0000000Z"

Addhours

Zaman damgasına birkaç saat ekleyin.

addHours('<timestamp>', <hours>, '<format>'?)
Parametre Zorunlu Türü Açıklama
<Zaman damgası> Yes String Zaman damgasını içeren dize
<hours> Yes Tamsayı Eklenecek pozitif veya negatif saat sayısı
<format> Hayır String Tek biçim tanımlayıcısı 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önüş değeri Type Açıklama
<güncelleştirilmiş zaman damgası> String Zaman damgası ve 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ş saat çı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 birkaç dakika ekleyin.

addMinutes('<timestamp>', <minutes>, '<format>'?)
Parametre Zorunlu Türü Açıklama
<Zaman damgası> Yes String Zaman damgasını içeren dize
<minutes> Yes Tamsayı Eklenecek pozitif veya negatif dakika sayısı
<format> Hayır String Tek biçim tanımlayıcısı 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önüş değeri Type Açıklama
<güncelleştirilmiş zaman damgası> String Zaman damgası ve 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 birkaç saniye ekleyin.

addSeconds('<timestamp>', <seconds>, '<format>'?)
Parametre Zorunlu Türü Açıklama
<Zaman damgası> Yes String Zaman damgasını içeren dize
<Saniye> Yes Tamsayı Eklenecek pozitif veya negatif saniye sayısı
<format> Hayır String Tek biçim tanımlayıcısı 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önüş değeri Type Açıklama
<güncelleştirilmiş zaman damgası> String Zaman damgası ve 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 çıkarı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 Zorunlu Türü Açıklama
<Zaman damgası> Yes String Zaman damgasını içeren dize
<interval> Yes Tamsayı Eklenecek belirtilen zaman birimi sayısı
<timeUnit> Yes String Aralıkla kullanılacak zaman birimi: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format> Hayır String Tek biçim tanımlayıcısı 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önüş değeri Type Açıklama
<güncelleştirilmiş zaman damgası> String Zaman damgası ve 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 döndür veya en az bir ifade false olduğunda false döndür.

and(<expression1>, <expression2>)
Parametre Zorunlu Türü Açıklama
<ifade1>, <ifade2> Yes Boolean Denetlenecek ifadeler
Dönüş değeri Type Açıklama
true veya false Boolean her iki ifade de true olduğunda true döndürür. En az bir ifade false olduğunda false döndürür.

Örnek 1

Bu örnekler, belirtilen Boole 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 olduğundan döndürür true.
  • İkinci örnek: bir ifade false olduğundan döndürür false.
  • Üçüncü örnek: her iki ifade de false olduğundan döndürür false.

Örnek 2

Bu örnekler, belirtilen ifadelerin her ikisinin de doğru olup olmadığını denetler:

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 true olduğundan döndürür true.
  • İkinci örnek: bir ifade false olduğundan döndürür false.
  • Üçüncü örnek: her iki ifade de false olduğundan döndürür false.

dizi

Belirtilen tek bir girişten dizi döndürür. Birden çok giriş için bkz . createArray().

array('<value>')
Parametre Zorunlu Türü Açıklama
<value> Yes String Dizi oluşturmaya yönelik dize
Dönüş değeri Type Açıklama
[<değer>] Dizi Belirtilen tek girişi içeren bir dizi

Örnek

Bu örnek, "hello" dizesinden 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 Zorunlu Türü Açıklama
<value> Yes String Giriş dizesi
Dönüş değeri Type Açıklama
<base64-string> String 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ış bir dizenin ikili sürümünü döndürür.

base64ToBinary('<value>')
Parametre Zorunlu Türü Açıklama
<value> Yes String Dönüştürülecek base64 kodlamalı dize
Dönüş değeri Type Açıklama
<base64 için ikili dize> String base64 ile kodlanmış dizenin ikili sürümü

Örnek

Bu örnek, "aGVsbG8=" base64 kodlu dizeyi ikili dizeye dönüştürür:

base64ToBinary('aGVsbG8=')

Ve şu sonucu döndürür:

"0110000101000111010101100111001101100010010001110011100000111101"

base64ToString

base64 ile kodlanmış bir dizenin dize sürümünü döndürerek base64 dizesinin kodunu etkili bir şekilde çözün. DecodeBase64() yerine bu işlevi kullanın. Her iki işlev de aynı şekilde çalışsa da tercih base64ToString() edilir.

base64ToString('<value>')
Parametre Zorunlu Türü Açıklama
<value> Yes String Kodunu çözmek için base64 ile kodlanmış dize
Dönüş değeri Type Açıklama
<kodu çözülen base64-string> String Base64 ile kodlanmış bir dize için 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 dizenin ikili sürümünü döndürür.

binary('<value>')
Parametre Zorunlu Türü Açıklama
<value> Yes String Dönüştürülecek dize
Dönüş değeri Type Açıklama
<giriş için ikili değer> String 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"

ikili

Bir değer için Boole sürümünü döndürür.

bool(<value>)
Parametre Zorunlu Türü Açıklama
<value> Yes Tümü Dönüştürülecek değer
Dönüş değeri Type Açıklama
true veya false Boolean Belirtilen değer için Boole 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 ilk null olmayan değeri döndürür. Boş dizeler, boş diziler ve boş nesneler null değildir.

coalesce(<object_1>, <object_2>, ...)
Parametre Zorunlu Türü Açıklama
<>object_1, <object_2>, ... Yes Herhangi biri, türleri karıştırabilir Null olup olmadığını denetlemek için bir veya daha fazla öğe
Dönüş değeri Type Açıklama
<null olmayan ilk öğe> Tümü Null olmayan ilk öğe veya değer. Tüm parametreler null ise, bu işlev null döndürür.

Örnek

Bu örnekler belirtilen değerlerden ilk null olmayan 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ştirilmiş dizeyi döndürin.

concat('<text1>', '<text2>', ...)
Parametre Zorunlu Türü Açıklama
<metin1>, <metin2>, ... Yes String Birleştirecek en az iki dize
Dönüş değeri Type Açıklama
<metin1metin2...> String Birleşik giriş dizelerinden oluşturulan dize

Örnek

Bu örnekte "Hello" ve "World" dizeleri birleştirilir:

concat('Hello', 'World')

Ve şu sonucu döndürür: "HelloWorld"

içerir

Koleksiyonun belirli bir öğeye sahip olup olmadığını denetleyin. Öğe bulunduğunda true değerini veya bulunamadığında false değerini döndürür. Bu işlev büyük/küçük harfe duyarlıdır.

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

Özellikle, bu işlev şu koleksiyon türlerinde çalışır:

  • Alt dizeyi bulmak için kullanılan dize
  • Değer bulmak için bir dizi
  • Anahtar bulmak için sözlük
Parametre Zorunlu Türü Açıklama
<Koleksiyon> Yes Dize, Dizi veya Sözlük Denetlenecek koleksiyon
<value> Yes Sırasıyla Dize, Dizi veya Sözlük Bulunacak öğe
Dönüş değeri Type Açıklama
true veya false Boolean Öğe bulunduğunda true değerini döndürür. Bulunamadığında false döndürür.

Örnek 1

Bu örnek, "hello world" dizesini "world" alt dizesi için denetler ve true döndürür:

contains('hello world', 'world')

Örnek 2

Bu örnek, "hello world" dizesini "evren" alt dizesi için denetler ve false döndürür:

contains('hello world', 'universe')

convertFromUtc

Zaman damgasını Evrensel Saat Eşgüdümlü (UTC) saat diliminden hedef saat dilimine dönüştürün.

convertFromUtc('<timestamp>', '<destinationTimeZone>', '<format>'?)
Parametre Zorunlu Türü Açıklama
<Zaman damgası> Yes String Zaman damgasını içeren dize
<destinationTimeZone> Yes String Hedef saat diliminin adı. Saat dilimi adları için bkz . Microsoft Saat Dilimi Değerleri, ancak saat dilimi adından tüm noktalama işaretlerini kaldırmanız gerekebilir.
<format> Hayır String Tek biçim tanımlayıcısı 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önüş değeri Type Açıklama
<dönüştürülmüş zaman damgası> String Hedef saat dilimine dönüştürülen zaman damgası

Ö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

Bir zaman damgasını kaynak saat diliminden hedef saat dilimine dönüştürün.

convertTimeZone('<timestamp>', '<sourceTimeZone>', '<destinationTimeZone>', '<format>'?)
Parametre Zorunlu Türü Açıklama
<Zaman damgası> Yes String Zaman damgasını içeren dize
<Sourcetimezone> Yes String Kaynak saat diliminin adı. Saat dilimi adları için bkz . Microsoft Saat Dilimi Değerleri, ancak saat dilimi adından tüm noktalama işaretlerini kaldırmanız gerekebilir.
<destinationTimeZone> Yes String Hedef saat diliminin adı. Saat dilimi adları için bkz . Microsoft Saat Dilimi Değerleri, ancak saat dilimi adından tüm noktalama işaretlerini kaldırmanız gerekebilir.
<format> Hayır String Tek biçim tanımlayıcısı 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önüş değeri Type Açıklama
<dönüştürülmüş zaman damgası> String Hedef saat dilimine dönüştürülen zaman damgası

Ö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, bir 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

Zaman damgasını kaynak saat diliminden Evrensel Saat Eşgüdümlü (UTC) saatine dönüştürün.

convertToUtc('<timestamp>', '<sourceTimeZone>', '<format>'?)
Parametre Zorunlu Türü Açıklama
<Zaman damgası> Yes String Zaman damgasını içeren dize
<Sourcetimezone> Yes String Kaynak saat diliminin adı. Saat dilimi adları için bkz . Microsoft Saat Dilimi Değerleri, ancak saat dilimi adından tüm noktalama işaretlerini kaldırmanız gerekebilir.
<format> Hayır String Tek biçim tanımlayıcısı 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önüş değeri Type Açıklama
<dönüştürülmüş zaman damgası> String UTC'ye dönüştürülen zaman damgası

Ö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 bir dizi döndürür. Tek giriş dizileri için bkz . array().

createArray('<object1>', '<object2>', ...)
Parametre Zorunlu Türü Açıklama
<object1>, <object2>, ... Yes Herhangi biri, ancak karışık değil Diziyi oluşturmak için en az iki öğe
Dönüş değeri Type Açıklama
[<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üzen kaynak tanımlayıcısı (URI) döndürür.

dataUri('<value>')
Parametre Zorunlu Türü Açıklama
<value> Yes String Dönüştürülecek dize
Dönüş değeri Type Açıklama
<data-uri> String 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üzen kaynak tanımlayıcısı (URI) için ikili sürümü döndürür. DecodeDataUri() yerine bu işlevi kullanın. Her iki işlev de aynı şekilde çalışsa da tercih dataUriBinary() edilir.

dataUriToBinary('<value>')
Parametre Zorunlu Türü Açıklama
<value> Yes String Dönüştürülecek veri URI'si
Dönüş değeri Type Açıklama
<veri için ikili uri> String Veri URI'sinin ikili sürümü

Örnek

Bu örnek, bu veri URI'si için ikili bir 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üzen kaynak tanımlayıcısı (URI) için dize sürümünü döndürür.

dataUriToString('<value>')
Parametre Zorunlu Türü Açıklama
<value> Yes String Dönüştürülecek veri URI'si
Dönüş değeri Type Açıklama
<string-for-data-uri> String Veri URI'sinin 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ünü döndürür.

dayOfMonth('<timestamp>')
Parametre Zorunlu Türü Açıklama
<Zaman damgası> Yes String Zaman damgasını içeren dize
Dönüş değeri Type Açıklama
<ayın günü> Tamsayı Belirtilen zaman damgasından ayın günü

Örnek

Bu örnek, bu zaman damgasından ayın gününün numarasını 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ünü döndürür.

dayOfWeek('<timestamp>')
Parametre Zorunlu Türü Açıklama
<Zaman damgası> Yes String Zaman damgasını içeren dize
Dönüş değeri Type Açıklama
<haftanın günü> Tamsayı Pazar'ın 0, Pazartesi'nin 1 olduğu belirtilen zaman damgasından haftanın günü vb.

Örnek

Bu örnek, bu zaman damgasından haftanın gününün numarasını 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ünü döndürür.

dayOfYear('<timestamp>')
Parametre Zorunlu Türü Açıklama
<Zaman damgası> Yes String Zaman damgasını içeren dize
Dönüş değeri Type Açıklama
<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ünü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ış bir dizenin dize sürümünü döndürerek base64 dizesinin kodunu etkili bir şekilde çözün. yerine decodeBase64()base64ToString() kullanmayı düşünün. Her iki işlev de aynı şekilde çalışsa da tercih base64ToString() edilir.

decodeBase64('<value>')
Parametre Zorunlu Türü Açıklama
<value> Yes String Kodunu çözmek için base64 ile kodlanmış dize
Dönüş değeri Type Açıklama
<kodu çözülen base64-string> String Base64 ile kodlanmış bir dize için dize sürümü

Örnek

Bu örnek, base64 ile kodlanmış bir dize için bir dize oluşturur:

decodeBase64('aGVsbG8=')

Ve şu sonucu döndürür: "hello"

decodeDataUri

Veri tekdüzen kaynak tanımlayıcısı (URI) için ikili sürümü döndürür. yerine decodeDataUri()dataUriToBinary() kullanmayı göz önünde bulundurun. Her iki işlev de aynı şekilde çalışsa da tercih dataUriToBinary() edilir.

decodeDataUri('<value>')
Parametre Zorunlu Türü Açıklama
<value> Yes String Kodunu çözmek için veri URI dizesi
Dönüş değeri Type Açıklama
<veri için ikili uri> String Veri URI dizesinin ikili sürümü

Örnek

Bu örnek, bu veri URI'sinin ikili sürümünü 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 Zorunlu Türü Açıklama
<value> Yes String Kodunu çözmek için kaçış karakterlerini içeren dize
Dönüş değeri Type Açıklama
<kod çözme uri'si> String Kodu çözülen kaçış karakterleriyle güncelleştirilmiş dize

Örnek

Bu örnek, bu dizedeki kaçış karakterlerini 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

Bir sayıyı başka bir sayıya bölmenin sonucunu döndürür.

div(<dividend>, <divisor>)

İşlevin tam dönüş türü, parametrelerinin türlerine bağlıdır; ayrıntılar için örneklere bakın.

Parametre Zorunlu Türü Açıklama
<Temettü> Yes Tamsayı veya Kayan Nokta Bölen tarafından bölünecek sayı
<Bölen> Yes Tamsayı veya Kayan Nokta Temettü bölen sayıdır. Sıfır bölen değeri çalışma zamanında hataya neden olur.
Dönüş değeri Type Açıklama
<quotient-result> Tamsayı veya Kayan Nokta İlk sayıyı ikinci sayıya bölmenin sonucu

Örnek 1

Bu örnekler 9 sayısını 2'ye böler:

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

Ve tümü şu sonucu döndürür: 4.5

Örnek 2

Bu örnek ayrıca 9 sayısını 2'ye böler, ancak her iki parametre de tamsayı olduğundan kalan atılır (tamsayı bölme):

div(9, 2)

İfade sonucunu 4döndürür. Kalan değeri almak için mod() işlevini kullanın.

encodeUriComponent

URL güvenli olmayan karakterleri kaçış karakterleriyle değiştirerek bir dize için tekdüzen kaynak tanımlayıcısı (URI) kodlanmış bir sürüm döndürebilirsiniz. yerine encodeUriComponent()uriComponent() kullanmayı düşünün. Her iki işlev de aynı şekilde çalışsa da tercih uriComponent() edilir.

encodeUriComponent('<value>')
Parametre Zorunlu Türü Açıklama
<value> Yes String URI ile kodlanmış biçime dönüştürülecek dize
Dönüş değeri Type Açıklama
<kodlanmış uri> String Kaçış karakterleri içeren 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ı denetleyin. Koleksiyon boş olduğunda true döndür veya boş olmadığında false döndür.

empty('<collection>')
empty([<collection>])
Parametre Zorunlu Türü Açıklama
<Koleksiyon> Yes Dize, Dizi veya Nesne Denetlenecek koleksiyon
Dönüş değeri Type Açıklama
true veya false Boolean Koleksiyon boş olduğunda true değerini döndürür. Boş olmadığında false döndürür.

Örnek

Bu örnekler, belirtilen koleksiyonların boş olup olmadığını denetler:

empty('')
empty('abc')

Ve şu sonuçları döndürür:

  • İlk örnek: İşlevin döndürdüğü trueboş bir dize geçirir.
  • İkinci örnek: İşlevin döndürdüğü false"abc" dizesini geçirir.

Endswith

Dizenin belirli bir alt dizeyle bitip bitmediğini denetleyin. Alt dize bulunduğunda true döndür veya bulunamadığında false döndür. Bu işlev büyük/küçük harfe duyarlı değildir.

endsWith('<text>', '<searchText>')
Parametre Zorunlu Türü Açıklama
<text> Evet String Denetlenecek dize
<searchText> Yes String Bulunacak son alt dize
Dönüş değeri Type Açıklama
true veya false Boolean Son alt dize bulunduğunda true değerini döndürür. Bulunamadığında false döndürür.

Örnek 1

Bu örnek, "hello world" dizesinin "world" dizesiyle bitip bitmediğini denetler:

endsWith('hello world', 'world')

Ve şu sonucu döndürür: true

Örnek 2

Bu örnek, "merhaba dünya" dizesinin "evren" dizesiyle bitip bitmediğini denetler:

endsWith('hello world', 'universe')

Ve şu sonucu döndürür: false

equals

Her iki değerin, ifadenin veya nesnenin eşdeğer olup olmadığını denetleyin. Her ikisi de eşdeğer olduğunda true döndür veya eşdeğer olmadığında false döndür.

equals('<object1>', '<object2>')
Parametre Zorunlu Türü Açıklama
<object1>, <object2> Yes Çeşitli Karşılaştıracak değerler, ifadeler veya nesneler
Dönüş değeri Type Açıklama
true veya false Boolean Her ikisi de eşdeğer olduğunda true döndürür. Eşdeğer olmadığında false döndürür.

Örnek

Bu örnekler, belirtilen girişlerin eşdeğer olup olmadığını denetler.

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 döndürür true.
  • İkinci örnek: her iki değer de eşdeğer olmadığından işlevi döndürür false.

Birinci

Bir dizeden veya diziden ilk öğeyi döndürür.

first('<collection>')
first([<collection>])
Parametre Zorunlu Türü Açıklama
<Koleksiyon> Yes Dize veya Dizi İlk öğenin bulunacağı koleksiyon
Dönüş değeri Type Açıklama
<ilk koleksiyon öğesi> Tümü Koleksiyondaki ilk öğe

Örnek

Bu örnekler, bu koleksiyonlardaki ilk öğeyi bulur:

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

Ve şu sonuçları döndür:

  • İlk örnek: "h"
  • İkinci örnek: 0

kayan noktalı sayı

Kayan nokta numarası için dize sürümünü gerçek bir kayan nokta numarasına dönüştürün.

float('<value>')
Parametre Zorunlu Türü Açıklama
<value> Yes String Dönüştürülecek geçerli kayan noktalı sayıya sahip dize
Dönüş değeri Type Açıklama
<float-value> Satışa Arz 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öndürür.

formatDateTime('<timestamp>', '<format>'?)
Parametre Zorunlu Türü Açıklama
<Zaman damgası> Yes String Zaman damgasını içeren dize
<format> Hayır String Tek biçim tanımlayıcısı 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önüş değeri Type Açıklama
<yeniden biçimlendirilmiş zaman damgası> String Belirtilen biçimde güncelleştirilmiş zaman damgası

Ö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 döndürür.

getFutureTime(<interval>, <timeUnit>, <format>?)
Parametre Zorunlu Türü Açıklama
<interval> Yes Tamsayı Eklenecek belirtilen zaman birimi sayısı
<timeUnit> Yes String Aralıkla kullanılacak zaman birimi: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format> Hayır String Tek biçim tanımlayıcısı 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önüş değeri Type Açıklama
<güncelleştirilmiş zaman damgası> String 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ı eksi belirtilen zaman birimlerini döndürür.

getPastTime(<interval>, <timeUnit>, <format>?)
Parametre Zorunlu Türü Açıklama
<interval> Yes Tamsayı Çıkarılabilmesi için belirtilen zaman birimi sayısı
<timeUnit> Yes String Aralıkla kullanılacak zaman birimi: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format> Hayır String Tek biçim tanımlayıcısı 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önüş değeri Type Açıklama
<güncelleştirilmiş zaman damgası> String 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"

greater

İlk değerin ikinci değerden büyük olup olmadığını denetleyin. İlk değer daha fazla olduğunda true döndür veya daha az olduğunda false döndür.

greater(<value>, <compareTo>)
greater('<value>', '<compareTo>')
Parametre Zorunlu Türü Açıklama
<value> Yes Integer, Float veya String İkinci değerden büyük olup olmadığını denetlemek için ilk değer
<compareTo> Yes Sırasıyla Integer, Float veya String Karşılaştırma değeri
Dönüş değeri Type Açıklama
true veya false Boolean İlk değer ikinci değerden büyük olduğunda true değerini döndürür. İlk değer ikinci değere eşit veya ondan küçük olduğunda false döndürür.

Örnek

Bu örnekler, ilk değerin ikinci değerden büyük olup olmadığını denetler:

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

Ve şu sonuçları döndür:

  • İlk örnek: true
  • İkinci örnek: false

greaterOrEquals

İlk değerin ikinci değerden büyük veya buna eşit olup olmadığını denetleyin. İlk değer daha büyük veya eşit olduğunda true döndür veya ilk değer daha az olduğunda false döndür.

greaterOrEquals(<value>, <compareTo>)
greaterOrEquals('<value>', '<compareTo>')
Parametre Zorunlu Türü Açıklama
<value> Yes Integer, Float veya String İkinci değerden büyük veya buna eşit olup olmadığını denetlemek için ilk değer
<compareTo> Yes Sırasıyla Integer, Float veya String Karşılaştırma değeri
Dönüş değeri Type Açıklama
true veya false Boolean İlk değer ikinci değerden büyük veya buna eşit olduğunda true döndürür. İ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 mü yoksa eşit mi olduğunu denetler:

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

Ve şu sonuçları döndür:

  • İlk örnek: true
  • İkinci örnek: false

guid

Dize olarak genel olarak benzersiz bir tanımlayıcı (GUID) oluşturun, ö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 Zorunlu Türü Açıklama
<format> Hayır String Döndürülen GUID için tek biçim tanımlayıcısı . Varsayılan olarak, biçim "D"dir, ancak "N", "D", "B", "P" veya "X" kullanabilirsiniz.
Dönüş değeri Type Açıklama
<GUID değeri> String Rastgele oluşturulan GUID

Örnek

Bu örnek aynı GUID'yi oluşturur, ancak tirelerle ayrılmış ve parantez içine alınmış 32 basamak olarak oluşturur:

guid('P')

Ve şu sonucu döndürür: "(c2ecc88d-88c8-4096-912c-d6f2e2b138ce)"

eğer

İfadenin doğru mu yoksa yanlış mı olduğunu denetleyin. Sonucu temel alarak, belirtilen değeri döndürür.

if(<expression>, <valueIfTrue>, <valueIfFalse>)
Parametre Zorunlu Türü Açıklama
<Ifa -de> Yes Boolean Denetlenecek ifade
<valueIfTrue> Yes Tümü İfade true olduğunda döndürülecek değer
<valueIfFalse> Yes Tümü İfade false olduğunda döndürülecek değer
Dönüş değeri Type Açıklama
<specified-return-value> Tümü İfadenin doğru mu yoksa yanlış mı olduğuna bağlı olarak döndüren belirtilen değer

Örnek

Belirtilen ifade true döndürdüğünden bu örnek döndürür "yes" . Aksi takdirde, örnek döndürür "no":

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

ındexof

Bir alt dize için başlangıç konumunu veya dizin değerini döndürür. Bu işlev büyük/küçük harfe duyarlı değildir ve dizinler 0 sayısıyla başlar.

indexOf('<text>', '<searchText>')
Parametre Zorunlu Türü Açıklama
<text> Evet String Bulunabilecek alt dizeye sahip dize
<searchText> Yes String Bulunacak alt dize
Dönüş değeri Type Açıklama
<dizin değeri> Tamsayı Belirtilen alt dize için başlangıç konumu veya dizin değeri.

Dize bulunamazsa -1 sayısını döndürür.

Örnek

Bu örnek, "hello world" dizesindeki "world" alt dizesi için başlangıç dizini değerini bulur:

indexOf('hello world', 'world')

Ve şu sonucu döndürür: 6

int

Bir dize için tamsayı sürümünü döndürür.

int('<value>')
Parametre Zorunlu Türü Açıklama
<value> Yes String Dönüştürülecek dize
Dönüş değeri Type Açıklama
<tamsayı sonucu> Tamsayı Belirtilen dize için 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 veya XML için JavaScript Nesne Gösterimi (JSON) türü değerini veya nesnesini döndürür.

json('<value>')
Parametre Zorunlu Türü Açıklama
<value> Yes Dize veya XML Dönüştürülecek dize veya XML
Dönüş değeri Type Açıklama
<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'yi 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 öğeleri içeren bir koleksiyon döndürür. Sonuçta görünmesi için, bu işleve geçirilen tüm koleksiyonlarda bir öğenin görünmesi gerekir. Bir veya daha fazla öğe aynı ada sahipse, sonuçta bu ada sahip son öğe görüntülenir.

intersection([<collection1>], [<collection2>], ...)
intersection('<collection1>', '<collection2>', ...)
Parametre Zorunlu Türü Açıklama
<collection1>, <collection2>, ... Yes Dizi veya Nesne, ancak ikisini birden değil Yalnızca ortak öğeleri istediğiniz koleksiyonlar
Dönüş değeri Type Açıklama
<ortak öğeler> Sırasıyla Dizi veya Nesne Belirtilen koleksiyonlar arasında yalnızca ortak öğeleri olan bir koleksiyon

Örnek

Bu örnek, bu dizilerdeki ortak öğeleri bulur:

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

Ve yalnızca şu öğeleri içeren bir dizi döndürür:[1, 2]

join

Bir dizideki tüm öğeleri içeren ve her karakteri bir sınırlayıcıyla ayrılmış olan bir dize döndürür.

join([<collection>], '<delimiter>')
Parametre Zorunlu Türü Açıklama
<Koleksiyon> Yes Dizi Birleştirecek öğeleri içeren dizi
<Sınırlayıcı> Yes String Sonuçta elde edilen dizedeki her karakter arasında görünen ayırıcı
Dönüş değeri Type Açıklama
<char1><sınırlayıcı><char2><sınırlayıcısı>... String Belirtilen dizideki tüm öğelerden oluşturulan sonuç dizesi

Örnek

Bu örnek, bu dizideki tüm öğelerden sınırlayıcı olarak belirtilen karaktere sahip bir dize oluşturur:

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

Ve şu sonucu döndürür: "a.b.c"

Sonuncu

Koleksiyondaki son öğeyi döndürür.

last('<collection>')
last([<collection>])
Parametre Zorunlu Türü Açıklama
<Koleksiyon> Yes Dize veya Dizi Son öğenin bulunacağı koleksiyon
Dönüş değeri Type Açıklama
<son koleksiyon öğesi> Sırasıyla Dize veya Dizi Koleksiyondaki son öğe

Örnek

Bu örnekler, bu koleksiyonlardaki 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şumu için başlangıç konumunu veya dizin değerini döndürür. Bu işlev büyük/küçük harfe duyarlı değildir ve dizinler 0 sayısıyla başlar.

lastIndexOf('<text>', '<searchText>')
Parametre Zorunlu Türü Açıklama
<text> Evet String Bulunabilecek alt dizeye sahip dize
<searchText> Yes String Bulunacak alt dize
Dönüş değeri Type Açıklama
<ending-index-value> Tamsayı Belirtilen alt dizenin son oluşumu için başlangıç konumu veya dizin değeri.

Dize bulunamazsa -1 sayısını döndürür.

Örnek

Bu örnek, "hello world" dizesindeki "world" alt dizesinin son oluşumu için başlangıç dizini değerini bulur:

lastIndexOf('hello world', 'world')

Ve şu sonucu döndürür: 6

uzunluk

Koleksiyondaki öğe sayısını döndürür.

length('<collection>')
length([<collection>])
Parametre Zorunlu Türü Açıklama
<Koleksiyon> Yes Dize veya Dizi Sayacak öğeleri içeren koleksiyon
Dönüş değeri Type Açıklama
<uzunluk veya sayı> Tamsayı Koleksiyondaki öğe sayısı

Örnek

Bu örnekler, bu koleksiyonlardaki öğe sayısını sayar:

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

Ve şu sonucu döndür: 4

less

İlk değerin ikinci değerden küçük olup olmadığını denetleyin. İlk değer daha az olduğunda true değerini veya ilk değer daha fazla olduğunda false değerini döndürür.

less(<value>, <compareTo>)
less('<value>', '<compareTo>')
Parametre Zorunlu Türü Açıklama
<value> Yes Integer, Float veya String İkinci değerden küçük olup olmadığını denetlemek için ilk değer
<compareTo> Yes Sırasıyla Integer, Float veya String Karşılaştırma öğesi
Dönüş değeri Type Açıklama
true veya false Boolean İlk değer ikinci değerden küçük olduğunda true değerini döndürür. İlk değer ikinci değere eşit veya ondan büyük olduğunda false döndürür.

Örnek

Bu örnekler, ilk değerin ikinci değerden küçük olup olmadığını denetler.

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

Ve şu sonuçları döndür:

  • İlk örnek: true
  • İkinci örnek: false

lessOrEquals

İlk değerin ikinci değerden küçük veya buna eşit olup olmadığını denetleyin. İlk değer küçük veya eşit olduğunda true döndür veya ilk değer daha fazla olduğunda false döndür.

lessOrEquals(<value>, <compareTo>)
lessOrEquals('<value>', '<compareTo>')
Parametre Zorunlu Türü Açıklama
<value> Yes Integer, Float veya String İkinci değerden küçük veya buna eşit olup olmadığını denetlemek için ilk değer
<compareTo> Yes Sırasıyla Integer, Float veya String Karşılaştırma öğesi
Dönüş değeri Type Açıklama
true veya false Boolean İlk değer ikinci değerden küçük veya buna eşit olduğunda true döndürür. İ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ı denetler.

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

Ve şu sonuçları döndür:

  • İlk örnek: true
  • İkinci örnek: false

max

Her iki uçta da dahil sayılar içeren bir listeden veya diziden en yüksek değeri döndürür.

max(<number1>, <number2>, ...)
max([<number1>, <number2>, ...])
Parametre Zorunlu Türü Açıklama
<sayı1>, <sayı2>, ... Yes Integer, Float veya her ikisi En yüksek değeri almak istediğiniz sayı kümesi
[<sayı1>, <sayı2>, ...] Yes Dizi - Tamsayı, Kayan veya her ikisi En yüksek değeri almak istediğiniz sayı dizisi
Dönüş değeri Type Açıklama
<maksimum değer> Tamsayı veya Kayan Nokta Belirtilen dizideki veya sayı kümesindeki en yüksek değer

Örnek

Bu örnekler, sayı kümesinden ve diziden en yüksek değeri alır:

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

Ve şu sonucu döndür: 3

dk

Bir sayı veya dizi kümesinden en düşük değeri döndürür.

min(<number1>, <number2>, ...)
min([<number1>, <number2>, ...])
Parametre Zorunlu Türü Açıklama
<sayı1>, <sayı2>, ... Yes Integer, Float veya her ikisi En düşük değeri almak istediğiniz sayı kümesi
[<sayı1>, <sayı2>, ...] Yes Dizi - Tamsayı, Kayan veya her ikisi En düşük değeri almak istediğiniz sayı dizisi
Dönüş değeri Type Açıklama
<min-value> Tamsayı veya Kayan Nokta Belirtilen sayı kümesindeki veya belirtilen dizideki en düşük değer

Örnek

Bu örnekler, sayı kümesindeki ve dizideki en düşük değeri alır:

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

Ve şu sonucu döndür: 1

mod

Bir sayıyı başka bir sayıya bölmeden kalan değeri döndürür. Tamsayı bölme için bkz . div().

mod(<dividend>, <divisor>)
Parametre Zorunlu Türü Açıklama
<Temettü> Yes Tamsayı veya Kayan Nokta Bölen tarafından bölünecek sayı
<Bölen> Yes Tamsayı veya Kayan Nokta Temettü bölen sayıdır. Sıfır bölen değeri çalışma zamanında hataya neden olur.
Dönüş değeri Type Açıklama
<modül sonucu> Tamsayı veya Kayan Nokta Geri kalanın ilk sayıyı ikinci sayıya bölmesi

Örnek

Bu örnek, ilk sayı ikinci sayıya bölündüğünde kalan değeri hesaplar:

mod(3, 2)

Ve şu sonucu döndürür: 1

Mul

Ürünü iki sayının çarpımından döndür.

mul(<multiplicand1>, <multiplicand2>)
Parametre Zorunlu Türü Açıklama
<multiplicand1> Yes Tamsayı veya Kayan Nokta Multiplicand2 ile çarpacak sayı
<multiplicand2> Yes Tamsayı veya Kayan Nokta Multiplicand1'i çarpan sayı
Dönüş değeri Type Açıklama
<ürün sonucu> Tamsayı veya Kayan Nokta Ürünün ilk sayıyı ikinci sayıyla çarpması

Örnek

Bu örnekler ilk sayıyı ikinci sayıyla çarpıyor:

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

Ve şu sonuçları döndür:

  • İlk örnek: 2
  • İkinci örnek 3

not

İfadenin false olup olmadığını denetleyin. İfade false olduğunda true döndür veya true olduğunda false döndür.

not(<expression>)
Parametre Zorunlu Türü Açıklama
<Ifa -de> Yes Boolean Denetlenecek ifade
Dönüş değeri Type Açıklama
true veya false Boolean İfade false olduğunda true değerini döndürür. İfade true olduğunda false döndürür.

Örnek 1

Bu örnekler, belirtilen ifadelerin yanlış olup olmadığını denetler:

not(false)
not(true)

Ve şu sonuçları döndür:

  • İlk örnek: İfade false olduğundan işlevi döndürür true.
  • İkinci örnek: İfade true olduğundan işlevi döndürür false.

Örnek 2

Bu örnekler, belirtilen ifadelerin yanlış olup olmadığını denetler:

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

Ve şu sonuçları döndür:

  • İlk örnek: İfade false olduğundan işlevi döndürür true.
  • İkinci örnek: İfade true olduğundan işlevi döndürür false.

veya

En az bir ifadenin doğru olup olmadığını denetleyin. En az bir ifade true olduğunda true döndür veya her ikisi de yanlış olduğunda false döndür.

or(<expression1>, <expression2>)
Parametre Zorunlu Türü Açıklama
<ifade1>, <ifade2> Yes Boolean Denetlenecek ifadeler
Dönüş değeri Type Açıklama
true veya false Boolean En az bir ifade true olduğunda true değerini döndürür. 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ı denetler:

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

Ve şu sonuçları döndür:

  • İlk örnek: En az bir ifade true olduğundan işlevi döndürür true.
  • İkinci örnek: her iki ifade de false olduğundan işlevi döndürür false.

Örnek 2

Bu örnekler en az bir ifadenin doğru olup olmadığını denetler:

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

Ve şu sonuçları döndür:

  • İlk örnek: En az bir ifade true olduğundan işlevi döndürür true.
  • İkinci örnek: her iki ifade de false olduğundan işlevi döndürür false.

rand

Belirtilen aralıktan rastgele bir tamsayı döndürür; bu yalnızca başlangıç sonunda dahil edilir.

rand(<minValue>, <maxValue>)
Parametre Zorunlu Türü Açıklama
<Minvalue> Yes Tamsayı Aralıktaki en düşük tamsayı
<Maxvalue> Yes Tamsayı İşlevin döndürebileceği aralıktaki en yüksek tamsayıyı izleyen tamsayı
Dönüş değeri Type Açıklama
<rastgele sonuç> Tamsayı Belirtilen aralıktan döndürülen rastgele tamsayı. Her çağrının rand() benzersiz bir sonuç oluşturacağını, yani çıkış izlemede gözlemlediğiniz değerin gerçek çalışma zamanında aynı olmayabileceğini unutmayın.

Örnek

Bu örnek, belirtilen aralıktan rastgele bir tamsayı alır ve en büyük değer hariç:

rand(1, 5)

Sonuç olarak şu sayılardan birini döndürür: 1, 2, 3veya 4

aralık

Belirtilen bir tamsayıdan başlayan bir tamsayı dizisi döndürür.

range(<startIndex>, <count>)
Parametre Zorunlu Türü Açıklama
<Startındex> Yes Tamsayı Diziyi ilk öğe olarak başlatan bir tamsayı değeri
<count> Yes Tamsayı Dizideki tamsayı sayısı
Dönüş değeri Type Açıklama
[<aralık-sonuç>] Dizi Belirtilen dizinden başlayan 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]

replace

Bir alt dizeyi belirtilen dizeyle değiştirin ve sonuç dizesini döndürin. Bu işlev büyük/küçük harfe duyarlıdır.

replace('<text>', '<oldText>', '<newText>')
Parametre Zorunlu Türü Açıklama
<text> Evet String Değiştirilecek alt dizeye sahip dize
<oldText> Yes String Değiştirilecek alt dize
<newText> Yes String Değiştirme dizesi
Dönüş değeri Type Açıklama
<güncelleştirilmiş metin> String Alt dize değiştirildikten sonra güncelleştirilmiş dize

Alt dize bulunamazsa özgün dizeyi döndürür.

Örnek

Bu örnek, "eski dize" içindeki "eski" alt dizesini bulur ve "eski" yerine "yeni" ifadesini koyar:

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

Ve şu sonucu döndürür: "the new string"

skip

Bir koleksiyonun önünden öğeleri kaldırın ve diğer tüm öğeleri döndürin.

skip([<collection>], <count>)
Parametre Zorunlu Türü Açıklama
<Koleksiyon> Yes Dizi Öğelerini kaldırmak istediğiniz koleksiyon
<count> Yes Tamsayı Önde kaldırılacak öğe sayısı için pozitif bir tamsayı
Dönüş değeri Type Açıklama
[<updated-collection>] Dizi Belirtilen öğeler kaldırıldıktan sonra güncelleştirilmiş koleksiyon

Örnek

Bu örnek, belirtilen dizinin önünden 0 sayısındaki bir öğeyi kaldırır:

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

Ve kalan öğelerle birlikte bu diziyi döndürür: [1,2,3]

split

Belirtilen sınırlayıcının her oluşumunda bir dizeyi bölerek sonuçta elde edilen alt dizeleri bir dizinin öğeleri olarak döndürür. Sınırlayıcı genellikle tek bir karakterdir, ancak çok karakterli sınırlayıcılar desteklenir.

split('<text>', '<delimiter>')
Parametre Zorunlu Türü Açıklama
<text> Evet String Alt dizelere ayrılacak dize
<Sınırlayıcı> Yes String Sınırlayıcı olarak kullanılacak dize
Dönüş değeri Type Açıklama
[<substring1,substring2><>,...] Dizi Özgün dizenin alt dizelerini içeren bir dizi

Örnek

Bu örnek, "_" sınırlayıcısını temel alan "a_b_c" dizesinin alt dizelerini içeren bir dizi döndürür:

split('a_b_c', '_')

Döndürülen dizi: ["a","b","c"]

startOfDay

Zaman damgası için günün başlangıcını döndürür.

startOfDay('<timestamp>', '<format>'?)
Parametre Zorunlu Türü Açıklama
<Zaman damgası> Yes String Zaman damgasını içeren dize
<format> Hayır String Tek biçim tanımlayıcısı 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önüş değeri Type Açıklama
<güncelleştirilmiş zaman damgası> String Belirtilen zaman damgası ancak gün için sıfır saat işaretinden 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"

startOfHour

Zaman damgası için saatin başlangıcını döndürür.

startOfHour('<timestamp>', '<format>'?)
Parametre Zorunlu Türü Açıklama
<Zaman damgası> Yes String Zaman damgasını içeren dize
<format> Hayır String Tek biçim tanımlayıcısı 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önüş değeri Type Açıklama
<güncelleştirilmiş zaman damgası> String Belirtilen zaman damgası ancak saat için sıfır dakika işaretinden başlıyor

Örnek

Bu örnek, bu zaman damgası için saatin 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

Zaman damgası için ayın başlangıcını döndürür.

startOfMonth('<timestamp>', '<format>'?)
Parametre Zorunlu Türü Açıklama
<Zaman damgası> Yes String Zaman damgasını içeren dize
<format> Hayır String Tek biçim tanımlayıcısı 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önüş değeri Type Açıklama
<güncelleştirilmiş zaman damgası> String Belirtilen zaman damgası ancak ayın ilk günü sıfır saat işaretiyle başlıyor

Ö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

Dizenin belirli bir alt dizeyle başlayıp başlamadığını denetleyin. Alt dize bulunduğunda true döndür veya bulunamadığında false döndür. Bu işlev büyük/küçük harfe duyarlı değildir.

startsWith('<text>', '<searchText>')
Parametre Zorunlu Türü Açıklama
<text> Evet String Denetlenecek dize
<searchText> Yes String Bulunacak başlangıç dizesi
Dönüş değeri Type Açıklama
true veya false Boolean Başlangıç alt dizesi bulunduğunda true değerini döndürür. Bulunamadığında false döndürür.

Örnek 1

Bu örnek, "hello world" dizesinin "hello" alt dizesiyle başlayıp başlamadığı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şlayıp başlamadığını denetler:

startsWith('hello world', 'greetings')

Ve şu sonucu döndürür: false

Dize

Bir değerin dize sürümünü döndürür.

string(<value>)
Parametre Zorunlu Türü Açıklama
<value> Yes Tümü Dönüştürülecek değer
Dönüş değeri Type Açıklama
<dize-değer> String Belirtilen değer için dize sürümü

Örnek 1

Bu örnek, bu sayı 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

Bir sayıyı başka bir numaradan çıkarmaktan elde edilen sonucu döndürür.

sub(<minuend>, <subtrahend>)
Parametre Zorunlu Türü Açıklama
<minuend> Yes Tamsayı veya Kayan Nokta Çıkarmanın çıkarıldığı sayı
<Subtrahend> Yes Tamsayı veya Kayan Nokta Minuend'den çıkarılmış sayı
Dönüş değeri Type Tanım
<Sonuç> Tamsayı veya Kayan Nokta İkinci sayıyı ilk sayıdan çıkarma sonucu

Örnek

Bu örnek, ikinci sayıyı ilk sayıdan çıkarır:

sub(10.3, .3)

Ve şu sonucu döndürür: 10

Dize

Belirtilen konumdan veya dizinden başlayarak dizedeki karakterleri döndürür. Dizin değerleri 0 sayısıyla başlar.

substring('<text>', <startIndex>, <length>)
Parametre Zorunlu Türü Açıklama
<text> Evet String 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ı
<length> Yes Tamsayı Alt dizede olmasını istediğiniz pozitif karakter sayısı
Dönüş değeri Type Açıklama
<alt dize sonucu> String 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ş karakterlik bir alt dize oluşturur:

substring('hello world', 6, 5)

Ve şu sonucu döndürür: "world"

subtractFromTime

Zaman damgasından bir dizi zaman birimini çıkarın. Ayrıca bkz. getPastTime.

subtractFromTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?)
Parametre Zorunlu Türü Açıklama
<Zaman damgası> Yes String Zaman damgasını içeren dize
<interval> Yes Tamsayı Çıkarılabilmesi için belirtilen zaman birimi sayısı
<timeUnit> Yes String Aralıkla kullanılacak zaman birimi: "Second", "Minute", "Hour", "Day", "Week", "Month", "Year"
<format> Hayır String Tek biçim tanımlayıcısı 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önüş değeri Type Açıklama
<güncelleştirilmiş zaman damgası> String 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 döndürme.

take('<collection>', <count>)
take([<collection>], <count>)
Parametre Zorunlu Türü Açıklama
<Koleksiyon> Yes Dize veya Dizi Öğelerini istediğiniz koleksiyon
<count> Yes Tamsayı Önden istediğiniz öğe sayısı için pozitif bir tamsayı
Dönüş değeri Type Açıklama
<alt küme veya [<alt küme>]> Sırasıyla Dize veya Dizi Özgün koleksiyonun önünden alınan belirtilen sayıda öğe içeren bir dize veya dizi

Örnek

Bu örnekler, bu koleksiyonların önünde belirtilen sayıda öğeyi alır:

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

Ve şu sonuçları döndür:

  • İlk örnek: "abc"
  • İkinci örnek: [0, 1, 2]

Ticks

ticks Belirtilen bir zaman damgası için özellik değerini döndürür. Onay işareti 100 nanosaniyelik bir aralıktır.

ticks('<timestamp>')
Parametre Zorunlu Türü Açıklama
<Zaman damgası> Yes String Zaman damgasının dizesi
Dönüş değeri Type Açıklama
<ticks-number> Tamsayı Giriş zaman damgasından bu yana Gregoryen takvimde 12:00:00 gece yarısından, 1 Ocak 0001'den bu yana geçen değer sayısı

Tolower

Küçük harf biçiminde bir dize döndürür. Dizedeki bir karakter küçük harfli bir sürüme sahip değilse, döndürülen dizede bu karakter değişmeden kalır.

toLower('<text>')
Parametre Zorunlu Türü Açıklama
<text> Evet String Küçük harf biçiminde döndürülecek dize
Dönüş değeri Type Açıklama
<küçük harfli metin> String Küçük harf biçimindeki özgün dize

Ö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 karakter büyük harfli bir sürüme sahip değilse, döndürülen dizede bu karakter değişmeden kalır.

toUpper('<text>')
Parametre Zorunlu Türü Açıklama
<text> Evet String Büyük harf biçiminde döndürülecek dize
Dönüş değeri Type Açıklama
<büyük harfli metin> String Büyük harf biçimindeki özgün dize

Ö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 baştaki ve sondaki boşluğu kaldırın ve güncelleştirilmiş dizeyi döndürin.

trim('<text>')
Parametre Zorunlu Türü Açıklama
<text> Evet String Kaldırılacak baştaki ve sondaki boşluklara sahip dize
Dönüş değeri Type Açıklama
<updatedText> String Özgün dize için başında veya sonunda boşluk olmadan güncelleştirilmiş bir sürüm

Örnek

Bu örnek, " " Merhaba Dünya " dizesinden baştaki ve sondaki boşluğu kaldırır:

trim(' Hello World  ')

Ve şu sonucu döndürür: "Hello World"

birleşim

Belirtilen koleksiyonlardan tüm öğeleri içeren bir koleksiyon döndürür. Sonuçta bir öğe, bu işleve geçirilen herhangi bir koleksiyonda görüntülenebilir. Bir veya daha fazla öğe aynı ada sahipse, sonuçta bu ada sahip son öğe görüntülenir.

union('<collection1>', '<collection2>', ...)
union([<collection1>], [<collection2>], ...)
Parametre Zorunlu Türü Açıklama
<collection1>, <collection2>, ... Yes Dizi veya Nesne, ancak ikisini birden değil Tüm öğeleri istediğiniz koleksiyonlar
Dönüş değeri Type Açıklama
<updatedCollection> Sırasıyla Dizi veya Nesne Belirtilen koleksiyonlardan tüm öğeleri içeren 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 güvenli olmayan karakterleri kaçış karakterleriyle değiştirerek bir dize için tekdüzen kaynak tanımlayıcısı (URI) kodlanmış bir sürüm döndürebilirsiniz. EncodeUriComponent() yerine bu işlevi kullanın. Her iki işlev de aynı şekilde çalışsa da tercih uriComponent() edilir.

uriComponent('<value>')
Parametre Zorunlu Türü Açıklama
<value> Yes String URI ile kodlanmış biçime dönüştürülecek dize
Dönüş değeri Type Açıklama
<kodlanmış uri> String Kaçış karakterleri içeren URI ile kodlanmış dize

Örnek

Bu örnek, bu dize için URI ile kodlanmış bir sürüm oluşturur:

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

Ve şu sonucu döndürür: "http%3A%2F%2Fcontoso.com"

uriComponentToBinary

Tekdüzen kaynak tanımlayıcısı (URI) bileşeni için ikili sürümü döndürür.

uriComponentToBinary('<value>')
Parametre Zorunlu Türü Açıklama
<value> Yes String Dönüştürülecek URI ile kodlanmış dize
Dönüş değeri Type Açıklama
<binary-for-encoded-uri> String URI ile kodlanmış dizenin ikili sürümü. İkili içerik base64 ile kodlanmış ve tarafından $contenttemsil edilir.

Örnek

Bu örnek, bu URI kodlu 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"

uriComponentToString

Tekdüzen kaynak tanımlayıcısı (URI) kodlanmış bir dizenin dize sürümünü döndürerek URI ile kodlanmış dizenin kodunu etkili bir şekilde çözebilirsiniz.

uriComponentToString('<value>')
Parametre Zorunlu Türü Açıklama
<value> Yes String Kodu çözmek için URI ile kodlanmış dize
Dönüş değeri Type Açıklama
<kod çözme uri'si> String URI ile kodlanmış dize için kodu çözülen sürüm

Örnek

Bu örnek, bu URI ile kodlanmış dize için kod çözülen 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 Zorunlu Türü Açıklama
<format> Hayır String Tek biçim tanımlayıcısı 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önüş değeri Type Açıklama
<geçerli zaman damgası> String Geçerli tarih ve saat

Örnek 1

Bugünün 15 Nisan 2018 saat 13:00:00 olduğunu varsayalım. Bu örnek geçerli zaman damgasını alır:

utcNow()

Ve şu sonucu döndürür: "2018-04-15T13:00:00.0000000Z"

Örnek 2

Bugünün 15 Nisan 2018 saat 13:00:00 olduğunu varsayalım. Bu örnek, isteğe bağlı "D" biçimini kullanarak geçerli zaman damgasını alı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ür.

xml('<value>')
Parametre Zorunlu Türü Açıklama
<value> Yes String Dönüştürülecek JSON nesnesini içeren dize

JSON nesnesinin tek bir kök özelliği olmalıdır ve bu bir dizi olamaz.
Çift tırnak işareti (") için kaçış karakteri olarak ters eğik çizgi karakterini (\) kullanın.
Dönüş değeri Type Açıklama
<xml sürümü> Object Belirtilen dize veya JSON nesnesi için kodlanmış XML

Örnek 1

Bu örnek, bu dize için JSON nesnesi içeren XML sürümünü oluşturur:

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

Ve şu sonuç XML'lerini 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 şu sonuç XML'lerini döndürür:

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

Xpath

XML'de XPath (XML Yol Dili) ifadesiyle eşleşen düğümleri veya değerleri denetleyin ve eşleşen düğümleri veya değerleri döndürin. XPath ifadesi veya yalnızca "XPath", XML içeriğindeki düğümleri veya işlem değerlerini seçebilmeniz için XML belge yapısında gezinmenize yardımcı olur.

xpath('<xml>', '<xpath>')
Parametre Zorunlu Türü Açıklama
<xml> Yes Tümü XPath ifade değeriyle eşleşen düğümleri veya değerleri aramak için XML dizesi
<Xpath> Yes Tümü Eşleşen XML düğümlerini veya değerlerini bulmak için kullanılan XPath ifadesi
Dönüş değeri Type Açıklama
<xml düğümü> XML Belirtilen XPath ifadesiyle yalnızca tek bir düğüm eşleştiğinde xml düğümü
<value> Tümü Belirtilen XPath ifadesiyle yalnızca tek bir değer eşleştiğinde XML düğümündeki değer
[<xml-node1>, <xml-node2>, ...]
-veya-
[<değer1>, <değer2>, ...]		 Dizi Belirtilen XPath ifadesiyle eşleşen XML düğümlerine veya değerlerine sahip bir dizi

Örnek 1

Örnek 1'de aşağıdaki örnekte, bu örnek düğümle eşleşen <count></count> düğümleri bulur ve bu düğüm değerlerini işleviyle sum() 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 ad alanına sahip XML içeren belirtilen bağımsız değişkenlerde düğümle eşleşen <location></location> 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\"]')

  • Expression 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 ifadeleri:

    • /*[name()=\"file\"]/*[name()=\"location\"]

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

Düğümle 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 düğümdeki <location></location> değer bulunur:

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

Ve şu sonucu döndürür: "Paris"

Not

Veri akışı ifadelerine açıklama ekleyebilir, ancak işlem hattı ifadelerine ekleyemezsiniz.

İlgili içerik

İfadelerde kullanabileceğiniz sistem değişkenlerinin listesi için bkz . Sistem değişkenleri.