Aracılığıyla paylaş

Text fonksiyon

Şunlar için geçerlidir: Tuval uygulamaları Copilot Studio Desktop akışları Dataverse formül sütunları Model temelli uygulamalar Power Platform CLI Dataverse işlevleri Power Pages

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

İşlev, Text bir sayıyı veya tarih/saat değerini şu bağımsız değişken türlerinden birine göre biçimlendirmektedir:

  • 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.

İşlev ayrıca Text varsayılan biçimi kullanarak herhangi bir veri türünü 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)
Uzun Tarih 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"
UzunDateTime24 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"
Uzun süreli Saat (12 saatlik düzende), dakika, saniye ve AM/PM gösterimi. "20:26:59 PM"
Uzun Süre24 Saat (24 saatlik düzende), dakika ve saniye. "20:26:59"
Kısa Tarih Sayısal ay ve ayın günü ile birlikte dört haneli yıl. "7.4.2020"
ShortDateTime (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"
Kısa Süre Saat (12 saatlik düzende), dakika ve AM/PM gösterimi. "20:26"
Kısa Süre24 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, Text sayının ondalık basamak sayısı biçimindeki # simgelerinden daha az basamak olduğunda fazladan sıfır 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. Text biçim, sayı işaretleri (#) veya sıfırlar içine alınmış bir virgül içeriyorsa grupları virgülle 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 veya hh kodundan hemen sonra veya ss kodundan hemen önce görünmelidir; aksi takdirde, Text 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 gece yarısından öğlene kadar olan saatler için "" veya "a" ve öğleden gece yarısına kadar zaman için "PM" veya "p" döndürür

Değişmez yer tutucular

Bu karakterlerden herhangi birini biçim dizenize ekleyebilirsiniz. Sonucu olarak görünürler Text . 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 İşlev genel olarak farkındadır. 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: Oluşturucular için özel bir 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 sonucu hangi dilde görünmelidir? Ayların ve haftanın günlerinin adları, uygulama kullanıcısı için uygun dilde olmalıdır ve işleve Text üçü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, formül çubuğuna veya sağ bölmenin Gelişmiş sekmesine ( 1234, "", ) yazınText ve ardından üçüncü bağımsız değişken için önerilen yerel ayarlar listesinde ilerleyin.

Dil yer tutucusu

Özel biçimin dilini belirtmek üzere şunu kullanın:

Yer tutucu Açıklama
[$-Dil Etiketi] LanguageTag , Language işlevinden döndürülen bir 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.

[$-en-US] uygulamanız çalıştırıldığında bu yer tutucu yoksa 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

sonucu Text aylar, hafta içi günleri ve/PM atamaları için çevrilmiş dizelerin yanı sıra uygun grup ve ondalık ayırıcıları içerir.

Varsayılan olarak, Text 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. için üçüncü bağımsız değişken Textiç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 ] )

  • Sayı - 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 ( Dinamik )

  • Dinamik - Gerekli. Bir dizeyi temsil eden dinamik değer. Kabul edilebilir değerler, türü belirtilmemiş sağlayıcıya bağlıdır. JSON için dinamik değer bir sayı veya boole ise metne dönüştürülür.

Ö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:
  • d ayın tek basamaklı veya çift basamaklı günü için
  • - sonuca kopyalanan değişmez bir karakter olarak
  • ayın üç harfli kısaltması için mmm
  • - Sonuca kopyalanan başka bir değişmez karakter olarak
  • yy yılın iki basamaklı kısaltması için
 "23-Kas-15"
Text(1448318857*1000, "mmm. dd, yyyy (hh:mm:ss/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 Açıklama Sonuç
Text(1234567.89, "[$-fr-FR]# ###,## €", "fr-FR") Boşluğu gruplandırma ayırıcısı, € virgülü ondalık ayırıcı 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. "4/1/2003 12:00"
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"
  • Last updated on