Қазір IsToday, UTCNow, UTCToday, IsUTCToday функциялары

Мақала
03/22/2024

Қолданылады: Canvas apps Desktop flows Dataverse формула бағандары Үлгіге негізделген CLI бағдарламалары Power Platform

Ағымдағы күн мен уақытты қайтарады әрі күн/уақыт мәні бүгін екенін тексереді.

Ескертпе

PAC CLI pac power-fx пәрмендері UTCNow , UTCToday және IsUTCTodayфункцияларын қолдамайды .

Сипаттама

Now функциясы ағымдағы күн мен уақытты күн/уақыт мәні түрінде қайтарады.

Today функциясы ағымдағы күнді күн/уақыт мәні түрінде қайтарады. Уақыт бөлігі — түн ортасында. Today функциясында күні бойы бір мән болады, бүгінгі түн ортасынан ертеңгі түн ортасына дейін.

IsToday функциясы күн/уақыт мәні бүгінгі түн ортасы және ертеңгі түн ортасы арасында екенін тексереді. Бұл функция логикалық (true немесе false) мәнді қайтарады.

Now, Today және IsToday функциялары ағымдағы пайдаланушының жергілікті уақытымен жұмыс істейді.

UTCNow, UTCToday және IsUTCToday функциялары олардың UTC емес аналогтарымен бірдей, бірақ уақыт белдеуінің тәуелсіз мәндерімен жұмыс істейді және Үйлестірілген әмбебап уақытты (UTC) пайдаланады.

Ескертпе

UTCNow, UTCToday және IsUTCToday функциялары тек Microsoft Dataverse for Teams формула бағандарында қолжетімді және тек уақытқа тәуелсіз өрістер мен мәндерге арналған.
Now, Today, and IsToday функциялары Dataverse for Teams формула бағандарында қолжетімді емес, себебі бағалаулар ағымдағы пайдаланушының жергілікті уақыт белдеуін ескермей орындалады.
Қосымша ақпарат: Dataverse for Teams бағдарламасындағы формула кесте бағандарымен жұмыс істеу

Қосымша ақпарат алу үшін Деректер түрлері құжаттамасындағы Date, Time және DateTime және күндермен және уақыттармен жұмыс істеу бөлімдерін қараңыз.

Өзгермелі функциялар

Now, Today, UTCNow және UTCToday өзгермелі функциялар болып табылады. Бұл функциялар әр бағалау үшін әртүрлі мәнді қайтарады.

Деректер ағыны формуласында пайдаланғанда, өзгермелі функция өзі орналасқан формула қайта есептелсе ғана басқа мәнді қайтарады. Егер формулада басқа ештеңе өзгермесе, ол бағдарламаңыздың орындалуының бүкіл барысында бір мәнге ие болады.

Мысалы, Label1.Text = Now() бар белгі басқару элементі бағдарлама белсенді кезде өзгермейді. Тек бағдарламаны жабу және қайта ашу жаңа мәнге әкеледі.

Функция басқа бірдеңе өзгерген формуланың бөлігі болса қайта есептеледі. Мысалы, мысалымызды Label1.Text = DateAdd( Now(), Slider1.Value, Minutes ) бар жүгірткі басқару элементі бар мысалға өзгертсек, ағымдағы уақыт жүгірткі басқару элементінің мәні өзгерген сайын және белгінің мәтін сипаты қайта есептелген сайын шығарып алынады.

Мінез-құлық формуласында пайдаланғанда, өзгермелі функциялар мінез-құлық формуласы есептелген сайын есептеледі. Мысалын төменде қараңыз.

Синтаксис

Пайдаланушының жергілікті уақытын пайдалану

Now()

Today()

IsToday( DateTime )

DateTime - Міндетті. Тексеретін күн/уақыт мәні.

Үйлестірілген әмбебап уақытты (UTC) пайдалану

UTCNow()

UTCToday()

IsUTCToday( TimeZoneIndependentTime )

TimeZoneIndependentDateTime - Міндетті. Уақыт белдеуі сынаққа арналған тәуелсіз күн/уақыт мәні.

Мысалдар

Осы бөлімдегі мысалдар үшін ағымдағы уақыт Тынық мұхиты уақыт белдеуіндегі (UTC-8) 20:5811 шілде, 2021 және тілі en-us.

