日期与时间#

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

操作#

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

请参考以下部分，了解每个操作特有的参数和选项。

添加到日期#

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

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

日期添加选项#

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

提取日期的一部分#

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

• 日期: 输入您想要四舍五入或提取部分的日期。
• Part: Select the part of the date you want to extract. Choose from:
  • 年份
  • 月份
  • 周
  • 天
  • 小时
  • 分钟
  • 第二
• 输出字段名称: 输入要将提取的日期部分输出到的字段名称。

提取日期部分选项#

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

格式化日期#

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

• 日期: 输入您想要格式化的日期。
• Format: Select the format you want to change the date to. Choose from:
  • 自定义格式: 使用Luxon的特殊标记输入您自己的自定义格式。标记区分大小写。
  • 月/日/年: 对于4 September 1986，此格式会将日期显示为09/04/1986。
  • YYYY/MM/DD: 对于4 September 1986，此格式会将日期显示为1986/09/04。
  • MMMM DD YYYY: 对于4 September 1986，此格式会将日期显示为September 04 1986。
  • MM-DD-YYYY: 对于4 September 1986，此格式会将日期显示为09-04-1986。
  • YYYY-MM-DD: 对于4 September 1986，此格式会将日期显示为1986-09-04。
• 输出字段名称: 输入要将格式化日期输出到的字段名称。

格式化日期选项#

此操作包含以下选项：

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

获取当前日期#

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

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

获取当前日期选项#

此操作包含以下选项：

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

计算日期之间的时间差#

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

• 开始日期: 输入您想要比较的较早日期。
• 结束日期: 输入您想要比较的较晚日期。
• Units: Select the units you want to calculate the time between. You can include multiple units. Choose from:
  • 年份
  • 月份
  • 周
  • 天
  • 小时
  • 分钟
  • 第二
  • 毫秒
• 输出字段名称: 输入要输出计算时间间隔的字段名称。

获取日期之间时间差选项#

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

1
2
3
4

timeDifference
years : 1
months : 3
days : 13

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

ISO持续时间格式显示为PYMDTHMS。表示其后单位对应的数值。

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

毫秒没有独立的单位，而是以十进制秒表示。例如，2.1毫秒表示为0.0021S。

日期取整#

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

• 日期: 输入您想要四舍五入的日期。
• 模式: 选择是向下取整还是向上取整。
• To Nearest: Select the unit you'd like to round to. Choose from:
  • 年份
  • 月份
  • 周
  • 天
  • 小时
  • 分钟
  • 第二
• 输出字段名称: 输入要将四舍五入日期输出到的字段名称。

日期舍入选项#

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

从日期中减去#

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

• 起始日期: 输入您想要从中减去的日期。
• 要减去的时间单位: 选择您想要减去的持续时间数值的单位。
• 持续时间: 输入要从起始日期中减去的时间单位数量。
• 输出字段名称: 输入要将四舍五入日期输出到的字段名称。

从日期中减去的选项#

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

模板和示例#

相关资源#

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

支持的日期格式#

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