Get Value

This function is used to get the value of any spilled cell. You can also use this function to calculate various statistics, such as YOY, MOM, Percentage, Cumulative, etc.

The available Value functions are as follows.

Syntax and Arguments

• R.V(cell, [offset | context_cell | "CurrentPage"])

  This function can be used to get the specific spilled cell values by offset or context.

  Argument	Description
  cell	[Required] Specify the cell from which you want to get data. Example: R.V(C2) This formula returns all the values from the C2 cell as an array, so you can use the SUM(R.V(C2)) to get the sum of all the C2 cell values.
  offset	[Optional] Specify the offset (R.A or R.R), you can specify multiple offsets, up to 254. Example: R.V(C2, R.A(A2, 1)), this will get the C2 cell value in the first group of the A2 spilled cells.
  context_cell	[Optional] Specify the cell for which you set the context. The context cell will filter the target cell values. You can specify up to two contexts for a single cell, one vertical context and one horizontal context. Example: If the A2 cell is bound to the year column, B2 cell is bound to the month column, C2 cell is bound to the sales column. • R.V(C2, A2) will return all the sales as an array in the current year. • C2/SUM(R.V(C2, A2)) will return the current month's sales as a percentage of the year's sales.
  “CurrentPage“	[Optional] Specify the current page as the context. You can use this context to get the spilled cell values on the current page. Example: If the A2 cell is bound to the year column, B2 cell is bound to the month column, C2 cell is bound to the sales column. • R.V(C2, “CurrentPage“) will return all the sales as an array on the current page. • SUM(R.V(C2, “CurrentPage“)) will return the sales page total.

• R.A(cell, offset)

  (Absolute offset) This function can only be used as the R.V function’s parameter.

  Argument	Description
  cell	[Required] Specify the cell to use as the offset.
  offset	[Required] Specify the number of the offset. Example: If the A2 cell is bound to the year column, B2 cell is bound to the month column, C2 cell is bound to the sales column. • R.V(C2, R.A(A2, 1), R.A(B2, 5)) will return the sales for the fifth month of the first year. • R.V(C2, R.A(A2, 2), R.A(B2, 2)) will return the sales for the second month of the second year.

• R.R(cell, offset)

  (Relative offset) This function can only be used as the R.V function’s parameter.

  Argument	Description
  cell	[Required] Specify the cell to use as the offset.
  offset	[Required] Specify the number of the offset. Example: If the A2 cell is bound to the year column, B2 cell is bound to the month column, C2 cell is bound to the sales column. • R.V(C2,R.R(B2,-1)) will return the previous month's sales. • C2/R.V(C2,R.R(B2,-1)) will return the month-over-month value. In the first month, there is no data for the previous month, so the referenced cell is empty and #DIV/0! error occurs. In this case, you need to use the IF function and modify the function as follows: IF(R.V(C2,R.R(B2,-1))>0,C2/R.V(C2,R.R(B2,-1)),0).

Example

The output of the above code will look like below.