Power Automate 常用表达式函数
表达式函数的参考指南 - Azure Logic Apps | Microsoft Learn
日期和时间函数
若要使用日期和时间,可以使用这些日期和时间函数。 有关每个函数的完整参考,请参阅按字母排序的列表。
日期或时间函数 | 任务 |
---|---|
addDays | 将日期添加到时间戳。 |
addHours | 将小时添加到时间戳。 |
addMinutes | 将分钟添加到时间戳。 |
addSeconds | 将秒添加到时间戳。 |
addToTime | 将指定的时间单位加到时间戳。 另请参阅 getFutureTime。 |
convertFromUtc | 将时间戳从协调世界时 (UTC) 转换为目标时区。 |
convertTimeZone | 将时间戳从源时区转换为目标时区。 |
convertToUtc | 将时间戳从源时区转换为协调世界时 (UTC)。 |
dateDifference | 以时间跨度形式返回两个日期之间的差值。 |
dayOfMonth | 返回时间戳中月份组成部分的日期。 |
dayOfWeek | 返回时间戳中周组成部分的星期日期。 |
dayOfYear | 返回时间戳中年组成部分的日期。 |
formatDateTime | 返回时间戳中的日期。 |
getFutureTime | 返回当前时间戳加上指定的时间单位。 另请参阅 addToTime。 |
getPastTime | 返回当前时间戳减去指定的时间单位。 另请参阅 subtractFromTime。 |
parseDateTime | 从包含时间戳的字符串中返回时间戳。 |
startOfDay | 返回时间戳中的天的开始时间。 |
startOfHour | 返回时间戳中的小时的开始时间。 |
startOfMonth | 返回时间戳中的月份的开始时间。 |
subtractFromTime | 从时间戳中减去一定数目的时间单位。 另请参阅 getPastTime。 |
ticks | 返回指定时间戳的 ticks 属性值。 |
utcNow | 返回字符串形式的当前时间戳。 |
addHours
将小时添加到时间戳。
addHours('<timestamp>', <hours>, '<format>'?)
参数 | 必选 | 类型 | 说明 |
---|---|---|---|
<timestamp> | 是 | 字符串 | 包含时间戳的字符串 |
<hours> | 是 | Integer | 要加上的正负小时数 |
<format> | 否 | 字符串 | 一个数字格式字符串,它是单个格式说明符或自定义格式模式。 时间戳的默认格式为“o”(yyyy-MM-ddTHH:mm:ss.fffffffK),这符合 ISO 8601 标准并保留了时区信息。 如果格式不是有效值,则会生成错误。 |
返回值 | 类型 | 说明 |
---|---|---|
<updated-timestamp> | 字符串 | 时间戳加上指定的小时数 |
示例 1
此示例将 10 小时加到指定的时间戳:
addHours('2018-03-15T00:00:00Z', 10)
并返回以下结果:"2018-03-15T10:00:00.0000000Z"
utcNow
返回当前时间戳。
utcNow('<format>')
另外,也可以使用 <format> 参数指定不同的格式。
参数 | 必选 | 类型 | 说明 |
---|---|---|---|
<format> | 否 | 字符串 | 一个数字格式字符串,它是单个格式说明符或自定义格式模式。 时间戳的默认格式为“o”(yyyy-MM-ddTHH:mm:ss.fffffffK),这符合 ISO 8601 标准并保留了时区信息。 如果格式不是有效值,则会生成错误。 |
返回值 | 类型 | 说明 |
---|---|---|
<current-timestamp> | 字符串 | 当前日期和时间 |
示例 1
假设今天的当前时间为 2018 年 4 月 15 日下午 1:00:00。 此示例获取当前时间戳:
utcNow()
并返回以下结果:"2018-04-15T13:00:00.0000000Z"
示例 2
假设今天的当前时间为 2018 年 4 月 15 日下午 1:00:00。 此示例使用可选的“D”格式获取当前时间戳:
utcNow('D')
并返回以下结果:"Sunday, April 15, 2018"
addHours(utcNow(),8,'yyyy/MM/dd HH:mm:ss')