שתף באמצעות

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

  • מאמר

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

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

Description

הפונקציה Date‎ ממירה ערכים בודדים של Year (שנה), Month (חודש) ו- Day (יום) לערך תאריך/שעה. חלק הזמן הוא חצות.

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

הפונקציה Time‎ ממירה ערכים בודדים של Hour (שעה), Minute (דקה) ו- Second (שנייה) לערך תאריך/שעה, ויכולה לכלול גם מילי-שנייה. לתוצאה לא משויך תאריך.

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

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

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

תחביר

Date( Year, Month, Day )‎

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

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

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

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

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

דוגמאות

תאריך‬

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

  • 1979 הוא פקד קלט טקסט ששמו HireYear
  • 3 הוא פקד קלט טקסט ששמו HireMonth
  • 17 הוא פקד קלט טקסט ששמו HireDay

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

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

זמן

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

  • 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" 
)

תאריך ושעה

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

  • 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"
)