Power Automate 「getFutureTime」関数

2023年10月12日

English version.

getFutureTimeはPower Automateの式に使用する関数で、

現在日時(タイムゾーンはUTC)から指定単位で加算(未来日付を算出)します。

単位は年、月、週、日、時、分、秒から選択可能です。

addToTimeと似ていますが、指定日時から計算するか、

現在日時から計算するかの違いがあります。

仕様

getFutureTime(<interval>, '<timeUnit>', '<format>')
引数省略時の値説明
interval省略不可現在日時から動かす量を指定します。
正の値では未来の方向、
負の値では過去の方向に計算します。
timeUnit省略不可計算する単位を指定します。
・年…Year
・月…Month
・週…Week
・日…Day
・時…Hour
・分…Minute
・秒…Second
formatyyyy-MM-ddTHH:mm:ss.fffffffK結果の形式を指定します。(任意項目)
各引数の詳細

利用方法

多くの場合、種類が「文字列」の変数の初期化か設定の際の「値」の中で利用されます。

「式」タブ、getFutureTimeをクリックすると関数名と()が数式欄にセットされます。

引数として1つめに動かす量、2つめに単位を指定します。

動的なコンテンツや変数を利用する場合は特殊な指定を行います。

動的なコンテンツを式で取得する方法

ボタンをクリックして次のような表示になれば設定完了です。

この紫のアイコンをクリックすると関数を変更可能です。

例のように getFutureTime(1, 'Day') と指定すると、

実行日時(タイムゾーンはUTC)から1日後が結果になります。

結果の形式を変えたい場合は3つめの引数にフォーマットを指定します。

1つめの引数に負の数を指定すると減算(過去日時への計算)になりますが、

式が難解になってしまうため、減算(過去日時への計算)はgetPastTimeを利用しましょう。

関連記事

日付と時刻関数の記事一覧