Funções que Recuperam Valores
Estas funções não têm argumentos:
@na
Definição
Não é um número.
Para uso como um valor de preenchimento geral ou para resultados não lógicos.
Retorna
N/A
Exemplo
Se um índice for relevante apenas em prazos de períodos previstos, use @na
para os outros períodos. Por exemplo:
@if(@ishist, @na, v1400/ v2890)
em que a Despesa de Juros Total é v1400 e o Total de Passivos é v2890.
Nota:
N/A* X= N/A e N/A+ X= X
@LOG
Definição
Calcula o logaritmo na base dez do argumento. Isso permite representar valores muito altos usando um quadro de referência menor. Por exemplo, LOG é usado para acessar atividade sísmica, como terremotos.
Exemplo
LOG(value, base))
Por exemplo, LOG(4, 100,000))= 0,12
Por exemplo, OG10(86)=1,93449
@LN
Definição
Calcula o logarítimo natural do argumento
@nummonths
Definição
Número de meses em um período
Retorna
O número de meses em um período de tempo.
N/D para estruturas de tempo com base em semanas.
Exemplo
Em um trimestre, ela devolve o número de meses em um trimestre.
Em meio ano, retorna 6.
Em um ano, retorna 12.
@numweeks
Definição
Número de semanas em um período
Retorna
O número de semanas em um período.
Exemplo
Em um mês, retorna o número de semanas no mês, ou um valor de 4 ou 5.
Em um trimestre, retorna 12 ou 13.
Em meio ano, retorna 26 ou 27.
Em um ano, retorna 52 ou 53.
@numweeks
Definição
Número de semanas em um período
Retorna
O número de semanas em um período.
Exemplo
Em um mês, retorna o número de semanas no mês, ou um valor de 4 ou 5.
Em um trimestre, retorna 12 ou 13.
Em meio ano, retorna 26 ou 27.
Em um ano, retorna 52 ou 53.
@LIKEPD
Definição
Use para especificar um tempo inicial ou retroativo a um período até a data do mesmo tipo. Essa função permite a criação de fórmulas nos locais em que deseja períodos atualizados para retardar um período completo em vez de usar o valor do período anterior.
Exemplo
Suponhamos que você defina uma fórmula usando out09:YTD em que o valor (V1000) do ano anterior, 2008, é usado V1000( -1 ). Para usar um valor diferente do resultado do período até a data de 2008, utilize V1000( @likepd(-1)).
@dimexact(vXXXX, membro da dimensão)
Definição
Refere-se às ocorrências de conta dimensional a partir de contas que não compartilham as mesmas dimensões que a conta com a fórmula, o que permite a referência de dimensões não designadas atualmente para a conta com a função.
Retorna
Retorna uma ocorrência dimensional
Exemplo
Se Vendas tem a dimensão Região, mas não Produto, e o Custo de Mercadorias Vendidas tem a dimensão Produtos, mas não Região, a conta Custo de Mercadorias Vendidas pode usar esta fórmula:
@dimexact(v1000,"North")*.1
para recuperar a ocorrência para Vendas/North e multiplicá-la por 10%.
@scalar
Cuidado:
Não use argumentos para recuperar valores de outras contas com @scalar. Essa funcionalidade pode ser diminuída em um lançamento futuro.
Definição
Retorna um valor escalar a partir do método de previsão.
Ao usar o @scalar em um método de previsão de Fórmula de Forma Livre, a conta aceita um valor de entrada escalar em todos os períodos da previsão.
Retorna
Retorna o valor de uma única entrada de previsão para uma variável quando aquele método de previsão está em uso.
@calc( PROCESSO, Vxxxx )
Definição
Um método geral de chamar uma rotina de cálculos complexa.
Retorna
Verdadeiro — se o cálculo é bem-sucedido.
Falso — se o cálculo falha.
@ipvalue( PROCESSO, Vxxxx )
Uma instrução para a máquina de cálculo indicando que há valores de dentro do período armazenados para essa conta, por alguns processo, que devem ser recuperados e, no caso dos Fluxos, somados para retornar o valor registrado para a conta do período.
@debt( Vxxxx, NOME_TOKEN )
Retorna o valor diretamente a partir da programação de dívidas para uso em fórmulas e relatórios. Diferente dos cálculo internos triviais, não realiza cálculos.
Palavras-chave de @Debt:
@sub(Vxxxx.xx)
Parecida com @dim pois, sem usar argumentos, faz referência ao mesmo número de subconta como a variável sendo calculada. Útil ao calcular fórmulas de subcontas, como com algumas varáveis do Agendador de Débito.
Funções que Fazem Referência a Períodos de Tempo Específicos
Essas funções retornam as informações de período dentro do período de tempo atual a partir de períodos diferentes. Nenhuma dessas funções têm argumentos.
@basepd
Definição
Período base
Retorna
Uma referência de tempo relativa que retorna o valor de uma conta no período base—consulte Definição de Períodos.
Exemplo
Se 2007 for o período-base, a equação: v1000(@basepd)
retorna o valor de Vendas (v1000) para 2007.
@closing
Definição
Período de fechamento
Retorna
Uma referência de tempo relativa que retorna o valor para o período de fechamento de uma conta.
Exemplo
Esta fórmula: v1000(@closing)
retorna o valor do período de fechamento para Vendas (v1000).
@deal
Definição
Período de negociação
Retorna
Uma referência de tempo relativa que retorna o valor para o período de negociação de uma conta.
Exemplo
Esta fórmula: v2005(@deal)
retorna o valor do período de negociação para o Caixa Usado na Transação (v2005).
@firstfore
Definição
Primeiro período previsto
Uma referência de tempo relativa que retorna o valor de uma conta no primeiro período de tempo previsto—consulte Definição de Períodos.
Exemplo
Para retornar o valor de saída do primeiro período previsto para Vendas se o último valor do histórico (por exemplo, 1999) das vendas for 10 e a taxa de crescimento for 10% em todos os períodos:
v1000(@firstfore)
O valor retornado é 11 (10* 1.1) ou as vendas de 2000.
@firstpd
Definição
Primeiro período
Retorna
Uma referência de tempo relativa que retorna o primeiro período no valor do modelo para uma conta.
Exemplo
Se 2007 for o primeiro período em um modelo, a fórmula:
v1000(@firstpd)
retorna o valor para as Vendas de 2007 (v1000). Se 2007 estiver em um dos trimestres, o Strategic Modeling retorna o primeiro trimestre para Vendas de 2007 (v1000).
@firsthist
Definição
Esta função especifica uma referência de período para o primeiro período histórico (primeiro período após o Período de Saldo Inicial) no modelo.
Retorna
Este método retorna uma referência de período para o primeiro período histórico (primeiro período após o Período de Saldo Inicial) no modelo.
Exemplo
v1000(@firsthist)
recupera o valor de uma conta "v1000" no primeiro período do histórico.
@lastfore, vXXXX(@lastfore)
Definição
Refere-se ao último valor previsto de uma conta.
Retorna
O valor de uma conta no último período previsto.
N/D para outros períodos.
Exemplo
Para esta fórmula e valores:
v1000(@lastfore)
V1000 | 1998H | 1999H | 2000F | 2001F | 2002F | 2003F | 2004F |
---|---|---|---|---|---|---|---|
Vendas |
10 |
15 |
16.5 |
18.15 |
19.965 |
21.962 |
24.158 |
A fórmula retorna 24.158 em 2004 e N/D nos outros períodos.
@lasthist, vXXXX(@lasthist)
Definição
Refere-se ao valor de uma conta que está no último período do histórico.
Retorna
O valor no último período do histórico.
N/D para todos os períodos até o último período do histórico.
Exemplo
Para esta fórmula e valores:
v1000(@lasthist)
V1000 | 1998H | 1999H | 2000F | 2001F | 2002F | 2003F | 2004F |
---|---|---|---|---|---|---|---|
Vendas |
10 |
15 |
16.5 |
18.15 |
19.965 |
21.962 |
24.158 |
A fórmula retorna N/D em 1998, 15.000 em 1999 e nos períodos restantes.
@opening
Definição
Período de abertura
Retorna
Uma referência de tempo relativo que recupera o valor para uma conta no período de abertura. O período de abertura é o agregado dos períodos de fechamento e de negociação. Por exemplo, para o período de negociação em Mar99, o Strategic Modeling cria contas Mar99:Fechamento e Mar99:Negociação, que são agregados a Mar99. Mar99 é o período de abertura.
Exemplo
A fórmula: v2000(@opening)
retorna o valor do período de abertura de Caixa (v2000).
@lastactual
Definição
Último valor real.
Retorna
Uma referência para o último período real.
@lastpd
Definição
Último período.
Retorna
Uma referência para o último período de tempo.
Funções que Recuperam Informações de Período de Tempo
Essas funções aceitam argumentos originais para especificar referências de período absolutas ou relativas. Sem os argumentos, elas retornam o valor para período atual.
@halfnum
Definição
Número do meio período
Usada para acionar declarações @if ao tornar a condição igual à primeira ou segunda parte do ano.
Retorna
1 — primeiro semestre
2 — segundo semestre
Exemplo
Se uma empresa acumula impostos para o primeiro semestre do ano e paga os impostos no segundo semestre, essa fórmula poderia ser inserida em uma conta Impostos a Pagar:
@if(@halfnum=1, @sum(v1690,@ytd), 0)
com Impostos Totais (v1690).
@inputpd( [referência do período de tempo])
Definição
Entrada de período
Essa função é útil ao usar uma referência de período de tempo opcional, normalmente um domínio ou atraso, apesar de referências de período absoluto serem possíveis.
Retorna
Retorna o período de entrada conduzindo o valor para o período sendo calculado. Isto pode ser o período que está sendo calculado, se ele for um período de entrada.
Exemplo
Por exemplo: @inputpd( -1 )
É possível fazer referência ao período de entrada antecedente, mesmo que aquele período for um tipo diferente do período atual, o que permite o retorno de alguns tipos de dados atrasados.
Esta fórmula:
@Vxxxx(-1)
retorna o valor de Vxxxx do período anterior do mesmo tipo.
Esta fórmula:
@Vxxxx(@inputpd(-1))
retorna o valor de Vxxxx a partir do período de entrada antecedente.
@isagg
Definição
É um período agregado
Uma referência relativa em declarações @if
. Usada com contas de memorando, contas de proporção e contas de contrato em estruturas de período de tempo que rendem períodos agregados.
Por exemplo, se um modelo estiver nos detalhes trimestrais, um período agregado de final de ano é criado. O exemplo aplica-se a meses, semestres e subperíodos. Usada em declarações @if, cálculos diferentes podem ser realizados nesse períodos agregados.
Retorna
Verdadeiro — se o período é um período agregado
Falso — Caso não ocorra
Exemplo
Se um modelos estiver nos trimestres e o final do ano for um período agregado, esta fórmula:
@if(@isagg,1,2)
retorna 2 em cada trimestre e 1 no agregado de final de ano.
Nota:
Essa função funciona somente quando um das Contas Definidas pelo Usuário for um campo calculado (CALC) e a opção Nenhum for selecionada.
@isclosing
Definição
É o período de fechamento no modelo
Uma referência relativa em declarações @if
.
Retorna
Verdadeiro — se o período é o período de fechamento no modelo
Falso — Caso não ocorra
Exemplo
Esta fórmula:
@if(@isclosing, 1, 2)
retorna 1 no período de fechamento e 2 para outros períodos.
@isdeal
Definição
É o período de negociação
Uma referência relativa em declarações @if
.
Retorna
Verdadeiro — se o período é o período de fechamento no modelo
Falso — Caso não ocorra
Exemplo
Esta fórmula:
@if(@isdeal, 1, 2)
retorna 1 no período de fechamento e 2 para outros períodos.
@iseoy
Definição
É o final do ano
Um referência relativa em declarações @if
usada para modelos em meses, trimestres ou semestres. Essa função modela os pagamentos de final de ano dos passivos provisionados. Não causa problemas no detalhe anual.
Retorna
Verdadeiro — se o período está no final do ano fiscal
Falso — Caso não ocorra
Exemplo
Se o modelo estiver em trimestres e Dezembro for o final do ano fiscal, esta fórmula:
@if(@iseoy,1,2)
retorna 2 nos primeiros três trimestres e 1 no quarto trimestre.
@isfirstpd
Definição
É o primeiro período
Uma referência relativa em declarações @if
.
Retorna
Verdadeiro — se o período é o primeiro período no modelo
Falso — Caso não ocorra
Exemplo 1
Se o primeiro trimestre de 1998 for o primeiro período no modelo, esta fórmula:
@if(@isfirstpd, 1, 2)
retorna 1 para 1Q98 e 2 para outros períodos.
Exemplo 2
Caso exclua 1998, a fórmula do exemplo anterior retorna 1 no primeiro período de 1999, e 2 nos períodos subsequentes.
@isfirsthist
Definição
É o primeiro período histórico no modelo.
Uma referência relativa em instruções @if
que permite alterar o limite histórico/de previsão e manter a integridade da fórmula. Períodos de previsão são determinados pelo limite de histórico/previsão definido em Definição de Períodos.
Retorna
Verdadeiro—se o período referenciado for o primeiro período histórico (primeiro período após o Período de Saldo Inicial)
Falso — Caso não ocorra
Exemplo
@if(@isfirsthist,@na,@sum(v1000,-1))
retorna uma referência de período para o primeiro período histórico.
@isfirstfore
Definição
É o primeiro período previsto no modelo
Uma referência relativa em instruções @if
que permite alterar o limite histórico/de previsão e manter a integridade da fórmula. Períodos de previsão são determinados pelo limite de histórico/previsão definido em Definição de Períodos.
Retorna
Verdadeiro — se o período é o primeiro período previsto no modelo
Falso — Caso não ocorra
Exemplo 1
Se um modelo estiver em anos e o limite histórico/previsão for 2007/2008, com 2008 como período de previsão, esta fórmula:
@if(@isfirstfore,1,2)
retorna 1 para 2000 2 e para outros períodos.
Exemplo 2
A mesma fórmula no exemplo anterior, mas com o modelo em trimestres com o primeiro trimestre de 2008 como o primeiro período da previsão, retorna 1 para o primeiro trimestre de 2008 e 2 para outros períodos.
@isfore
Definição
É o período previsto.
Uma referência relativa em declarações @if
.
Períodos de previsão são determinados pelo limite de histórico/previsão definido em Definição de Períodos.
Retorna
Verdadeiro — se o período é um período previsto
Falso — Caso não ocorra
Exemplo
Se um modelo contém 6 anos começando em 2006, com o primeiro ano histórico, os anos restantes, 2007-2011, são previstos. Esta fórmula:
@if(@isfore, 1, 2)
retorna 1 para 2006 e 2 para os outros anos.
@isfirstforeyr
Definição
É o primeiro ano da previsão.
Aceita uma referência do período de tempo como um argumento.
Retorna
Verdadeiro — Se esse período está contido no primeiro ano de previsão ou o primeiro ano está, mesmo parcialmente, no período de previsão.
Falso — Caso não ocorra.
@ishalf
Definição
É um semestre
Uma referência relativa em declarações @if
.
Você pode dividir um ano em trimestres, o que lhe permitirá agregar períodos semestrais, ou em semestres, o que não gerará esses períodos agregados. Os detalhes do período são determinados em Definição de Períodos.
Retorna
Verdadeiro — se o período é semestral, seja ou não um período agregado
Falso — Caso não ocorra
Exemplo
Se um modelo tem 2006 em anos e 2007 em semestres, esta fórmula:
@if(@ishalf, 1, 2)
retorna 2 em 2006 e 1 em 2007.
@ishist
Definição
É um período do histórico
Uma referência relativa em declarações @if
.
Períodos históricos são determinados pelo limite de histórico/previsão definido em Definição de Períodos.
Retorna
Verdadeiro — se o período é histórico
Falso — Caso não ocorra
Exemplo
Se um modelo contém 6 anos começando em 2006 e o primeiro ano é histórico, 2007-2012 são períodos de previsão. Esta fórmula:
@if(@ishist, 1, 2)
retorna 1 em 2006 e 2 nos outros anos.
@isinput
Definição
É um período de entrada
Uma referência relativa em declarações @if
.
Utilize em estruturas de período de tempo contendo períodos agregados ou de final de ano: meses, trimestres, semestres. Utilize esta função com contas que podem ser convertidas em contas calculadas: contas de aviso, contas de intervalo e contas de contrato.
Retorna
Verdadeiro — se o período é um período de entrada
Falso — Caso não ocorra
Exemplo
Se 2006 estiver em trimestres com um final de ano agregado, esta fórmula:
@if(@isinput, 1, 2)
retorna 1 para cada trimestre de 2006 e 2 no final do ano de 2006.
@islastfore
Definição
É o último período da previsão
Uma referência relativa em declarações @if
.
Retorna
Verdadeiro — se o período é o último período previsto no modelo
Falso — Caso não ocorra
Exemplo
Se um modelo contém 6 anos terminando em 2011 e 2007-2011 são previstos, esta fórmula:
@if(@islastfore, 1, 2)
retorna 1 em 2011 (o último período previsto) e 2 nos outros anos.
@islasthist
Definição
É o último período do histórico
Uma referência relativa em declarações @if
.
Períodos de previsão são determinados pelo limite de histórico/previsão definido em Definição de Períodos.
Retorna
Verdadeiro — se o período é o último período histórico no modelo
Falso — Caso não ocorra
Exemplo
Se um modelo contém 6 anos começando em 2005, com 2006 como o último período histórico, 2007-2010 são previstos. Esta fórmula:
@if(@islasthist, 1, 2)
retorna 1 em 2006 e 2 em todos os outros anos.
@ismonth
Definição
É um período mensal
Uma referência relativa em declarações @if
.
Os detalhes do período são definidos em Definição de Períodos.
Retorna
Verdadeiro — se o período está em meses
Falso — Caso não ocorra
Exemplo
Se 2006 estiver em anos e 2007 em meses, esta fórmula:
@if(@ismonth, 1, 2)
retorna 2 para 2006 e 1 nos períodos mensais para 2007.
@isopening
Definição
É o período de abertura no modelo
Uma referência relativa em declarações @if
.
O período de abertura é o agregado dos períodos de fechamento e de negociação.
Por exemplo, caso crie um período de negociação em Mar08, o Strategic Modeling cria contas Mar08:Fechamento e Mar08:Negociação, que são agregadas a Mar08. Mar08 é o período de abertura.
Retorna
Verdadeiro — se o período é o período de abertura no modelo
Falso — Caso não ocorra
@isqtr
Definição
É um trimestre
Uma referência relativa em declarações @if
.
Retorna
Verdadeiro — se o período está em trimestres
Falso — Caso não ocorra
Exemplo
Se 2007 estiver em anos e 2008 em trimestres, esta fórmula:
@if(@isqtr, 1, 2)
retorna 2 em 2007 e 1 para cada trimestre de 2008.
@issub
Definição
É um subperíodo
Uma referência de tempo relativa em declarações @if
.
O período de abertura é o agregado dos períodos de fechamento e de negociação.
Retorna
Verdadeiro — se o período é um subperíodo com zero dias
Falso — Caso não ocorra
Exemplo
Se 2007 estiver em anos e 2008 compreender dois subperíodos, um de 365 dias e outro de zero dias, esta fórmula:
@if(@issub, 1, 2)
retorna 2 para 2007 e, para 2008, 1 para o 365º dia e 1 na redeclaração ou o período de zero dias.
@isweek
Definição
É uma semana
Uma referência de tempo relativa em declarações @if
.
Os detalhes do período são definidos em Definição de Períodos.
Retorna
Verdadeiro — se o período está em detalhes semanais
Falso — Caso não ocorra
Exemplo
Se 2007 estiver em meses e 2008 estiver em semanas, esta fórmula:
@if(@isweek, 1, 2)
retorna 2 nos meses de 2007 e 1 nas semanas de 2008. Os períodos agregados de 2008 retornam 2.
@isyear
Definição
É um ano
Uma referência de tempo relativa em declarações @if
.
Retorna
Verdadeiro — se o período é um ano ou final de ano
Falso — Caso não ocorra
Exemplo
Se 2007 estiver em anos e 2008 em trimestres, esta fórmula:
@if(@isyear, 1, 2)
retorna 1 em 2007 e 2 para cada trimestre de 2008.
@monthnum
Definição
O número do mês fiscal
Utilize @monthnum
em instruções @if
para modelar ocorrências que se passam uma vez ao ano. O Strategic Modeling numera os meses de 1 a 12 iniciando com o primeiro mês do ano fiscal. Por exemplo, a função é usada se um passivo foi liquidado em um mês.
Retorna
O número do mês: entre 1 e 12.
Exemplo
Se os Impostos de Renda a Pagar forem v2530, os Impostos Totais forem v1690, e setembro for o mês 9, esta fórmula:
@if(@monthnum= 9, v1690, v2530(-1m)+v1690)
agrega todos os impostos em v2530 até setembro, paga os impostos ao diminuir o saldo para 0 e começa a acumular impostos do período atual.
@period
Definição
Número do período, iniciando a partir do primeiro período de tempo previsto
Essa função conta os agregados e as coluna de entrada. A última coluna de tempo histórico é o número 0, e cada número da coluna seguinte aumenta em 1.
Retorna
Verdadeiro — se o número do período é igual ao número inserido em @if
Falso — Caso não ocorra
Exemplo
Esta fórmula:
@if(@period= 2, 1, 2)
executa (resultado: 1) depois que a fórmula alcança a segunda coluna de tempo previsto.
@pdexists
Definição
O período existe
Executa comandos se um período existe
Retorna
Verdadeiro — se o período existe
Falso — Caso não ocorra
Exemplo
Para a conta Vendas (v1000):
@if(@pdexists(-3),V1000(-3),@na)
Incorporado em uma fórmula maior, essa fórmula assegura que as Vendas dos 3 períodos anteriores entram na equação. Se não houver figuras de Vendas para aqueles períodos, retorna N/D.
@pdlen
Retorna
Retorna o dias em números de um período.
Exemplo
Esta fórmula calcula a despesa de juros:
@pdlen/@yearlen * v2520 * 9%
Em que Notas a Pagar (v2520) têm uma taxa anual de 9%. Essa leva o número de dias no período, divide o número de dias no ano, multiplica o saldo de débito e multiplica por 9% para obter uma despesa de juros periódica.
@pdnum
Definição
Número do período, iniciando da primeiro coluna de tempo
Totaliza os agregados e as entradas. A primeira coluna de tempo é o número 0.
Retorna
O número de colunas de tempo no modelo desde o primeiro período.
Verdadeiro — se o número do período é igual ao número inserido em @if
Falso — Caso não ocorra
Exemplo
@if(@pdnum= 2, 1, 2)
Essa executa (resultado: 1) depois de a fórmula alcançar a terceira coluna de tempo no modelo.
@qtrnum
Definição
Número do trimestre
Retorna
Uma referência de tempo relativa em declarações @if
.
Exemplo
@if(@qtrnum=3,v1080(-1Q),v1000*@input)
No terceiro trimestre, essa fórmula leva o valor do segundo trimestre de Despesa de Venda, Geral e Administrativa (v1080). Nos primeiro, segundo e quarto trimestres, a fórmula leva uma porcentagem da entrada (@input) multiplicada pelas Vendas (v1000).
@since( referência do período ), @after
Definição
Adiciona durações a funções como @sum
.
@since
inclui os períodos de início. Aceita referências de períodos absolutos como @firstfore
ou mai03, mas rejeita referências de período relativo como -1Y.
@after
não inclui os períodos de início.
Exemplo
@sum( Vyyyy, @since( @issuepd( Vxxxx )))
Soma todos os fluxos que ocorreram depois que a dívida foi emitida.
@weeknum
Definição
O número da semana fiscal
Usada em declarações @if
para modelar ocorrências que se passam uma vez ao ano.
O Strategic Modeling numera as semanas de 1 a 52 (ou 53) iniciando com a primeira semana do ano fiscal. Por exemplo, utilize essa função se um dividendo tiver sido liquidado em uma semana.
Retorna
O número da semana fiscal, entre 1 e 53.
Exemplo
Para Dividendo Comum (v1880) e Ações Comuns Pendentes Média Ponderada (v3410):
@if(@weeknum=37,v3410*.65,0)
retorna um Dividendo Comum correspondente a 65 centos por ação comum na 37ª semana de cada ano e 0 em todas as outras semanas.
@yearlen
Definição
Duração do ano
Retorna
O número de dias em um ano, conforme definido em Definição de Períodos.
Exemplo
Esta fórmula retorna o valor das Vendas (v1000) nos períodos anuais:
@if(@isyear,v1000,v1000/@pdlen*@yearlen)
Em períodos não anuais, ela anualiza as Vendas ao dividir pelo comprimento do período e multiplicar pelo número de dias no ano.
@yearnum
Definição
Número do ano
Uma referência de tempo relativa em declarações @if
.
Retorna
O número do ano.
Exemplo
@if(@yearnum=2001,v1080(-1y),v1000*@input)
Em 2001, a fórmula retorna o valor de Despesa de Venda, Geral e Administrativa (v1080) de 2000. Nos outros períodos da previsão, a fórmula retorna uma porcentagem da entrada (@input) multiplicada pelas Vendas (v1000).
@firstday
Definição
O primeiro dia do período de tempo
Retorna
O número de dias para o primeiro dia do período.
@lastday
Definição
O último dia do período de tempo
Retorna
O número de dias para o último dia do período. Para o calendário, esse é o número de dias desde 30 de dezembro de 1899. Para períodos diferentes do calendário, o valor é ajustado para o comprimento do ano (360 ou 364 dias).
@iscalc
Definição
É um número calculado
Retorna
Verdadeiro — se o período de tempo contém valores calculados
Falso — Caso não ocorra
@isleaf
Definição
É um modelo sem modelos filhos
Retorna
Verdadeiro — se o período de tempo não tem períodos filhos
Falso — Caso não ocorra
Exemplo
Em um ano contendo apenas meses, o ano retorna falso e os meses retornam verdadeiro.
@isptd
Definição
É o período até a data
Retorna
Verdadeiro — se o período de tempo é um acumulado no período
Falso — Caso não ocorra
@istrailing
Definição
É um período final
Retorna
Verdadeiro — se o período de tempo é um período final
Falso — Caso não ocorra
@islastactual
Definição
É o último valor real
Retorna
Verdadeiro — se o período de tempo é o último período real
Falso — Caso não ocorra
@islastperiod
Definição
É o último período de tempo
Retorna
Verdadeiro — se o período de tempo é o último período
Falso — Caso não ocorra
@blocknum
Definição
Um bloco de períodos de tempo definidos por mês ou número de semanas
Retorna
Para modelos em meses, o número do mês no ano, 1 a 12.
Para modelos em semanas, o número da semana no ano, 1 a 53.
@issuepd( Vxxxx, [referência de período opcional])
Definição
Período de emissão
Retorna
Se Vxxxx contiver uma programação de dívida, retorna o período no qual a dívida foi emitida.
Caso contrário, retorna uma referência de período inválida.
@isissuepd( Vxxxx, [referência de período opcional])
Definição
É o período de emissão
Retorna
Verdadeiro — se Vxxxx contém uma programação de débito e o período atual, ou referência opcional, é quando o débito foi emitido
Falso — Caso não ocorra
Utilize a referência de período opcional para alterar o período de teste. Por exemplo:
@isissuepd( Vxxxx, -1 )
testa se o período anterior foi o período de emissão.
@isinterm( Vxxxx, [referência de período opcional])
Definição
Está no prazo — Somente Agendador de Débito
Utilize a referência de período opcional para verificar outro período se o primeiro estiver dentro do prazo. Um período está dentro do prazo de dívida se a dívida for emitida, existir ou estiver extinta durante aquele período.
Retorna
Verdadeiro — Se Vxxxx tem uma programação de débito e o período atual está dentro do prazo.
Falso — Se Vxxxx não tem uma programação de débito ou o período atual não está dentro do prazo.
Funções que Modificam a Recuperação do Valor de uma Conta
Para essas funções, o primeiro argumento é uma referência de conta, a menos que indicado o contrário. Os argumentos entre [] são opcionais.
@abs(vXXXX)
Definição
Valor absoluto
Retorna
O valor absoluto de uma conta específica.
Exemplo
@abs(v1750)
Em que a Receita Líquida é igual a v1750 e é -10, isso retorna 10.
@annualize(vXXXX)
Definição
Anualiza um valor
Utilize ao trabalhar em meses, trimestres ou semestres. O cálculo utiliza o número de dias no ano e o número de dias naquele período para calcular um valor anualizado.
Retorna
Retorna o valor anualizado da conta.
Exemplo
@annualize(v1150)
Em que o Lucro Operacional é igual a v1150 e é 15 no terceiro trimestre de 2000. Isso é calculado como:
15*(nº. de dias no ano)/(nº. de dias no período)
ou
15* 366/ 92= 59.674.
@avg(vXXXX, -t)
Definição
Tira a média de um valor sobre os períodos t
A variável t pode ser um mês, trimestre ou semestre. O Strategic Modeling calcula os valores para os períodos com detalhes insuficientes.
Retorna
Retorna uma média em movimento de uma conta para os períodos t preciosos.
Exemplo
@avg(v1040, -3q)
Em que Custo de Mercadorias Vendidas (v1040) é:
v1040 | 1998 | 1999 | 1Q00 | 2Q00 | 3Q00 | 4Q00 |
---|---|---|---|---|---|---|
Custo de Mercadorias Vendidas |
15 |
20 |
4 |
5 |
6 |
7 |
O cálculo em 2Q00:
[5+ 4+ (20*(nº. de dias em 4Q99)/(nº. de dias em 1999)]/3
O resultado: 5,68
O cálculo em 3Q00:
(4+ 5+ 6)/3 or 5.
@ceil(vXXXX)
Definição
Arredonda um valor até o próximo número inteiro
Retorna
Retorna o próximo número inteiro maior (por exemplo, 2, 10, 65, 149...) com base no resultado da variável entre parênteses ou equação.
Exemplo
Em que Inventário (v2040) é 233, esta fórmula:
@ceil(v2040/100)
calcula o número de caminhões necessários para transportar o inventário, levando em consideração que cada caminhão carrega 100 vezes o inventário em um período. Esse exemplo equaciona a 2.33 e a função arredonda o resultado para 3.
@chg(vXXXX,-t)
Definição
Calcula a alteração
Retorna
Retorna a alteração na variável sobre os períodos t.
Exemplo
@chg(v1040, -1q)
Em que Custo de Mercadorias Vendidas (v1040) é:
v1040 | 1998 | 1999 | 1Q00 | 2Q00 | 3Q00 | 4Q00 |
---|---|---|---|---|---|---|
Custo de Mercadorias Vendidas |
15 |
20 |
4 |
5 |
6 |
7 |
No segundo trimestre de 2000 a equação retorna:
1, (5- 4)
@floor(vXXXX)
Definição
Arredonda um valor abaixo do próximo número inteiro
Retorna
Retorna o próximo número inteiro menor (por exemplo, 2, 10, 65, 149...) com base no resultado da variável entre parênteses ou equação.
Exemplo
Se as Vendas forem 20,23 e 34,45:
@floor(v1000)
calcula o valor 20 e 34.
@histavg ou @histavg(vXXXX)
Definição
Média de previsão histórica
Se um método de previsão de Fórmula de Forma Livre contém @histavg, nenhuma entrada é necessária no período do histórico. Na exibição Conta, quando o cursor está na conta de referência, a caixa de diálogo Méd. Hist. exibe a média histórica.
Os anos no cálculo da média histórica são definidos em Definição de Períodos.
Retorna
A média histórica com base no método de previsão usado na conta.
Exemplo 1
A fórmula básica:
@histavg
Exemplo 2
Se as Vendas (v1000) em 2006 e 2007 são 10 e 12, e o método de previsão de vendas for um valor real em dólares, esta fórmula:
@histavg(v1000)
retorna 11.
Exemplo 3
Se o exemplo 2 usar um método de previsão de taxa de crescimento, o Strategic Modeling calculará a média histórica como 20% — a taxa de crescimento necessária para passar de 10 para 12.
@input ou @input(vXXXX)
Cuidado:
Não usa argumentos para recuperar valores de outras contas, já que essa opção pode ser diminuída.
Definição
Usa uma entrada na fórmula
Permite que os usuário insiram um número e façam referência para tal entrada na fórmula.
Retorna
A função de entrada funciona em conjunto com as caixas de texto Entrada como e Unidades.
Exemplo 1
Ao calcular dividendos, o Lucro Líquido do primeiro período de tempo previsto pode ser usado como uma base. O Lucro Líquido é multiplicado por uma entrada da porcentagem em cada período.
Por exemplo:
@input* v1750(@firstfore)
Por padrão, Entrada Como é Moeda. Altere-o para Porcentagem para essa fórmula.
Exemplo 2
Para Custo de Mercadorias Vendidas (v1040):
@input(v1040)
retorna a entrada de v1040 independentemente de a conta conter a fórmula. Se Custo de Mercadorias Vendidas for 75% de Vendas, o Strategic Modeling retorna 75% em vez da saída Custo de Mercadorias Vendidas.
@irr(vXXXX(t),vXXXX(t), [%])
Definição
Taxa Interna de Retorno (IRR)
A primeira variável é a conta na qual há saída de dinheiro inicial em um período.
A segunda variável é a corrente de caixa iniciando em um período.
A porcentagem é uma hipótese opcional na IRR.
Retorna
A taxa interna do retorno de uma corrente de fluxos de caixa.
Exemplo
Um projeto com investimento inicial em 2000 e um fluxo de caixa iniciando em 2000 usa esta fórmula:
@irr(v300(1999), v4100(2000))
se o investimento inicial existir em v300 de 1999. A corrente de caixa é originada do fluxo de caixa de Operações (v4100) iniciando em 2000.
@normalize
Definição
Normaliza um valor
Calcula um valor normalizado do número de dias no período atual e no período anterior. Para comparar períodos de tempo consecutivos de diversas extensões.
Retorna
O valor normalizado de uma conta através de períodos de tempo consecutivos.
Exemplo
@normalize(v1150(-1))
Se o Lucro Operacional (v1150) for $8,515 in 2006,
2007 é calculado como:
(v1150(-1)*# of days in current period)/(# of days in prior period) or (8515*366)/365 = 8538.
@prior(vXXXX)
Definição
Conta do período anterior
Retorna
Refere-se ao saldo de conta do período anterior.
Exemplo
@prior(v1040)
refere-se ao saldo do período anterior para Custo de Mercadorias Vendidas (v1040).
@sum(vXXXX, -t)
Definição
Soma
Retorna
Esta é uma função de soma de giro. É necessário inserir um número de conta e o número de períodos a somar.
Exemplo
@sum(V1040,-3M)
soma o Custo de Mercadorias Vendidas (v1040) nos últimos três meses.
@ytd
Definição
Acumulado no Ano
Refere-se aos períodos de tempo acumulados no ano.
Retorna
Uma soma de valores a partir do início de um ano até o presente.
Exemplo
Se um modelo de três anos, 2004-2006, estiver em trimestres:
@avg(v1040(-2Q), @ytd)
faz a média do valor de Custo de Mercadorias Vendidas acumulado no ano a partir dos dois trimestres anteriores. No primeiro trimestre de 2006, as somas 1Q2000, 2Q2000 e 3Q2000 e divide por três.
Funções que Operam sobre Expressões
Essas funções podem tomar qualquer expressão como um argumento:
@depr(vXXXX,"schedule") ou @depr(vXXXX,schedule, previdências do período estão dentro, % do investimento inicial previdenciado)
Definição
Depreciação
Retorna
Calcula a depreciação ou remove previdências da despesa de depreciação.
Permite a depreciação da previsão contra a corrente de gastos de capital. A fórmula básica:
@depr (CAPX* stream, * schedule)
em que fluxo CAPX é a conta de gasto capital depreciado e programado é o nome programado definido em Como Usar o Agendador de Débito. Insira essa fórmula em v2190.1 ou em uma conta de memorando e a saída da função é a depreciação para aquele ativo do período.
Ao depreciar fluxos CAPX, @depr
retarda-se. A depreciação em 2003 para uma ativo de cinco anos é:
CAPX de 2003 vezes a primeira taxa do ano
mais o CAPX de 2002 vezes a segunda taxa do ano
mais o CAPX de 2001 vezes a terceira taxa do ano, etc.
Se um ano não tiver CAPX ou não existir, o Strategic Modeling multiplica zero por uma taxa.
O Strategic Modeling aplica a mesma taxa para todos os CAPXs de variáveis, por isso cada classe de ativo deve ter um fluxo de CAPX. Por exemplo, use subcontas separadas de v2170.1 para propriedades de cinco e dez anos.
Ao depreciar ativos para propósito financeiros e de relatório de imposto, é possível usar o fluxo CAPX, mas diferentes programações e contas de saída.
Períodos Provisórios
Caso insira ativos por trimestre, mês ou semestre, @depr
calcula a depreciação anual para o ativo, exibindo o montante no trimestre. Para calcular cada período provisório da mesma maneira, crie programações.
Nos anos subsequentes ao ano colocado no serviço, o Strategic Modeling calcula a depreciação anual para aquele ativo e aloca nos períodos provisórios com base em dias.
Previdências
Para registrar uma previdência, essa função registra a depreciação:
@DEPR(v2170.03, "schedule", 3, 50)
v2170.3 (Previdências Brutas) é a previdência nos ativos
Programado é a programação contendo a taxa de depreciação (ex.: 5 anos SL)
(3) é o ano atual na programação (em uma convenção semestral, propriedades de cinco anos depreciam em seis anos). Deve ser um número natural.
(50) é a porcentagem de depreciação não reconhecida no ano de previdência. Deve estar entre (0) e (100) e aplica-se somente ao anos de previdência. Nos anos subsequentes ao ano de previdência, o Strategic Modeling calcula a depreciação não mais reconhecida. Se um método não reconhece depreciação no ano de previdência, insira 100.
Nota:
Ao modelar as vendas de ativos, modele a depreciação acumulada nos ativos de previdência.
A depreciação total é calculada ao adicionar todas as contas de depreciação e subtrair as previdências.
Propósito 1: Depreciação
@depr
pode depreciar os fluxos de investimentos de capital usando as programações de depreciação. A fórmula deve usar os investimentos de capital de conta de previsão (v2170.1.xxx). Insira o nome exato da programação entre aspas.
Exemplo 1:
@depr(v2170.1.010, "Tax: 5 year")
Com a programação de depreciação MACRS de 5 anos: 20%, 32%, 19,2%, 11,52%, 11,52%, 5,76%. Há seis porcentagens de depreciação devido à convenção semestral.
V2170.1.010 | 1998H | 1999H | 2000F | 2001F | 2002F | 2003F |
---|---|---|---|---|---|---|
CAPEX |
16 |
20 |
30 |
35 |
40 |
45 |
No primeiro ano de previsão, 2000, o Strategic Modeling tira 19,2% do investimento de 1998 (do terceiro período da programação), 32% de 20 do investimento de 1999, 20% de 30 do investimento de 2000. A resposta é 15,28.
Propósito 2: Remoção de Previdências
Ao remover ativos do serviço antes da depreciação completa, remova a porção do ativo da despesa de depreciação, pois o Strategic Modeling deprecia os investimentos iniciais. Strategic Modeling não sabe como as previdências ocorrem no futuro e pode não ajustar corretamente.
@depr
pode remover a porção previdenciada do montante da depreciação. Em @depr
, faça referência com a conta que contém baixas de ativo (v2170.3.xxx).
Faça referência da programação depreciando os ativos, insira o número de períodos de volta no ativo previdenciado iniciado e faça referência da % de investimento inicial sendo removido da despesa de depreciação.
Exemplo 2:
@depr(v2170.3.010, "Tax: 5 year", 3, .75)
@if(T/F Condição de Teste, Executar se Verdadeiro, Executar se Falso)
Definição
Declaração lógica condicional
Sintaxe:
@if(test condition, execute if "true", execute if "false")
Executa um dos dois comandos com base em uma condição. A condição pode ser uma fórmula, string, lista ou data e deve retornar verdadeiro ou falso. É possível alojar declarações @if
.
Retorna
Resultados de comando de execução.
Exemplo 1
Para Receita Líquida (v1750), se a porcentagem de desembolso de dividendo comum tiver base no crescimento da receita líquida da empresa sobre o ano anterior, e:
Se a Receita Líquida aumentar em pelo menos 25%, o dividendo é 20%
Se a Receita Líquida for inferior a 25%, o dividendo será 15%
A fórmula para os Dividendos Comuns é:
@if((v1750-v1750(-1Y))/v1750(-1Y)>=25%, v1750*20%,v1750*15%)
Exemplo 2
Se o modelo no exemplo 1 estiver em trimestre, mas os dividendos forem pagos uma vez ao ano no início do ano fiscal, tendo como base a receita líquida do ano anterior, use um @if
alojado para calcular o pagamento no primeiro trimestre somente:
@if(@qtrnum=1,@if((v1750(-1q)-v1750(-5q))/v1750(-5q)>=25%, v1750(-1q)*20%,v1750(-1q)*15%),0)
Nota:
No rastreamento de análise, o Strategic Modeling retorna 1 se a resposta for verdadeiro e 0 se a resposta for falso.
Como Usar Strings
Digite strings entre aspas. Por exemplo: Subscrição. As strings não fazem distinção entre maiúsculas e minúsculas e são usadas como argumentos de funções somente para testar fórmulas — elas não podem ser usadas como resultados.
Isto é válido:
@if(v1.0.600="Underwriting", v300*v305, @na)
porque é possível usar as strings em testes.
Isto não é válido:
@if(v155=v160, 300, "Revenue")
porque não é possível usar strings como resultados.
Como Usar Listas
As listas comportam-se como as strings. As listas podem ser séries de tempo ou escalar.
Por exemplo, se uma conta "Processado?" (v150.00.0000) tiver estes valores possíveis: Sim, Não, Não Disponível — isto será válido:
@if(v150="Yes", 100, 200)
Em listas de números enumeradas, os números são processados como strings e inseridos entre aspas. Por exemplo:
@if(v176="8", 300, 400)
Como Usar Datas
Para inserir datas, use o formato MM/DD/AAAA
entre aspas, por exemplo:
@if(v174="06/30/2003", 100, 300)
As datas são processadas como strings.
@isna(expressão)
Definição
Não está disponível
Pode ser usada em declarações @if
.
Retorna
Verdadeiro — se a expressão for indefinida ou não for um número
Falso — caso não seja
Exemplo 1
@isna(1/0)
A resposta para a expressão é indefinida; portanto, oStrategic Modeling retorna verdadeiro.
Exemplo 2
@if(@isna(v2040/v1040), v2040/v1040, 0)
Com Inventário (v2040) e Custo de Mercadorias (v1040), esta fórmula retorna o movimento de estoque quando o Custo de Mercadorias Vendidas não for igual a zero, e 0 quando o Custo de Mercadorias Vendidas não for igual a 0 ou estiver N/D.
@max(val.,val.)
Definição
Máximo
Retorna
O maior número em um intervalo de valores.
Exemplo
@max(0, 1, 2)
Retorna 2.
@min(val.,val.)
Definição
Mínimo
Retorna o mínimo de um intervalo de valores. As fórmulas podem ser executadas dentro da função.
Exemplo
@min(0, 1, 2)
Strategic Modeling retorna 0.
@not(condição ou fórmula)
Definição
Não é algo
Usada em declarações @if
para executar um comando se uma condição não for verdadeira.
Exemplo 1
@if(@not(v1750>100000), 1, 2)
Se v1750 (Lucro Líquido) for menor que ou igual a 1 milhão, 1 é retornado, caso contrário, 2 é retornado.
Exemplo 2
@if(@not(@isyear), 1, 2)
O Strategic Modeling retorna 1 se o período não for um ano (ex.: um mês, trimestre...) e 2 em outras estruturas de tempo.
Funções Especiais
Estas funções são para uso específico. Só as utilize se for absolutamente necessário.
@debtex
Usado pelo Agendador de Débito para cálculos internos.
@pfdindebt
Usado pelas Opções de Fundo para cálculos internos.
@xspfdtodebt
Usado pelas Opções de Fundo para cálculos internos.
Funções que Fazem Referência a Valores Infinitos
@ inf
Definição
Carrega um valor infinito
Retorna
Infinito
Se você precisar usar Inifinito em uma fórmula do Strategic Modeling, a maneira mais fácil será usar a função @inf
. Os valores infinitos positivos e negativos também são gerados por operações matemáticas, como divisão por zero.
@isinf(expression)
Definição
Método usado para verificar se o valor de uma expressão é infinito.
Retorna
Verdadeiro — se for informado um valor infinito positivo ou negativo
Falso — caso não seja
Exemplo 1
@isinf (1/0)
A resposta para 1/0 é "Infinity"
, então o Strategic Modeling retorna verdadeiro.
Exemplo 2
@if(@isinf (v2040/v1040), v2040/v1040, 0)
Com Inventário (v2040)
e Custo de Mercadorias(v1040)
, esta fórmula para rotatividade de inventário verifica se o cálculo produz um valor infinito (o que acontece quando o Custo de Mercadorias Vendidas é zero ou o Inventário é Infinito) e, nesse caso, o valor calculado é definido como 0
.