DateValue, TimeValueופונקציות DateTimeValue

חל על: אפליקציות Canvas Copilot Studio Desktop זורמות אפליקציות מונחות דגמים פונקציות Power Platform CLI Dataverse Power Pages

ממירה תאריך, שעה או שניהם במחרוזת לערך תאריך/שעה.

תיאור

• DateValue הפונקציה ממירה מחרוזת תאריך (כגון "01/10/2014") לערך תאריך/ שעה.

• TimeValue הפונקציה ממירה מחרוזת שעה (כגון "12:15 PM") לערך תאריך/ שעה.

• DateTimeValue הפונקציה ממירה מחרוזת תאריך ושעה (כגון "10 בינואר 2013 12:13 AM") לערך תאריך/ שעה.

DateValue הפונקציה מתעלמת מכל מידע שעה במחרוזת התאריך, והפונקציה TimeValue מתעלמת מכל מידע תאריך במחרוזת השעה.

הערה

, DateValueTimeValue, והפונקציות DateTimeValue משתמשות כברירת מחדל בשפה מתוך הגדרות המשתמש הנוכחי. ניתן לעקוף זאת כדי להבטיח פירוש תקין של המחרוזות. לדוגמה, "1/10/1920" מפורש כ- 1 באוקטובר ב- "en" וב- 10 בינואר ב- "fr".

התאריכים חייבים להשתמש באחת מהתבניות הבאות:

• MM/DD/YYYY או MM-DD-YYYY
• DD/MM/YYYY או DD-MM-YYYY
• YYYY/MM/DD או YYYY-MM-DD
• MM/DD/YY או MM-DD-YY
• DD/MM/YY או DD-MM-YY
• DD יום שני YYYY
• חודש DD, YYYY

כדי לבצע המרה מתוך רכיבים מספריים של תאריך, חודש ושנה, קרא את המאמר בנושא הפונקציה Date.
כדי לבצע המרה מתוך רכיבים מספריים של שעה, דקה ושנייה, קרא את המאמר בנושא הפונקציה Time.

לקבלת מידע נוסף, ראה:

• עבודה עם תאריך ושעה
• תאריך/שעה וסוגי נתונים

תחביר

DateValue( מחרוזת [, שפה] )
DateTimeValue( מחרוזת [, שפה ] )
TimeValue( מחרוזת [, שפה ] )

• מחרוזת - חובה. מחרוזת טקסט שמכילה תאריך, שעה או ערך שילוב של תאריך ושעה.
• שפה - אופציונלי. מחרוזת שפה, בדומה למחרוזת שתוחזר על-ידי שני התווים הראשונים מהפונקציה Language‎. אם ערך זה לא סופק, נעשה שימוש בהגדרות של המשתמש הנוכחי.

DateValue(דינמי) אני לא יכול לעשות את זה.
DateTimeValue(דינמי) אני לא יכול לעשות את זה.
TimeValue(דינמי) אני לא יכול לעשות את זה.

• Dynamic - נדרש. ערך דינאמי המייצג תאריך או שעה. ערכים מקובלים תלויים בספק הלא מסווג. עבור JSON, הערך הדינאמי צפוי להיות מחרוזת JSON המכילה תאריך ושעה בתבנית ISO 8601. תאריכים או שעות בתבניות אחרות התוצאה היא שגיאה. שקול להמיר ערכים כאלה לטקסט תחילה, אחר כך לתאריך או שעה. זכור כי אזורי זמן ופורמטים הקשורים לאזור הם שיקולים חשובים בעת תקשורת עם מערכות חיצוניות.

דוגמאות

DateValue

אם אתה מקליד 10/11/2014 בפקד קלט טקסט בשם Startdate ולאחר מכן מגדיר את המאפיין Text‎ של תווית לנוסחאות הבאות:

• המר תאריך מתוך מחרוזת באזור של המשתמש והצג את התוצאה כתאריך ארוך.

  Text( DateValue( Startdate.Text ), DateTimeFormat.LongDate )
  

  מכשיר שמוגדר לאזור en מציג את התווית כ- Saturday, October 11, 2014.

  הערה

  ניתן להשתמש בכמה אפשרויות עם הספירה של DateTimeFormat. להצגת רשימת אפשרויות, הקלד את הפרמטר ואחריו נקודה ( .) בשורת הנוסחאות, או עיין בחומר העזר בנושא הפונקציה Text.

• המר תאריך מתוך מחרוזת באזור עבור צרפתית והצג את התוצאה כתאריך ארוך. בדוגמה זו, החודשים והיום בחודש מפורשים באופן שונה בהשוואה לאנגלית.

  Text( DateValue( Startdate.Text, "fr" ), DateTimeFormat.LongDate )
  

  מכשיר שמוגדר לאזור en מציג את התווית כ- Monday, November 10, 2014.

אם תזין 20 באוקטובר 2014 במקום זאת:

• המר תאריך מתוך מחרוזת באזור של המשתמש וחשב את ההפרש בין שני ימים, בימים

  DateDiff( DateValue( Startdate.Text ), Today() )
  

  מכשיר שמוגדר לאזור en מציג את התווית כ- 9, שמציינת את מספר הימים בין 11 באוקטובר ל- 20 באוקטובר. הפונקציה DateDiff‎ יכולה להציג את ההפרש גם בחודשים, ברבעונים או בשנים.

DateTimeValue

אם אתה מקליד 10/11/2014 1:50:24.765 PM בפקד קלט טקסט בשם Start ולאחר מכן מגדיר את המאפיין Text‎ של תווית לנוסחה הבאה:

• המר גם מחרוזת תאריך וגם מחרוזת זמן באזור הנוכחי.

  Text( DateTimeValue( Start.Text ), DateTimeFormat.LongDateTime )
  

  מכשיר שמוגדר לאזור en מציג את התווית כ- Saturday, October 11, 2014 1:50:24 PM.

  הערה

  ניתן להשתמש בכמה אפשרויות עם הספירה של DateTimeFormat. להצגת רשימת אפשרויות, הקלד את הפרמטר ואחריו נקודה ( .) בשורת הנוסחאות, או עיין בחומר העזר בנושא הפונקציה Text.

• המר גם מחרוזת תאריך וגם מחרוזת זמן באזור עבור צרפתית. החודש והיום בחודש מפורשים באופן שונה.

  Text( DateTimeValue( Start.Text, "fr"), DateTimeFormat.LongDateTime )
  

  מכשיר שמוגדר לאזור en מציג את התווית כ- Monday, November 10, 2014 1:50:24 PM.

• המר גם מחרוזת תאריך וגם מחרוזת שעה באזור של המשתמש והצג את התוצאה עם שניות חלקיות.

  Text( DateTimeValue( Start.Text ), "dddd, mmmm dd, yyyy hh:mm:ss.fff AM/PM" )
  

  מכשיר שמוגדר לאזור en מציג את התווית כ- Saturday, October 11, 2014 01:50:24.765 PM.

  כחלופה, ציין את hh:mm:ss.f או hh:mm:ss.ff כדי לעגל את השעה לעשירית או מאית השנייה הקרובה ביותר.

TimeValue

תן לפקד קלט טקסט את השם FinishedAt‎ והגדר את המאפיין Text‎ של תווית לנוסחה הבאה:

If( TimeValue( FinishedAt.Text ) < TimeValue( "5:00:00.000 PM" ),
    "You made it!",
    "Too late!"
)

• אם אתה מקליד 4:59:59.999 PM בפקד FinishedAt‎, התווית מציגה "You made it!‎"
• אם אתה מקליד 5:00:00.000 PM בפקד FinishedAt‎, התווית מציגה "Too late!‎"