跳转至

日期时间#

日期时间节点操作日期和时间数据，并将其转换为不同格式。

时区设置

该节点依赖于时区设置。n8n 使用以下之一：

  1. 工作流时区（如果已设置）。有关更多信息，请参阅工作流设置。
  2. n8n 实例时区（如果未设置工作流时区）。自托管实例的默认时区是 America/New York。n8n Cloud 会在用户注册时尝试检测实例所有者的时区，默认回退到 GMT。自托管用户可以使用环境变量更改实例设置。Cloud 管理员可以在管理控制台中更改实例时区。

其他节点中的日期和时间

您可以在代码节点中处理日期和时间数据，以及在任何节点的表达式中使用。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 字符串选项。如果您保持此选项关闭，您选择的每个单位将返回自己的时间差计算，例如：

1
2
3
4
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

相关资源#

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

支持的日期格式#

n8n 支持所有 Luxon 支持的日期格式。标记区分大小写。

此页面是否
💬 微信

🚀 与作者交流

关注公众号
n8n实战笔记公众号
n8n实战笔记
📚 教程 💡 案例 🔧 技巧
添加微信
添加作者微信
1对1 专业指导
⚡ 快答 🎯 定制 🚀 支持

添加后请直说来意， 看到会回复。谢谢