日期和时间#
日期和时间节点操作日期和时间数据,并将其转换为不同格式。
时区设置
节点依赖于时区设置。n8n 使用以下之一:
其他节点中的日期和时间
您可以在代码节点中处理数据和时间,以及在任何节点的表达式中。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 |
|
如果您打开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 包含输入字段。如果您想在输出中包含所有输入字段,请打开此选项。如果关闭,则只输出输出字段名称及其内容。
模板和示例#
相关资源#
日期和时间节点使用 Luxon。您也可以在代码节点和表达式中使用 Luxon。有关更多信息,请参考使用 Luxon 处理日期和时间。
支持的日期格式#
n8n 支持 Luxon 支持的所有日期格式。标记区分大小写。