Date, DateTimeופונקציות Time

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

ממירה רכיבי תאריך ושעה לערך תאריך/שעה.

Description

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

• אם הערך של Year הוא בין 0 ל- 1899 (כולל), הפונקציה מוסיפה ערך זה ל- 1900 כדי לחשב את השנה. 70 הופך ל 1970.
• אם הערך של Month קטן מ- 1 או גדול מ- 12, התוצאה מחסירה או מוסיפה את מספר החודשים הזה מתחילת השנה שצוינה.
• אם הערך של Day גדול ממספר הימים בחודש שצוין, הפונקציה מוסיפה את מספר הימים הזה ליום הראשון בחודש ומחזירה את התאריך המתאים מחודש שבא לאחר מכן. אם הערך של Day קטן מ- 1, הפונקציה מחסירה את מספר הימים, ועוד 1, מהיום הראשון של החודש שצוין.

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

הפונקציה DateTime משלבת Date את הפונקציות Time ופונקציה אחת לפונקציה אחת, Dateלוקחת הן את הארגומנטים תאריך והן את השעה ומחזירה ערך /Time הכולל הן רכיבי תאריך והן שעה.

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

ראה גם עבודה עם תאריכים ושעות לקבלת מידע נוסף.

תחביר

Date( שנה, חודש, יום )

• שנה - חובה. מספרים גדולים מ- 1899 מפורשים כמוחלטים (1980 מתפרש כ -1980); מספרים שנעים בין 0 ל- 1899 מפורשים ביחס ל- 1900. (לדוגמא, 80 מפורש כ- 1980.)
• חודש - חובה. מספר שנע בין 1 ל- 12.
• יום - חובה. מספר שנע בין 1 ל- 31.

Time( hour, Minute, Second [, Milliseconds ] )

• שעה - חובה. מספר שעות, בדרך כלל בטווח 0 (12:00 בבוקר) עד 23 (23:00).
• דקה - חובה. מספר דקות, לרוב מספר בטווח שבין 0 ל- ‎59.
• שני - חובה. מספר שניות, לרוב מספר בטווח שבין 0 ל- ‎59.
• אלפיות שניות - אופציונלי. מספר אלפיות השניות, לרוב מספר בטווח שבין 0 ל- ‎999.

DateTime( Year, Month, Day, Hour, Minute, Second [, Milliseconds ] )

• שנה - חובה. מספרים גדולים מ- 1899 מפורשים כמוחלטים (1980 מתפרש כ -1980); מספרים שנעים בין 0 ל- 1899 מפורשים ביחס ל- 1900. (לדוגמא, 80 מפורש כ- 1980.)
• חודש - חובה. מספר שנע בין 1 ל- 12.
• יום - חובה. מספר שנע בין 1 ל- 31.
• שעה - חובה. מספר שעות, בדרך כלל בטווח 0 (12:00 בבוקר) עד 23 (23:00)
• דקה - חובה. מספר דקות, לרוב מספר בטווח שבין 0 ל- ‎59.
• שני - חובה. מספר שניות, לרוב מספר בטווח שבין 0 ל- ‎59.
• אלפיות שניות - אופציונלי. מספר אלפיות השניות, לרוב מספר בטווח שבין 0 ל- ‎999.

דוגמאות

Date

אם משתמש הקליד

• 1979 בפקד קלט טקסט בשם HireYear
• 3 בפקד קלט טקסט בשם HireMonth
• 17 בפקד קלט טקסט בשם HireDay

הנוסחה הזו תחזיר 3/17/1979:

Date( Value(HireYear.Text), Value(HireMonth.Text), Value(HireDay.Text) )

Time

אם משתמש הקליד

• 14 בפקד קלט טקסט בשם BirthHour
• 50 בפקד קלט טקסט בשם BirthMinute
• 24 בפקד קלט טקסט בשם BirthSecond

הנוסחה הזו תחזיר 02:50:24 P:

Text( 
    Time(Value(BirthHour.Text), Value(BirthMinute.Text), Value(BirthSecond.Text)), 
    "hh:mm:ss A/P" 
)

DateTime

אם משתמש הקליד

• 2023 בפקד קלט טקסט בשם EclipseYear
• 10 בפקד קלט טקסט בשם EclipseMonth
• 28 בפקד קלט טקסט בשם EclipseDate
• 13 בפקד קלט טקסט בשם EclipseHour
• 14 בפקד קלט טקסט בשם EclipseMinute
• 5 בפקד קלט טקסט בשם EclipseSecond
• 231 בפקד קלט טקסט בשם EclipseMillisecond

הנוסחה הזו תחזיר 10/28/23 01:14:05.231 PM:

Text(
    DateTime(Value(EclipseYear.Text), Value(EclipseMonth.Text), Value(EclipseDate.Text), 
        Value(EclipseHour.Text), Value(EclipseMinute.Text), 
        Value(EclipseSecond.Text), Value(EclipseSecond.Millisecond)
    ), 
    "yy/mm/dd hh:mm:ss.000 AM/PM"
)