> Documentation index: https://www.gooddata.ai/docs/gooddata-ui/llms.txt lists every page of these docs as Markdown.

# newPreviousPeriodMeasure()

- Package: [@gooddata/sdk-model](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/index.md)
- Kind: function
- Source: https://github.com/gooddata/gooddata-ui-sdk/blob/rel/11.64/libs/sdk-model/src/execution/measure/factory.ts
- Guides: [Working with measures](https://www.gooddata.ai/docs/gooddata-ui/latest/data-layer/data-model/measures/index.md), [Compare a measure with a previous period](https://www.gooddata.ai/docs/gooddata-ui/latest/data-layer/execution/time-over-time/index.md)

Creates a new Previous Period measure with the specified measure identifier and date data sets and optional modifications and localIdentifier.

**Signature:**

```typescript
export declare function newPreviousPeriodMeasure(measureIdOrLocalId: MeasureOrLocalId, dateDataSets: IPreviousPeriodDateDataSetSimple[], modifications?: MeasureModifications<PreviousPeriodMeasureBuilder>): IMeasure<IPreviousPeriodMeasureDefinition>;
```

## Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| measureIdOrLocalId | [MeasureOrLocalId](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.measureorlocalid/index.md) | measure or local identifier of the measure to create Previous Period measure for |
| dateDataSets | [IPreviousPeriodDateDataSetSimple](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.ipreviousperioddatedatasetsimple/index.md)[] | date data sets to use in the Previous Period calculation |
| modifications | [MeasureModifications](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.measuremodifications/index.md)&lt;[PreviousPeriodMeasureBuilder](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.previousperiodmeasurebuilder/index.md)&gt; | _(Optional)_ optional modifications (e.g. alias, title, etc.) |

**Returns:**

[IMeasure](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.imeasure/index.md)&lt;[IPreviousPeriodMeasureDefinition](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.ipreviousperiodmeasuredefinition/index.md)&gt;