Difference

Calcula a diferença entre o valor do período atual e o valor de abertura.

Valor de Retorno

Retorna uma string de caracteres representando a expressão correta a ser usada como parte da função HS.EXP.

Sintaxe

Difference (PointOfView, View)

Tabela 12-7 Sintaxe da Função Diferença

Parâmetro Valores Válidos

PointOfView

Combinação válida de Conta, Custom1….4, membros ICP, por exemplo, "A#CASH.C1#[None].I#[ICP Top]"

View

Deve ser um dos seguintes valores:

"" (aspas duplas) - Com base na exibição padrão definida para o cenário que está sendo processado (YTD ou Periódico).

YTD - Especifica a data Ano Atual, a qual substitui a exibição padrão definida para o cenário.

Periódico - Especifica a opção periódica, a qual substitui a exibição padrão definida para o cenário.

Descrição Detalhada

Essa função calcula a diferença entre o valor do período atual e o valor de abertura. (Atual - Abertura)

O valor de abertura é derivado diferentemente com base no parâmetro Exibição informado para a função.

  • Se o parâmetro Exibição for YTD, o valor de abertura será recuperado do último período do ano anterior.

  • Se o parâmetro Exibição for Periódico, o valor de abertura será recuperado do período anterior do ano atual. Se o período atual for o primeiro período do ano, o valor de abertura será recuperado do último período do ano anterior.

  • Se o parâmetro Exibição estiver em branco (" "), o valor de abertura será baseado na exibição de dados padrão do cenário.

Exemplo

A conta CASH retornará os seguintes valores para janeiro, fevereiro e março de 2014 dependendo do parâmetro Exibição usado na função Diferença. A exibição padrão definida para o cenário que está sendo processado será YTD. A função Diferença subtrai o valor de abertura do valor de período atual.

Tabela 12-8 Exemplo de Função Diferença

Conta Dec2013 Jan2014 Feb2014 Mar2014

A#Cash

900

1,200

1,100

1,500

Difference("A#Cash", ""

N/D

300

200

600

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

N/D

300

200

600

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

N/D

300

-100

400

Script de Amostra

' 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