Microsoft Fabric'te Data Factory için ifadeler ve işlevler

Makale
12/18/2024

Bu makalede, Microsoft Fabric'te Data Factory tarafından desteklenen ifadeler ve işlevler hakkında ayrıntılar sağlanır.

İfadeler

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

"value"

veya

"@pipeline().parameters.password"

İfadeler bir dize değerinin herhangi bir yerinde görünebilir ve her zaman başka bir dize değeriyle sonuçlanabilir. Değer 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.

İfade değeri	Result
"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: "First Name: @{pipeline().parameters.firstName} Last Name: @{pipeline().parameters.lastName}"

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

İfade değeri	Result
"@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ür`42`.
"@{pipeline().parameters.myNumber}"	Dize olarak döndürür`42`.
"Yanıt: @{pipeline().parameters.myNumber}"	dizesini `Answer is: 42`dö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 10 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.

Dosya adına Tarih Ekle: @concat('Test_', formatDateTime(utcnow(), 'yyyy-dd-MM'))
Müşteri saat diliminde DateTime ekleme: @concat('Test_', convertFromUtc(utcnow(), 'Pacific Standard Time'))
Ekleme Tetikleyici Zamanı: @concat('Test_', pipeline().TriggerTime)
Tarihe sahip tek bir dosyaya çıkış yaparken Eşleme Veri Akışı özel bir dosya adı çıktısını alma:'Test_' + toString(currentDate()) + '.csv'

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

Dinamik içerik düzenleyicisi

Düzenlemeyi bitirdiğinizde, dinamik içerik düzenleyicisi içeriğinizdeki karakterleri otomatik olarak çıkarır. Örneğin, içerik düzenleyicisinde aşağıdaki içerik, bir ifade işleviyle bir dize ilişkilendirmesidir.

"@{toUpper('myData')}"

Dinamik içerik düzenleyicisi yukarıdaki içeriği ifadeye "@{toUpper('myData')}"dönüştürür. Bu ifadenin sonucu aşağıda gösterilmiş biçimlendirilmiş dizedir.

"MYDATA"

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

Özgün dize değerine karşı URL kodlaması
URL ile kodlanmış dizeyi değiştirin; örneğin, satır besleme (%0A), satır başı(%0D), yatay sekme(%09).
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

İşlem hattı kapsam değişkenleri

Bu sistem değişkenlerine işlem hattında herhangi bir yerde başvurulabilir.

Değişken Adı	Açıklama
@pipeline().DataFactory	İşlem hattı çalıştırmasının çalıştığı verilerin veya Synapse çalışma alanının adı
@pipeline().Pipeline	İşlem hattının adı
@pipeline().RunId	Belirli işlem hattı çalıştırmasının kimliği
@pipeline().TriggerId	İşlem hattını çağıran tetikleyicinin kimliği
@pipeline().TriggerName	İşlem hattını çağıran tetikleyicinin adı
@pipeline().TriggerTime	İşlem hattını çağıran tetikleyici çalıştırmasının zamanı. Bu, tetikleyicinin işlem hattı çalıştırmasını çağırmak için tetiklendiği zamandır ve tetikleyicinin zamanlanan zamanından biraz farklı olabilir.
@pipeline().GroupId	İşlem hattı çalıştırmasının ait olduğu grubun kimliği.
@pipeline()?. TriggeredByPipelineName	İşlem hattı çalıştırmasını tetikleyen işlem hattının adı. İşlem hattı çalıştırması bir ExecutePipeline etkinliği tarafından tetiklendiğinde geçerlidir. Başka durumlarda kullanıldığında Null olarak değerlendirin. Ardından soru işaretini not edin @pipeline()
@pipeline()?. TriggeredByPipelineRunId	İşlem hattı çalıştırmasını tetikleyen işlem hattının çalıştırma kimliği. İşlem hattı çalıştırması bir ExecutePipeline etkinliği tarafından tetiklendiğinde geçerlidir. Başka durumlarda kullanıldığında Null olarak değerlendirin. Ardından soru işaretini not edin @pipeline()

Not

Tetikleyiciyle ilgili tarih/saat sistem değişkenleri (hem işlem hattı hem de tetikleyici kapsamlarında) UTC tarihlerini ISO 8601 biçiminde döndürür, örneğin. 2017-06-01T22:20:00.4061448Z

