DateOffset() 文字函數 (適用於關聯式表格以及規劃和 Essbase 方格中的日期類型值) 將計算一個相對於參考日期指定偏移量的新日期。偏移量基於指定的單位 (天、月或年)。如果文字函數出現在關聯式表格中,或者報表中只有一個關聯式表格,則 table-name 為選擇性;否則必須提供 table-name。資料列參考為選擇性,如果未提供,則將使用目前資料列。單位參數為必要,且必須是天、月或年。
語法
DateOffset("Grid/TableName", row-reference,ol-reference, calendar-unit, offsetAmount)
參數
Grid/TableName
- 如果文字函數用於方格/關聯式表格的文字儲存格中,則此為選擇性參數。如果文字函數用於文字物件中,且報表中只有一個方格/關聯式表格,則 grid/table-name 參數為選擇性;否則為必要參數。
row-reference
- 此為擇性參數。如果未提供 row-reference 參數,將使用「目前」資料列 (文字函數所在的資料列),這與 CellValue() 和 CellText() 等文字函數的工作方式類似。如果 date-offset 文字函數出現在文字物件中,則 row-reference 為必要參數。資料列參考可以包含偏移量 (例如:row-reference 1(5) 將傳回資料列 1 中第 5 個元組的屬性值)。參考資料欄必須參考資料來源中的日期或時間戳記值,否則將傳回空白字串。
col-reference
- 此為選擇性參數。如果未提供 col-reference 參數,將使用「目前」資料欄 (文字函數所在的資料欄),這與 CellValue() 和 CellText() 等文字函數的工作方式類似。如果 date-offset 文字函數出現在文字物件中,則 col-reference 為必要參數。資料欄參考可以包含偏移量 (例如:C(E) 將參考資料欄 C 中的第 5 個屬性名稱)。參考資料欄必須參考資料來源中的日期或時間戳記值,否則將傳回空白字串。
calendar-unit
- 工作曆單位為必要參數。它可以是:天、月或年;且將決定資料差異偏移量以何種單位計算。
offsetAmount
- offset-amount 為必要,且必須是正或負整數 (不能為零)。如果 offset-amount 是正數,則必須包含前置 '+' 符號 (例如:+3)。
Note:
如果 row-reference 或 col-reference 其中之一參考非日期值,則函數會傳回空白字串。
當 DateOffset() 函數參考不包含日期的資料欄/儲存格時,不會進行其他驗證。在此情況下,函數將傳回空白字串。
如同參數描述中所指定,如果 offsetAmount 是正數,則必須在前面加上符號 '+'。如果缺少加號且沒有負號,則會發生語法錯誤。這是正確剖析文字函數字串的必要條件。
範例
如果參考資料欄 B 中的日期值是 '2023 年 7 月 21 日':