# 系统内置变量

Recurve 产品内提供多种内置变量，可以基于调度时间定义数据范围

## 内置变量

<table><thead><tr><th width="240">变量名称</th><th width="230">类型</th><th width="417">描述</th></tr></thead><tbody><tr><td><code>data_interval_start</code></td><td>datetime.datetime</td><td>表示当前调度批次所处理的数据范围的开始时间，结合调度周期来确定。</td></tr><tr><td><code>data_interval_end</code></td><td>datetime.datetime</td><td>表示当前调度批次所处理的数据范围的结束时间，结合调度周期来确定。</td></tr><tr><td><code>logical_date</code></td><td>datetime.datetime</td><td>表示调度批次的逻辑时间，通常与 <code>data_interval_end</code> 相等</td></tr><tr><td><code>dt</code></td><td>datetime.date</td><td><code>logical_date</code>的日期部分</td></tr><tr><td><code>yesterday</code></td><td>datetime.datetime</td><td><code>logical_date</code>的前一天，在日度任务中有用，其他周期不要使用</td></tr><tr><td><code>yesterday_dt</code></td><td>datetime.date</td><td><code>yesterday</code>的日期部分</td></tr><tr><td><code>tomorrow</code></td><td>datetime.datetime</td><td><code>logical_date</code> 的后一天，在日度任务中有用，其他周期不要使用</td></tr><tr><td><code>tomorrow_dt</code></td><td>datetime.date</td><td><code>tomorrow</code> 的日期部分</td></tr></tbody></table>

以每天 10 点运行的日度任务为例，在 2025-02-01 这一天，各个变量的值为：

* `data_interval_start`：是 T-1 的 10 点，即 `2025-01-31 10:00:00`
* `data_interval_end`：是 T 的 10 点，即 `2025-02-01 10:00:00`（同理，如果是周度、月度的，`data_interval_end` 就是本次调度度的逻辑时间(不是系统时间)，`data_interval_start` 就是上一个周期）
* `logical_date`：`2025-02-01 10:00:00`
* `dt`：`2025-02-01`
* `yesterday`:  `2025-01-31 10:00:00`
* `yesterday_dt`:  `2025-01-31`
* `tomorrow`: `2025-02-02 10:00:00`
* `tomorrow_dt`: `2025-02-02`

以每月 1 号 10点运行月度任务为例，在 2025-02-01 这一天，各个变量的值为：

* `data_interval_start`：表示 1 月 1 日 10 点，即 `2025-01-01 10:00:00`
* `data_interval_end`：`2025-02-01 10:00:00`
* `logical_date`：`2025-02-01 10:00:00`
* `dt`：`2025-02-01`

以下几个变量是方便在日度任务中使用的，在月度（及其他）任务中仍然有值，但是通常没有实际用途，建议**不要使用**。

* `yesterday`:  `2025-01-31 10:00:00`
* `yesterday_dt`:  `2025-01-31`
* `tomorrow`: `2025-02-02 10:00:00`
* `tomorrow_dt`: `2025-02-02`

## 使用系统变量

你可以在数据模型、高级管道中使用这些系统变量，在代码中使用 `{{ var("变量名称") }}`

例如：在数据建模中增量更新当天的数据

```sql
 select ...
 from {{ source("jaffle_shop", "raw_orders") }}
 where dt = {{ var('dt') }}
```

通常建议使用 `data_interval_start` 和 `data_interval_end` 来圈定数据范围，因为能根据调度周期自动灵活调整。可以使用这两个时间进行演变，得到其他格式，如：

<pre class="language-django"><code class="lang-django"><strong># 获取日期部分，返回 datetime.date 类型，date(2025, 1, 1)
</strong><strong>{{ var("data_interval_start").date() }}
</strong><strong>
</strong><strong># 格式化为 `20250101`，结果是个字符串
</strong>{{ var("data_interval_start").strftime("%Y%m%d") }}
</code></pre>