שתף באמצעות

הפונקציות DateValue,‏ TimeValue ו- DateTimeValue

  • מאמר

חל על: יישומי בד ציור זרימות שולחן עבודה יישומים מונחי-דגמים Power Pages Power Platform CLI

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

תיאור

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

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

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

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

הערה

הפונקציות DateValue,‏ TimeValue ו- DateTimeValue משתמשות כברירת מחדל בשפה מההגדרות של המשתמש הנוכחי. ניתן לעקוף זאת כדי להבטיח פירוש תקין של המחרוזות. לדוגמה, "10/1/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 Mon YYYY
  • Month DD, YYYY

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

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

תחביר

DateValue( String [, Language ])‎
DateTimeValue( String [, Language ])‎
TimeValue( String [, Language ])‎

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

DateValue( לא מסווג )
DateTimeValue( לא מסווג )
TimeValue( לא מסווג )

  • Untyped - נדרש. אובייקט לא מסווג שמייצג תאריך או שעה. ערכים מקובלים תלויים בספק הלא מסווג. עבור 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.

אם היית מקליד October 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!‎"