notion image
notion image
 
以下是阅读本文需要知悉的一些注意事项:
  1. 本文所解析的功能细节以 Notion 官方发布的这篇 文章 为参考
  1. 阅读本文需要具备一定的 Formula 1.0 使用经验,否则可能难以领会 2.0 的更新要点
  1. 作者本人没有一般的编程基础,仅能通过自己对公式应用的理解去为大家解析这些函数的用法,因此可能在一些专业术语的表达上存在错误,欢迎各位读者及时纠正反馈

细节变化

去掉了 prop() 的函数格式

在 Formula 1.0 中,每个字段都需要带上 prop() 的固定格式,于是当你的公式写得复杂,过长的函数格式就会使得阅读体验急剧下降,例如这样:
notion image
Formula 2.0 去除了 prop() 后就能非常直观地让公式缩短,极大提升了可读性:
notion image
不过需要注意的是,当你复制这串新的 Formula 并粘贴于别处(例如 Code block),则会发现粘贴的文本中依然带有 prop() 的格式:
也因此,本文所展示的诸多函数都将继续带有 prop() 的固定样式。

支持代码换行与注释添加

现在的编辑器终于支持换行和添加注释了,这使得公式的书写更加便利,不会写着写着就迷失在各种括号之中:
notion image
换行的方式为 Shift+回车键,添加注释的方法则是用 /* 与 */ 将注释文本包围起来即可。

更快显示计算结果 & 更直观的错误提示

现在的编辑器会在函数下方实时显示计算结果,这样能让你更快地判断函数书写正确与否:
notion image
如果书写错误,它也会出现更加直观易读的错误提醒:
notion image

新增撤销按钮

当我们对现有的公式进行编辑,但编辑结果出现错误的时候,现在可以直接点击右上角的 Revert 按钮,来将所有的操作进行复位:
notion image

全新函数写法 Dot notation

在 Formula 1.0 中,如果我们想实现诸如 「计算特定日期与今天的天数差」,则需要这么写:
notion image
如果你想继续将计算得出的天数转换为字符串,则需要再用 format() 将其包括在内:
notion image
以上是传统的函数调用写法,当函数一长,就会出现无数个括号,我们就总是会因为漏写了哪一个括号而需要花半天时间去排查,在阅读的时候又需要先去找括号,才能找到正确的阅读顺序。
不过现在我们可以在 Formula 中使用如下所示的全新写法:
notion image
这项更新几乎彻底改变了 Formula 的写法与阅读顺序:
  • 最左边的 now() 表示我们要进行操作的对象
  • 其后的 .dateBetween() 函数表示我们要对 now() 进行日期间隔计算
  • 最后的 .format() 表示我们要对前一步的计算结果进行字符串转换
结合可换行的特性,这样函数就变得更加和易读了:
notion image
notion image

新增四个默认字段

现在 Notion 在编辑器中内置了四个默认字段,分别是:
  • Created By、创建者
  • Created Time、创建时间
  • Last Edited By 、最近一位编辑者
  • Last Edited Time 、最近一次编辑时间
这样一来当我们需要用到这些字段的时候,就不用再特意新建一个字段了:
notion image
鉴于 Created By 与 Last Edited By 都与某个 Member 有关,所以我们还可以用 .name() 或者 .email() 这两个函数来直接返回创建者(或编辑者)的姓名或邮箱:
notion image
所以,如果你将 Notion 用于团队协作,并且同一个数据库会有多人参与编辑,就可以用这些默认的内置字段来实时显示编辑者的名字、邮箱或者编辑时间等操作,然后就能达到如下图所示的效果:
notion image

日期函数调整

dateStart 与 dateEnd
在 Formula 1.0 中,如果我们想从一个范围日期中获取它的开始时间或者结束时间,其函数写法是 Start() 或者 end(),不过现在这两个函数被重新命名为 dateStart() 与 dateEnd():
notion image
month、week、day
  • 现在 month() 函数会返回从 1-12 的值,在 Formula 1.0 中则是 0-11;例如现在是 11 月,则 month(now()) 将返回数字 11
  • 现在 day() 函数会返回从 1-7 的值,在 Formula 1.0 中则是 0-6;例如现在是星期三,则 day(now()) 将返回数字 3
  • week(now()) 将返回当前时间是一年中的第几周,例如现在是 11 月 6 号,则 week(now()) 将返回数字 44

