Date, DateTime, and Time functions - Power Platform _ Microsoft Learn
Date, DateTime, and Time functions - Power Platform _ Microsoft Learn
Article • 06/10/2024
Description
The Date function converts individual Year, Month, and Day values to a Date/Time value.
The time portion is midnight.
If Year is between 0 and 1899 (inclusive), the function adds that value to 1900 to
calculate the year. 70 becomes 1970.
If Month is less than 1 or more than 12, the result subtracts or adds that many
months from the beginning of the specified year.
If Day is greater than the number of days in the specified month, the function adds
that many days to the first day of the month and returns the corresponding date
from a subsequent month. If Day is less than 1, the function subtracts that many
days, plus 1, from the first day of the specified month.
The Time function converts individual Hour, Minute, Second, and optionally Millisecond
values to a Date/Time value. The result has no date associated with it.
The DateTime function combines the Date and Time functions into a single function,
taking both date and time arguments and returning a Date/Time value that has both
date and time components.
See the DateValue, TimeValue, and DateTimeValue functions for information about how
to convert a string to a value.
Also see working with dates and times for more information.
Syntax
Date( Year, Month, Day )
Year - Required. Numbers greater than 1899 are interpreted as absolute (1980 is
interpreted as 1980); numbers that range from 0 to 1899 are interpreted as relative
to 1900. (For example, 80 is interpreted as 1980.)
Month - Required. A number that ranges from 1 to 12.
Day - Required. A number that ranges from 1 to 31.
Time( Hour, Minute, Second [, Milliseconds ] )
Hour - Required. Number of hours, usually in the range 0 (12:00 AM) to 23 (11:00
PM).
Minute - Required. Number of minutes, usually in the range 0 to 59.
Second - Required. Number of seconds, usually in the range 0 to 59.
Milliseconds - Optional. Number of milliseconds, usually in the range 0 to 999.
Examples
Date
If a user typed
1979 in a text-input control named HireYear
3 in a text-input control named HireMonth
17 in a text-input control named HireDay
Power Fx
Time
If a user typed
Power Fx
Text(
Time(Value(BirthHour.Text), Value(BirthMinute.Text),
Value(BirthSecond.Text)),
"hh:mm:ss A/P"
)
DateTime
If a user typed
2023 in a text-input control named EclipseYear
10 in a text-input control named EclipseMonth
28 in a text-input control named EclipseDate
13 in a text-input control named EclipseHour
14 in a text-input control named EclipseMinute
5 in a text-input control named EclipseSecond
231 in a text-input control named EclipseMillisecond
this formula would return 10/28/23 01:14:05.231 PM :
Power Fx
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"
)
Feedback
Was this page helpful? Yes No
Provide product feedback