# **PRE**

计算上期的统计数值。

此函数的计算，需要数据模型是`周期快照`类型，并指定`数据期`字段，相关说明可以查看文档 [数据期类型](../../../data-gov/model/model-settings.md)设置。

## 语法{#grammar}

PRE(**field**, **\[offset]**, **\[periodField]**)

- **field**：数值类型的表达式，一般是度量的字段名，如果没有统计方法，数值类型默认取合计值，字符类型默认取最大值
- **offset**：可选。数据偏移参数，支持具体的数据期
  - `PP` 默认值，表示取上期，等价于整数`-1`
  - `NP` 表示取下期
  - `YA` 表示取去年同期
  - `FM` 表示取年初
- **periodField**：可选。指定数据期字段，默认取模型设置的数据期字段，但是当模型有多个业务数据期字段时，比如说合同签订时间、到货时间、打款时间等等，不同的度量需要根据不同时间计算同环比，此时可以使用数据期字段参数来指定。

## 示例{#example}

1. `PRE([销售数量])` 上期合计值，默认取合计值`7214`
2. `PRE(AVG([销售数量]),'PP')` 'PP' 表示取上期，返回上期平均值`18.3096`
3. `PRE([销售数量],'NP')` 'NP' 表示取下期，返回下期合计值`5507`
4. `PRE([销售数量],'YA')` 'YA' 表示取去年同期，返回去年同期的合计值`4934`
5. `PRE([销售数量],'FM')` 'FM' 表示取年初，返回年初合计值`4788`
6. `PRE([销售数量],'201801')` 指定数据期为201801的合计值`4788`