映射数据流中的日期和时间函数
适用于：
Azure 数据工厂 Azure Synapse Analytics
数据流在 Azure 数据工厂和 Azure Synapse 管道中均可用。 本文适用于映射数据流。 如果不熟悉转换，请参阅介绍性文章使用映射数据流转换数据。
以下文章详细介绍了映射数据流中 Azure 数据工厂和 Azure Synapse Analytics 所支持的日期和时间函数。
表达式函数列表
在数据工厂和 Synapse 管道中，使用日期和时间函数来表示日期/时间值并对其进行操作。
| 表达式函数 | 任务 |
|---|---|
| add | 添加一对字符串或数字。 将日期添加到日期数。 将持续时间添加到时间戳。 将类似类型的数组追加到另一个数组。 与 + 运算符相同。 |
| addDays | 将日期添加到日期或时间戳。 与日期的 + 运算符相同。 |
| addMonths | 将月份添加到日期或时间戳。 可以选择性地传递时区。 |
| between | 检查第一个值是否在两个其他值之间（含这两个值）。 可以比较数字、字符串和日期值 |
| currentDate | 当此作业开始运行时获取当前日期。 可以“GMT”、“PST”、“UTC”、“America/Cayman”格式传递可选的时区。 当地时区用作默认值。 请参阅 Java 的 SimpleDateFormat 类，了解可用格式。 https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html。 |
| currentTimestamp | 当作业开始运行时，获取采用当地时区的当前时间戳。 |
| currentUTC | 获取 UTC 格式的当前时间戳。 如果希望在不同于你的群集时区的时区中解释当前时间，可以传递“GMT”、“PST”、“UTC”或“开曼群岛”等可选时区。 默认使用当前时区。 请参阅 Java 的 SimpleDateFormat 类，了解可用格式。 https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html。 要将 UTC 时间转换为其他时区，请使用 fromUTC()。 |
| dayOfMonth | 获取给定日期的月份日期。 |
| dayOfWeek | 获取给定日期的星期日期。 1 - 星期日，2 - 星期一…7 - 星期六。 |
| dayOfYear | 获取给定日期的年份日期。 |
| days | 天数的持续时间（以毫秒为单位）。 |
| fromUTC | 转换为 UTC 格式的时间戳。 可以选择以“GMT”、“PST”、“UTC”、“America/Cayman”格式传递时区。 默认使用当前时区。 请参阅 Java 的 SimpleDateFormat 类，了解可用格式。 https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html。 |
| hour | 获取时间戳的小时值。 可以“GMT”、“PST”、“UTC”、“America/Cayman”格式传递可选的时区。 当地时区用作默认值。 请参阅 Java 的 SimpleDateFormat 类，了解可用格式。 https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html。 |
| 小时数 | 小时数的持续时间（以毫秒为单位）。 |
| isDate | 使用可选输入日期格式检查输入日期字符串是否为日期。 有关可用格式，请参阅 Java 的 SimpleDateFormat。 如果省略输入日期格式，则默认格式为 yyyy-[M]M-[d]d。 接受的格式为 [ yyyy, yyyy-[M]M, yyyy-[M]M-[d]d, yyyy-[M]M-[d]dT* ] |
| isTimestamp | 使用可选输入时间戳格式检查输入日期字符串是否为时间戳。 有关可用格式，请参阅 Java 的 SimpleDateFormat。 如果省略时间戳，则使用默认模式 yyyy-[M]M-[d]d hh:mm:ss[.f...]。 可以“GMT”、“PST”、“UTC”、“America/Cayman”格式传递可选的时区。 时间戳最多支持毫秒准确度，值为 999。有关可用格式，请参阅 Java 的 SimpleDateFormat。 |
| lastDayOfMonth | 获取给定日期的最后一个月份日期。 |
| millisecond | 获取日期的毫秒值。 可以“GMT”、“PST”、“UTC”、“America/Cayman”格式传递可选的时区。 当地时区用作默认值。 请参阅 Java 的 SimpleDateFormat 类，了解可用格式。 https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html。 |
| milliseconds | 毫秒数的持续时间（以毫秒为单位）。 |
| minus | 减去数字。 从日期数中减去日期。 从时间戳中减去持续时间。 减去两个时间戳以获取差异（以毫秒为单位）。 与 - 运算符相同。 |
| minute | 获取时间戳的分钟值。 可以“GMT”、“PST”、“UTC”、“America/Cayman”格式传递可选的时区。 当地时区用作默认值。 请参阅 Java 的 SimpleDateFormat 类，了解可用格式。 https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html。 |
| minutes | 分钟数的持续时间（以毫秒为单位）。 |
| month | 获取日期或时间戳的月份值。 |
| monthsBetween | 获取两个日期之间的月数。 你可以采用四舍五入计算法。 可以“GMT”、“PST”、“UTC”、“America/Cayman”格式传递可选的时区。 当地时区用作默认值。 请参阅 Java 的 SimpleDateFormat 类，了解可用格式。 https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html。 |
| second | 获取日期的秒值。 可以“GMT”、“PST”、“UTC”、“America/Cayman”格式传递可选的时区。 当地时区用作默认值。 请参阅 Java 的 SimpleDateFormat 类，了解可用格式。 https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html。 |
| seconds | 秒数的持续时间（以毫秒为单位）。 |
| subDays | 从日期或时间戳中减去天数。 与日期的 - 运算符相同。 |
| subMonths | 从日期或时间戳中减去月份。 |
| toDate | 使用可选输入日期格式将输入日期字符串转换为日期。 请参阅 Java 的 SimpleDateFormat 类，了解可用格式。 如果省略输入日期格式，则默认格式为 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”、“PST”、“UTC”、“America/Cayman”格式传递可选的时区。 时间戳支持高达 999 毫秒的精度值。 请参阅 Java 的 SimpleDateFormat 类，了解可用格式。 https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html。 |
| toUTC | 将时间戳转换为 UTC。 可以“GMT”、“PST”、“UTC”、“America/Cayman”格式传递可选的时区。 默认为当前时区。 请参阅 Java 的 SimpleDateFormat 类，了解可用格式。 https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html。 |
| weekOfYear | 获取给定日期的年份周次。 |
| weeks | 周数的持续时间（以毫秒为单位）。 |
| year | 获取日期的年份值。 |