Funções Usadas em Fórmulas

@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:

  • DAYS_IN_TERM: retorna o número total de dias no prazo do instrumento de débito, de acordo com a Convenção da Contagem de Dias usada pelo instrumento. Mede a diferença entre a Data de Emissão e a Data de Vencimento.
  • FIRST_DAY: retorna o número do dia da Data de Emissão do instrumento de débito.
  • LAST_DAY: retorna o número do dia da Data de Vencimento do instrumento de débito.
  • INITIAL_BALANCE: retorna o saldo inicial do instrumento de débito.
  • ISSUE_COSTS: retorna o valor dos custos de emissão (como valor da moeda) do instrumento de débito.
  • PREM_DISC: retorna o valor do prêmio/desconto (como o valor da moeda) para o instrumento de débito.
  • ELAPSED_DAYS: retorna o número de dias decorridos desde a Data de Emissão do instrumento de débito; retorna zero quando está fora do prazo do instrumento.
  • TERM_REMAINING: retornará a fração do prazo restante para o instrumento de débito, ajustado para reembolso antecipado do débito se a opção Amortização segue o principal estiver selecionada. Retorna 0 quando está fora do prazo do instrumento.
  • DAYS_IN_PERIOD: retorna o número de dias no período atual de acordo com a Convenção da Contagem de Dias usada pelo instrumento.
  • DCF: a Fração do Número de Dias retorna o número de dias no período atual de acordo com a Convenção da Contagem de Dias usada pelo instrumento.

@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.

@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

Definição

Comprimento do período

Os detalhes do período são definidos em Definição de Períodos.

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.

@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

Exemplo

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.