Skip to content

日期和时间#

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

时区设置

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

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

其他节点中的日期和时间

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

操作#

  • Add to a Date 添加到日期:向日期添加指定的时间量。
  • Extract Part of a Date 提取日期的一部分:提取日期的一部分,如年、月或日。
  • Format a Date 格式化日期:使用预设选项或自定义表达式将日期格式转换为新格式。
  • Get Current Date 获取当前日期:获取当前日期并选择是否包含当前时间。对于触发其他流和条件逻辑很有用。
  • Get Time Between Dates 获取日期之间的时间:计算两个日期之间特定单位的时间量。
  • Round a Date 舍入日期:将日期向上或向下舍入到您选择的最近单位,如月、日或小时。
  • Subtract From a Date 从日期中减去:从日期中减去指定的时间量。

有关每个操作的特定参数和选项,请参考下面的部分。

Add to a Date 添加到日期#

使用这些参数配置此操作的节点:

  • Date to Add To 要添加到的日期:输入您要更改的日期。
  • Time Unit to Add 要添加的时间单位:为持续时间参数选择时间单位。
  • Duration 持续时间:输入要添加到日期的时间单位数量。
  • Output Field Name 输出字段名称:输入要输出新日期的字段名称。

Add to a Date options 添加到日期选项#

此操作有一个选项:Include Input Fields 包含输入字段。如果您想在输出中包含所有输入字段,请打开此选项。如果关闭,则只输出输出字段名称及其内容。

Extract Part of a Date 提取日期的一部分#

使用这些参数配置此操作的节点:

  • Date 日期:输入您要舍入或提取一部分的日期。
  • Part 部分:选择您要提取的日期部分。选择:
    • Year 年
    • Month 月
    • Week 周
    • Day 日
    • Hour 小时
    • Minute 分钟
    • Second 秒
  • Output Field Name 输出字段名称:输入要输出提取的日期部分的字段名称。

Extract Part of a Date options 提取日期部分选项#

此操作有一个选项:Include Input Fields 包含输入字段。如果您想在输出中包含所有输入字段,请打开此选项。如果关闭,则只输出输出字段名称及其内容。

Format a Date 格式化日期#

使用这些参数配置此操作的节点:

  • Date 日期:输入您要格式化的日期。
  • Format 格式:选择您要将日期更改为的格式。选择:
    • Custom Format 自定义格式:使用 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
  • Output Field Name 输出字段名称:输入要输出格式化日期的字段名称。

Format a Date options 格式化日期选项#

此操作包括这些选项:

  • Include Input Fields 包含输入字段:如果您想在输出中包含所有输入字段,请打开此选项。如果关闭,则只输出输出字段名称及其内容。
  • From Date Format 来源日期格式:如果节点无法正确识别日期格式,请在此处输入该日期的格式,以便节点可以正确处理。使用 Luxon 的特殊标记输入格式。标记区分大小写。
  • Use Workflow Timezone 使用工作流时区:是否使用输入的时区(关闭)或工作流的时区(打开)。

Get Current Date 获取当前日期#

使用这些参数配置此操作的节点:

  • Include Current Time 包含当前时间:选择是否包含当前时间(打开)或将时间设置为午夜(关闭)。
  • Output Field Name 输出字段名称:输入要输出当前日期的字段名称。

Get Current Date options 获取当前日期选项#

此操作包括这些选项:

  • Include Input Fields 包含输入字段:如果您想在输出中包含所有输入字段,请打开此选项。如果关闭,则只输出输出字段名称及其内容。
  • Timezone 时区:设置要使用的时区。如果留空,节点使用 n8n 实例的时区。

+00:00 时区

对于 +00:00 时区使用 GMT

Get Time Between Dates 获取日期之间的时间#

使用这些参数配置此操作的节点:

  • Start Date 开始日期:输入您要比较的较早日期。
  • End Date 结束日期:输入您要比较的较晚日期。
  • Units 单位:选择您要计算时间间隔的单位。您可以包含多个单位。选择:
    • Year 年
    • Month 月
    • Week 周
    • Day 日
    • Hour 小时
    • Minute 分钟
    • Second 秒
    • Millisecond 毫秒
  • Output Field Name 输出字段名称:输入要输出计算出的时间间隔的字段名称。

Get Time Between Dates options 获取日期间隔选项#

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

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

如果您打开Output as ISO String 输出为 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

Round a Date 舍入日期#

使用这些参数配置此操作的节点:

  • Date 日期:输入您要舍入的日期。
  • Mode 模式:选择是Round Down 向下舍入还是Round Up 向上舍入
  • To Nearest 到最近的:选择您要舍入到的单位。选择:
    • Year 年
    • Month 月
    • Week 周
    • Day 日
    • Hour 小时
    • Minute 分钟
    • Second 秒
  • Output Field Name 输出字段名称:输入要输出舍入日期的字段名称。

Round a Date options 舍入日期选项#

此操作有一个选项:Include Input Fields 包含输入字段。如果您想在输出中包含所有输入字段,请打开此选项。如果关闭,则只输出输出字段名称及其内容。

Subtract From a Date 从日期中减去#

使用这些参数配置此操作的节点:

  • Date to Subtract From 要减去的日期:输入您要减去的日期。
  • Time Unit to Subtract 要减去的时间单位:为您要减去的持续时间量选择单位。
  • Duration 持续时间:输入您要从要减去的日期中减去的时间单位量。
  • Output Field Name 输出字段名称:输入要输出舍入日期的字段名称。

Subtract From a Date options 从日期减去选项#

此操作有一个选项:Include Input Fields 包含输入字段。如果您想在输出中包含所有输入字段,请打开此选项。如果关闭,则只输出输出字段名称及其内容。

模板和示例#

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

相关资源#

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

支持的日期格式#

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