GFIRSTOPV returns the first value found(or the optional print value if the value is outside the optional print limits) in the date range specified by the Offset and Grouping for the variable.

SYNTAX:

GFIRSTOPV(VarNum, GroupOffset/StartDate, Grouping/EndDate, Decimal Places)

VarNum: The variable number to get the first value for.

GroupOffset/StartDate: Used with the Grouping parameter to set the dates to calculate the stat for.  Sets the number of Groups (set by the Grouping Parameter) to be added to set the dates.  See examples below. If this field is a date string (i.e. "07/16/2004") or refers to a cell with a date in it, it is assumed to be the start date to calculate the stat for.

Grouping/EndDate: Used to set which dates to calculate the stat for.  If the Grouping is a date literal string (i.e. "07/16/2004") or refers to a cell with a date in it, it is assumed to be the end date to calculate the stat for. Common Groupings are:

"D" Days
“M” Monthly 
"R" Report Dates
Click here for availiable Grouping options

Decimal Places: Sets the number of decimal places to be displayed. For variables with decimal places set to "Not Fixed" click here for additional formatting options.

NOTES:

Data is placed with this function as text, therefore data placed in this manner cannot be used in other formulas. In Design, Spread Reports use Locate, Group Summary to place this formula on a report.

EXAMPLES:

GFIRSTOPV(1,1,"R")  returns the first value for Variable 1 for the Report date range. If this value crosses the threshold of the Optional Print Value setup for variable 1, the Optional Print value will be printed in lieu of the first value.

Download Example Template: Help_GFIRST_Examples.ss3 (Click here for download instructions)

See Also: GFIRST, GFIRSTZ