Skip to content

日期和时间#

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

时区设置

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

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

Date and time in other nodes

You can work with data and time in the Code node, and in expressions in any node. n8n supports Luxon to help work with date and time in JavaScript. Refer to Date and time with Luxon for more information.

操作#

  • 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 包含输入字段。如果您想在输出中包含所有输入字段，请打开此选项。如果关闭，则只输出输出字段名称及其内容。

模板和示例#

Template widget placeholder.

相关资源#

The Date & Time node uses Luxon. You can also use Luxon in the Code node and expressions. Refer to Date and time with Luxon for more information.

支持的日期格式#

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