AppendixD: Using the Expression Editor
User Guide   241
variance
Returns the variance of selected data items. The keyword distinct is available for backward 
compatibility of expressions used in previous versions of the product.
Syntax
variance ( [ distinct ] expr [ auto ] )
variance ( [ distinct ] expr for [ all | any ] expr { , expr } )
variance ( [ distinct ] expr for report )
Example
variance ( Product Cost )
Result: A value indicating how widely product costs vary from the average product cost.
variance-pop
Returns the population variance of a set of numbers after discarding the nulls in this set.
Syntax
variance-pop ( [ distinct ] expr [ auto ] )
variance-pop ( [ distinct ] expr for [ all | any ] expr { , expr } )
variance-pop ( [ distinct ] expr for report )
Example
variance-pop ( Qty)
Result: For each row, this displays the population variance of a set of numbers after discarding the 
nulls in this set.
Member Summaries
This list contains predefined functions that return either a single summary value for a set of 
members or a different summary value for each member of a set of members.
aggregate
Returns a calculated value using the appropriate aggregation function, based on the aggregation 
type of the expression.
Syntax
aggregate ( < currentMeasure | expr > within set set_expr { , set_expr } )
aggregate ( < currentMeasure | expr > within < detail | aggregate > expr )
average
Returns the average value of selected data items.
Syntax
average ( < currentMeasure | expr > within set set_expr { , set_expr } )
average ( < currentMeasure | expr > within < detail | aggregate > expr )
count
Returns the number of selected data items excluding NULL values.
Syntax
count ( < currentMeasure | expr > within set set_expr { , set_expr } )
count ( < currentMeasure | expr > within < detail | aggregate > expr )
maximum
Returns the maximum value of selected data items.
Adding pages to a pdf document - insert pages into PDF file in C#.net, ASP.NET, MVC, Ajax, WinForms, WPF
Guide C# Users to Insert (Empty) PDF Page or Pages from a Supported File Format
adding pages to a pdf document in preview; add pdf pages together
Adding pages to a pdf document - VB.NET PDF Page Insert Library: insert pages into PDF file in vb.net, ASP.NET, MVC, Ajax, WinForms, WPF
Easy to Use VB.NET APIs to Add a New Blank Page to PDF Document
add page numbers to pdf document; add blank page to pdf preview
242    Report Studio
AppendixD: Using the Expression Editor
Syntax
maximum ( < currentMeasure | expr > within set set_expr { , set_expr } )
maximum ( < currentMeasure | expr > within < detail | aggregate > expr )
median
Returns the median value of selected data items.
Syntax
median ( < currentMeasure | expr > within set set_expr { , set_expr } )
median ( < currentMeasure | expr > within < detail | aggregate > expr )
minimum
Returns the minimum value of selected data items.
Syntax
minimum ( < currentMeasure | expr > within set set_expr { , set_expr } )
minimum ( < currentMeasure | expr > within < detail | aggregate > expr )
percentage
Returns the percent of the total value for selected data items.
Syntax
percentage ( numeric_expr  [ tuple member_expr {, member_expr } ] within set 
set_expr  {, set_expr } )
Example
percentage ( [gosales].[sales measures].[quantity] tuple 
[gosales].[Staff].[].[department]->[West] within set 
children([gosales].[Staff].[].[Staff] )
percentile
Returns a value, on a scale of one hundred, that indicates the percent of a distribution that is equal 
to or below the selected data items.
Syntax
percentile ( numeric_expr  [ tuple member_expr {, member_expr } ] within set 
set_expr  {, set_expr } )
quantile
Returns the rank of a value for the specified range. It returns integers to represent any range of 
ranks, such as 1 (highest) to 100 (lowest).
Syntax
quantile ( numeric_expr, numeric_expr  [ tuple member_expr {, member_expr } ] 
within set set_expr  {, set_expr } )
quartile
Returns the rank of a value, represented as integers from 1 (highest) to 4 (lowest), relative to a 
group of values.
Syntax
quartile ( numeric_expr [ tuple member_expr {, member_expr } ] within set 
set_expr  {, set_expr } )
rank
Returns the rank value of selected data items. The type of ranking returned (Olympic, dense or 
serial) is data source dependent.
VB.NET PDF Library SDK to view, edit, convert, process PDF file
PDF document (pages) creation and edit methods in VB.NET. Feel free to define text or images on PDF document and extract accordingly. Capable of adding PDF file
adding page to pdf in preview; add pages to pdf document
C# PDF insert image Library: insert images into PDF in C#.net, ASP
Using this C# .NET image adding library control for PDF document, you can easily and quickly add an image, picture or logo to any position of specified PDF
add page number to pdf; add pages to pdf in preview
AppendixD: Using the Expression Editor
User Guide   243
Syntax
rank ( numeric_expr  [ tuple member_expr {, member_expr } ] within set set_expr  
{, set_expr } )
Example
rank  ( [gosales].[sales measures].[quantity] tuple 
[gosales].[Staff].[].[department]->[West] within set 
children([gosales].[Staff].[].[Staff] )
standard-deviation
Returns the standard deviation of selected data items.
Syntax
standard-deviation ( < currentMeasure | expr > within set set_expr { , set_expr 
} )
standard-deviation ( < currentMeasure | expr > within < detail | aggregate > 
expr )
total
Returns the total value of selected data items.
Syntax
total ( < currentMeasure | expr > within set set_expr { , set_expr } )
total ( < currentMeasure | expr > within < detail | aggregate > expr )
variance
Returns the variance of selected data items.
Syntax
variance ( < currentMeasure | expr > within set set_expr { , set_expr } )
variance ( < currentMeasure | expr > within < detail | aggregate > expr )
Constants
A constant is a fixed value that you can use in an expression.
date
Inserts the current system date.
date-time
Inserts the current system date and time.
time with time zone
Inserts a zero time with time zone.
timestamp with time zone
Inserts an example of a timestamp with time zone.
interval
Inserts a zero interval.
interval year
Inserts a zero year interval.
C# PDF File & Page Process Library SDK for C#.net, ASP.NET, MVC
for adding an (empty) page to a PDF and adding empty pages Sorting Pages. RasterEdge XDoc.PDF allows you to easily move PDF document pages position, including
add page numbers to pdf; add and delete pages in pdf online
C# PDF insert text Library: insert text into PDF content in C#.net
Library. Best and multifunctional Visual Studio .NET PDF SDK supports adding and inserting text content to adobe PDF document in C#.
add a page to a pdf in acrobat; add page to existing pdf file
244    Report Studio
AppendixD: Using the Expression Editor
interval  month
Inserts a zero month interval.
interval year to month
Inserts a zero year to month interval.
interval day
Inserts a zero day interval.
interval hour
Inserts a zero hour interval.
interval minute
Inserts a zero minute interval.
interval second
Inserts a zero second interval.
interval day to hour
Inserts a zero day to hour interval.
interval day to minute
Inserts a zero day to minute interval.
interval day to second
Inserts a zero day to second interval.
interval hour to minute
Inserts a zero hour to minute interval.
interval hour to second
Inserts a zero hour to second interval.
interval minute to second
Inserts a zero minute to second interval.
null
Inserts a null value if the expression conditions are not met.
number
Inserts the number 0, which you can replace with a new numeric value.
string
Inserts an empty string.
time
Inserts the current system time.
Constructs
VB.NET PDF File & Page Process Library SDK for vb.net, ASP.NET
page, you will find detailed guidance on creating, loading, merge and splitting PDF pages and Files, adding a page into PDF document, deleting unnecessary page
adding page numbers to pdf in preview; adding pages to a pdf
VB.NET PDF insert text library: insert text into PDF content in vb
Multifunctional Visual Studio .NET PDF SDK library supports adding text content to adobe PDF document in VB.NET WinForms and ASP.NET.
add contents page to pdf; add a page to a pdf document
AppendixD: Using the Expression Editor
User Guide   245
if then else
Syntax
IF ([Country] = 'Canada') 
THEN ([List Price] * 0.60) 
ELSE ([List Price])
in_range
Specify one or more constants or ranges. A range can be open ended.
Example
[gosales].[CONVERSIONRATE].[COUNTRYCODE] IN_RANGE { :30 , 40, 50, 999: }
search case
Syntax
CASE
WHEN [Country] = 'Canada' THEN ([List Price] * 0.60) 
WHEN [CountryCode] > 100 THEN [List Price] * 0.80 
ELSE [List Price]
END
simple case
Syntax
CASE [Country] 
WHEN 'Canada' THEN ([List Price] * 0.60) 
WHEN 'Australia' THEN [List Price] * 0.80 
ELSE [List Price]
END
Business Date/Time Functions
This list contains business functions for performing date and time calculations.
_add_days
Returns the date or datetime dependent on the first argument resulting from adding integer_exp 
days to date_exp.
Syntax
_add_days ( date_exp, integer_exp )
Example 1
_add_days ( 2002-04-30 , 1 )
Result: 2002-05-01
Example 2
_add_days ( 2002-04-30 12:10:10.000, 1 )
Result: 2002-05-01 12:10:10.000
Example 3
_add_days ( 2002-04-30 00:00:00.000, 1/24 )
Note that the second argument is not a whole number. This is supported by some 
database technologies and increments the time portion.
C# PDF Library SDK to view, edit, convert, process PDF file for C#
Rapidly load, create, convert and edit PDF document (pages) in C# class with .NET PDF library. Support protecting PDF file by adding password and digital
adding pages to a pdf document; adding page numbers to pdf in reader
C# PDF Annotate Library: Draw, edit PDF annotation, markups in C#.
C#.NET: Add Text Box to PDF Document. Provide users with examples for adding text box to PDF and edit font size and color in text box field in C#.NET program.
add page numbers pdf; add page to pdf without acrobat
246    Report Studio
AppendixD: Using the Expression Editor
Result: 2002-04-30 01:00:00.000
_add_months
Returns the date or datetime dependent on the first argument resulting from adding integer_exp 
months to date_exp.
Syntax
_add_months ( date_exp, integer_exp )
Example 1
_add_months ( 2002-04-30 , 1 )
Result: 2002-05-30
Example 2
_add_months ( 2002-04-30 12:10:10.000, 1 )
Result: 2002-05-30 12:10:10.000
_add_years
Returns the date or datetime dependent on the first argument resulting from adding integer_exp 
years to date_exp.
Syntax
_add_years ( date_exp, integer_exp )
Example 1
_add_years ( 2002-04-30 , 1 )
Result: 2003-04-30
Example 2
_add_years ( 2002-04-30 12:10:10.000 , 1 )
Result: 2003-04-30 12:10:10.000
_age
Returns a number that is obtained from subtracting date_exp from today’s date. This value has 
the form YYYYMMDD, where YYYY represents the number of years, MM represents the 
number of months, and DD represents the number of days.
Syntax
_age (date_exp ) 
Example
Today's date=2003-02-05 _age ( 1990-04-30 )
Result: 120906 that is 12 years, 9 months and 6 days 
_day_of_week
Returns the day of week ( between 1 and 7), where 1 is the first day of the week as indicated by 
the second parameter(between 1 and 7, 1 being Monday and 7 being Sunday). Note that in ISO 
8601 standard, a week begins with Monday being day 1. In North America where Sunday is the 
first day of the week being day 7.
Syntax
_day_of_week ( date_exp, integer ) 
Example
_day_of_week ( 2003-01-01, 1 )
AppendixD: Using the Expression Editor
User Guide   247
Result: 3
_day_of_year
Returns the ordinal for the day of the year in date_ exp (1 to 366). Also known as Julian day.
Syntax
_day_of_year ( date_exp ) 
Example
_day_of_year ( 2003-03-01 )
Result: 61
_days_between
Returns a positive or negative number representing the number of days between the two date 
expressions. If date_exp1 < date_exp2 then the result will be a negative number.
Syntax
_days_between ( date_exp1, date_exp2 )
Example
_days_between ( 2002-04-30 , 2002-06-21 )
Result: -52
_days_to_end_of_month
Returns a number representing the number of days remaining in the month represented by the 
date expression date_exp.
Syntax
_days_to_end_of_month ( date_exp )
Example
_days_to_end_of_month ( 2002-04-20 14:30:22.123 )
Result: 10
_first_of_month
Returns a date or datetime dependent on the argument obtained from converting date_exp to a 
date with the same year and month but the day set to 1.
Syntax
_first_of_month ( date_exp )
Example 1
_first_of_month ( 2002-04-20 )
Result: 2002-04-01
Example 2
_first_of_month ( 2002-04-20 12:10:10.000 )
Result: 2002-04-01 12:10:10.000
_last_of_month
Returns a date or datetime dependent on the argument that is the last day of the month 
represented by date_exp.
Syntax
_last_of_month ( date_exp )
248    Report Studio
AppendixD: Using the Expression Editor
Example 1
_last_of_month ( 2002-01-14 )
Result: 2002-01-31
Example 2
_last_of_month ( 2002-01-14 12:10:10.000 )
Result: 2002-01-31 12:10:10.000
_make_timestamp
Returns a timestamp constructed from integer_exp1 (the year), integer_exp2 (the month) and 
integer_exp3 (the day).
Syntax
_make_timestamp ( integer_exp1, integer_exp2, integer_exp3 )
Example
_make_timestamp ( 2002 , 01 , 14 )
Result: 2002-01-14 00:00:00.000
_months_between
Returns a positive or negative integer number representing the number of months between 
date_exp1 to date_exp2. If date_exp1 < date_exp2, then a negative number is returned.
Syntax
_months_between ( date_exp1, date_exp2 )
Example
_months_between ( 2002-01-30, 2002-04-03 )
Result: 2
_week_of_year
Returns the number of the week of the year of the date_exp according to ISO 8601, in which week 
1 of the year is the first week of the year to contain a Thursday, which is equivalent to the first 
week containing January 4th.
Syntax
_week_of_year ( date_exp )
Example
_week_of_year ( 2003-01-01 )
Result: 1
_years_between
Returns a positive or negative integer number representing the number of years from date_exp1 to 
date_exp2. If date_exp1 < date_exp2 then a negative value is returned.
Syntax
_years_between ( date_exp1, date_exp2 )
Example
_years_between ( 2003-01-30, 2001-04-03 )
Result: 1
AppendixD: Using the Expression Editor
User Guide   249
_ymdint_between
Returns a number representing the difference between the date expressions date_exp1 and 
date_exp2. This value has the form YYYYMMDD, where YYYY represents the number of years, 
MM represents the number of months, and DD represents the number of days.
Syntax
_ymdint_between ( date_exp1, date_exp2 )
Example
_ymdint_between ( 1990-04-30 , 2003-02-05 )
Result: 120906 that is 12 years, 9 months and 6 days
Block Functions
This list contains functions used to access members of a set, usually in the context of Analysis 
Studio.
_firstFromSet
Returns the first members found in the set up to numeric_exp_max + numeric_exp_overflow.  If 
numeric_exp_max + numeric_exp_overflow is exceeded, then only the max number of members 
are returned.
Syntax
_firstFromSet ( set_exp, numeric_exp_max , numeric_exp_overflow )
_remainderSet
The member expression will be included in the returned set when the size of the set_exp set is 
greater than numeric_exp.
Syntax
_remainderSet (member_exp,  set_exp , numeric_exp )
Macro Functions
This list contains functions that can be used within a macro. A macro may contain one or more 
macro functions. A macro is delimited by  a number sign (#) at the beginning and at the end. 
Everything between the number signs is treated as a macro expression, which is executed at run 
time.
+
Concatenates two strings.
Syntax
value1 + value2
Example
# '{' + $runLocale + '}'#
Result: {en-us}
array
Constructs an array out of the list of parameters.
Syntax
array ( string_exp | array_exp { , string_exp | array_exp } )
250    Report Studio
AppendixD: Using the Expression Editor
Example
#csv ( 'x1' , 'x2' , array ( 'a1' , 'a2' ) )#
Result:  'x1' , 'x2' , 'a1' , 'a2' 
csv
Constructs a comma separated values string from the elements of the array. Optionally the 
separator and quote strings can be specified. The default separator is a comma ( , ) and the default 
quote character is a single quote ( ' ).
Syntax
csv ( array_exp [ , separator_string [ , quote_string ] ] )
Example
#csv ( array ( 'a1' , 'a2' ) )#
Result:  'a1' , 'a2' 
dq
Surround the passed string with double quotes.
Syntax
dq ( string_exp )
Example
#dq ( 'zero' )#
Result: "zero"
grep
Searches for elements of an array that match the pattern specified in the first argument. It returns 
an array with the elements that pass the pattern.
Syntax
grep ( pattern_string , array_exp )
Example
#csv ( grep ( 's' , array ( 'as', 'an', 'arts' ) ) )#
Result:  'as', 'arts'
join
Joins the elements of an array using the separator string.
Syntax
join ( separator_string , array_exp )
Example
# sq ( join ( ' | | ' , array ( 'as', 'an', 'arts' ) ) )#
Result:  'as | | an | | arts'
prompt
Prompt the user for a single value. Only the prompt_name argument is required.
Documents you may be interested
Documents you may be interested