日期与时间#
日期与时间节点用于处理日期和时间数据,并将其转换为不同格式。
时区设置
该节点依赖于时区设置。n8n 按以下顺序使用时区:
- 若工作流时区已设置,则优先使用工作流时区。详细信息请参阅工作流设置
- 若未设置工作流时区,则使用 n8n 实例时区。自托管实例默认为
America/New_York。n8n Cloud 会在用户注册时尝试检测其时区,若检测失败则默认使用 GMT。自托管用户可通过环境变量修改实例设置。云管理员可在管理控制台中修改实例时区。
其他节点中的日期与时间
您可以在代码节点及任何节点的表达式中处理日期和时间。n8n 支持使用 Luxon 库在 JavaScript 中处理日期和时间,更多信息请参阅使用 Luxon 处理日期和时间。
操作类型#
- 日期加法:为日期添加指定的时间量
- 提取日期部分:提取日期的特定部分(如年、月、日)
- 格式化日期:通过预设选项或自定义表达式将日期转换为新格式
- 获取当前日期:获取当前日期,并可选择是否包含当前时间。适用于触发其他流程和条件逻辑
- 计算时间间隔:计算两个日期之间以特定单位表示的时间量
- 日期取整:将日期向上或向下取整到最接近的指定单位(如月、日、小时)
- 日期减法:从日期中减去指定的时间量
各操作对应的参数和选项请参阅以下章节。
日期加法#
使用以下参数配置此操作:
- 基准日期:输入需要计算的原始日期
- 时间单位:选择时长参数的时间单位
- 时长:输入要添加到日期的单位数量
- 输出字段名:输入新日期值的输出字段名称
日期加法选项#
此操作有一个选项:包含输入字段。如需在输出中包含所有输入字段,请启用此选项。若关闭此选项,则仅输出输出字段名称及其内容。
提取日期部分#
使用以下参数配置此操作节点:
- 日期:输入需要截取或提取部分的日期
- 部分:选择要提取的日期部分,可选值包括:
- 年
- 月
- 周
- 日
- 小时
- 分钟
- 秒
- 输出字段名称:输入用于输出提取日期部分的字段名称
提取日期部分选项#
此操作有一个选项:包含输入字段。如需在输出中包含所有输入字段,请启用此选项。若关闭此选项,则仅输出输出字段名称及其内容。
格式化日期#
使用以下参数配置此操作节点:
- 日期:输入需要格式化的日期
- 格式:选择目标日期格式,可选值包括:
- 自定义格式:使用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
- 输出字段名称:输入用于输出格式化日期的字段名称
格式化日期选项#
此操作包含以下选项:
- 包含输入字段:如需在输出中包含所有输入字段,请开启此选项。若关闭,则仅输出输出字段名称及其内容。
- 源日期格式:若节点未能正确识别日期格式,请在此处输入该日期的格式以便节点正确处理。使用 Luxon 的特殊标记输入格式。标记区分大小写
- 使用工作流时区:使用输入时区(关闭)还是工作流时区(开启)。
获取当前日期#
使用以下参数配置此操作的节点:
- 包含当前时间:选择是否包含当前时间(开启)或将时间设为午夜(关闭)。
- 输出字段名称:输入要输出当前日期的字段名称。
获取当前日期选项#
此操作包含以下选项:
- 包含输入字段:如需在输出中包含所有输入字段,请开启此选项。若关闭,则仅输出输出字段名称及其内容。
- 时区:设置要使用的时区。若留空,节点将使用 n8n 实例的时区。
+00:00 时区
使用 GMT 表示 +00:00 时区。
获取日期时间间隔#
使用以下参数配置此操作的节点:
- 开始日期:输入要比较的较早日期。
- 结束日期:输入要比较的较晚日期。
- 单位:选择要计算时间间隔的单位。可包含多个单位。可选:
- 年
- 月
- 周
- 日
- 小时
- 分钟
- 秒
- 毫秒
- 输出字段名称:输入要输出计算时间间隔的字段名称。
获取日期时间间隔选项#
获取日期时间间隔操作包含包含输入字段选项以及输出为 ISO 字符串选项。若关闭此选项,每个选定的单位将返回各自的时间差计算结果,例如:
1
2
3
4| ``` 时间差 年 : 1 月 : 3 日 : 13
---|---
如果开启**输出为 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`。
## 日期取整#
通过以下参数配置此操作节点:
* **日期**:输入需要取整的日期
* **模式**:选择**向下取整**或**向上取整**
* **取整单位**:选择取整的最小单位,可选值包括:
* **年**
* **月**
* **周**
* **日**
* **小时**
* **分钟**
* **秒**
* **输出字段名**:输入存储取整后日期的输出字段名称
### 日期取整选项#
此操作包含一个选项:**包含输入字段**。若需要在输出中包含所有输入字段,请开启此选项。若关闭,则仅输出**输出字段名**及其内容。
## 日期减法#
通过以下参数配置此操作节点:
* **被减日期**:输入需要进行减法运算的基准日期
* **时间单位**:选择要减去的时间单位类型
* **时长**:输入需要从**被减日期**中减去的时间单位数量
* **输出字段名**:输入存储计算结果的输出字段名称从日期中减去的选项#
此操作有一个选项:包含输入字段。如需在输出中包含所有输入字段,请开启此选项。若关闭,则仅输出输出字段名称及其内容。
模板和示例#
处理日期和时间 作者:Jonathan 查看模板详情
基于网站内容创建RSS订阅源 作者:Tom 查看模板详情
基于Google Docs知识库和Gemini AI的客户支持WhatsApp机器人 作者:Tharwat Mohamed 查看模板详情
浏览日期与时间集成模板,或搜索所有模板
相关资源#
日期与时间节点使用 Luxon 库。您也可以在代码节点和表达式中使用 Luxon。更多信息请参阅使用 Luxon 处理日期和时间。
支持的日期格式#
n8n 支持 Luxon 支持的所有日期格式。格式符号区分大小写。