日期与时间#

日期与时间(Date & Time)节点用于操作日期时间数据并将其转换为不同格式。

/// 注意 | 时区设置该节点依赖于时区设置。n8n 会按以下顺序使用时区：

如果设置了工作流时区，则优先使用工作流时区。更多信息请参考工作流设置。
如果未设置工作流时区，则使用 n8n 实例时区。自托管实例默认为 America/New York。n8n Cloud 会在用户注册时尝试检测其所在时区，若检测失败则默认使用 GMT。自托管用户可以通过环境变量修改实例设置。云管理员可以在管理面板中更改实例时区。 ///

其他节点中的日期时间处理

您可以在代码节点(Code node)以及任何节点的表达式中处理日期时间数据。n8n 支持使用 Luxon 库来帮助在 JavaScript 中处理日期时间。更多信息请参考使用 Luxon 处理日期时间。

操作类型#

日期加法：向指定日期添加一定时间量
提取日期部分：提取日期的某部分，如年、月或日
格式化日期：使用预设选项或自定义表达式将日期转换为新格式
获取当前日期：获取当前日期并可选择是否包含当前时间。适用于触发其他工作流和条件逻辑
计算日期差值：计算两个日期之间以特定单位表示的时间量
日期舍入：将日期向上或向下舍入到您选择的最近单位，如月、日或小时
日期减法：从指定日期减去一定时间量

各操作的具体参数和选项请参考下方对应章节。

日期加法#

使用以下参数配置此操作：

基准日期：输入需要修改的日期
时间单位：为持续时间参数选择时间单位
持续时间：输入要添加到日期的单位数量
输出字段名：输入新日期要输出的字段名称

日期加法选项#

此操作有一个选项：包含输入字段。如需在输出中包含所有输入字段，请启用此选项。如关闭，则仅输出输出字段名及其内容。

提取日期部分#

使用以下参数配置节点进行此操作：

日期：输入您想要提取部分的日期
部分：选择您想要提取的日期部分。可选：
- 年
- 月
- 周
- 日
- 小时
- 分钟
- 秒
输出字段名：输入用于输出提取日期部分的字段名称

提取日期部分选项#

此操作有一个选项：包含输入字段。如果您希望在输出中包含所有输入字段，请开启此选项。如果关闭，则仅输出输出字段名及其内容。

格式化日期#

使用以下参数配置节点进行此操作：

日期：输入您想要格式化的日期
格式：选择您想要转换的日期格式。可选：
- 自定义格式：使用 Luxon 的特殊标记输入您自己的自定义格式。标记区分大小写。
- MM/DD/YYYY：对于 1986年9月4日，此格式会将日期格式化为 09/04/1986
- YYYY/MM/DD：对于 1986年9月4日，此格式会将日期格式化为 1986/09/04
- MMMM DD YYYY：对于 1986年9月4日，此格式会将日期格式化为 September 04 1986
- MM-DD-YYYY：对于 1986年9月4日，此格式会将日期格式化为 09-04-1986
- YYYY-MM-DD：对于 1986年9月4日，此格式会将日期格式化为 1986-09-04
输出字段名：输入用于输出格式化日期的字段名称

格式化日期选项#

此操作包含以下选项：

包含输入字段：若要在输出中包含所有输入字段，请启用此选项。若关闭，则仅输出输出字段名称及其内容。
源日期格式：如果节点无法正确识别日期格式，请在此处输入该日期的格式以便节点正确处理。使用 Luxon 的特殊标记输入格式。标记区分大小写。
使用工作流时区：选择使用输入的时区（关闭）还是工作流的时区（开启）。

获取当前日期#

使用以下参数配置此操作的节点：

包含当前时间：选择是否包含当前时间（开启）或将时间设置为午夜（关闭）。
输出字段名称：输入要输出当前日期的字段名称。

获取当前日期选项#

此操作包含以下选项：

包含输入字段：若要在输出中包含所有输入字段，请启用此选项。若关闭，则仅输出输出字段名称及其内容。
时区：设置要使用的时区。若留空，节点将使用 n8n 实例的时区。

+00:00 时区

对于 +00:00 时区，请使用 GMT。

计算日期时间差#

使用以下参数配置此操作的节点：

开始日期：输入要比较的较早日期。
结束日期：输入要比较的较晚日期。
单位：选择要计算时间差的单位。可包含多个单位。可选：
- 年
- 月
- 周
- 日
- 小时
- 分钟
- 秒
- 毫秒
输出字段名称：输入要输出计算结果的字段名称。

获取日期时间差选项#

"获取日期时间差"操作包含包含输入字段选项以及输出为ISO字符串选项。如果关闭后者选项，每个选中的时间单位将返回独立的时间差计算结果，例如：

timeDifference
years : 1
months : 3
days : 13

如果开启输出为ISO字符串选项，节点会将输出格式化为单个ISO持续时间字符串，例如：P1Y3M13D。

ISO持续时间格式显示为P<n>Y<n>M<n>DT<n>H<n>M<n>S。其中<n>代表紧随其后的时间单位数值。

P = 周期（持续时间）。所有ISO持续时间字符串以此开头
Y = 年
M = 月
W = 周
D = 天
T = 日期与时间的分隔符，用于避免月份与分钟的混淆
H = 小时
M = 分钟
S = 秒

毫秒没有独立单位，而是以小数秒表示。例如2.1毫秒表示为0.0021S。

日期取整#

使用以下参数配置该操作节点：

日期：输入需要取整的日期
模式：选择向下取整或向上取整
取整单位：选择取整的时间单位。可选：
- 年
- 月
- 周
- 天
- 小时
- 分钟
- 秒
输出字段名：输入用于输出取整后日期的字段名称

日期取整选项#

此操作有一个选项：包含输入字段。如需在输出中包含所有输入字段，请开启此选项。若关闭，则仅输出输出字段名及其内容。

从日期中减去时间#

使用以下参数配置该节点操作：

基准日期：输入您想要进行减法运算的日期
时间单位：选择要减去的时长单位
时长：输入要从基准日期中减去的时间单位数量
输出字段名：输入用于输出计算后日期的字段名称

从日期中减去的选项#

此操作有一个选项：包含输入字段。若要在输出中包含所有输入字段，请启用此选项。如果关闭，则仅输出输出字段名及其内容。

模板与示例#

Browse 日期与时间 integration templates, or search all templates