日期与时间#

日期与时间节点用于处理日期和时间数据，并将其转换为不同格式。

时区设置

该节点依赖于时区设置。n8n 按以下优先级使用时区：

1. 若已设置工作流时区，则优先使用。详情请参阅工作流设置。
2. 若未设置工作流时区，则使用 n8n 实例时区。自托管实例默认为 America/New_York。n8n Cloud 会在用户注册时尝试检测其时区，若检测失败则默认使用 GMT。自托管用户可通过环境变量修改实例设置。云管理员可在管理控制台中修改实例时区。

其他节点中的日期与时间

您可以在代码节点及任何节点的表达式中处理日期和时间。n8n 支持使用 Luxon 库在 JavaScript 中处理日期时间，详情请参阅使用 Luxon 处理日期和时间。

操作类型#

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

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

日期加法#

通过以下参数配置此操作：

• 目标日期：输入需要修改的日期
• 添加时间单位：选择「时长」参数的时间单位
• 时长：输入要添加到日期的时间单位数量
• 输出字段名：输入新日期输出的字段名称

日期加法选项#

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

提取日期部分#

通过以下参数配置此操作：

• 日期：输入需要取整或提取部分的日期
• 提取部分：选择要提取的日期部分，可选：
  • 年
  • 月
  • 周
  • 日
  • 小时
  • 分钟
  • 秒
• 输出字段名：输入提取结果输出的字段名称

提取日期部分选项#

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

格式化日期#

通过以下参数配置此操作：

• 日期：输入需要格式化的日期
• 格式：选择目标格式，可选：
  • 自定义格式：使用 Luxon 的特殊标识符输入自定义格式（注意大小写敏感）
  • 月/日/年：例如 1986年9月4日 格式化为 09/04/1986
  • 年/月/日：例如 1986年9月4日 格式化为 1986/09/04
  • 月份 日 年：例如 1986年9月4日 格式化为 September 04 1986
  • 月-日-年：例如 1986年9月4日 格式化为 09-04-1986
  • 年-月-日：例如 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。

日期取整#

通过以下参数配置节点进行此操作：

• 日期：输入需要取整的日期
• 模式：选择向下取整或向上取整
• 取整单位：选择取整的最小单位，可选：
  • 年
  • 月
  • 周
  • 日
  • 小时
  • 分钟
  • 秒
• 输出字段名称：输入存储取整后日期的输出字段名称

日期取整选项#

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

日期减法#

通过以下参数配置节点进行此操作：

• 被减日期：输入基准日期
• 时间减数单位：选择持续时间数值的单位
• 持续时间：输入需要从被减日期中扣除的时间单位数量
• 输出字段名称：输入存储计算结果的输出字段名称

日期减法选项#

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

模板与示例#

日期时间处理

作者：Jonathan

查看模板详情

基于网站内容创建RSS订阅

作者：Tom

查看模板详情

集成Google Docs知识库与Gemini AI的客户支持WhatsApp机器人

作者：Tharwat Mohamed

查看模板详情

浏览日期时间集成模板 或 搜索所有模板

相关资源#

日期时间节点使用 Luxon 库。您也可以在代码节点和表达式中使用Luxon。更多信息请参考使用Luxon处理日期时间。

支持的日期格式#

n8n支持所有Luxon兼容的日期格式。格式符号区分大小写。