映射数据流中的日期和时间函数

适用于:Azure 数据工厂 Azure Synapse Analytics

数据流在 Azure 数据工厂管道和 Azure Synapse Analytics 管道中都可用。 本文适用于映射数据流。 如果你不熟悉转换,请参阅介绍性文章: 使用映射数据流转换数据

本文提供有关 Azure 数据工厂和 Azure Synapse Analytics 在映射数据流中支持的日期和时间函数的详细信息。

表达式函数列表

在 Azure 数据工厂和 Azure Synapse Analytics 管道中,使用日期和时间函数来表达 datetime 值并对其进行作。

表达式函数 任务
add 添加一对字符串或数字。 将日期添加到日期数。 向时间戳添加时长。 将类似类型的数组追加到另一个数组。 与 + 运算符相同。
addDays 将天数添加到日期或时间戳。 与 + 日期的运算符相同。
addMonths 向日期或时间戳添加月份。 您可以选择性地传递一个时区。
between 检查第一个值是否在两个其他值之间(含这两个值)。 可以比较数值、字符串和 datetime 值。
currentDate 当此作业开始运行时获取当前日期。 可以采用以下形式GMT传递可选时区:、PSTUTCAmerica/Cayman。 本地时区用作默认值。 有关 可用格式,请参阅 Kusto 的 format_datetime() 函数
currentTimestamp 获取作业在本地时区开始运行时的当前时间戳。
currentUTC 获取当前时间戳作为 UTC。 如果希望当前时间在群集时区以外的时区中解释,则可以采用以下形式GMT传递可选时区:或PSTUTCAmerica/Cayman。 它默认为当前时区。 有关 可用格式,请参阅 Kusto 的 format_datetime() 函数。 若要将 UTC 时间转换为其他时区,请使用 fromUTC()
dayOfMonth 获取给定日期的月份中的某一天。
dayOfWeek 获取给定日期的一周中的一天。 例如,1 是星期日,2 是星期一,继续为 7,即星期六。
dayOfYear 获取给定日期时的年份日期。
days 提供天数的持续时间(以毫秒为单位)。
fromUTC 从 UTC 转换为时间戳。 可以选择以GMTPSTUTCAmerica/Cayman的形式传递时区。 它默认为当前时区。 有关 可用格式,请参阅 Kusto 的 format_datetime() 函数
hour 获取时间戳的小时值。 可以采用以下形式GMT传递可选时区:、PSTUTCAmerica/Cayman。 本地时区用作默认值。 有关 可用格式,请参阅 Kusto 的 format_datetime() 函数
小时数 提供小时数的持续时间(以毫秒为单位)。
isDate 使用可选的输入日期格式检查输入日期字符串是否为日期。 有关 可用格式,请参阅 Kusto 的 format_datetime() 函数。 如果省略输入日期格式,则默认格式为 yyyy-[M]M-[d]d。 接受的格式为 [ yyyy, yyyy-[M]M, yyyy-[M]M-[d]d, yyyy-[M]M-[d]dT* ]
isTimestamp 使用可选的输入时间戳格式检查输入日期字符串是否为时间戳。 有关 可用格式,请参阅 Kusto 的 format_datetime() 函数。 如果省略时间戳,则使用默认模式 yyyy-[M]M-[d]d hh:mm:ss[.f...] 。 可以采用以下形式GMT传递可选时区:、PSTUTCAmerica/Cayman。 该 Timestamp 函数支持高达毫秒的准确性,值为 999。 有关 可用格式,请参阅 Kusto 的 format_datetime() 函数
lastDayOfMonth 获取给定日期时月份的最后一个日期。
millisecond 获取日期的毫秒值。 可以采用以下形式GMT传递可选时区:、PSTUTCAmerica/Cayman。 本地时区用作默认值。 有关 可用格式,请参阅 Kusto 的 format_datetime() 函数
毫秒 提供毫秒数的持续时间(以毫秒为单位)。
减去数字。 减去日期中的天数。 从时间戳中减去持续时间。 减去两个时间戳以获取毫秒的差异。 与 - 运算符相同。
minute 获取时间戳的分钟值。 可以采用以下形式GMT传递可选时区:、PSTUTCAmerica/Cayman。 本地时区用作默认值。 有关 可用格式,请参阅 Kusto 的 format_datetime() 函数
minutes 提供分钟数的持续时间(以毫秒为单位)。
month 从日期或时间戳中获取月份值。
monthsBetween 获取两个日期之间的月数。 你可以把计算结果四舍五入。 可以采用以下形式GMT传递可选时区:、PSTUTCAmerica/Cayman。 本地时区用作默认值。 有关 可用格式,请参阅 Kusto 的 format_datetime() 函数
second 获取日期的秒值。 可以采用以下形式GMT传递可选时区:、PSTUTCAmerica/Cayman。 本地时区用作默认值。 有关 可用格式,请参阅 Kusto 的 format_datetime() 函数
seconds 为秒数提供持续时间(以毫秒为单位)。
subDays 从日期或时间戳中减去天数。 与 - 日期的运算符相同。
subMonths 从日期或时间戳中减去月份。
toDate 使用可选的输入日期格式将输入日期字符串转换为日期。 有关 可用格式,请参阅 Kusto 的 format_datetime() 函数。 如果省略输入日期格式,则默认格式为 yyyy-[M]M-[d]d。 接受的格式为 [ yyyy, yyyy-[M]M, yyyy-[M]M-[d]d, yyyy-[M]M-[d]dT* ]
toTimestamp 给定可选时间戳格式时,将字符串转换为时间戳。 如果省略时间戳,则使用默认模式 yyyy-[M]M-[d]d hh:mm:ss[.f...] 。 可以采用以下形式GMT传递可选时区:、PSTUTCAmerica/CaymanTimestamp 支持最多毫秒的准确性,值为 999。 有关 可用格式,请参阅 Kusto 的 format_datetime() 函数
toUTC 将时间戳转换为 UTC。 可以采用以下形式GMT传递可选时区:、PSTUTCAmerica/Cayman。 它默认为当前时区。 有关 可用格式,请参阅 Kusto 的 format_datetime() 函数
weekOfYear 获取指定日期在一年中的周数。
weeks 为周数提供持续时间(以毫秒为单位)。
year 获取日期的年份值。