You can use the IBP_ADD_TIME_DIMENSION function to retrieve and return the value of the time-independent input key figure in a time-dependent output key figure.
Typical use cases to present the following key figures in SAP Integrated Business Planning, add-in for Microsoft Excel (Excel add-in) or in the Planner Workspaces app:
Time-independent stock and/or cost key figures
- Other time-independent key figures, like forecast accuracy
The function can be very useful for project work when regular integration from the ERP system is not yet established. Configurators can load an extract with inventory values, etc., into a time-independent key figure and use the IBP_ADD_TIME_DIMENSION to have these values present in the current week.
The function can present values in the current period or shift the value to other periods. It can also present the time-independent value in all past or future periods.

Features and Modeling Requirements
- The displayed key figure is not editable.
- This function does not cause a filter block unless the time-independent input key figure is the aggregated value of a time-dependent key figure (i.e., when the previously aggregated time dimension must be joined again).
- It can work with a stored or calculated input.
- The second parameter determines the current period in the calculation. Use the placeholder $$PERIODIDnCU$$ to have a fixed variable for the current period. The variable n represents the time profile level that matches the time profile level of the output planning level.
- You can also add a plus or a minus operator with an integer value in the expression to shift the current date.
For example: $$PERIODID0CU$$ +1 or $$PERIODID0CU$$ -2.
- The current period offset of the planning area affects the results.
- The third parameter defines the time periods where the time-independent value will be populated. Possible values are PAST, PASTCURRENT, PASTCURRENTFUTURE, CURRENT, CURRENTFUTURE, and FUTURE.
The IBP_ADD_TIME_DIMENSION function can't be used at REQUEST.
When a calculation graph includes an IBP_ADD_TIME_DIMENSION calculation, the topmost key figure in the calculation graph must not be editable.