Ir para o conteúdo principal
Documentação
Documentação
Adaptive Planning
Referência: funções de fórmula

Referência: funções de fórmula

As funções de fórmula são agrupadas em quatro categorias: matemáticas, lógicas, cadeia de caracteres e data. Este tópico apresenta cada função e uma breve explicação.
Para simplificar, as descrições na tabela mostram fórmulas que usam vírgulas como separadores. Algumas configurações de navegador requerem que você use ponto e vírgula como separador. As colunas de sintaxe mostram ambas as versões.

Funções matemáticas

As funções matemáticas estão disponíveis como botões. Por exemplo, somar (+), subtrair (-) e multiplicar (*). Seleções adicionais estão disponíveis em
Função > Matemáticas
.

Funções lógicas

Para incluir como parte de um
If
 A instrução, as funções lógicas básicas e as comparações estão disponíveis como botões. Por exemplo, lógico e (
AND
), lógico ou (
OR
) e negação lógica (
NOT
). As comparações incluem igual a (
=
), maior que (
>
), menor que (
<
) ou diferente de (
!=
). Você também pode usar (
<>
) para diferente de igual a.
Opções adicionais estão disponíveis em
Função > Lógicas
:
Sintaxe
Descrição
Blank()
Retorna o
Blank
 valor. Esse valor é exibido como em branco (em vez de zero), mas é avaliado de forma idêntica ao zero para fins de fórmula. Ao contrário de um zero, faz com que o
IsBlank()
 função a ser retornada
TRUE
, mas, semelhante a zero, pode ser suprimida quando a opção "suprimir linhas vazias" está habilitada em planilhas ou relatórios.
Error ()
Causa um erro de avaliação em tempo de execução.
Exemplo:
IF(ACCT.EffectiveHeadcount < 0, Error(), ACCT.EffectiveHeadcount+ACCT.AddlHeadcount)
Se o total de headcount efetivo for menor que 0, retornará um erro para ajudar a rastrear a raiz do problema.
If (EXPR, T, F)
If (EXPR; T; F)
Retorna um valor numérico (
T
) if Expressão booliana (
EXPR
) é verdadeiro; caso contrário, retorna um valor numérico (
F
). Você pode usar operadores boolianos e de comparação para construir a expressão booliana.
Iff (EXPR, T, F)
Iff (EXPR; T; F)
A forma "rápida" ou de atalho do
If
 função. Retorna o mesmo valor que
If
. No entanto, se a condição é verdadeira, o terceiro argumento da função não é avaliado. Do mesmo modo, se a condição é falsa, o segundo argumento não é avaliado. Isso significa que o segundo ou o terceiro argumento pode conter erros, mas os resultados do
Iff
 ainda será válido porque o argumento que inclui o erro não é avaliado.
Exemplos:
  • IFF (this.Version.isActuals, ACCT.TravelExp, ACCT.Personnel.EstimatedTravel)
  • IFF (this.Qtr.PositionOf (this.Month) = 2, 100000, 0)
IsBlank (N)
Retorna verdadeiro se o argumento está em branco ou vazio; caso contrário, retorna falso. Só pode ser usado em um argumento de expressão (
EXPR
) para o
If
 função.
