Date、DateTime、Time 関数

  • [アーティクル]

適用先 : キャンバス アプリ デスクトップ フロー モデル駆動型アプリ Power Platform CLI

日付と時間のコンポーネントを日付/時刻値に変換します。

Description

Date 関数は、個々の年、月、および日の値を日付/時刻値に変換します。 時刻部分は、午前 0 時です。

  • 年が 0 と 1899 (を含む) の間の場合は、関数はその値を 1900 に加算して年を計算します。 70 は 1970 になります。
  • 月が 1 未満または 12 を超える場合、結果は指定された年の始めからその月数を減算または加算します。
  • 指定された月の日数より日が大きい場合、関数はその日数を月の最初の日に加算し、その後の月から対応する日付を返します。 日が 1 未満の場合、関数は指定された月の最初の日から、その日数に 1 を加えた日数を減算します。

Time 機能は、個々の時、分、秒、そしてオプションでミリ秒の値を Date/Time 値に変換します。 結果には、関連付けられている日付がありません。

DateTime 関数は、Date 関数と Time 関数を 1 つの関数に統合したもので、日付と時刻の両方の引数を取り、日付と時刻の両方の要素を持つ 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 時) から 23 (午後 11 時) の範囲。
  • Minute - 必須。 分の数です。通常は 0 から 59 の範囲です。
  • Second - 必須。 秒の数です。通常は 0 から 59 の範囲です。
  • ミリ秒 - オプションです。 ミリ秒の数です。通常は 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 時) から 23 (午後 11 時) の範囲
  • Minute - 必須。 分の数です。通常は 0 から 59 の範囲です。
  • Second - 必須。 秒の数です。通常は 0 から 59 の範囲です。
  • ミリ秒 - オプションです。 ミリ秒の数です。通常は 0 から 999 の範囲です。

使用例

日

ユーザーが入力した場合

  • HireYear という名前のテキスト入力コントロールの 1979
  • HireMonth という名前のテキスト入力コントロールの 3
  • HireDay という名前のテキスト入力コントロールの 17

この式は 3/17/1979 を返します:

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

時間

ユーザーが入力した場合

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

DateTime

ユーザーが入力した場合

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