n8n 中文文档

Luxon 的日期和时间

Luxon 是一个 JavaScript 库,可以更轻松地处理日期和时间。有关如何使用 Luxon 的完整详细信息,请参阅 Luxon 的文档。

n8n 将节点之间的日期作为字符串传递,因此您需要解析它们。 Luxon 让这一切变得更容易。

提示

Python support Python支持

Luxon 是一个 JavaScript 库。在代码节点中使用 Python 时,可以使用 n8n 创建的两个方便的变量,但它们的功能有限:

  • 您无法对这些变量执行 Luxon 运算。例如,$today.minus(...) 没有 Python 等效项。
  • 通用 Luxon 功能,例如 将日期字符串转换为 Luxon,不适用于 Python 用户。

n8n 中的日期和时间行为

请注意以下事项:

  • 在工作流程中,n8n 将日期和时间转换为节点之间的字符串。对其他节点的日期和时间进行算术时请记住这一点。
  • 在 n8n 中推荐使用 Luxon 的 DateTime() 方法。使用普通 JavaScript 的 Date() 不适用于某些 n8n 功能。例如,它不遵守工作流程特定时区。
  • 使用普通 JavaScript,您可以使用 new Date('2019-06-23') 将字符串转换为日期。在 Luxon 中,您必须使用明确说明格式的函数,例如 DateTime.fromISO('2019-06-23') 或 DateTime.fromFormat("23-06-2019", "dd-MM-yyyy")。

在 n8n 中设置时区

Luxon 使用 n8n 时区。该值是:

  • 默认值:America/New York
  • n8n 实例的自定义时区,使用 GENERIC_TIMEZONE 环境变量设置。
  • 单个工作流程的自定义时区,在工作流程设置中配置。

常见任务

本节提供一些常见操作的示例。更多示例和详细指南可在 Luxon 自己的文档 中找到。

获取当前日期时间或日期

使用 $now 和 $today Luxon 对象获取当前时间或日期:

  • now:包含当前时间戳的Luxon对象。相当于 DateTime.now()。
  • today:包含当前时间戳的 Luxon 对象,向下舍入到日期。相当于 DateTime.now().set({ hour: 0, minute: 0, second: 0, millisecond: 0 })。

请注意,这些变量在转换为字符串时可以返回不同的时间格式:

Expressions (JavaScript)

{{$now}}
// n8n displays the ISO formatted timestamp
// For example 2022-03-09T14:02:37.065+00:00
{{"Today's date is " + $now}}
// n8n displays "Today's date is <unix timestamp>"
// For example "Today's date is 1646834498755"

Code node (JavaScript)

$now
// n8n displays <ISO formatted timestamp>
// For example 2022-03-09T14:00:25.058+00:00
let rightNow = "Today's date is " + $now
// n8n displays "Today's date is <unix timestamp>"
// For example "Today's date is 1646834498755"

Code node (Python)

_now
# n8n displays <ISO formatted timestamp>
# For example 2022-03-09T14:00:25.058+00:00
rightNow = "Today's date is " + str(_now)
# n8n displays "Today's date is <unix timestamp>"
# For example "Today's date is 1646834498755"

n8n 提供内置的便利函数来支持日期表达式中的数据转换。有关更多信息,请参阅表达式参考。

将 JavaScript 日期转换为 Luxon

要将本机 JavaScript 日期转换为 Luxon 日期:

  • 在表达式中,使用 .toDateTime() 方法。例如,{{ (new Date()).toDateTime() }}。
  • 在代码节点中,使用 DateTime.fromJSDate()。例如,let luxondate = DateTime.fromJSDate(new Date())。

将日期字符串转换为 Luxon

您可以将日期字符串和其他日期格式转换为 Luxon DateTime 对象。您可以从标准格式和任意字符串进行转换。

提示

A difference between Luxon DateTime and JavaScript Date Luxon DateTime 和 JavaScript Date 之间的区别

使用普通 JavaScript,您可以使用 new Date('2019-06-23') 将字符串转换为日期。在 Luxon 中,您必须使用明确说明格式的函数,例如 DateTime.fromISO('2019-06-23') 或 DateTime.fromFormat("23-06-2019", "dd-MM-yyyy")。

如果您有受支持的标准技术格式的日期:

大多数日期使用 fromISO()。这将根据 ISO 8601 字符串创建 Luxon DateTime。例如:

Expressions (JavaScript)

{{DateTime.fromISO('2019-06-23T00:00:00.00')}}

Code node (JavaScript)

let luxonDateTime = DateTime.fromISO('2019-06-23T00:00:00.00')

Luxon 的 API 文档在 fromISO 上提供了更多信息。

Luxon 提供了处理多种格式转换的函数。详情请参考Luxon的解析技术格式指南。

如果您的日期为不使用标准格式的字符串:

使用Luxon的Ad-hoc解析。为此,请使用 fromFormat() 函数,提供字符串和一组描述格式的 标记。

例如,n8n 的成立日期为 2019 年 6 月 23 日,格式为 23-06-2019。您想将其转换为 Luxon 对象:

Expressions (JavaScript)

{{DateTime.fromFormat("23-06-2019", "dd-MM-yyyy")}}

Code node (JavaScript)

let newFormat = DateTime.fromFormat("23-06-2019", "dd-MM-yyyy")

使用即席解析时,请注意 Luxon 关于 限制 的警告。如果您看到意外结果,请尝试他们的调试 指南。

