Intro to formulas

Notion 函数可以对你现有的数据库属性执行计算，以便你更好地理解数据。

在开始编写函数时，请将函数属性添加到你的 Notion 数据库：

1. 点击数据库中的 ••• 更多

2. 选择属性并点击 + 添加属性

3. 选择函数

4. 点击编辑并开始编写函数

如果你之前有任何编程经验，则会对 Notion 的函数语法感到很熟悉！你可以选择相应函数（用于完成不同任务）和输入（要处理的数据）。数据库每一行都将计算并显示输出（结果），具体显示在新函数属性中。

例如，在此函数中：dateSubtract(prop("Date"), 14, "days")

• 函数为 dateSubtract()

• dateSubtract() 接受一个日期、数字和单位文本作为输入，该单位可以是“天”、“小时”等。

• 输入为 Date（属性）、14（数字）和 "days"（时间单位）。

• 输出则为一个日期，表示在 Date 属性所指定日期的前 14 天。

Notion 的公式编辑器包含几个可协助编写函数的辅助功能。

• 编辑器会根据函数的内容自动提供函数或属性的建议。

  • 你可以使用 up 键和 down 键浏览建议面板，并使用回车键接受建议。

• 对于较长公式，当超出编辑器宽度时会自动换行，你也可以使用 Shift + 回车键进行换行！

  • 如需在各行之间进行切换，可以使用 alt/option + up/down。

• 如果从数据库行打开公式编辑器，你就会看到该行函数结果的实时预览。

  • 请注意，结果预览中不会显示换行符，可以在函数中使用 "\n" 添加换行符，例如："Hello" + "\n" + "World"

• 编辑器将显示错误并突出显示错误的代码，以便你更好地识别问题的来源。

函数可以操作并返回不同的数据类型。支持其他属性类型，但会转换其数据类型。

文本

• 例如，"Hello world"

数字

• 例如，1, -2.5

• 可以使用函数属性的格式选项进行显示（例如，显示为百分比、货币、环形图或条形图）。

日期

• 显示为日期和时间（如 2023 年 8 月 29 日下午 1:33），并可以使用 dateFormat() 函数重新设置格式为文本。

• 日期可以为日期范围，通过 dateRange() 函数进行搭建。

• 日期无法存储秒或毫秒。

人员

• You can use name() or email() to retrieve data off any People types.

• 显示为带有姓名的人员照片。

布尔属性

• 可以为 true 或 false。

• 显示为已填充或未填充的复选框。

页面

• 代表 Notion 页面，不同页面间可能有关联关系。

• 你可以在指定的 Notion 页面上使用 . 来检索其属性！

• 显示为带有页面图标的富媒体页面链接。

Lists(or arrays)

• Lists can hold items of any type, including more lists. Multi-select, People, Relation, and most Rollup properties will return list values.

• 你可以使用列表函数（例如，at()、filter()、map()）来处理列表。

• Use the includes() function to check whether these values contain a specific value instead of equality checks.

  • Example: prop("Tags").includes("Movie")

• 列表项目以逗号分隔显示文本、数字和日期。以空格分隔显示人员、复选框和页面。

空白

• 公式属性输出中不显示空值，但可以在计算中使用空值。

• 你可以使用 empty() 函数检查任何数据项是否为空。

• 例如，toNumber("") 或 parseDate("Not a date") 会返回结果为空。