Формула	Сипаттама	Нәтиже
Text( Now(), "mm/dd/yyyy hh:mm:ss" )	Ағымдағы күн мен уақытты пайдаланушының уақыт белдеуінде шығарып алады және оны жол түрінде көрсетеді.	"07/11/2021 20:58:00"
Text( Today(), "mm/dd/yyyy hh:mm:ss" )	Тек ағымдағы күнді шығарып алып, уақыт бөлігін түн ортасы түрінде қалдырады және оны жол түрінде көрсетеді.	"07/12/2021 00:00:00"
IsToday( Now() )	Ағымдағы күн мен уақыт бүгінгі түн ортасы және ертеңгі түн ортасы арасында екенін тексереді.	true
IsToday( Today() )	Ағымдағы күн бүгінгі түн ортасы және ертеңгі түн ортасы арасында екенін тексереді.	true
Text( DateAdd( Now(), 12 ), "mm/dd/yyyy hh:mm:ss" )	Ағымдағы күн мен уақытты шығарып алады, нәтижеге 12 күнді қосады әрі оны жол түрінде көрсетеді.	"07/23/2021 20:58:00"
Text( DateAdd( Today(), 12 ), "mm/dd/yyyy hh:mm:ss" )	Ағымдағы күнді шығарып алады, нәтижеге 12 күнді қосады әрі оны жол түрінде көрсетеді.	"07/23/2021 00:00:00"
IsToday( DateAdd( Now(), 12 ) )	Ағымдағы күн мен уақыт плюс 12 күн бүгінгі түн ортасы және ертеңгі түн ортасы арасында екенін тексереді.	false
IsToday( DateAdd( Today(), 12 ) )	Ағымдағы күн плюс 12 күн бүгінгі түн ортасы және ертеңгі түн ортасы арасында екенін тексереді.	false
Hour( UTCNow() )	Ағымдағы күн мен уақытты UTC уақытында шығарып алады және жергілікті уақыттан 8 сағат бұрын болатын сағатты ғана шығарады.	4
Day( UTCToday() )	Ағымдағы күнді тек UTC бағдарламасында шығарып алады және жергілікті уақыт бойынша 1 күн бұрын болатын күнді шығарып алады.	12
IsUTCToday( UTCNow() )	Ағымдағы күн мен уақыт бүгінгі түн ортасы және ертеңгі түн ортасы арасында барлығы UTC уақытында екенін тексереді.	true
IsUTCToday( UTCToday() )	Ағымдағы күн мен уақыт бүгінгі түн ортасы және ертеңгі түн ортасы арасында барлығы UTC уақытында екенін тексереді.	true

Нақты уақытта жаңартылатын сағатты көрсетеді

Таймер басқару элементін қосыңыз, оның Ұзақтық сипатын 1000 мәніне орнатыңыз және оның Қайталау сипатын true мәніне орнатыңыз.

Таймер бір секунд бойы жұмыс істейді, автоматты түрде қайтадан басталады және сол үлгімен жалғастырады.
Басқару элементінің OnTimerEnd сипатын мына формулаға орнатыңыз:

Set( CurrentTime, Now() )

Таймер қайта басталған сайын (әр секундтан кейін), бұл формула CurrentTime глобалдық айнымалысын Now функциясының ағымдағы мәніне орнатады.
Белгі басқару элементін қосыңыз және оның Мәтін сипатын мына формулаға орнатыңыз:

Text( CurrentTime, LongTime24 )

Text функциясын күн мен уақытты қалағанша пішімдеу үшін пайдаланыңыз немесе сағаттар мен минуттарды көрсету, бірақ секундтарды көрсетпеу үшін бұл сипатты тек CurrentTime мәніне орнатыңыз.
F5 пернесін басу арқылы бағдарламаны алдын ала қараңыз, содан кейін оны басу немесе түрту арқылы таймерді іске қосыңыз.

Белгі секундқа дейін ағымдағы уақытты үздіксіз көрсетеді.
Таймердің AutoStart сипатын true мәніне және оның Visible сипатын false мәніне орнатыңыз.

Таймер көрінбейді және автоматты түрде іске қосылады.
Экранның OnStart сипатын CurrentTime айнымалысында мына мысалдағыдай жарамды мән болатындай орнатыңыз:

Set(CurrentTime, Now())

Белгі бағдарлама іске қосылғанда көрінеді (таймер толық секунд бойы орындалмай тұрып).

Share via