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 yönetimli uygulamalar Power Pages 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 veIsUTCToday 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. Bugün , bugün gece yarısından yarı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.
Şimdi, Bugün 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 Saat'i (UTC) kullanır.
Not
- UTCNow, UTCToday ve IsUTCToday yalnızca formül sütunlarında Microsoft Dataverse for Teams ve yalnızca zamandan bağımsız alanlar ve değerler için kullanılabilir.
- Şimdi, Bugün ve IsToday formül sütunlarında Dataverse for Teams kullanılamaz, çünkü değerlendirmeler geçerli kullanıcının yerel saat diliminin bilgisi olmadan yapılır.
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
Şimdi, Bugün, UTCNow ve UTCToday geçici fonksiyonlardır. 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
Şimdi()
Bugün()
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ç |
|---|---|---|
| Metin( Şimdi(), "aa/gg/yyyy ss:dd: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" |
| Metin( Bugün(), "aa/gg/yyyy ss:dd: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" |
| Bugün( Şimdi() ) | 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. | doğru |
| Bugün( Bugün() ) | 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. | doğru |
| Text( DateAdd( Now(), 12 ), "aa/gg/yyyy ss:dd: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( Bugün(), 12 ), "aa/gg/yyyy ss: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( Şimdi(), 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. | YANLIŞ |
| IsToday( DateAdd( Bugün(), 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. | YANLIŞ |
| Saat( UTCNow() ) | UTC olarak geçerli tarihi ve saati alır ve yalnızca yerel saatten 8 saat önde olan saati ayıklar. | 4 |
| Gün( 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. | doğru |
| 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. | doğru |
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, Şimdi() )
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:
Metin( 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, Şimdi())
Uygulama başlatıldığı anda (süreölçer tam bir saniye çalışmadan önce) etiket görüntülenir.