Now, Today, IsToday, UTCNow, UTCToday, IsUTCToday işlevleri
Şunlar için geçerlidir:
Tuval uygulamaları Masaüstü akışları Dataverse formül sütunları Model temelli uygulamalar Power Platform CLI
Geçerli tarih ve saati döndürür ve bir tarih/saat değerinin, içinde bulunulan güne karşılık gelip gelmediğini test eder.
Not
PAC CLI pac power-fx komutları; UTCNow, UTCToday ve IsUTCToday işlevlerini desteklemez.
Description
Now işlevi, geçerli tarih ve saati bir tarih/saat değeri olarak döndürür.
Today işlevi, geçerli tarihi bir tarih/saat değeri olarak döndürür. Saat bölümü gece yarısıdır. Today, içinde bulunulan günün gece yarısından ertesi günün gece yarısına kadar bir gün boyunca aynı değere sahiptir.
IsToday işlevi, bir tarih/saat değerinin içinde bulunulan günün gece yarısı ile ertesi günün gece yarısı arasında olup olmadığını test eder. Bu işlev, true veya false olarak bir Boole değeri döndürür.
Now, Today ve IsToday işlevleri geçerli kullanıcının yerel saatiyle çalışır.
UTCNow, UTCToday ve IsUTCToday işlevleri, UTC olmayan karşılıklarıyla aynıdır ancak saat diliminden bağımsız değerlerle çalışır ve Eşgüdümlü Evrensel Saati (UTC) kullanır.
Not
- UTCNow, UTCToday ve IsUTCToday yalnızca Microsoft Dataverse for Teams formül sütunlarında bulunur ve saat diliminden bağımsız alanlar ve değerler için çalışır.
-
Değerlendirmeler geçerli kullanıcının yerel saat dilimi bilgisi olmadan yapıldığından Now, Today ve IsToday işlevleri Dataverse for Teams formül sütunlarında kullanılmaz.
Daha fazla bilgi: Dataverse for Teams'de formül tablosu sütunlarıyla çalışma
Daha fazla bilgi edinmek için bkz. Veri türlerinde Date, Time ve DateTime belgeleri ve Tarih ve saatler ile çalışma.
Geçici İşlevler
Now, Today, UTCNow ve UTCToday geçici işlevlerdir. Bu işlevler, her değerlendirme için farklı bir değer döndürür.
Bir veri akışı formülünde kullanıldığında, geçici işlevin farklı bir değer döndürmesi için içinde yer aldığı formülün yeniden hesaplanması gerekir. Formülde başka hiçbir değişiklik olmazsa, uygulamanız yürütüldüğü sürece aynı değere sahip olur.
Örneğin, Etiket1.Text = Now() formülünü içeren bir label denetimi, uygulamanız etkin olduğu sürece değişmez. Yalnızca uygulamanın kapatılması ve yeniden açılması yeni bir değer sonucu verir.
İşlev, başka bir öğesi değişen bir formülün parçası olduğunda yeniden hesaplanır. Örneğin, yukarıdaki örneğimizi bir Slider denetimi içeren Etiket1.Text = DateAdd( Now(), Kaydırıcı1.Value, Dakika ) formülüyle değiştirirseniz, Slider denetiminin değeri her değiştiğinde geçerli saat alınır ve etiketin metin özelliği yeniden hesaplanır.
Bir davranış formülünün içinde kullanılırsa, davranış formülü her hesaplandığında davranış işlevi de hesaplanır. Aşağıdaki örneğe bakın.
Sözdizimi
Kullanıcının yerel saati kullanılarak
Now()
Today()
IsToday( DateTime )
- DateTime - Gerekli. Test edilecek tarih/saat değeri.
Eşgüdümlü Evrensel Saat (UTC) kullanma
UTCNow()
UTCToday()
IsUTCToday( TimeZoneIndependentTime )
- TimeZoneIndependentDateTime - Gerekli. Test için saat diliminden bağımsız tarih/saat değeri.
Örnekler
Bu bölümdeki örneklerde, geçerli saat 20:58, tarih 11 Temmuz 2021 (Pasifik Saat Dilimi (UTC-8)) ve dil en-US'dir.
| Formül | Açıklama | Sonuç |
|---|---|---|
| Text( Now(), "mm/dd/yyyy hh:mm:ss" ) | Geçerli tarih ve saati kullanıcının saat diliminde alır ve bir dize olarak görüntüler. | "07/11/2021 20:58:00" |
| Text( Today(), "mm/dd/yyyy hh:mm:ss" ) | Yalnızca geçerli tarihi alarak saat kısmını gece yarısı olarak bırakır ve bunu bir dize olarak görüntüler. | "07/12/2021 00:00:00" |
| IsToday( Now() ) | Geçerli tarih ve saatin, içinde bulunulan günün gece yarısı ile ertesi günün gece yarısı arasında olup olmadığını test eder. | true |
| IsToday( Today() ) | Geçerli tarihin, içinde bulunulan günün gece yarısı ile ertesi günün gece yarısı arasında olup olmadığını test eder. | true |
| Text( DateAdd( Now(), 12 ), "mm/dd/yyyy hh:mm:ss" ) | Geçerli tarih ve saati alır, sonuca 12 gün ekler ve bir dize olarak görüntüler. | "07/23/2021 20:58:00" |
| Text( DateAdd( Today(), 12 ), "mm/dd/yyyy hh:mm:ss" ) | Geçerli tarihi alır, sonuca 12 gün ekler ve bir dize olarak görüntüler. | "07/23/2021 00:00:00" |
| IsToday( DateAdd( Now(), 12 ) ) | Geçerli tarih ve saat ile 12 gün toplamının içinde bulunulan günün gece yarısı ile ertesi günün gece yarısı arasında olup olmadığını test eder. | false |
| IsToday( DateAdd( Today(), 12 ) ) | Geçerli tarih ile 12 gün toplamının içinde bulunulan günün gece yarısı ile ertesi günün gece yarısı arasında olup olmadığını test eder. | false |
| Hour( UTCNow() ) | UTC olarak geçerli tarihi ve saati alır ve yalnızca yerel saatten 8 saat önde olan saati ayıklar. | 4 |
| Day( UTCToday() ) | Geçerli tarihi yalnızca UTC diliminde alır ve yerel saatten 1 gün önde olan günü ayıklar. | 12 |
| IsUTCToday( UTCNow() ) | Geçerli tarih ve saatin, içinde bulunulan günün gece yarısı ile ertesi günün gece yarısı arasında (tümü UTC saat diliminde) olup olmadığını test eder. | true |
| IsUTCToday( UTCToday() ) | Geçerli tarihin içinde bulunulan günün gece yarısı ile ertesi günün gece yarısı arasında (tümü UTC saat diliminde) olup olmadığını test eder. | true |
Gerçek zamanlı olarak güncelleştirilen bir saat görüntüleme
Bir Timer denetimi ekleyin, denetimin Duration özelliğini 1000 olarak ayarlayın ve Repeat özelliğini de true olarak ayarlayın.
Süreölçer bir saniye boyunca çalışır, otomatik olarak yeniden başlatılır ve bu şekilde devam eder.
Denetimin OnTimerEnd özelliğini şu formüle ayarlayın:
Set( CurrentTime, Now() )
Süreölçerin her yeniden başlatılışında (her saniyenin sonunda), bu formül CurrentTime genel değişkenini Now işlevinin geçerli değerine ayarlar.
Bir Label denetimi ekleyin ve denetimin Text özelliğini şu formül olarak ayarlayın:
Text( CurrentTime, LongTime24 )
Tarih ve saati istediğiniz gibi biçimlendirmek için Text işlevini kullanın veya bu özelliği doğrudan CurrentTime olarak ayarlayıp saatleri ve dakikaları görüntüleyin (ancak saniyeler görüntülenmez).
F5 tuşuna basarak uygulamanın önizlemesine bakın ve ardından dokunarak veya tıklayarak süreölçeri başlatın.
Etiket sürekli geçerli saati (saniyesine kadar) gösterir.
Süreölçerin AutoStart özelliğini true ve Visible özelliğini false olarak ayarlayın.
Süreölçer görünür değildir ve otomatik olarak başlatılır.
Aşağıdaki örnekte gösterildiği gibi ekranın OnStart özelliğini, CurrentTime değişkeninin geçerli bir değeri olacak şekilde ayarlayın:
Set(CurrentTime, Now())
Uygulama başlatıldığı anda (süreölçer tam bir saniye çalışmadan önce) etiket görüntülenir.