Obsidian Dataview 表达式详解：从基础到高级用法

Obsidian Dataview 表达式详解：从基础到高级用法

obsidian-dataview A high-performance data index and query language over Markdown files, for https://obsidian.md/. 项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-dataview

引言

Obsidian Dataview 插件作为知识管理系统的强大扩展，其查询语言（DQL）中的表达式系统是构建复杂查询的核心基础。本文将全面解析 Dataview 表达式的各种类型和使用场景，帮助用户掌握数据查询的精髓。

表达式基础概念

在 Dataview 查询语言中，表达式是指任何能够产生值的语法结构。主要包括三大类：

1. 字段引用（如 duedate）
2. 字面量（如 1, "text"）
3. 计算值（如 field - 9 或函数调用）

表达式构成了查询的条件部分和结果显示部分，是连接原始数据和最终呈现的桥梁。

核心表达式类型详解

字段引用表达式

字段引用是最简单的表达式形式，直接通过字段名访问元数据：

TABLE author, publish-date, reading-time

特殊字段名处理：

• 包含空格或标点的字段名会被转换为小写并用连字符连接
• 例如："Review Status" → review-status
• "Important!" → important

字面量表达式

Dataview 支持多种类型的字面量：

| 类型 | 示例 | 说明 | |------|------|------| | 数字 | 3.14 | 整数或浮点数 | | 布尔 | true/false | 逻辑值 | | 文本 | "Obsidian" | 字符串值 | | 日期 | date(2023-07-20) | 特定日期 | | 时长 | dur(2 hours) | 时间跨度 | | 链接 | [[Note]] | 笔记引用 | | 列表 | [1, 2, 3] | 有序集合 | | 对象 | { key: value } | 键值对集合 |

算术运算表达式

支持标准的四则运算和模运算：

TABLE start, end, (end - start) AS "Duration"
FROM #meetings

运算规则：

• 加减乘除：+, -, *, /
• 模运算：% (返回除法余数)
• 字符串连接："Hello" + "World" → "HelloWorld"
• 字符串重复："-" * 5 → "-----"

比较运算表达式

用于构建查询条件：

TASK
WHERE due <= date(today) AND priority = "high"

比较运算符：

• 大小比较：>, <, >=, <=
• 相等判断：=, !=

类型比较注意事项： 不同类型比较可能产生意外结果，建议先进行类型检查：

LIST
WHERE typeof(rating) = "number" AND rating > 3

索引表达式

用于访问复杂数据结构中的元素：

列表索引（从0开始）：

TABLE tags[0] AS "PrimaryTag"

对象属性访问：

---
book:
  title: "Dune"
  author: "Frank Herbert"
---

查询时可使用：

TABLE book.title, book.author

特殊字段名访问： 对于与关键字冲突的字段名（如where），使用：

LIST
WHERE row["where"] = "home"

函数调用表达式

Dataview 提供丰富的内置函数：

LIST
WHERE contains(lower(file.name), "report")

常用函数类别：

• 字符串处理：lower(), upper(), split()
• 日期计算：date(), dur()
• 集合操作：length(), reverse()
• 逻辑判断：contains(), startswith()

Lambda 表达式

高阶函数，用于数据转换：

基本语法：(参数) => 表达式

TABLE map(file.tasks, (t) => t.duration) AS "TaskDurations"

典型应用场景：

• map()：列表元素转换
• reduce()：列表元素聚合
• filter()：列表元素筛选

类型特有操作

日期与时长操作

日期支持特殊字段访问：

TABLE file.day.year + "-Q" + file.day.quarter

时长运算：

TABLE end - start AS "Duration",
      (end - start).hours AS "Hours"

链接解引用

通过链接访问目标页面属性：

TABLE [[Project A]].status, [[Project B]].owner

等价于：

TABLE link(file.link).status

最佳实践与技巧

1. 防御性编程：

LIST
WHERE typeof(progress) = "number" AND progress < 50

2. 复杂表达式分解：

TABLE start, end, 
      end - start AS "duration",
      (end - start).hours AS "hours"

3. 合理使用注释：

TABLE 
  /* 计算工作日时长，扣除午休时间 */
  (end - start - dur(1 hour)) AS "work_duration"

4. 性能优化：

• 优先使用简单比较而非正则
• 对大型库避免全文本搜索

总结

Dataview 表达式系统提供了灵活而强大的数据操作能力，从简单的字段引用到复杂的 Lambda 表达式，可以满足从基础到高级的各种查询需求。掌握这些表达式的使用技巧，能够大幅提升在 Obsidian 中管理和分析知识的效率。建议从简单查询开始，逐步尝试更复杂的表达式组合，以充分发挥 Dataview 的潜力。

obsidian-dataview A high-performance data index and query language over Markdown files, for https://obsidian.md/. 项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-dataview