Exemplo:
If(IsBlank(Row.StartDate),0,1)
Switch (Orig_EXPR, Case1, Case2, ..., Default)
Switch (Orig_EXPR; Case1; Case2; ...; Default)
Fornece um método para escrever expressões compactas que podem ser usadas em vez de expressões complexas e aninhadas
If
 declarações.
  • O primeiro argumento (
    Orig_EXPR
    ) é a expressão original (às vezes chamada de
    expressão de controle
    ) que é avaliada primeiro.
  • Os argumentos subsequentes são
    Cases
    (valores e expressões correspondentes) que podem ser ativados dependendo de qual maiúsculas e minúsculas corresponde ao valor da expressão original.
  • Você pode definir um ou mais casos. Cada caso consiste em um valor (
    N
    ) e uma expressão (
    EXPR
    ) separados por vírgula. A sintaxe expandida fica assim:
    Switch (Orig_EXPR, N1, EXPR1, N2, EXPR2, ..., Default)
  • Por exemplo, se o valor da expressão original corresponder ao valor definido em
    Case1
    , a expressão associada a
    Case1
     é retornado. Mas, se o valor da expressão original corresponder
    Case2
    , a expressão associada a
    Case2
     é retornado e assim por diante.
  • Se não houver correspondência,
    Switch
     retorna o
    Default
     expression
  • Todas as expressões (
    EXPR
    ) no
    Switch
     A instrução deve ser do mesmo tipo de dados (cadeia de caracteres, data, número etc.). Se as expressões variam em tipo de dados, este erro é exibido:
    Inconsistent
     Alternar tipos de devolução
  • Em vez de um único valor (
    N
    ) para cada caso, você pode especificar um
    Range(L,U)
     de valores em que
    L
     é o limite inferior do intervalo e
    U
     é o limite superior do intervalo. Por exemplo, um intervalo pode incluir vários anos
    Range(2014,2017)
     e quando o valor da expressão original está dentro desse intervalo, inclusive, a expressão associada a esse intervalo é ativada.
  • Cada argumento de um intervalo deve ser do mesmo tipo de dados (por exemplo, um número como 7, uma constante de cadeia de caracteres como
    Engineering
     ou uma constante de data criada usando a constante
    Date()
     Uma função ou uma expressão que resolva o tipo de dados apropriado (por exemplo,
    this.Version.Name
     ou
    ACCT.Rent
    ).
Exemplos:
  • Switch (ROW.DAY,1,"Sunday",2,"Monday",3,"Tuesday","No match")
     Se
    ROW.DAY
     é 2, então segunda-feira é a expressão que corresponde ao valor 2, portanto, o
    Switch
     O resultado é segunda-feira.
  • Switch (ToNumber (ROW.CaseQty), Range (0,11), 0, Range (12,24), 1, Range (24,48), 4, 0)
     Este segundo exemplo retorna0, 1 ou4, dependendo do valor numérico encontrado no
    CaseQty
     seletor

Funções de data e hora

As funções de data são geralmente usadas em combinação com colunas de
Data
 de planilha modelada. As funções de data são exibidas somente em contas calculadas em planilha modelada.
As funções de data se aplicam a calendários com configurações de Mês > Trimestre > Ano. Se você tem um calendário que usa uma estrutura diferente, muitas dessas funções retornam erros. Considere usar esta função: this.version.positionOf(D.strata). Substitua D por uma data do calendário neste formato: aaaa,mm,dd e substitua os estratos pelos estratos que você usa no calendário. Exemplo: this.version.positionOf(2024,01,02.week) retorna a primeira semana de 2024.
Sintaxe
Descrição
D.Month.NumberOfDays
Retorna o número de dias no mês em que a data
D
 ocorre
.
D.Year.PositionOf(D.Month).
Retorna o mês do exercício fiscal em que a data
D
 ocorre.
D.Year.PositionOf(D.Qtr)
Retorna o trimestre do exercício fiscal em que a data
D
 ocorre.
(Date).
stratum_code
Retorna o
Timeperiod
 do tipo de estrato solicitado que contém a Data (única, gregoriana). Qualquer data pode ser usada como base do código de estrato.
Exemplo:
ToDate
(2016,8,5).Qtr
 retorna o trimestre-calendário que contém 5 de agosto de 2016.
Day (D)
Retorna o dia do mês de data (
D
).
DaysInMonth (D)
Retorna o número de dias de um mês em que a data D ocorre. Pode retornar um erro ou um valor incorreto para calendários personalizados. Uso
D.Month.NumberOfDays
 em vez disso.
FiscalMonth (D)
Retorna o mês do exercício fiscal em que a data (
D
) ocorre. Pode retornar um erro para calendários personalizados. Uso
D.Year.PositionOf(D.Month).
FiscalQuarter (D)
Retorna o trimestre do exercício fiscal em que a data (
D
) ocorre. Pode retornar um erro para calendários personalizados. Uso
D.Year.PositionOf(D.Qtr).
FiscalYear (D)
Retorna o exercício fiscal em que a data (
D
) ocorre. Pode retornar um erro para calendários personalizados. Tente codificar seus anos com números que correspondam exatamente ao ano e use
ToNumber
(D.Year.code).
Month (D)
Retorna o mês em que a data (
D
) ocorre.
Quarter (D)
Retorna o trimestre-calendário em que a data (
D
) ocorre. Pode não ser igual ao trimestre fiscal da sua empresa (veja abaixo).
this.Version.PositionOf(D.Month)
Retorna um número que representa o mês da versão em que a data D ocorre (primeiro mês =
0
). Esse número pode ser negativo se a data D for anterior ao início da versão.
this.Version.PositionOf(D.Year)
Retorna um número que representa o ano da versão em que a data D ocorre (primeiro ano =
0
). Esse número pode ser negativo se a data D for anterior ao início da versão.
TimeFraction (D1, D2, D, Dx)
TimeFraction (D1; D2; D; Dx)
Retorna a parte do mês atual que ocorre entre a data de início (
D1
) e a data de término (
D2
). Se uma data opcional (
D
) é especificado, usa o mês em que
D
 ocorre, em vez do mês atual. Se o parâmetro opcional de número fixo de dias (
Dx
) é especificado, substitui o período em
D
 com o valor numérico.
As instâncias configuradas sem um calendário personalizado podem usar
MonthFraction
 em vez de
TimeFraction
.
ToDate (Y, M, D)
ToDate (Y; M; D)
Retorna a data especificada pelo ano fornecido (
Y
), mês (
M
) e dia (
D
). Se
D
 é omitido,
15
 é usado. O valor retornado pode ser usado como argumento para outras funções que usam uma data.
VersionMonth (D)
Retorna um número que representa o mês da versão em que a data (
D
) ocorre (primeiro mês =
0
). Esse número pode ser negativo se a data (
D
) é anterior ao início da versão.
Pode retornar um erro para calendários personalizados. Uso
this.Version.PositionOf(D.Month).
Version.PositionOf (timeperiod)
Retorna a ordem relativa do período informado dentro de todo o intervalo da versão. O primeiro período em uma versão começa com 1, e o número da ordem pode ser negativo se o período ocorrer antes do início da versão. Essa função também funciona com um período posterior ao término da versão.
VersionYear (D)
Retorna um número que representa o ano da versão em que a data (
D
) ocorre (primeiro ano =
0
). Esse número pode ser negativo se a data (
D
) é anterior ao início da versão.
Pode retornar um erro para calendários personalizados. Uso
this.Version.PositionOf(D.Year)
.
Year (D)
Retorna o ano em que a data (
D
) ocorre independentemente de um calendário personalizado ser usado ou não.

Funções de cadeia de caracteres

Sintaxe
Descrição
Concat (text1, text2, ...)
Concat (text1; text2; ...)
Retorna a cadeia de caracteres concatenada pela união de duas ou mais cadeias de caracteres de texto.
Exemplo:
Concat ("hello", "world")
 retorna "
helloworld"
.
Length (text)
Retorna o número de caracteres em uma cadeia de caracteres de texto.
Exemplo:
Length ("Now, is the winter of our discontent. Made glorious summer by this son or York.")
 devoluções
79
.
Search (source_text, search_text)
Search (source_text; search_text)
Retorna a posição inicial de
search_text
 em
source_text
. Devoluções
0
 se
search_text
 não foi localizado. Search não diferencia maiúsculas de minúsculas.
Exemplos:
Search ("Now is the winter of our discontent.", "Winter")
 devoluções
12
.
Search ("Now is the winter of our discontent.", "Summer")
 devoluções
0.
Substring (source_text, start_position, length)
Substring (source_text; start_position; length)
Retorna uma cadeia de caracteres de texto que contém os caracteres encontrados em
source_text
 começando em
start_position
 (em que posição
1
 é o primeiro caractere da cadeia de caracteres de texto) e executando para
length
 (ou até o final da cadeia de caracteres de texto, o que ocorrer primeiro).
Selecionando um
start_position
 de
0
 ou menos é tratado como se fosse posição
1
. Selecionando um comprimento de
0
 ou menos é tratado como um comprimento de
0
 e retorna uma cadeia de caracteres vazia. Selecionando um
start_position
 que é após o fim de
source_text
 retorna uma cadeia de caracteres vazia.
ToNumber (text)
Converte uma cadeia de caracteres de texto que representa um número em seu respectivo valor numérico. Converte a parte à esquerda da cadeia de caracteres até um caractere não numérico ser encontrado. Se o primeiro caractere não é numérico, resulta em erro.
Exemplos:
ToNumber ("7")
 devoluções
7
.
ToNumber ("2017-12-31")
 retorna 2017 (um número).
ToNumber ("Sample")
 retorna um erro.

Exemplos

A seguir, uma fórmula de headcount de uma planilha modelada de pessoal. É um bom exemplo de como as funções podem ser combinadas. Esta fórmula retorna um resultado binário:
1
 ou
0
.
If(this.Version.PositionOf(this.Month) >= this.Version.PositionOf(ROW.StartDate.Month) # if this month is after the person's start date and (isblank(ROW.EndDate) # and either they have no termination date or this.Version.PositionOf(this.Month) <= Version.PositionOf(ROW.EndDate.Month)), # or the current month is before termination date 1, # return 1 for their headcount in this month 0) # otherwise, return 0