DateOffset() 文本函数(对关系表以及 Planning 和 Essbase 网格中的日期类型值有效)通过将引用的日期偏移指定的偏移量,计算出新日期。偏移量采用指定的单位(天、月或年)。如果关系表中存在文本函数,或者报表中只有单个关系表,则表名是可选的,否则需要提供表名。行引用是可选的,如果未提供此项,则将使用当前行。单位参数是必需参数,并且应为天、月或年。
语法
DateOffset("Grid/TableName", row-reference,ol-reference, calendar-unit, offsetAmount)
参数
Grid/TableName
- 如果在网格/关系表的文本单元格中使用了文本函数,则这是可选参数。如果在文本对象中使用了文本函数,并且报表中只有单个网格/关系表,则 Grid/TableName 参数是可选参数,否则 Grid/TableName 参数是必需参数。
row-reference
- 这是可选参数。如果未提供 row-reference 参数,则将使用“当前”行(文本函数所在行),这类似于 CellValue() 和 CellText() 等文本函数的工作方式。如果文本对象中存在 DateOffset 文本函数,则需要提供 row-reference。row-reference 可以包含偏移(例如 row-reference 为 1(5) 时将返回第 1 行中第 5 个元组的属性值)。引用列必须引用数据源中的日期或时间戳值,否则将返回空字符串。
col-reference
- 这是可选参数。如果未提供 col-reference 参数,则将使用“当前”列(文本函数所在列),这类似于 CellValue() 和 CellText() 等文本函数的工作方式。如果文本对象中存在 DateOffset 文本函数,则需要提供 col-reference。col-reference 可以包含偏移(例如:C(E) 将引用 C 列中的第 5 个属性名称)。引用列必须引用数据源中的日期或时间戳值,否则将返回空字符串。
calendar-unit
- 日历单位是必需参数。此参数可以为天、月或年;并确定计算数据差异偏移时使用的度量单位。
offsetAmount
- offsetAmount 是必需参数,并且必须为正整数或负整数(非零)。如果 offsetAmount 是正数,则必须包含前导 '+' 符号(例如:+3)。
Note:
如果 row-reference 或 col-reference 引用非日期值,则该函数将返回空字符串。
当 DateOffset() 函数引用的列/单元格时不包含日期时,将不会进行额外的验证。在这种情况下,该函数将返回空字符串。
如参数说明中所述,如果 offsetAmount 是正数,其前面必须有加号 '+'。如果缺少加号,并且没有负号,将出现语法错误。这项要求是为了能够正确对文本函数字符串进行解析。
示例
如果引用列 B 中的日期值为 'Jul, 21, 2023'(2023 年 7 月 21 日):