Power Automateには、日付に関する便利な関数があります。
以下では、Power Automateに2023年3月現在で登録されている日付関数について、説明していきます。
関数の種類については、同サイト内のコチラをご覧下さい。
※表内のtimeUnit：間隔と共に使用する時間単位：”Second”、”Minute”、”Hour”、”Day”、”Week”、”Month”、”Year”
| 関数名 | 説明 | 構文 | |
| utcNOW | 現在のUTC時間を返す。 | utcNow(‘<format>’) | ・format: string ■戻り値: string タイムスタンプの既定の形式: “o” (yyyy-MM-ddTHH:mm:ss.fffffffK) 形式についてはコチラを確認 |
| getFutureTime | 現在の時刻に指定した時刻間隔を加算したタイムスタンプを返す。 | getFutureTime(<interval>, <timeUnit>, <format>?) | ・interval: integer(時間単位) ・timeUnit: string ・format: string ■戻り値: string |
| getPastTime | 現在の時刻に指定した時刻間隔を減算したタイムスタンプを返す。 | getPastTime(<interval>, <timeUnit>, <format>?) | ・interval: integer(時間単位) ・timeUnit: string ・format: string ■戻り値: string |
| addToTime | 渡された文字列タイムスタンプに指定された時間単位の整数を加算 | addToTime(‘<timestamp>’, <interval>, ‘<timeUnit>’, ‘<format>’?) | ・timestamp: string ・nterval: integer(時間単位) ・timeUnit: string ・format: string ■戻り値: string |
| subtractFromTime | 渡される文字列タイムスタンプに指定された時間単位の整数を減算 | subtractFromTime(‘<timestamp>’, <interval>, ‘<timeUnit>’, ‘<format>’?) | ・timestamp: string ・nterval: integer(時間単位) ・timeUnit: string ・format: string ■戻り値: string |
| addSeconds | タイムスタンプに秒を加算 | addSeconds(‘<timestamp>’, <seconds>, ‘<format>’?) | ・timestamp: string ・seconds: integer(正 or 負の秒数) ・format: string ■戻り値: string |
| addMinutes | タイムスタンプに分を加算 | addMinutes(‘<timestamp>’, <minutes>, ‘<format>’?) | ・timestamp: string ・minutes: integer(正 or 負の分数) ・format: string ■戻り値: string |
| addHours | タイムスタンプに時間を加算 | addHours(‘<timestamp>’, <hours>, ‘<format>’?) | ・timestamp: string ・hours: integer(正 or 負の時間数) ・format: string ■戻り値: string |
| addDays | タイムスタンプに日にちを加算 | addDays(‘<timestamp>’, <days>, ‘<format>’?) | ・timestamp: string ・days integer(正 or 負の日数) ・format: string ■戻り値: string |
| dateDifference | 2つのタイムスタンプの差を文字列のタイムスタンプとして返す | dateDifference(‘<startDate>’, ‘<endDate>’) | ・startDate / endDate: string ■戻り値: string |
| convertTimeZone | 渡されるタイムスタンプを送信元タイム ゾーンからターゲット タイム ゾーンに変換 | convertTimeZone(‘<timestamp>’, ‘<sourceTimeZone>’, ‘<destinationTimeZone>’, ‘<format>’?) | ・timestamp: string ・sourceTimeZone / destinationTimeZone: string ・format: string ■戻り値: string |
| convertToUtc | 渡されるタイムスタンプを送信元タイム ゾーンからUTC(協定世界時間)に変換 | convertToUtc(‘<timestamp>’, ‘<sourceTimeZone>’, ‘<format>’?) | ・timestamp: string ・sourceTimeZone : string ・format: string ■戻り値: string |
| convertFromUtc | 渡されるタイムスタンプをUTCから送信元タイム ゾーンに変換 | convertFromUtc(‘<timestamp>’, ‘<destinationTimeZone>’, ‘<format>’?) | ・timestamp: string ・destinationTimeZone: string ・format: string ■戻り値: string |
| formatDateTime | 指定した形式でタイムスタンプを返す | formatDateTime(‘<timestamp>’, ‘<format>’?, ‘<locale>’?) | ・timestamp: string ・locale: string ・format: string ■戻り値: string |
| parseDateTime | タイムスタンプを含む文字列からタイムスタンプを返す | parseDateTime(‘<timestamp>’, ‘<locale>’?, ‘<format>’?) | ・timestamp: string ・locale: string ・format: string ■戻り値: string |
| startOfHour | タイムスタンプの時刻の開始を返す | startOfHour(‘<timestamp>’, ‘<format>’?) | ・timestamp: string ・format: string ■戻り値: string |
| startOfDay | タイムスタンプの日の開始日時を返す | startOfDay(‘<timestamp>’, ‘<format>’?) | ・timestamp: string ・format: string ■戻り値: string |
| startOfMonth | タイムスタンプの月の開始を返す | startOfMonth(‘<timestamp>’, ‘<format>’?) | ・timestamp: string ・format: string ■戻り値: string |
| dayOfWeek | タイムスタンプから曜日を返す | dayOfWeek(‘<timestamp>’) | ・timestamp: string ■戻り値: integer ※日曜日は 0、月曜日は 1みたいな感じ |
| dayOfMonth | タイムスタンプから月コンポーネントの日付を返す | dayOfMonth(‘<timestamp>’) | ・timestamp: string ■戻り値: integer ※月の日付 |
| dayOfYear | タイムスタンプから年の何日目かを返す | dayOfYear(‘<timestamp>’) | ・timestamp: string ■戻り値: integer ※年初からの通算日数 |
| ticks | 文字列タイムスタンプの1 年日 0001 12:00:00 午前 0 時から指定したタイムスタンプまでの 100 ナノ秒間隔のティック数 | ticks(‘<timestamp>’) |
以上が、Power Automateで使われる日付関数です。これらの関数を使って、Power Automateのワークフローで日付を扱う際に便利に活用していきたいです。
関数使用例を小さくてもつけたかったのですが、勉強も兼ねて後日検証してから、追記するようにします。
また、遊びに来て下さいね。