新增函数

数组

在 Formula 1.0 中,公式结果只支持输出文本、数值以及布尔值这三种,但现在 Formula 还能够以列表(数组)形式输出结果,例如:
notion image
如果我们在数组的基础上 +1 ,则输出的所有数值都会 +1
notion image
使用 sort() 函数可以对数组进行排序:
notion image
使用 reverse() 函数可以对排序后的数组进行倒序处理:
notion image
除了数字排序,还支持英文首字母排序:
notion image
使用 at() 函数可以输出指定位数的对象(0 为第一个,1 为第二个):
notion image
使用 first() 或者 last() 分别获取首位或者末尾对象:
notion image
使用 unique() 函数去除数组中重复的值,输出唯一值:
notion image
使用 includes() 函数判断数组中是否存在指定的对象,存在则为 ture,否则 flase:
notion image
使用 slice()函数则能从数组中切割出指定数量的对象:
notion image
除了数字数组外,我们还可以在 Formula 中选中人员(Person)、多选(Multi-select)以及关联页面(Relation)等字段,Formula 将直接以数组的形式输出这些字段:
notion image
因为输出的是数组,所以上述提及的所有函数如 sort() 、reverse()、includes() 都是可以应用在这些字段上的。
例如我们还可以用 length() 这个函数来快速计算数组中的对象数量:
notion image
通过这个方法我们可以用 Person 这个字段来统计投票数:
notion image
或者用于统计 Multi-select 的选择个数:
notion image
以上仅是数组的一些基础特性,后面的内容还会介绍更多可供参考的函数与用法。

map

Map 这个函数的基础表达式是 map(list, expression),它能接收一个列表(数组),然后通过你自定义的表达式的处理来返回另一个列表。
以官方提供的案例为例:
我们来逐个解析这串公式:
  • [1,2,3]是我们给定的一个数组
  • current 用于返回当前数组,+1 则是在其基础上增加数值 1
  • [2,3,4] 则是通过 map 这个函数最终返回的结果
接下来我们尝试用 map 函数来读取 Relation 这个字段,并且表达式仅为 current,则这个函数将原封不动地返回 Relation 字段所关联到的页面列表:
notion image
如果在 current后面添加一个点 . ,map 函数就能够 读取并输出页面中的特定字段信息,例如下面的动图我选取的就是 Status 字段,于是 map 函数就返回了所有任务(页面)的当前状态:
notion image
notion image
如果我选择的是 Number(成本) 这个字段,则 map 函数会返回所有页面的成本字段:
notion image
基于数组的特性,我们就可以再使用 min() 或者 max() 函数,然后从中获取成本最少或者最多的那一项,这就是 map 函数的最基础用法。
notion image

filter

在 filter() 这个函数的帮助下,我们无需创建 Rollup 字段,就可以直接用 Formula 来对 Relation 进行快捷的筛选操作。
在本栏目的 4.2 篇中我们讲到了 PARA 个人知识库的搭建方法,在其理论基础上我们会将领域与项目进行关联,例如我的二级领域「笔记软件测评」就使用 Relation 这个字段关联到了数个测评项目上:
notion image
但是随着时间的增长,领域所关联的项目一定会越来越多,而这个字段也会变得越来越拥挤,直到关联个数超过 10 个后,就会将其余字段折叠起来:
notion image
所以这个时候我们就可以利用 filter() 这个函数来对 Relation 字段进行筛选,如果我希望筛选出那些未完成的项目(即 Status 不为 Done),那个这个函数的写法如下:
从左往右阅读这串函数,其含义依次是:
  1. 正在进行操作的字段是 prop("关联项目")
  1. 操作的方式是使用.filter()这个函数对它进行过滤
  1. 过滤方式是使用 current 这个变量来获取prop("关联项目")  的 Status 字段
  1. 最后从中筛选出所有状态不为 Done 的条目(!= 的含义是不等于)
notion image
同样的,如果我希望从中筛选出「负责人是 A 的项目」,那么函数的写法如下:
notion image
再加上 length() 函数,就能通过计算数组所包含的对象的个数来统计出符合筛选条件的个数:
notion image

parseTime

