Skip to content

日期和时间

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

时区设置

节点依赖于时区设置。n8n 使用以下任一方式：

  1. 工作流时区（如果已设置）。有关更多信息，请参阅工作流设置。
  2. 如果未设置工作流时区，则为 n8n 实例时区。默认值适用于自托管实例。n8n Cloud 会在实例所有者注册时尝试检测其时区，并将 GMT 时间作为默认值。自托管用户可以使用环境变量更改实例设置。云管理员可以在管理仪表板中更改实例时区。

其他节点中的日期和时间

您可以在代码节点以及任何节点的表达式中处理数据和时间。n8n 支持 Luxon，以帮助您在 JavaScript 中处理日期和时间。有关更多信息，请参阅使用 Luxon 处理日期和时间。

运营

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

有关每个操作的特定参数和选项，请参阅以下部分。

添加日期

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

  • 添加日期：输入您想要更改的日期。
  • 要添加的时间单位：选择持续时间参数的时间单位。
  • 持续时间：输入要添加到日期的时间单位数。
  • 输出字段名称：输入输出新日期的字段名称。

添加日期选项

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

提取日期的一部分

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

  • 日期：输入要四舍五入或提取部分的日期。
  • 部分：选择要提取的日期部分。可选：
    • 年
    • 月
    • 周
    • 日
    • 小时
    • 分钟
    • 秒
  • 输出字段名称：输入输出提取的日期部分的字段名称。

提取日期的一部分选项

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

格式化日期

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

  • 日期：输入要格式化的日期。
  • 格式：选择您要将日期更改为的格式。从以下选项中选择：
    • 自定义格式
    • ：使用 Luxon 的
    输入您自己的自定义格式
    • 。令牌区分大小写。MM
    • /DD/YYYY
    • ：对于
    • ，这会将日期格式化为
    • 。YYYY
    • /MM/DD
    • ：对于
    • ，这会将日期格式化为
    • 。MMMM
    • DD YYYY
    • ：对于
    • ，这会将日期格式化为
    • 。MM
    • -DD-YYYY
    • ：对于
    • ，这会将日期格式化为
    • 。YYYY
    • -MM-DD
    • ：对于
    • ，这会将日期格式化为
    • 。
  • 输出字段名称：输入要输出格式化日期的字段的名称。

格式化日期选项

此操作包括以下选项：

  • 包含输入字段：如果您希望在输出中包含所有输入字段，请启用此选项。如果禁用，则仅输出输出字段名称及其内容。
  • 起始日期格式：如果节点无法正确识别日期格式，请在此处输入该日期的格式，以便节点能够正确处理。请使用 Luxon 的特殊令牌输入格式。令牌区分大小写。
  • 使用工作流时区：是否使用输入的时区（关闭）或工作流的时区（打开）。

获取当前日期

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

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

获取当前日期选项

此操作包括以下选项：

  • 包含输入字段：如果您希望在输出中包含所有输入字段，请启用此选项。如果禁用，则仅输出输出字段名称及其内容。
  • 时区：设置要使用的时区。如果留空，则节点使用 n8n 实例的时区。

+00:00 时区

用于+00:00 时区。

获取日期之间的时间

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

  • 开始日期：输入您想要比较的较早日期。
  • 结束日期：输入您想要比较的较晚日期。
  • 单位：选择要计算时间间隔的单位。您可以包含多个单位。可选：
    • 年、
    • 月、
    • 周
    • 、日、
    • 小时
    • 、分钟
    • 、秒
    • 、毫秒
  • 输出字段名称：输入用于输出计算时间的字段名称。

获取日期之间的时间选项

获取日期间时间操作包含“包含输入字段”选项以及“输出为 ISO 字符串”选项。如果您关闭此选项，则您选择的每个单位将返回其各自的时间差计算结果，例如：

1
2
3
4
timeDifference
years : 1
months : 3
days : 13

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

ISO 持续时间格式显示格式为。是其后单位的数字。

  • P = 周期（持续时间）。它是所有 ISO 持续时间字符串的开头。
  • Y = 年
  • M = 个月
  • W = 周
  • D = 天
  • T = 日期和时间之间的分界线，用于避免月份和分钟之间的混淆
  • H = 小时
  • M = 分钟
  • S = 秒

毫秒没有自己的单位，而是十进制秒。例如，2.1 毫秒是。

围绕日期

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

  • 日期：输入您想要四舍五入的日期。
  • 模式：选择向下舍入还是向上舍入。
  • 到最接近的：选择您想要四舍五入到的单位。可选：
    • 年
    • 月
    • 周
    • 日
    • 小时
    • 分钟
    • 秒
  • 输出字段名称：输入输出四舍五入日期的字段名称。

四舍五入日期选项

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

从日期中减去

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

  • 要减去的日期：输入要减去的日期。
  • 要减去的时间单位：选择要减去的持续时间的单位。
  • 持续时间：输入要从要减去的日期中减去的时间单位量。
  • 输出字段名称：输入输出四舍五入日期的字段名称。

从日期中减去选项

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

模板和示例

没有任何

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

支持的日期格式

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