CONTEÚDO

1. Visão Geral
2. Funções

01. VISÃO GERAL 

   As fórmulas globais são aquelas apresentadas para todos os módulos do sistema, e são passíveis de uso em qualquer um deles. O objetivo deste documento é apresentar as Fórmulas Globais, com sua descrição, sintaxe, parâmetros e apresentar um breve exemplo com seu respectivo retorno.

       Conheça as fórmulas globais:

02. FUNÇÕES 

ABS

Retorna o valor absoluto de um número.

Sintaxe

• NUM → Número para Operação

ABS(-17)

17

ANODT

Sintaxe

• DATA → Data para selecionar o ano

ANODT('24/10/2018')

ARRED

Arredonda um valor sem casas decimais.

Sintaxe

• NUM → Número para Operação

ARRED(24.73)
ARRED(24.33)
ARRED(24.50)

25
24
25

ARREDONDA

Arredonda um valor.

Sintaxe

• NUM A → Número para Operação
• NUM B → Quantidade de casas decimais

ARREDONDA(24.33568784,3)

24,336

ARREDVALOR

Arredonda um valor Independente de Sistema.

Sintaxe

• NUM A → Número para Operação
• NUM B → Fator

ARREDVALOR(24.33,1)

25

ASCII

Sintaxe

• CHAR → Caracteres que se deseja retirar.

ASCII('o')

ATRIBUI

Atribui um valor à uma memoria.

Sintaxe

• CHAVE → Chave da memória
• CONTEUDO → Conteúdo para atribuir

ATRIBUI('MEMORIA001','Mundo bonito')

Mundo Bonito

COLIGADACORRENTE

Retorna a coligada corrente.

Sintaxe

N/A

COLIGADACORRENTE()

1

CONCAT

Sintaxe

• TEXTO A → Primeiro Texto
• TEXTO B → Segundo Texto

CONCAT('Mundo','Bonito')

CONCAT2

Sintaxe

• TEXTO A → Primeiro Texto
• TEXTO B → Segundo Texto

CONCAT2('Mundo','Bonito')

CONTEMVALOR

Procura um determinado valor em um conjunto de dados.

Sintaxe

• CONJUNTO → Conjunto de valores separados por /
• VALOR → Valor a ser procurado
• TIPO → Tipo de dado a ser tratado

  D = Data
  S = String
  Vazio/Outros → Decimal

CONTEMVALOR( 'casa/geladeira/mesa/gato/gaiola ', 'gato', 'S')

1

COTACAOMOEDA

Cotação de uma moeda.

Sintaxe

• SIMBOLO → Símbolo da moeda
• DATA→ Data da cotação

COTACAOMOEDA('US$','25/10/2018')

3,724

DATANULA

Sintaxe

N/A

DATANULA()

DECANO

Sintaxe

• INTEIRO1 → Mês da data inicial
• INTEIRO2 → Ano da data inicial
• INTEIRO3 → Quantidade de meses para subtrair da data inicial

DECANO(2,2018,26)

DECMES

Sintaxe

• INTEIRO1 → Mês inicial
• INTEIRO2 → Quantidade de meses para diminuir do mês inicial

DECMES(11,5)

DIADT

Sintaxe

• DATA → Data para selecionar o dia

DIADT('24/10/2018')

DIASEMANA

Sintaxe

• DATA → Data para selecionar o dia da semana

DIASEMANA('24/10/2018')

ESCREVELOG

Escreve Log

Sintaxe

• TEXTO → Texto a ser inserido no Log.

ESCREVELOG(' Log Adicionado')

Log Adicionado

EXECSQL

Executa uma Consulta SQL.

Sintaxe

• CÓDIGO → Código da Consulta SQL.

EXECSQL('CON001' )

Será o retorno (Se tiver) da Consulta SQL 'CON001'.

FALSO

Retorna 0.

Sintaxe

N/A

FALSO()

0

FOR

Executa uma fórmula.

Sintaxe

• CÓDIGO → Código da fórmula.

FOR('FOR001' )

Será o retorno da fórmula 'FOR001'.

FRAC

Retorna a parte fracionada de um valor.

Sintaxe

• NUM → Número para Operação

FRAC(24.73)

0,73

HOJE

Sintaxe

N/A

HOJE()

INCANO

Sintaxe

• INTEIRO1 → Mês da data inicial
• INTEIRO2 → Ano da data inicial
• INTEIRO3 → Quantidade de meses para adicionar na data inicial

INCANO(2,2018,26)

INCMES

Sintaxe

• INTEIRO1 → Mês inicial
• INTEIRO2 → Quantidade de meses para adicionar ao mês inicial

INCMES(2,19)

INTTOSTRFORMAT

Converte um valor inteiro para string (texto) preenchendo com zeros.

Sintaxe

• INTEIRO → Valor a ser convertido.
• ZEROS→ Quantidade de Zeros.

INTTOSTRFORMAT(27,5)

00027

MAX

Retorna o maior número.

Sintaxe

• NUM A → Número para comparação
• NUM B → Número para comparação

MAX(17,12)

17'

MEMORIA

Retorna o valor de uma memória.

Sintaxe

• CHAVE → Chave da memória

MEMORIA('MEMORIA001')

Mundo Bonito

