Power Automate 「getFutureTime」関数
getFutureTimeはPower Automateの式に使用する関数で、
現在日時(タイムゾーンはUTC)から指定単位で加算(未来日付を算出)します。
単位は年、月、週、日、時、分、秒から選択可能です。
addToTimeと似ていますが、指定日時から計算するか、
現在日時から計算するかの違いがあります。
仕様
getFutureTime(<interval>, '<timeUnit>', '<format>')
引数 | 省略時の値 | 説明 |
---|---|---|
interval | 省略不可 | 現在日時から動かす量を指定します。 正の値では未来の方向、 負の値では過去の方向に計算します。 |
timeUnit | 省略不可 | 計算する単位を指定します。 ・年…Year ・月…Month ・週…Week ・日…Day ・時…Hour ・分…Minute ・秒…Second |
format | yyyy-MM-ddTHH:mm:ss.fffffffK | 結果の形式を指定します。(任意項目) |
利用方法
多くの場合、種類が「文字列」の変数の初期化か設定の際の「値」の中で利用されます。
「式」タブ、getFutureTimeをクリックすると関数名と()が数式欄にセットされます。
引数として1つめに動かす量、2つめに単位を指定します。
動的なコンテンツや変数を利用する場合は特殊な指定を行います。
ボタンをクリックして次のような表示になれば設定完了です。
この紫のアイコンをクリックすると関数を変更可能です。
例のように getFutureTime(1, 'Day') と指定すると、
実行日時(タイムゾーンはUTC)から1日後が結果になります。
結果の形式を変えたい場合は3つめの引数にフォーマットを指定します。
1つめの引数に負の数を指定すると減算(過去日時への計算)になりますが、
式が難解になってしまうため、減算(過去日時への計算)はgetPastTimeを利用しましょう。