Text işlevi
Şunlar için geçerlidir:
Tuval uygulamaları Tuval uygulamaları Dataverse formül sütunları Model temelli uygulamalar Power Platform CLI
Herhangi bir değeri dönüştürür ve bir sayı veya tarih/saat değerini bir metin dizesi olarak biçimlendirir.
Açıklama
Text işlevi, sayı veya tarih/saat değerini şu bağımsız değişken türlerinden birine göre biçimlendirir:
- DateTimeFormat numaralandırmasını kullanarak belirttiğiniz, önceden tanımlanmış tarih/saat biçimi. Her kullanıcının diline ve bölgesine göre otomatik olarak ayarlandığından tarihler ve saatler için bu yaklaşım tercih edilir.
- Örneğin, sayıların ondalık ayracı, tarihlerin ayın tam adını, ayı kısaltma olarak veya sayı olarak göstereceğini belirten yer tutucu dizesinden oluşan bir özel biçim. Power Apps, Microsoft Excel'in oluşturduğu yer tutucu alt kümesini destekler. Bu dizede, dil yer tutucusu diğer yer tutucuları yorumlamakta kullanılacak dili belirtir. Örneğin, özel biçim bir nokta içeriyorsa dil biçimi yer tutucusu, noktanın ondalık ayracı mı (ja-JP), yoksa binlik ayracı mı (es-ES) olduğunu belirtir.
Daha fazla bilgi edinmek için bkz. tarihler ve saatler ile çalışma.
Text işlevi her türden veriyi varsayılan biçimi kullanarak metin gösterimine dönüştürebilir. Metin olmayan değerleri Len, Right ve IsMatch gibi metin tabanlı işlevlere geçirmek için bunu kullanın.
Önceden tanımlanmış tarih/saat biçimleri
Bu örnekler için tarih ve saat olarak UTC-7 saat diliminde Salı, Nisan 7, 2020 8:26:59.180 PM kullanılmaktadır.
| DateTimeFormat numaralandırma | Açıklama | Örnekler (en-US kullanarak) |
|---|---|---|
| LongDate | Dört basamaklı yıl, ay adı, ayın günü ve haftanın günü. Ay ve haftanın günü adları kısaltılmaz. | "7 Nisan 2020 Salı" |
| LongDateTime | Dört basamaklı yıl, ay adı, ayın günü ve haftanın gününe ek olarak saat (12 saatlik düzende), dakika, saniye ve AM/PM gösterimi. Ay ve haftanın günü adları kısaltılmaz. | "7 Nisan 2020 Salı 8:26:59 PM" |
| LongDateTime24 | Dört basamaklı yıl, ay, ayın günü ve haftanın gününe ek olarak saat (24 saatlik düzende), dakika ve saniye. Ay ve haftanın günü adları kısaltılmaz. | "7 Nisan 2020 Salı 20:26:59" |
| LongTime | Saat (12 saatlik düzende), dakika, saniye ve AM/PM gösterimi. | "8:26:59 PM" |
| LongTime24 | Saat (24 saatlik düzende), dakika ve saniye. | "20:26:59" |
| ShortDate | Sayısal ay ve ayın günü ile birlikte dört haneli yıl. | "7.4.2020" |
| ShortDateTime | Sayısal ay ve ayın günü ile birlikte dört haneli yıla ek olarak saat (12 saatlik düzende), dakika ve AM/PM gösterimi. | "7.4.2020 8:26 PM" |
| ShortDateTime24 | Sayısal ay ve ayın günü ile birlikte dört haneli yıla ek olarak saat (24 saatlik düzende) ve dakika. | "7.4.2020 20:26" |
| ShortTime | Saat (12 saatlik düzende), dakika ve AM/PM gösterimi. | "8:26 PM" |
| ShortTime24 | Saat (24 saatlik düzende) ve dakika. | "20:26" |
| UTC | Tarih/saat değeri, kullanıcının saat dilimi temel alınarak UTC'ye dönüştürülür ve ISO 8601 standardına göre biçimlendirilir. | "2020-04-08T03:26:59.180Z" |
Sayı yer tutucuları
| Yer tutucu | Açıklama |
|---|---|
| 0 (sıfır) | Sayı, biçimdeki sıfır sayısından daha az basamağa sahipse önemsiz sıfırları görüntüler. Örneğin, 8.9 değerini 8.90 olarak görüntülemek istiyorsanız #.00 biçimini kullanın. |
| # | 0 (sıfır) ile aynı kurallara göre hareket eder. Ancak sayı, ondalığın her iki tarafında, biçimdeki # simgesi sayısından daha az basamağa sahipse Text işlevi başka sıfır değeri döndürmez. Örneğin, özel biçim #.## olduğunda ve biçimlendirilecek sayı 8.9 olduğunda 8.9 görüntülenir. |
| , (nokta) | Sayıdaki ondalık ayracı görüntüler. Bu, özel biçimin diline göre değişiklik gösterir. Daha fazla ayrıntı için bkz. genel uygulamalar. |
| , (virgül) | Bir sayıdaki gruplandırma ayracını görüntüler ve genellikle dört basamaklı sayılar için kullanılır. Biçim, sayı işaretleri (#) veya sıfırlar tarafından çevrelenen bir virgül içeriyorsa Text, grupları virgül yardımıyla ayırır. Bu, özel biçimin diline göre değişiklik gösterir. Daha fazla ayrıntı için bkz. genel uygulamalar. |
Sayıdaki ondalık ayracının sağında, biçimde bulunan yer tutucu sayısından daha fazla basamak varsa sayı, sahip olduğu ondalık basamak sayısı yer tutucu sayısına eşit olacak şekilde yuvarlanır. Sayıdaki ondalık ayracının solundaki basamak sayısı, yer tutucu sayısından fazlaysa ek basamaklar görüntülenir. Biçimdeki ondalık ayracının solunda yalnızca sayı işaretleri (#) bulunuyorsa 1'den küçük olan sayılar ondalık ayracıyla başlar (örneğin, .47).
Tarih ve saat yer tutucuları
| Yer tutucu | Açıklama |
|---|---|
| m | Ay değerini, önünde sıfır olmadan bir sayı olarak görüntüler. |
| mm | Uygun olduğunda ay değerini, önüne sıfır getirilmiş bir sayı olarak görüntüler. |
| mmm | Ay değerini, bir kısaltma (Oca-Ara) olarak görüntüler. |
| mmmm | Ay değerini, tam adıyla (Ocak-Aralık) görüntüler. |
| d | Gün değerini, önünde sıfır olmadan bir sayı olarak görüntüler. |
| dd | Uygun olduğunda gün değerini, önüne sıfır getirilmiş bir sayı olarak görüntüler. |
| ddd | Gün değerini, bir kısaltma (Paz-Cts) olarak görüntüler. |
| dddd | Gün değerini, tam adıyla (Pazar-Cumartesi) görüntüler. |
| yy | Yıl değerini, iki basamaklı bir sayı olarak görüntüler. |
| yyyy | Yıl değerini, dört basamaklı bir sayı olarak görüntüler. |
| h | Saat değerini, önünde sıfır olmadan bir sayı olarak görüntüler. |
| hh | Uygun olduğunda saat değerini, önüne sıfır getirilmiş bir sayı olarak görüntüler. Biçim, AM veya PM gösterimi içeriyorsa saat, 12 saatlik düzende gösterilir. Aksi takdirde saat, 24 saatlik düzende gösterilir. |
| m | Dakika değerini, önünde sıfır olmadan bir sayı olarak görüntüler. Bu yer tutucu h ya da hh kodundan hemen sonra veya ss kodundan hemen önce yer almalıdır; aksi takdirde Text işlevi, dakika yerine ay döndürür. |
| mm | Uygun olduğunda dakika değerini, önüne sıfır getirilmiş bir sayı olarak görüntüler. Bu yer tutucu, h ya da hh yer tutucusundan hemen sonra veya ss yer tutucusundan hemen önce yer almalıdır. Aksi takdirde Text, dakika yerine ayı döndürür. |
| s | Saniye değerini, önünde sıfır olmadan bir sayı olarak döndürür. |
| ss | Uygun olduğunda saniye değerini, önüne sıfır getirilmiş bir sayı olarak görüntüler. |
| f | Saniyelerin kesirlerini görüntüler. |
| AM/PM, a/p | Saati, 12 saatlik düzende görüntüler. Text işlevi, gece yarısından öğleye kadar olan saatler için "AM" veya "a" gösterimlerini döndürürken öğleden gece yarısına kadar olan saatler için "PM" veya "p" gösterimlerini döndürür |
Değişmez yer tutucular
Bu karakterlerden herhangi birini biçim dizenize ekleyebilirsiniz. Bu karakterler, Text işlevinin sonucunda, oldukları gibi görünür. Ek karakterler, gelecekte sunulacak yer tutucular için ayrılmıştır; bu nedenle bu karakterleri kullanmamanız gerekir.
| Karakter | Açıklama |
|---|---|
| Tüm para birimi simgeleri | Dolar işareti, sent işareti, euro işareti vb. |
| + | Artı işareti |
| ( | Sol ayraç |
| : | İki nokta üst üste |
| ^ | İnceltme işareti (şapka karakteri) |
| ' | Kesme işareti |
| { | Sol küme ayracı |
| < | Küçüktür işareti |
| = | Eşittir işareti |
| - | Eksi işareti |
| / | Eğik çizgi işareti |
| ) | Sağ ayraç |
| & | Ve işareti |
| ~ | Tilde |
| } | Sağ küme ayracı |
| > | Büyüktür işareti |
| Boşluk karakteri |
Genel uygulamalar
Text işlevi, genel olarak kullanılabilen bir işlevdir. Bu işlev geniş bir dil yelpazesinde tarihlerin, saatlerin, para birimlerinin ve sayıların düzgün bir şekilde yazılabilmesine olanak sağlar. Text işlevinin kullanılabilmesi için şu iki bilgi gereklidir:
- Özel biçimin dili: Üreticiler için bir özel biçim nasıl yorumlanmalıdır? Ayırıcı karakterler (.ve ,), farklı dillerde farklı görevlerde kullanılır. Özel bir biçim belirtirseniz, bir dil yer tutucusu ekleyebilir veya cihazınızın ayarlandığı dili yansıtan varsayılan değeri alabilirsiniz. Dillerden bağımsız olan önceden tanımlanmış tarih/saat biçimlerinden birinin kullanılması bu işlemi daha da kolay bir hale getirir.
- Sonucun dili: Kullanıcılar için işlev sonucunun hangi dilde görünmelidir? Ay ve iş günü adları, uygulamanın kullanıcısı için uygun dilde olmalıdır; bunu, Text işlevine üçüncü, isteğe bağlı bir bağımsız değişken ekleyerek belirtebilirsiniz.
Her ikisi için de dili bir dil etiketi kullanarak belirtirsiniz. Desteklenen dillerin listesini görmek için sağdaki bölmenin formül çubuğuna veya Gelişmiş sekmesine Text( 1234, "", ) yazın ve üçüncü bağımsız değişken için kaydırma çubuğunu kullanarak önerilen yerel ayar listesinde gezinin.
Dil yer tutucusu
Özel biçimin dilini belirtmek üzere şunu kullanın:
| Yer tutucu | Açıklama |
|---|---|
| [$-LanguageTag] | LanguageTag, Language işlevinden döndürülen dil etiketidir. Dil etiketi, yalnızca bir dili (ör. İngilizce için [$-en]) belirtebileceği gibi bölgeyi (Büyük Britanya'yı ayrıntılı bir şekilde belirtmek için [$-en-GB]) de belirtebilir. |
Dil yer tutucusu, bir kez olmak üzere özel biçimin herhangi bir yerinde görünebilir.
Dil yer tutucusu olmadan özel bir biçim belirtirseniz ve biçim genel anlamda belirsizse geçerli diliniz için dil etiketi otomatik olarak eklenir.
Uygulamanız çalıştırıldığında bu yer tutucu yoksa dil etiketinizin [$-en-US] olduğu varsayılır.
Not
Gelecekte yayımlanacak bir sürümde, Excel'in desteklediği benzer ancak farklı bir yer tutucuyla karıştırılmasını engellemek için bu yer tutucunun sözdizimi değiştirilebilir.
Sonuç dili etiketi
Text işlevinin sonucu ay, haftanın günü ve AM/PM gösterimlerinin yanı sıra uygun grup ve ondalık ayraçları da içerir.
Varsayılan olarak Text işlevi, uygulamayı çalıştıran kullanıcının dilini kullanır. Language işlevi, geçerli kullanıcıya ilişkin dil etiketini döndürür. Text işlevine yönelik üçüncü bağımsız değişken için bir dil etiketi sağlayarak bu varsayılan değeri geçersiz kılabilirsiniz.
Sözdizimi
Text( NumberOrDateTime, DateTimeFormatEnum [, ResultLanguageTag ] )
- NumberOrDateTime - Gerekli. Biçimlendirilecek sayı veya tarih/saat.
- DateTimeFormat - Gerekli. DateTimeFormat numaralandırmasının bir üyesi.
- ResultLanguageTag - İsteğe bağlı. Sonuç metni için kullanılacak dil etiketi. Varsayılan olarak, geçerli kullanıcının dili kullanılır.
Text( NumberOrDateTime, CustomFormat [, ResultLanguageTag ] )
- Number - Gerekli. Biçimlendirilecek sayı veya tarih/saat.
- CustomFormat - Gerekli. Çift tırnak işaretleriyle çevrelenmiş bir veya daha fazla yer tutucu.
- ResultLanguageTag - İsteğe bağlı. Sonuç metni için kullanılacak dil etiketi. Varsayılan olarak, geçerli kullanıcının dili kullanılır.
Text( AnyValue )
- AnyValue - Gerekli. Metin gösterimine dönüştürülecek değer. Varsayılan bir biçim kullanılır.
Text ( Türü Belirtilmemiş )
- Türü belirtilmemiş - Gerekli. Türü belirtilmemiş nesne dize ifade eder. Kabul edilebilir değerler, türü belirtilmemiş sağlayıcıya bağlıdır. JSON için yazılmamış nesne bir sayı veya boolean ise metne dönüştürülecektir.
Örnekler
Aksi belirtilmediyse, bu formülleri çalıştıran kullanıcı, Amerika Birleşik Devletleri'ndedir ve dil olarak İngilizceyi seçmiştir. Language işlevi, "en-US" döndürür.
Numara
| Formül | Açıklama | Sonuç |
|---|---|---|
| Text( 1234.59, "####.#" ) | Sayıyı, bir ondalık basamakla biçimlendirir. | "1234.6" |
| Text( 8.9, "#.000" ) | Gerekirse sayının ondalık kısmını, sona sıfır ekleyerek doldurur. | "8.900" |
| Text( 0.631, "0.#" ) | Gerekirse sayının tamamını, öne sıfır ekleyerek doldurur. | "0.6" |
| Text( 12, "#.0#" ) Text( 1234.568, "#.0#" ) |
Sayının ondalık kısmındaki bir ondalık basamağı sıfır ile doldurur ve sağlanırsa ikinci bir ondalık basamak ekler. | "12.0" "1234.57" |
| Text( 12000, "$ #,###" ) Text( 1200000, "$ #,###" ) |
Her üç basamakta bir binlik ayracı yerleştirir ve para birimi simgesi ekler. | "$ 12,000" "$ 1,200,000" |
Tarih/Zaman
- 23 Kasım 2015 Pazartesi saat 2:37:47 PM
- Amerika Birleşik Devletleri Pasifik Saat Dilimi (UTC-8)
| Formül | Açıklama | Sonuç |
|---|---|---|
| Text( Now(), DateTimeFormat.LongDate ) | Tarih değerini, geçerli kullanıcının dilinde ve yerel ayarında, uzun tarih dizesi olarak biçimlendirir. | "23 Kasım 2015 Pazartesi" |
| Text( Now(), DateTimeFormat.LongDateTime ) | Tarih/saat değerini, geçerli kullanıcının dilinde ve yerel ayarında, 12 saatlik düzende uzun tarih ve saat dizesi olarak biçimlendirir. | "23 Kasım 2015 Pazartesi 2:37:47 PM" |
| Text( Now(), DateTimeFormat.LongTime24 ) | Saat değerini, 24 saatlik düzende uzun saat dizesi olarak biçimlendirir. | "14:37:47" |
| Text( Now(), DateTimeFormat.ShortDate ) | Tarih değerini, geçerli kullanıcının dilinde ve yerel ayarında, kısa tarih dizesi olarak biçimlendirir. | "11/23/2015" |
| Text( Now(), "d-mmm-yy" ) | Aşağıdaki yer tutucu karakterlerini kullanarak biçimlendirir:
|
"23-Kas-15" |
| Text(1448318857*1000, "mmm. dd, yyyy (hh:mm:ss AM/PM)") | Kaynak değeri 1.000'le çarptığınızda insanlar tarafından okunabilen biçimde bir UNIX tarih-saat değeri gösterir. | "23 Kas 2015 (02:47:37 PM)" |
Genel uygulamalar
| Formül | Tanım | Result |
|---|---|---|
| Text(1234567.89, "[$-fr-FR]# ###,## €", "fr-FR") | Boşluğu gruplandırma ayracı olarak, virgülü ondalık ayracı ve € para birimi simgesi olarak gösterir. | "1 234 567,89 €" |
| Text(1234567,89; "[$-fr-FR]# ###,## €") | Kaynak veriler ondalık ayracı olarak virgülü kullanan Fransız geleneğini izliyorsa, yukarıdakiyle aynı sonucu almak için yerel ayarı Fransızcaya çevirmeli ve bağımsız değişkenleri virgül yerine, noktalı virgülle ayırmalısınız. | "1 234 567,89 €" |
| Text( Date(2016,1,31), "dddd mmmm d" ) | Geçerli kullanıcının dilinde haftanın gününü, ayı ve ayın gününü döndürür. Yer tutucuların tümü dilden bağımsız olduğundan biçim metni dil etiketine gerek yoktur. | "Pazar Ocak 31" |
| Text( Date(2016,1,31), "dddd mmmm d", "es-ES" ) | Haftanın gününü, ayı ve ayın gününü "es-ES" dilinde döndürür. | "domingo enero 31" |
Değerleri metne dönüştürme
| Formül | Açıklama | Sonuç |
|---|---|---|
| Text( 1234567.89 ) | Sayıyı bir dizeye dönüştürür. Ondalık ayracından önceki veya sonraki basamakların sayısı üzerinde denetim ya da binler ayracı bulunmamaktadır. Daha fazla denetim için ikinci bağımsız değişken olarak sayı yer tutucularını girin. | "1234567.89" |
| Text( DateTimeValue( "01/04/2003" ) ) | Tarih/saat değerini metin dizesine dönüştürür. Dönüştürmeyi denetlemek için DateTimeFormat numaralandırmasının bir üyesini ya da özel biçim dizesi sağlayın. | "1/4/2003 12:00 AM" |
| Text( true ) | Bir Boolean değerini dizeye dönüştürür. | "true" |
| Text( GUID() ) | Oluşturulmuş bir GUID değerini dizeye dönüştürür. | "f8b10550-0f12-4f08-9aa3-bb10958bc3ff" |
| Left( Text( GUID() ), 4 ) | Üretilen GUID'in ilk dört karakterini döndürür. | "2d9c" |