הפונקציות 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"
)