共用方式為

Date、DateTime 和 Time 函式

  • 發行項

適用於： 畫布應用 桌面流 模型驅動應用 Power Pages Power Platform CLI

將日期和時間元件轉換成日期/時間值。

Description

Date 函式會將個別的 Year、Month 和 Day 值轉換成 Date/Time 值。 時間部分為午夜。

  • 如果 Year 值介於 0 和 1899 (含) 之間，則函式會將該值新增到 1900 來計算年份。 70 年變成了 1970 年。
  • 如果 Month 值小於 1 或大於 12，結果會從指定年份的起點減去或加上那些月數。
  • 如果 Day 值大於指定月份的天數，則函式會將這些天數加到該月份的第一天，並從後續月份傳回對應的日期。 如果 Day 值小於 1，此函式會從指定月份的第一天減去該天數，再加上 1。

Time 函數會將 Hour、Minute 和 Second 和 Millisecond (選擇性) 的個別值轉換成 Date/Time 值。 結果沒有與其相關聯的日期。

DateTime 函式將日期和時間 函數合併為單一函數，接受日期和時間參數並傳回具有日期和時間元件的 Date/Time 值。

如需如何將字串轉換為值的相關資訊，請參閱 DateValue、TimeValue 和 DateTimeValue 函式。

另請參閱 處理日期和時間 以取得詳細資訊。

語法

日期（ 年， 月， 日 ）

  • Year - 必需。 大於 1899 的數字會解讀為絕對值 (1980 會解讀為 1980)；範圍從 0 到 1899 的數字會解讀為 1900。 (例如，80 會解讀為 1980。)
  • Month - 必需。 範圍從 1 到 12 的數字。
  • Day - 必需。 範圍從 1 到 31 的數字。

時間（ 小時， 分鐘， 秒 [， 毫秒 ]）

  • 小時 - 必需。 小時數，通常在 0 (12:00 AM) 到 23 (11:00 PM) 範圍內。
  • minute - 必需。 分鐘數，通常在 0 到 59 範圍內。
  • Second - 必需。 秒數，通常在 0 到 59 範圍內。
  • milliseconds - 可選。 豪秒數，通常在 0 到 999 範圍內。

DateTime（ 年，月 ， 日， 小時， 分鐘， 秒 [， 毫秒 ]）

  • Year - 必需。 大於 1899 的數字會解讀為絕對值 (1980 會解讀為 1980)；範圍從 0 到 1899 的數字會解讀為 1900。 (例如，80 會解讀為 1980。)
  • Month - 必需。 範圍從 1 到 12 的數字。
  • Day - 必需。 範圍從 1 到 31 的數字。
  • 小時 - 必需。 小時數，通常在 0 (12:00 AM) 到 23 (11:00 PM) 範圍內
  • minute - 必需。 分鐘數，通常在 0 到 59 範圍內。
  • Second - 必需。 秒數，通常在 0 到 59 範圍內。
  • milliseconds - 可選。 豪秒數，通常在 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" 
)

日期時間

如果使用者

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