Date、DateTime 和 Time 函式

  • 發行項

適用於： 畫布應用程式 桌面流程 模型導向應用程式 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 函式。

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

語法

Date( Year, Month, Day )

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

Time(小時, 分鐘, 秒鐘 [, 毫秒])

  • Hour - 必要項目。 小時數，通常在 0 (12:00 AM) 到 23 (11:00 PM) 範圍內。
  • Minute - 必要項目。 分鐘數，通常在 0 到 59 範圍內。
  • Second - 必要項目。 秒數，通常在 0 到 59 範圍內。
  • 毫秒 - 選擇性。 豪秒數，通常在 0 到 999 範圍內。

DateTime( 年, 月, 日, 小時, 分鐘, 秒鐘 [, 毫秒])

  • Year - 必要項目。 大於 1899 的數字會解讀為絕對值 (1980 會解讀為 1980)；範圍從 0 到 1899 的數字會解讀為 1900。 (例如，80 會解讀為 1980。)
  • Month - 必要項目。 範圍從 1 到 12 的數字。
  • Day - 必要項目。 範圍從 1 到 31 的數字。
  • Hour - 必要項目。 小時數，通常在 0 (12:00 AM) 到 23 (11:00 PM) 範圍內
  • Minute - 必要項目。 分鐘數，通常在 0 到 59 範圍內。
  • Second - 必要項目。 秒數，通常在 0 到 59 範圍內。
  • 毫秒 - 選擇性。 豪秒數，通常在 0 到 999 範圍內。

範例

Date

如果使用者

  • 在名為 HireYear 的文字輸入控制項中輸入 1979
  • 在名為 HireMonth 的文字輸入控制項中輸入 3
  • 在名為 HireDay 的文字輸入控制項中輸入 17

此公式將傳回 3/17/1979：

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

Time

如果使用者

  • 在名為 BirthHour 的文字輸入控制項中輸入 14
  • 在名為 BirthMinute 的文字輸入控制項中輸入 50
  • 在名為 BirthSecond 的文字輸入控制項中輸入 24

此公式將傳回 02:50:24 P：

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

日期時間

如果使用者

  • 在名為 EclipseYear 的文字輸入控制項中輸入 2023
  • 在名為 EclipseMonth 的文字輸入控制項中輸入 10
  • 在名為 EclipseDate 的文字輸入控制項中輸入 28
  • 在名為 EclipseHour 的文字輸入控制項中輸入 13
  • 在名為 EclipseMinute 的文字輸入控制項中輸入 14
  • 在名為 EclipseSecond 的文字輸入控制項中輸入 5
  • 在名為 EclipseMillisecond 的文字輸入控制項中輸入 231

此公式將傳回 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"
)