MESDT

Sintaxe

• DATA → Data para selecionar o mês

MESDT('24/10/2018')

MIN

Retorna o menor número.

Sintaxe

• NUM A → Número para comparação
• NUM B → Número para comparação

MIN(17,12)

12

MTDATA

Sintaxe

• INTEIRO1 → Dia da data
• INTEIRO2 → Mês da data
• INTEIRO3 → Ano da data

MTDATA(17,11,1989)

PAR

Retorna o que foi armazenado na propriedade de parâmetros genéricos de fórmula.

Sintaxe

N/A

PAR()

Conteúdo do parâmetro armazenado

PARMQRY

Retorna o conteúdo de um campo.
Utilizada no Gerador de Relatórios (RMGerador.dll).

Sintaxe

• CAMPO → Nome do Campo

PARMQRY('CODUSUARIO')

IgorMC

POTENCIA

Retorna a potência.

Sintaxe

• NUM A→ Base da potência
• NUM B→ Expoente da potência

POTENCIA(2,4)

16

PROXREGSQL

Avança um registro na Consulta SQL executada.

Sintaxe

• CÓDIGO → Código da Consulta SQL.

PROXREGSQL('CON001' )

Avança um registro na Consulta SQL 'CON001'.

RAIZ

Retorna a raiz quadrada de um valor.

Sintaxe

• NUM → Número para Operação

RAIZ(25)

5

RESULTSQL

Retorna o valor de um campo de um resultado da Consulta SQL.

Sintaxe

• CÓDIGO → Código da Consulta SQL
• CAMPO → Campo desejado

RESULTSQL('CON001','CODUSUARIO' )

Retorna o valor do campo CODUSUARIO do resultado da Consulta SQL 'CON001'.

RETIRACARACTERES

Sintaxe

• CHAR → Caracteres que se deseja retirar.
• TEXTO → String que é desejado retirar os caracteres

RETIRACARACTERES('o','Mundo Bonito')

SETVAR

Atribui um valor a uma variável.

Sintaxe

• VAR → Variável
• CONTEUDO → Conteúdo para adicionar na variável

SETVAR('var1', 200)

200

STR

Retorna número de acordo com máscara informada, que pode ser composta da seguinte forma:
• com noves: o número será completado com espaços brancos à esquerda;
• com zeros ou 'z' (minúsculo ou maiúsculo): o número será completado com zeros à esquerda.
• Pode-se usar separador de decimais: '.' (ponto) ou ',' (vírgula)
• No caso da máscara contiver ':' será formatado do tipo hora.

Sintaxe

• VALOR → Valor decimal a ser formatado.
• MASK → Máscara que será aplicada no valor.

STR(27, '000')
STR(12,'99,99')
STR(5, '00.00')
STR(320, '00:00')
STR(22222, '000:00')

027
12,00
05.00
05:20
370:20

STRLEFT

Sintaxe

• TEXTO → String para fazer a cópia iniciando pelo lado Direito
• INTEIRO → Quantidade de caracteres que deseja-se copiar

STRLEFT('Mundo Bonito',10)

ndo Bonito

STRRIGHT

Sintaxe

• TEXTO → String para fazer a cópia iniciando pelo lado Esquerdo
• INTEIRO → Quantidade de caracteres que deseja-se copiar

STRRIGHT('Mundo Bonito',10)

SUBSTR

Sintaxe

• TEXTO → Texto onde é desejado selecionar uma parte para cópia
• INTEIRO1 → Caracter início
• INTEIRO2 → Quantidade de caracteres que você deseja selecionar.

SUBSTR('Alô Mundo', 2,5)

SUBTRAIDATAS

Retorna a subtração entre duas datas

Sintaxe

• DATA1 → Data inicial
• DATA2 → Data para subtrair

SUBTRAIDATAS('24/10/2018','21/09/2018')

33

TABCOLIG

Retorna o valor de um campo da coligada.

Sintaxe

• CAMPO → Nome do Campo

TABCOLIG('NOMEFANTASIA')

TOTVS SA

TABCOLIGADA

Retorna o valor de uma Coluna da tabela GCOLIGADA da coligada corrente que o usuário tem acesso na GPERMISS.

Sintaxe

• CAMPO → Nome do Campo

TABCOLIGADA('Numero')

2664

TAMSTR

Sintaxe

• TEXTO → String que é desejado saber a quantidade de caracteres

TAMSTR('Mundo Bonito')

TETO

Retorna o valor truncado mais um.

Sintaxe

• NUM → Número para Operação

TETO(24.03)

25

TRUNCVALOR

Trunca um valor com casas decimais.

Sintaxe

• NUM A→ Número para Operação
• NUM B→ Quantidade de casas Decimais

TRUNCVALOR(24.83)
TRUNCVALOR(24.83, 1)

24
24,8

ULTDIAMES

Sintaxe

• DATA → Data para selecionar o último dia do mês

ULTDIAMES('24/10/2018')

USUARIOCORRENTE

Retorna o usuário corrente.

Sintaxe

N/A

USUARIOCORRENTE()

IgorMC

VAL

Sintaxe

• VALOR → String para se converter em valor

VAL('12,65')

VERDADE

Retorna 1.

Sintaxe

N/A

VERDADE()

1