差異

計算目前期間值和期初值之間的差異。

傳回值

傳回字元字串,代表要作為 HS.EXP 函數一部分使用的正確表示式。

語法

Difference (PointOfView, View)

表格 12-7 Difference 函數的語法

參數 有效值

PointOfView

Account、Custom1….4、ICP 成員的有效組合,例如「A#CASH.C1#[None].I#[ICP Top]」

View

必須為以下值之一:

"" (雙引號) - 依據為要處理的案例所定義的預設檢視 (YTD 或 Periodic)。

YTD - 指定迄今年度選項,這個選項會置換案例的預設檢視設定。

Periodic - 指定定期選項,這個選項會置換案例的預設檢視設定。

詳細說明

這個函數會計算目前期間值和期初值之間的差異。(目前 - 期初)

期初值會根據傳遞給函數的 View 參數而各自衍生。

  • 如果 View 參數是 YTD,則會從先前年度的最後一個期間擷取期初值。

  • 如果 View 參數是 Periodic,則會從目前年度的先前期間擷取期初值。如果目前期間是年度第一個期間,則會從先前年度的最後一個期間擷取期初值。

  • 如果 View 參數是空白 ( " " ),則期初值會以案例的預設資料檢視為基礎。

範例

CASH 帳戶會根據 Difference 函數中使用的 View 參數,傳回 2014 年一月、二月和三月的這些值。要處理的案例預設檢視設定為 YTD。Difference 函數會從目前期間值中減去期初值。

表格 12-8 Difference 函數的範例

科目 Dec2013 Jan2014 Feb2014 Mar2014

A#Cash

900

1,200

1,100

1,500

Difference("A#Cash", ""

N/A

300

200

600

Difference("A#Cash", "YTD")

N/A

300

200

600

Difference("A#Cash", "Periodic")

N/A

300

-100

400

範例指令碼

' sample statement written in the calling routine
Sub Calculate()
Hs.Exp  = "A#DiffCash" & Difference("A#Cash", "YTD")
End Sub
' programming of the DIFFERENCE function
FUNCTION DIFFERENCE(strPOV,strVIEW)
IF strVIEW =  "" THEN 
strVIEW = HS.SCENARIO.DEFAULTVIEW ("") 
END IF
strPOV = UCASE(strPOV)
strVIEW = UCASE(strVIEW)
IF strVIEW = "PERIODIC" THEN
DIFFERENCE = """&" "&strPOV"-& strPOV & ".P#PRIOR" &"")""
ELSEIF strVIEW = "YTD" THEN
DIFFERENCE = "" ("&strPOV &""-" & strPOV & ".Y#PRIOR.P#LAST" &"") ""
ELSE
EXIT FUNCTION
END IF
END FUNCTION