次の方法で共有

DateValue、 TimeValue、および DateTimeValue 関数

適用対象: キャンバス アプリ Copilot Studio デスクトップ フロー モデル駆動型アプリ Power Platform CLI Dataverse 関数 Power Pages

文字列の日付、時刻またはその両方を日付/時刻値に変換します。

内容

  • DateValue 関数は 日付文字列 ("10/01/2014" など) を 日付/時刻 値に変換します。

  • TimeValue 関数は、 時刻文字列 ("12:15 PM" など) を 日付/時刻 値に変換します。

  • DateTimeValue 関数は、 日付と時刻の文字列 ("2013 年 1 月 10 日午前 12 時 13 分" など) を 日付/時刻 値に変換します。

DateValue 関数は日付文字列内の時刻情報を無視し、 TimeValue 関数は時刻文字列内の日付情報を無視します。

Note

既定では、 DateValue、 TimeValue、および DateTimeValue 関数では、現在のユーザーの設定の言語が使用されます。 これを上書きして、文字列が適切に解釈されるようにすることができます。 たとえば、"10/1/1920" は "en" では 10 月 1 日、"fr" では 1 月 10 日と解釈されます。

日付には、次のいずれかの形式を使用する必要があります。

  • MM/DD/YYYY または MM-DD-YYYY
  • DD/MM/YYYY または DD-MM-YYYY
  • YYYY/MM/DD または YYYY-MM-DD
  • MM/DD/YY または MM-DD-YY
  • DD/MM/YY または DD-MM-YY
  • DD Mon YYYY
  • 月 DD、YYYY

数値の日付、月および年コンポーネントから変換するには、Date を参照してください。
数値の時間、分および秒コンポーネントから変換するには、Time を参照してください。

詳細については、以下を参照してください。

構文

DateValue( String [, Language] )
DateTimeValue( String [, Language ] )
TimeValue( String [, Language ] )

  • 文字列 - 必須。 日付、時刻、または日付と時刻の組み合わせの値を含むテキスト文字列。
  • 言語 - オプション。 Language 関数の最初の 2 文字で返されるなどの言語文字列。 指定しない場合は、現在のユーザーの設定の言語が使用されます。

DateValue( 動的 )
DateTimeValue( 動的 )
TimeValue( 動的 )

  • 動的 - 必須。 日付または時刻を表す動的な値。 許容値は、型指定されていないプロバイダーによって異なります。 JSON の場合、動的な値は、ISO 8601 形式の日付と時刻を含む JSON 文字列である必要があります。 日付または時刻が他の形式の場合、エラーが発生します。 そのような値を テキスト にまず、その後日付または時刻に返還することを検討してください。 外部システムと通信するときは、タイム ゾーンとロケール関連の形式が重要な考慮事項であることに注意してください。

使用例

DateValue

Startdate という名前のテキスト入力コントロールに 10/11/2014 を入力し、次にラベルの Text プロパティを次の関数に設定する場合:

  • ユーザーのロケールの文字列から日付を変換し、長い日付として結果を表示します。

    Text( DateValue( Startdate.Text ), DateTimeFormat.LongDate )

    en ロケールとして設定されたデバイスは、ラベルを Saturday, October 11, 2014 として表示します。

    Note

    DateTimeFormat 列挙で複数のオプションを使用できます。 オプションの一覧を表示するには、数式バーでパラメーターの後に続いてドット または ピリオド (.) を入力する、または Text 関数の参照 を確認します。

  • フランス語ロケールの文字列から日付を変換し、長い日付として結果を表示します。 この例では、月と月の日付は英語とは異なって解釈されます。

    Text( DateValue( Startdate.Text, "fr" ), DateTimeFormat.LongDate )

    en ロケールに設定されたデバイスは、ラベルを Monday, November 10, 2014 として表示します。

代わりに 2014 年 10 月 20 日 を入力する場合:

  • ユーザーのロケールの文字列から日付を変換し、2日間の差を日数で計算します

    DateDiff( DateValue( Startdate.Text ), Today() )

    en ロケールに設定されたデバイスは、ラベルを 9 として表示し、10 月 11 日から 10 月 20 日までの日数を示します。 DateDiff 関数は、差を月、四半期、または年で示すこともできます。

DateTimeValue

Start という名前のテキスト入力コントロールに 10/11/2014 1:50:24.765 PM を入力し、次にラベルの Text プロパティを次の数式に設定した場合:

  • 現在のロケールで日付と時刻両方の文字列を変換します。

    Text( DateTimeValue( Start.Text ), DateTimeFormat.LongDateTime )

    en ロケールに設定されたデバイスは、ラベルを October 11, 2014 1:50:24 PM として表示します。

    Note

    DateTimeFormat 列挙で複数のオプションを使用できます。 オプションの一覧を表示するには、数式バーでパラメーターの後に続いてドット または ピリオド (.) を入力する、または Text 関数の参照 を確認します。

  • フランス語ロケールで日付と時間の両方の文字列を変換します。 月と月の日付は異なって解釈されます。

    Text( DateTimeValue( Start.Text, "fr"), DateTimeFormat.LongDateTime )

    en ロケールに設定されたデバイスは、ラベルを Monday, November 10, 2014 1:50:24 PM として表示します。

  • ユーザーのロケールで日付と時間の両方の文字列を変換し、小数の秒で結果を表示します。

    Text( DateTimeValue( Start.Text ), "dddd, mmmm dd, yyyy hh:mm:ss.fff AM/PM" )

    en ロケールに設定されたデバイスは、ラベルを October 11, 2014 01:50:24.765 PM として表示します。

    代替策として、hh:mm:ss.f または hh:mm:ss.ff を指定して、時間を最も近い 10分 または 100分 の 1 秒に丸めることができます。

TimeValue

テキスト入力コントロールに FinishedAt という名前を付け、ラベルの Text プロパティを次の数式に設定します。

If( TimeValue( FinishedAt.Text ) < TimeValue( "5:00:00.000 PM" ),
    "You made it!",
    "Too late!"
)
  • FinishedAt コントロールに 4:59:59.999 PM と入力する場合、ラベルは "間に合った!" と表示します
  • FinishedAt コントロールに 5:00:00.000 PM と入力する場合、ラベルは "遅すぎる!" と表示します
  • Last updated on