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.

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

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

  3. Tetikleyici Süresi Ekleme: @concat('Test_', pipeline().TriggerTime)

  4. 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:

  1. Özgün dize değerine göre URL kodlaması
  2. URL ile kodlanmış dizeyi (örneğin, satır besleme (%0A), satır başı (%0D), yatay sekme(%09) değiştirin.
  3. 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 true döndürür.
  • İkinci örnek: Bir ifade false olduğu için false döndürür.
  • Üçüncü örnek: Her iki ifade de false olduğu için false dö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 true döndürür.
  • İkinci örnek: "abc" dizesini geçtiği için işlevi false dö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 true döndürür.
  • İkinci örnek: Her iki değer de eşdeğer değildir, bu nedenle işlevi false dö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 true döndürür.
  • İkinci örnek: İfade true olduğu için işlevi false dö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 true döndürür.
  • İkinci örnek: İfade true olduğu için işlevi false dö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 true döndürür.
  • İkinci örnek: her iki ifade de false şeklindedir, bu nedenle işlevi false dö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 true döndürür.
  • İkinci örnek: her iki ifade de false şeklindedir, bu nedenle işlevi false dö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.
\Çift tırnak işareti (") için kaçış karakteri olarak ters eğik çizgi karakterini () kullanın.

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.