N8N中文教程
集成节点/Built in_nodes/Core_nodes

日期与时间#

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

时区设置

该节点依赖于时区设置。n8n 按以下顺序使用时区:

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

其他节点中的日期与时间

您可以在代码节点及任何节点的表达式中处理日期和时间。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 时区 使用 GMT 表示 +00:00 时区。

获取日期时间间隔#

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

  • 开始日期:输入要比较的较早日期。
  • 结束日期:输入要比较的较晚日期。
  • 单位:选择要计算时间间隔的单位。可包含多个单位。可选:
    • 小时
    • 分钟
    • 毫秒
  • 输出字段名称:输入要输出计算时间间隔的字段名称。

获取日期时间间隔选项#

获取日期时间间隔操作包含包含输入字段选项以及输出为 ISO 字符串选项。若关闭此选项,每个选定的单位将返回各自的时间差计算结果,例如:

1
2
3
4

| ``` 时间差 年 : 1 月 : 3 日 : 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 支持的所有日期格式。格式符号区分大小写。