从今天起获取 n 天

获取今天之前或之后的天数。

Expressions (JavaScript)

例如,您希望将字段设置为始终显示当前日期前 7 天的日期。

在表达式编辑器中,输入:

{{$today.minus({days: 7})}}

2019 年 6 月 23 日,返回 [Object: "2019-06-16T00:00:00.000+00:00"]。

为了方便起见,本示例使用 n8n 的自定义变量 $today。它相当于 DateTime.now().set({ hour: 0, minute: 0, second: 0, millisecond: 0 }).minus({days: 7})。

Code node (JavaScript)

例如,您需要一个包含当前日期前 7 天的日期的变量。

在代码编辑器中输入:

let sevenDaysAgo = $today.minus({days: 7})

2019 年 6 月 23 日,返回 [Object: "2019-06-16T00:00:00.000+00:00"]。

为了方便起见,本示例使用 n8n 的自定义变量 $today。它相当于 DateTime.now().set({ hour: 0, minute: 0, second: 0, millisecond: 0 }).minus({days: 7})。

有关更详细的信息和示例,请参阅:

创建人类可读的日期

在 从今天开始计算 n 天 中,该示例获取当前日期前 7 天的日期,并将其返回为 [Object: "yyyy-mm-dd-T00:00:00.000+00:00"](对于表达式)或 yyyy-mm-dd-T00:00:00.000+00:00(在代码节点中)。为了使其更具可读性,您可以使用 Luxon 的格式化函数。

例如,您希望包含日期的字段格式为 DD/MM/YYYY,以便在 2019 年 6 月 23 日返回 23/06/2019。

此表达式获取今天之前 7 天的日期,并将其转换为 DD/MM/YYYY 格式。

Expressions (JavaScript)

{{$today.minus({days: 7}).toLocaleString()}}

Code node (JavaScript)

let readableSevenDaysAgo = $today.minus({days: 7}).toLocaleString()

您可以更改格式。例如:

Expressions (JavaScript)

{{$today.minus({days: 7}).toLocaleString({month: 'long', day: 'numeric', year: 'numeric'})}}

2019 年 6 月 23 日,返回“2019 年 6 月 16 日”。

Code node (JavaScript)

let readableSevenDaysAgo = $today.minus({days: 7}).toLocaleString({month: 'long', day: 'numeric', year: 'numeric'})

2019 年 6 月 23 日,返回“2019 年 6 月 16 日”。

有关详细信息,请参阅 Luxon 的 toLocaleString(人类字符串) 指南。

获取两个日期之间的时间

要获取两个日期之间的时间,请使用 Luxon 的差异功能。这会从一个日期中减去另一个日期并返回持续时间。

例如,获取两个日期之间的月数:

Expressions (JavaScript)

{{DateTime.fromISO('2019-06-23').diff(DateTime.fromISO('2019-05-23'), 'months').toObject()}}

这将返回 [Object: {"months":1}]。

Code node (JavaScript)

let monthsBetweenDates = DateTime.fromISO('2019-06-23').diff(DateTime.fromISO('2019-05-23'), 'months').toObject()

这将返回 {"months":1}。

请参阅 Luxon 的 Diffs 了解更多信息。

更长的例子:距离圣诞节还有多少天?

此示例汇集了多个 Luxon 功能,使用 JMESPath,并执行一些基本的字符串操作。

场景:您想要 12 月 25 日倒计时。每天,它都会告诉您距离圣诞节还剩多少天。您不想在明年更新它 - 它需要每年都能无缝工作。

Expressions (JavaScript)

{{"There are " + $today.diff(DateTime.fromISO($today.year + '-12-25'), 'days').toObject().days.toString().substring(1) + " days to Christmas!"}}

Code node (JavaScript)

let daysToChristmas = "There are " + $today.diff(DateTime.fromISO($today.year + '-12-25'), 'days').toObject().days.toString().substring(1) + " days to Christmas!";

输出 "There are <number of days> days to Christmas!"。例如,3 月 9 日,它输出 "There are 291 days to Christmas!"(即“距离圣诞节还有 291 天!”)。

代码作用的详细解释:

  • {{ 和 }}:在表达式版本中表示表达式的开始和结束。Code 节点版本不需要它们。
  • "There are ":一个字符串。
  • +:用于连接两个字符串。
  • $today.diff():这与获取两个日期之间的时间中的示例类似,但它使用 n8n 的自定义 $today 变量。
  • DateTime.fromISO($today.year + '-12-25'), 'days':这部分使用 $today.year 获取当前年份,将其与月份和日期一起转换为 ISO 字符串,然后获取整个 ISO 字符串并将其转换为 Luxon DateTime 数据结构。它还告诉 Luxon 您需要以天为单位的持续时间。
  • toObject() 将 diff() 的结果转换为更可用的对象。此时,表达式返回 [Object: {"days":-<number-of-days>}]。例如,3 月 9 日,[Object: {"days":-291}]。
  • .days 使用 JMESPath 语法从对象中仅检索天数。有关将 JMESPath 与 n8n 结合使用的更多信息,请参阅我们的 JMESpath 文档。这为您提供了距离圣诞节的天数,为负数。
  • .toString().substring(1) 将数字转换为字符串并删除 -。
  • + " days to Christmas!":另一个字符串,用 + 将其连接到前一个字符串。

相关资源

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。