הפונקציות Now, Today, IsToday, UTCNow, UTCToday ו-IsUTCToday
חל על:
יישומי בד ציור זרימות שולחן עבודה Dataverse עמודות נוסחה יישומים מונחי-דגמים Power Platform CLI
מחזירה את התאריך והשעה הנוכחיים ובודקת אם ערך תאריך/שעה הוא היום.
הערה
פקודות PAC CLI pac power-fx לא תומכות בפונקציות UTCNow, UTCToday, ו- IsUTCToday.
Description
הפונקציה Now מחזירה את התאריך והשעה הנוכחיים כערך תאריך/שעה.
הפונקציה Today מחזירה את התאריך הנוכחי כערך תאריך/שעה. חלק הזמן הוא חצות. Today כוללת את אותו ערך לכל אורך של יום, מחצות היום ועד חצות מחר.
הפונקציה IsToday בודקת אם ערך תאריך/שעה הוא בין חצות היום לחצות מחר. פונקציה זו מחזירה ערך בוליאני (true או false).
הפונקציות Now, Today ו-IsToday פועלות עם הזמן המקומי של המשתמש הנוכחי.
הפונקציות UTCNow, UTCToday ו-IsUTCToday זהות למקבילות שלהן שאינן UTC אך פועלות עם ערכים לא תלויים באזור זמן ומשתמשות בזמן אוניברסלי מתואם (UTC).
הערה
- הפונקציות UTCNow, UTCToday ו-IsUTCToday זמינות רק בעמודות נוסחה של Microsoft Dataverse for Teams ורק עבור שדות וערכים שלא תלויים באזור זמן.
-
הפונקציות Now, Today ו-IsToday אינן זמינות בעמודות נוסחה של Dataverse for Teams מכיוון שההערכות מבוצעות ללא ידיעת אזור הזמן המקומי של המשתמש הנוכחי.
מידע נוסף: עבוד עם עמודות נוסחה בטבלה ב-Dataverse for Teams
עיין בתיעוד בנושא תאריך, שעה ותאריך/שעה בתיעוד של סוגי הנתונים וכן עבודה עם תאריכים ושעות לקבלת מידע נוסף.
פונקציות נדיפות
הפונקציות 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 - נדרש. ערך התאריך/שעה הבלתי תלוי באזור הזמן שיש לבדוק.
דוגמאות
עבור הדוגמאות במקטע זה, השעה הנוכחית היא 20:58 בתאריך 11 ביולי 2021 לפי שעון החוף המערבי (UTC-8) והשפה היא en-us.
| נוסחה | תיאור | תוצאה |
|---|---|---|
| Text( Now(), "mm/dd/yyyy hh:mm:ss" ) | מאחזרת את התאריך והשעה הנוכחיים באזור הזמן של המשתמש, ומציג אותם כמחרוזת. | "11/07/2021 20:58:00" |
| Text( Today(), "mm/dd/yyyy hh:mm:ss" ) | מאחזרת את התאריך הנוכחי בלבד, משאירה את חלק הזמן כחצות ומציגה אותו כמחרוזת. | 12/07/2021 - 00/00/00 |
| IsToday( Now() ) | בודקת אם התאריך והשעה הנוכחיים הם בין חצות היום לחצות מחר. | true |
| IsToday( Today() ) | בודקת אם התאריך הנוכחי הוא בין חצות היום לחצות מחר. | true |
| Text( DateAdd( Now(), 12 ), "mm/dd/yyyy hh:mm:ss" ) | מאחזרת את התאריך והשעה הנוכחיים, מוסיפה 12 ימים לתוצאה ומציגה אותם כמחרוזת. | "23/07/2021 20:58:00" |
| Text( DateAdd( Today(), 12 ), "mm/dd/yyyy hh:mm:ss" ) | מאחזרת את התאריך הנוכחי, מוסיפה 12 ימים לתוצאה ומציגה אותו כמחרוזת. | 23/07/2021 - 00/00/00 |
| IsToday( DateAdd( Now(), 12 ) ) | בודקת אם התאריך והשעה הנוכחיים, בתוספת 12 ימים, הם בין חצות היום לחצות מחר. | false |
| IsToday( DateAdd( Today(), 12 ) ) | בודקת אם התאריך הנוכחי, בתוספת 12 ימים, הוא בין חצות היום לחצות מחר. | false |
| שעה( UTCNow() ) | מאחזרת את התאריך והשעה הנוכחיים ב-UTC ומחלץ את השעה בלבד, שהיא 8 שעות לפני הזמן המקומי. | 4 |
| יום( UTCToday() ) | מאחזרת את התאריך הנוכחי בלבד ב-UTC ומחלץ את התאריך, שהוא יום אחד לפני הזמן המקומי. | 12 |
| IsUTCToday( UTCNow() ) | בודקת אם התאריך והשעה הנוכחיים הם בין חצות היום לחצות מחר, הכול בזמן UTC. | true |
| IsUTCToday( UTCToday() ) | בודקת אם התאריך הנוכחי הוא בין חצות היום לחצות מחר, הכול בזמן UTC. | true |
הצגת שעון שמתעדכן בזמן אמת
הוסף פקד Timer, הגדר את מאפיין Duration שלו ל-1000, והגדר את מאפיין Repeat שלו ל-true.
שעון העצר יפעל למשך שנייה אחת, יופעל מחדש באופן אוטומטי וימשיך בדפוס זה.
הגדר את המאפיין OnTimerEnd של הפקד לנוסחה זו:
Set( CurrentTime, Now() )
כאשר שעון העצר מתחיל מחדש (אחרי כל שנייה), נוסחה זו מגדירה את המשתנה הכללי CurrentTime לערך הנוכחי של הפונקציה Now.
הוסף פקד Label והגדר את מאפיין Text שלו לנוסחה זו:
Text( CurrentTime, LongTime24 )
השתמש בפונקציה Text fכדי לעצב את התאריך והשעה בכל דרך שתרצה, או הגדר את המאפיין הזה ל- CurrentTime בלבד כדי להציג שעות ודקות, אבל לא שניות.
הצג את היישום בתצוגה מקדימה על-ידי הקשה על F5, ולאחר מכן הפעל את שעון העצר על-ידי לחיצה או הקשה עליו.
התווית מציגה ללא הפסקה את השעה הנוכחית, עד לרמת השנייה.
הגדר את המאפיין AutoStart של שעון העצר ל- true ואת המאפיין Visible שלו ל- false.
שעון העצר אינו גלוי ומופעל אוטומטית.
הגדר את המאפיין OnStart של המסך כך שהמשתנה CurrentTime יהיה בעל ערך חוקי, בדומה לדוגמה הבאה:
Set(CurrentTime, Now())
התווית מופיעה ברגע שהיישום מופעל (לפני ששעון העצר פועל למשך שנייה מלאה).