İş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	Özgün dizede belirtilen sınırlayıcı karakterini temel alan daha büyük bir dizeden virgülle ayrılmış alt dizeler içeren bir dizi 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.
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	İki sayıyı 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	kalan iki sayıyı bölmeden geri kalanı 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	İkinci sayıyı ilk numaradan çıkararak 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	Tam sayı	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	Tam sayı	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	Tam sayı	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	Tam sayı	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	Tam sayı	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ü>	Tam sayı	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ü>	Tam sayı	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ü>	Tam sayı	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:

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

İki sayıyı bölerek tamsayı sonucunu döndürür. Kalan sonucu almak için bkz . mod().

div(<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	Kar payını bölen ancak 0 olamaz

Dönüş değeri	Type	Açıklama
<quotient-result>	Tam sayı	İlk sayıyı ikinci sayıya bölmenin sonucu tamsayı

Örnek

Her iki örnek de ilk sayıyı ikinci sayıya böler:

div(10, 5)
div(11, 5)

Ve şu sonucu döndür: 2

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>	Kayan	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	Tam sayı	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	Tam sayı	Çı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>	Tam sayı	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>	Tam sayı	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>	Tam sayı	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ı>	Tam sayı	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

min

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

kalan iki sayıyı bölmeden geri kalanı döndürür. Tamsayı sonucunu almak 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	Kar payını bölen ancak 0 olamaz.

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ıyı ikinci sayıya böler:

mod(3, 2)

Ve şu sonucu döndü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 katlayan 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ıya göre birden çok kez verir:

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	Tam sayı	Aralıktaki en düşük tamsayı
<Maxvalue>	Yes	Tam sayı	İşlevin döndürebileceği aralıktaki en yüksek tamsayıyı izleyen tamsayı

Dönüş değeri	Type	Açıklama
<rastgele sonuç>	Tam sayı	Belirtilen aralıktan döndürülen rastgele tamsayı

Ö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	Tam sayı	Diziyi ilk öğe olarak başlatan bir tamsayı değeri
<count>	Yes	Tam sayı	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.

Ö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	Tam sayı	Ö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

Özgün dizede belirtilen sınırlayıcı karakterine göre virgülle ayrılmış alt dizeler içeren bir dizi döndürür.

split('<text>', '<delimiter>')

Parametre	Zorunlu	Türü	Açıklama
<text>	Evet	String	Özgün dizede belirtilen sınırlayıcıya göre alt dizelere ayrılacak dize
<Sınırlayıcı>	Yes	String	Sınırlayıcı olarak kullanılacak özgün dizedeki karakter

Dönüş değeri	Type	Açıklama
[<substring1,substring2><>,...]	Dizi	Özgün dizeden virgülle ayrılmış alt dizeler içeren bir dizi

Örnek

Bu örnek, sınırlayıcı olarak belirtilen karaktere göre belirtilen dizeden alt dizeler içeren bir dizi oluşturur:

split('a_b_c', '_')

Sonuç olarak şu 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	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

İkinci sayıyı ilk numaradan çıkararak 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	Tam sayı	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	Tam sayı	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	Tam sayı	Çı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	Tam sayı	Ö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>	Tam sayı	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 `$content`temsil 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.

Genel parametre kullanımıyla ilgili yönergeler için bkz . Dokuda Data Factory Parametreleri

Aracılığıyla paylaş

Microsoft Fabric'te Data Factory için ifadeler ve işlevler

İfadeler

Örnekler

Karmaşık ifade örneği

Dinamik içerik düzenleyicisi

Özel karakterleri değiştirme

Tek tırnak karakterinden kaçış

İşlem hattı kapsam değişkenleri

İşlevler

Tarih işlevleri

Dize işlevleri

Koleksiyon işlevleri

Mantıksal işlevler

Dönüştürme işlevleri

Matematik İşlevleri

İşlev başvurusu

add

Adddays

Addhours

Addminutes

Addseconds

addToTime

ve

dizi

base64

base64ToBinary

base64ToString

ikili

ikili

Coalesce

concat

içerir

convertFromUtc

convertTimeZone

convertToUtc

createArray

dataUri

dataUriToBinary

dataUriToString

dayOfMonth

Dayofweek

Dayofyear

decodeBase64

decodeDataUri

decodeUriComponent

div

encodeUriComponent

empty

Endswith

equals

Birinci

kayan noktalı sayı

formatDateTime

getFutureTime

getPastTime

greater

greaterOrEquals

guid

eğer

ındexof

int

json

Kesişim

join

Sonuncu

Lastındexof

uzunluk

less

lessOrEquals

max

min

mod

Mul

not

veya

rand

aralık

replace

skip