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

# modifyPreviousPeriodMeasure()

- 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

Creates a new Previous Period measure by applying modifications on top of an existing measure.

**Signature:**

```typescript
export declare function modifyPreviousPeriodMeasure(measure: IMeasure<IPreviousPeriodMeasureDefinition>, modifications?: MeasureModifications<PreviousPeriodMeasureBuilder>): IMeasure<IPreviousPeriodMeasureDefinition>;
```

## Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| measure | [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; | measure to use as template for the new measure |
| 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)_ modifications to apply |

**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;

new instance

## Remarks

This operation is immutable and will not alter the input measure.

The returned measure will have the same localIdentifier as the original measure. If you would like to assign new/different local identifier to the measure, you can do that using the modifications where you can provide either new custom localId or indicate that the measure should fall back to the auto-generated localId.