Calcula o valor médio de uma conta em um número de períodos.
Valor de Retorno
Retorna uma string de caracteres representando a expressão correta a ser usada como parte da função HS.EXP.
Sintaxe
Average (PointOfView, Periods)
Tabela 12-3 Sintaxe de Função Média
| 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]" Para contas de tipo de fluxo, a função tira a média apenas do valor periódico. |
|
Period |
Deve ser um dos seguintes valores: YTD - Especifica a opção do ano atual para tirar a média da data cumulativa do período um no ano atual. Periódico - Especifica a opção periódica para fazer a média do período atual e do imediatamente anterior somente no ano anterior. Para o primeiro período, esse valor será o mesmo que o da origem. [Qualquer número positivo inteiro] - Especifique um número de períodos sobre o qual a média deverá ser calculada. Para a média de um ano corrente em uma categoria mensal, especifique |
Descrição Detalhada
Essa função calcula o valor médio de uma conta sobre um número específico de períodos anteriores. Se a origem for uma conta do tipo saldo, a média será baseada nos dados informados. Se a origem for uma conta do tipo fluxo, a média será baseada somente nos dados periódicos.
O valor médio é derivado diferentemente com base no parâmetro Períodos.
Se o parâmetro Períodos for YTD, o valor médio será a soma de todos os períodos no ano atual até o atual dividido pelo número do período atual.
Se o parâmetro Períodos for Periódico, o valor médio será a soma dos períodos atual e imediatamente anterior dividida por dois. Se o período atual for o primeiro período do ano, o valor médio será o mesmo valor que o de origem.
Se o parâmetro Períodos for um número, o valor médio será a soma do atual e de cada período precedente para o número especificado de períodos, dividida pelo número especificado.
Exemplo
A conta SALES retornará os seguintes valores para janeiro, fevereiro e março de 2014 dependendo do parâmetro Períodos usado na função personalizada Média. A exibição padrão definida para o cenário que está sendo processado será YTD.
Tabela 12-4 Exemplo de Função Média
| Conta | Oct2013 | Nov2013 | Dec2013 | Jan2014 | Feb2014 | Mar2014 |
|---|---|---|---|---|---|---|
|
A#Sales |
9,000 |
10,500 |
11,700 |
800 |
1,900 |
3,200 |
|
Average ("A#Sales", "YTD)" |
N/D |
N/D |
N/D |
800 |
950 |
1,067 |
|
Average ("A#Sales", "Periodic)" |
N/D |
N/D |
N/D |
800 |
950 |
1,200 |
|
Average ("A#Sales", "3") |
N/D |
N/D |
N/D |
1,167 |
1,033 |
1,067 |
Script de Amostra
' sample statement written in the calling routine
Sub Calculate()
Hs.Exp "A#AVG_SALES = "& Average("A#Sales", "12")
End Sub
' programming of the AVERAGE function
FUNCTION Average(strPOV,strPERIOD)
DIM nPERIOD DIM strCUM DIM i
strPOV = UCASE(strPOV) strPERIOD = UCASE(strPERIOD)
IF strPERIOD = "PERIODIC" THEN
IF HS.PERIOD.ISFIRST = TRUE THEN
nPERIOD = 1
ELSE
nPERIOD = 2
END IF
ELSEIF strPERIOD = "YTD" THEN
nPERIOD = HS.PERIOD.NUMBER()
ELSEIF CINT(strPERIOD) > 0 THEN
nPERIOD = CINT(strPERIOD)
ELSE
EXIT FUNCTION
END IF
FOR i = 0 TO nPERIOD-1
IF i = 0 THEN
strCUM = strPOV &".W#PERIODIC"
ELSE
strCUM = strCUM &"+" & strPOV &".W#PERIODIC.P#CUR-" &i
END IF
NEXT
Average = "" (("" & strCUM &"")/""& nPERIOD &"")""
END FUNCTION