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})。
有关更详细的信息和示例,请参阅:
- Luxon的数学指南
- 他们关于 DateTime plus 和 DateTime minus 的 API 文档
创建人类可读的日期
在 从今天开始计算 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!":另一个字符串,用+将其连接到前一个字符串。