La función de texto DateOffset() (válida para tablas relacionales, así como para valores de tipo de fecha en cuadrículas de Planning y Essbase) calculará una nueva fecha mediante el desfase de la fecha a la que se hace referencia según la cantidad de desfase especificada. La cantidad de desfase se basa en las unidades especificadas (ya sean días, meses o años). El nombre de tabla es opcional si la función de texto aparece en una tabla relacional o si solo hay una única tabla relacional en el informe; de lo contrario, será necesario proporcionar el nombre de tabla. La referencia de fila es opcional y será la fila actual, si no se ha proporcionado. El parámetro de unidad es necesario y debe ser día, mes o año.
Sintaxis
DateOffset("Grid/TableName", row-reference,ol-reference, calendar-unit, offsetAmount)
Parámetros
Grid/TableName: es un parámetro opcional si se utiliza la función de texto en una celda de texto de la cuadrícula/tabla relacional. Si se utiliza la función de texto en un objeto de texto, el parámetro de nombre de cuadrícula/tabla es opcional si solo hay una única cuadrícula/tabla relacional en el informes; de lo contrario, el parámetro de cuadrícula/nombre de tabla es necesario.
row-reference: es un parámetro opcional. Si no se proporciona ningún parámetro de referencia de fila, se utilizará la fila "actual" (la fila en la que se produce la función de texto). Esto es similar al modo en que funcionan funciones de texto como CellValue() y CellText(). Si la función de texto de desfase de fecha se produce en un objeto de texto, es necesaria la referencia de fila. La referencia de fila puede incluir un desfase (por ejemplo, una referencia de fila de 1(5) devolverá el valor de atributo de la quinta tupla de la fila 1). La columna a la que se hace referencia debe hacer referencia a un valor de fecha o registro de hora en el origen de datos; de lo contrario, se devolverá una cadena vacía.
col-reference: es un parámetro opcional. Si no se proporciona ningún parámetro de referencia de columna, se utilizará la columna "actual" (la columna en la que se produce la función de texto). Esto es similar al modo en que funcionan funciones de texto como CellValue() y CellText(). Si la función de texto de desfase de fecha se produce en un objeto de texto, es necesaria la referencia de columna. La referencia de columna puede incluir un desfase (por ejemplo: C(E) hará referencia al quinto nombre de atributo en la columna C). La columna a la que se hace referencia debe hacer referencia a un valor de fecha o registro de hora en el origen de datos; de lo contrario, se devolverá una cadena vacía.
calendar-unit: la unidad de calendario es un parámetro necesario. Puede ser: día, mes o año; y determinará en qué unidad de medida se calcula el desfase de diferencia de datos.
offsetAmount: la cantidad de desfase es necesaria y debe ser un entero positivo o negativo (distinto de cero). Si la cantidad de desfase en un valor positivo, este debe incluir delante el símbolo "+" (por ejemplo: +3).
Note:
Si la referencia de fila o la referencia de columna hace referencia a un valor no de fecha, la función devuelve una cadena vacía.
No se realiza ninguna validación adicional cuando una función DateOffset() hace referencia a una columna/fecha que no contiene una fecha. En este caso, la función devolverá una cadena vacía.
Como se especifica en la descripción de parámetro, si offsetAmount en un número positivo, debe estar precedido por el símbolo más "+". Si falta el signo más y no hay ningún símbolo negativo, se producirá un error de sintaxis. Este es necesario para poder analizar la cadena de función de texto.
Ejemplo
Si el valor de fecha en la columna B a la que se hace referencia es "Jul, 21, 2023":