Duaer

表达式与代码

Duaer 日期上的转换方法

Duaer 表达式里,$now 和 $today 是 Luxon 的 DateTime。字符串或数字要先 toDateTime(),再调用 format、plus、setZone。

先变成 DateTime

日期运算对象是 DateTime,不是普通的 Date。$now 和 $today 已经是 DateTime。字符串、数字用 toDateTime() 转过去。库本身的差别——包括 Code 节点里要用 toFormat 而不是 format——见在 Duaer 里用 Luxon 处理日期

{{ $json.createdAt.toDateTime().toFormat("yyyy-MM-dd") }}

DateTime 上常用的方法和属性

  • year、month、day、hour、minute、second、millisecond、quarter、weekNumber、weekday:读出那一部分。monthLong、monthShort、weekdayLong、weekdayShort 是文字。
  • toFormat 在快捷页用过。format() 是表达式里的格式化扩展。
  • plus(数量, 单位)、minus(数量, 单位):加减。startOf(单位)、endOf(单位):取这一单位的开始或结束。
  • set({ ... }):改其中一部分。setZone(时区)、toUTC()、toLocal():换时区。
  • toISO()、toMillis()、toSeconds()、toString()、toLocaleString()、toRelative():输出成字符串或数字。
  • diffTo(另一个时间)、diffToNow():算间隔。equals()、hasSame(单位)、isBetween():比较。
  • extract(单位):取出单位。isEmpty()、isNotEmpty()、isInDST、locale、zone:空值、夏令时、语言和时区。
  • setLocale(语言):改这份时间的语言,影响月份名字这类输出。

常见问题

在 Duaer 里 $now 是什么类型?

在 Duaer 表达式里,$now 和 $today 是 Luxon 的 DateTime。字符串或数字要先 toDateTime(),再调用 toFormat、plus 或 setZone。

Duaer 表达式的 plus 和 Code 节点的 plus 一样吗?

不一样。Duaer 表达式可以写 plus(7, "days")。Code 节点里的原生 Luxon 要写成 plus({ days: 7 })。表达式的 format() 对应 Code 节点的 toFormat()。

同组

变量

在 Duaer 里定义自定义变量

在 Duaer 里用自定义变量存值,并在多条数字组织中复用。

表达式

在 Duaer 里用表达式转换数据

Duaer 表达式写在 {{ }} 里,可在支持表达式的参数中调用转换方法。只做字段整理时,先用 Edit Fields(Set)。

表达式

在 Duaer 里使用内置方法和变量

Duaer 在表达式里提供读取数据的变量和按类型调用的方法。Code 节点跑的是普通 JavaScript 和原生 Luxon。

表达式

在 Duaer 表达式里使用快捷方法

在 Duaer 表达式里用 $json 读当前项,用 $("节点名") 读前面的节点,用 $now 和 $if() 处理时间和条件。

表达式

在 Duaer 里使用 HTTP 节点分页变量

Duaer 的 HTTP Request 节点在分页表达式里提供 $pageCount、$request 和 $response。这三个名字只在该节点里有效。

转换

在 Duaer 里使用数据转换方法

在 Duaer 表达式里,在值后面调用转换方法,例如 {{ $json.name.toTitleCase() }}。按数组、布尔、日期、数字、对象、字符串分组。

转换

Duaer 数组上的转换方法

在 Duaer 表达式里,数组方法写在数组后面,例如 {{ $json.ids.unique() }}。average、max、min 遇到非数字会报错。

转换

Duaer 布尔值上的转换方法

在 Duaer 表达式里,布尔值可以判断空不空,也可以转成数字或字符串。true 转成数字是 1,false 是 0。

转换

Duaer 数字上的转换方法

在 Duaer 表达式里,数字方法做取整、奇偶判断,以及转成布尔、字符串或 DateTime。round 取最接近的数,ceil 向上,floor 向下。

转换

Duaer 对象上的转换方法

在 Duaer 表达式里,对象方法用来判断字段、删字段、合并,以及把对象编成查询字符串。

转换

Duaer 字符串上的转换方法

在 Duaer 表达式里,字符串方法做大小写、截取、判断邮箱和网址,以及 base64 和 URL 编解码。

查询

在 Duaer 里用 JMESPath 查询 JSON

在 Duaer 里用 $jmespath(对象, "查询") 查询 JSON。表达式和 JavaScript Code 节点可用;Python Code 节点没有。

日期

在 Duaer 里用 Luxon 处理日期

Duaer 表达式里的日期是 Luxon 的 DateTime。$now 和 $today 直接就是。Code 节点用原生 Luxon,format() 和 plus(数量, 单位) 不能照搬。

示例

Duaer 表达式示例

这些 Duaer 示例都在表达式模式里:读当前项、补默认值、格式化日期,并在字段很多时改用 Edit Fields(Set)。

示例

Duaer 方法和变量对照

Duaer 表达式里最常用的名字:当前项用 $json,前面的节点用 $("节点名"),变量用 $vars,转换方法按数据类型分到各自的页面。