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.
IBP Time Dimension Function - Enhancements
You can use the IBP_ADD_TIME_DIMENSION function to retrieve and return the value of a time-dependent input key figure in a time-dependent output key figure that is on a more granular time level.
The presence or absence of time attributes on the input planning level decides which use case is realized:
The function adds a time dimension to a time-independent input key figure if there are no time attributes on the input planning level.
If the input key figure is time-dependent, its value is copied to an output key figure on a finer time granularity. The value of the input key figure is not disaggregated; it is only copied into the output key figure.
Note
The root time profile level of the input planning level must be an aggregate of the root time profile level of
the output planning level. For example, if the root time profile level of the input key figure is month, the
root time profile level of the output key figure can be technical week or day, but can't be calendar week.