在 Formula 1.0 中,如果我们希望能指定一个自定义的日期,则实现的方式相当麻烦,需要先将日期转换为 Unix 时间戳,然后再利用 fromTimestamp() 这个函数将时间戳转换为可供阅读的日期格式才行,过程非常的繁琐:
notion image
不过现在我们可以使用 parseTime() 这个函数来快捷地输入任意日期:
notion image
但默认情况下返回的日期格式有可能不太符合预期,所以我们可以继续用 formatDate() 函数来指定你希望的格式:
notion image
通过 parseDate() 所自定义的日期就可以参与到 dateBetween() 等日期函数的计算之中了。

let 和 lets

在一些复杂的函数计算中,我们经常遇到需要重复取用同一个计算结果,但这个计算结果又需要通过一串较长的公式才能得出,这就可能导致完整的函数书写中,这串长长的公式需要重复出现多次,使得完整的函数变得冗长且难以阅读。
举一个简单的例子,在 Formula 1.0 中,假设我们有一个「销售业绩数据库」,其中包含 目标销售额 、实际销售额 这两个字段,并且在后续的一系列业绩抽成中,我们需要围绕 实际销售额/目标销售额 所得出的 销售额完成率 来进行计算,这就使得 实际销售额/目标销售额 需要在函数书写中反复出现:
notion image
当然我们确实可以再创建一个字段,单独求出其销售完成率:
notion image
但随着 let() 和 lets() 这两个新函数的出现,今后我们有了全新的解法。这两个函数都能允许你在计算中自定义局部变量,以此减少重复的函数、提高整体可读性。
let() 函数的基本结构是:let(variable, value, expression),官方给定的例子如下:
这里定义了一个名为 name 的变量,并赋值为 "Doug Engelbart"。然后在后续的计算中,我们就能直接使用这个变量 name 来构造一句问候语。
另外,这个例子中出现的人名 Dough Engelbart 其实是 Notion 官方所留下的一个彩蛋,这是一位对 Notion 这款产品的开发历程产生了极其深远影响的学者,你可以阅读我曾经写过的这篇《Notion 10 年发展史》来了解关于这位学者的更多介绍。
lets() 函数的基本结构是:lets(variable, value, variable2, value2, ..., expression),官方给定的例子如下:
这里定义了两个变量:a 和 b,分别赋值为 "Hello" 和 "world”,然后使用这两个变量构造了一个简单的句子。
所以让我们回到本段开头的问题,为了避免 实际销售额/目标销售额 在函数中反复出现,我们就可以用 let() 函数自定义一个名为「销售完成率」的变量,并将其赋值为 实际销售额/目标销售额 ,然后规定当销售完成率大于 1,则奖金 1000 元,小于 1 则没有奖金:
notion image

ifs

在 Formula 1.0 关于 if() 函数的书写中,有一个非常让人头疼的问题就是很容易漏掉多个条件嵌套的括号,例如在下面的绩效工资计算中,不同的绩效评级对应了不同的工资倍率,于是我们的 if 函数就得这么写:
但是随着 ifs 函数的加入,我们可以将整个函数简化成这样:
全程只要用逗号将不同的条件隔开即可,并且最终也只需要一个括号即可,使得书写和阅读体验大大提高。

Style

在 Formula 1.0 中,如果我们希望对输出的文字进行一点修饰,则最多只能用一些 emoji 符号,就像这样:
notion image
但现在 Notion 推出了 sytle 函数,这让我们可以自由地指定字符串的字体颜色、字体背景色、是否加粗等特性:
notion image
Style 的用法也非常简单,如果要实现加粗效果的话,只需要在字符串后面使用.style("b")即可:
notion image
在 Formula 提示框中,官方一共提供了以下几种格式:
  • “b”:加粗
  • “i” :斜体
  • “u”:下划线
  • “c”:代码
  • “s”:删除线
同时可用的字体颜色包括:
  • gray:灰色
  • brown:棕色
  • orange:橙色
  • yellow:黄色
  • green:绿色
  • blue:蓝色
  • purple:紫色
  • pink:粉色
  • red:红色
如果你想添加的是字体的背景颜色,则只需要在颜色的后面添加_background 的后缀即可。
notion image

尾声

至此,本次 Formula 2.0 的基础解析就暂告结束了,我非常期待 Notion 下一次的大更新还将给我们带来怎样新的变化,届时我也将第一时间与各位读者分享,那么就让我们下一篇文章再见吧,感谢大家的支持!
notion image
Loading...