Linha RM

Atalhos

Páginas filhas
  • Funções Globais

Versões comparadas

Versão antiga 19

changes.mady.by.user Igor Macedo Cardoso

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Thales Xavier de Almeida Nogueira

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

INDICE

       

Índice

include

exclude(CONTEÚDO|0.*

ndice:

)

separator

CONTEÚDO

|
  1. Visão Geral
OBJETIVO
  1. 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

       

FunçãoABS
Descrição

Retorna o valor absoluto de um número.

Sintaxe

ABS( NUM )
Parâmetros
  • NUM → Número para Operação
Exemplo

ABS(-17)

Retorno

17

ANODT

 

     

  

FunçãoANODT
DescriçãoRetorna o ano de uma data.

Sintaxe

ANODT( ' DATA ' )
Parâmetros
  • DATA → Data para selecionar o ano
Exemplo

ANODT('24/10/2018')

Retorno2018

ARRED

       

FunçãoARRED
Descrição

Arredonda um valor sem casas decimais.

Sintaxe

ARRED( NUM )
Parâmetros
  • NUM → Número para Operação
Exemplo

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

Retorno

25
24
25

ARREDONDA

       

FunçãoARREDONDA
Descrição

Arredonda um valor.

Sintaxe

ARREDONDA( NUM A, NUM B )
Parâmetros
  • NUM A → Número para Operação
  • NUM B → Quantidade de casas decimais
Exemplo

ARREDONDA(24.33568784,3)

Retorno

24,336

ARREDVALOR

       

FunçãoARREDVALOR
Descrição

Arredonda um valor Independente de Sistema.

Sintaxe

ARREDVALOR( NUM A, NUM B )
Parâmetros
  • NUM A → Número para Operação
  • NUM B → Fator
Exemplo

ARREDVALOR(24.33,1)

Retorno

25

ASCII

       

FunçãoASCII
DescriçãoRetorna o valor que representa um determinado caractere na tabela ASCII.

Sintaxe

ASCII( ' CHAR ' )
Parâmetros
  • CHAR → Caracteres que se deseja retirar.
Exemplo

ASCII('o')

Retorno111

ATRIBUI

       

FunçãoATRIBUI
Descrição

Atribui um valor à uma memoria.

Sintaxe

ATRIBUI( CHAVE , CONTEUDO)
Parâmetros
  • CHAVE → Chave da memória
  • CONTEUDO → Conteúdo para atribuir
Exemplo

ATRIBUI('MEMORIA001','Mundo bonito')

Retorno

Mundo Bonito

INCMES

COLIGADACORRENTE

       

Função
INCMES
COLIGADACORRENTE
Descrição
Adiciona uma quantidade de meses ( X meses) à um mês inicial (1 a 12).

Retorna a coligada corrente.

Sintaxe

COLIGADACORRENTE(

Sintaxe

INCMES(INTEIRO1,INTEIRO2
)
Parâmetros
  • INTEIRO1 → Mês inicial
  • INTEIRO2 → Quantidade de meses para adicionar ao mês inicial

N/A

Exemplo

COLIGADACORRENTE(

ExemploINCMES(2,19

)

Retorno
9

1

DECMES

CONCAT

       

Função
DECMES
CONCAT
Descrição
Subtrai uma quantidade de meses ( X meses) de um mês inicial (1 a 12).
Concatena os textos A e B

Sintaxe

DECMES(INTEIRO1,INTEIRO2
CONCAT( ' TEXTO A ' , ' TEXTO B ' )
Parâmetros
  • INTEIRO1 → Mês inicial
    • TEXTO A → Primeiro Texto
    • TEXTO B → Segundo Texto
    INTEIRO2 → Quantidade de meses para diminuir do mês inicial
    Exemplo
    DECMES

    CONCAT(

    11,5

    'Mundo','Bonito')

    Retorno
    6
    MundoBonito
    INCANO

    CONCAT2

           

    Função
    INCANO
    CONCAT2
    Descrição
    Adiciona um número de meses a um mês/ano e retorna o ano do resultado
    Concatena as strings A e B com um espaço entre elas.

    Sintaxe

    INCANO(INTEIRO1,INTEIRO2,INTEIRO3
    CONCAT2( ' TEXTO A ' , ' TEXTO B ' )
    Parâmetros
    • INTEIRO1 → Mês da data inicial
    • INTEIRO2 → Ano da data inicial
    • INTEIRO3 → Quantidade de meses para adicionar na data inicial
    • TEXTO A → Primeiro Texto
    • TEXTO B → Segundo Texto
    Exemplo

    CONCAT2('Mundo','Bonito'

    ExemploINCANO(2,2018,26

    )

    Retorno
    2019
    Mundo Bonito
    DECANO

    CONTEMVALOR

           

    Função
    DECANO
    CONTEMVALOR
    Descrição
    Subtrai um número de meses de um mês/ano e retorna o ano do resultado

    Procura um determinado valor em um conjunto de dados.

    Sintaxe

    DECANO
    CONTEMVALOR(
    INTEIRO1
    ' CONJUNTO ' ,
    INTEIRO2
    VALOR ,
    INTEIRO3
    ' TIPO ' )
    Parâmetros
    • INTEIRO1 → Mês da data inicial
    • INTEIRO2 → Ano da data inicial
    • INTEIRO3 → Quantidade de meses para subtrair da data inicial
    • 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

    Exemplo

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

    Retorno

    1

    COTACAOMOEDA

    Exemplo

    DECANO(2,2018,26)

    Retorno2015MTDATA

           

    Função

    MTDATA
    COTACAOMOEDA
    Descrição
    Monta uma data a partir de um dia, mês e ano

    Cotação de uma moeda.

    Sintaxe

    MTDATA
    COTACAOMOEDA(
    INTEIRO1,INTEIRO2,INTEIRO3
    ' SIMBOLO ' , 'DATA' )
    Parâmetros
    INTEIRO1
    • SIMBOLO →
    Dia
    • Símbolo da
    data
  • INTEIRO2 → Mês da data
  • INTEIRO3 → Ano da data
    • moeda
    • DATA→ Data da cotação
    Exemplo

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

    Retorno

    3,724

    DATANULA

    Exemplo

    MTDATA(17,11,1989)

    Retorno17/11/1989DIADT

           

    Função

    DIADT
    DATANULA
    DescriçãoRetorna
    o dia de uma data
    a data mínima do sistema.

    Sintaxe

    DIADT
    DATANULA(
    ' DATA '
    )
    Parâmetros
    DATA → Data para selecionar o dia

    N/A

    Exemplo
    DIADT('24/10/2018'

    DATANULA()

    Retorno
    24MESDT
    01/01/2000

    DECANO

           

    Função
    MESDT
    DECANO
    Descrição
    Retorna o mês de uma data
    Subtrai um número de meses de um mês/ano e retorna o ano do resultado.

    Sintaxe

    MESDT( ' DATA '
    DECANO(INTEIRO1,INTEIRO2,INTEIRO3)
    Parâmetros
    • DATA → Data para selecionar o mês
    • INTEIRO1 → Mês da data inicial
    • INTEIRO2 → Ano da data inicial
    • INTEIRO3 → Quantidade de meses para subtrair da data inicial
    Exemplo

    DECANO(2,2018,26

    ExemploMESDT('24/10/2018'

    )

    Retorno
    10
    2015
    HOJE

    DECMES

           

    Função
    HOJE
    DECMES
    Descrição
    Retorna a data de hoje
    Subtrai uma quantidade de meses ( X meses) de um mês inicial (1 a 12).

    Sintaxe

    HOJE
    DECMES(INTEIRO1,INTEIRO2)
    Parâmetros
    • INTEIRO1 → Mês inicial
    • INTEIRO2 → Quantidade de meses para diminuir do mês inicial
    N/A
    Exemplo
    HOJE

    DECMES(11,5)

    Retorno
    24/10/2018
    6

    DIADT

    DATANULA

           

    Função

    DATANULA
    DIADT
    DescriçãoRetorna
    a data mínima do sistema
    o dia de uma data.

    Sintaxe

    DATANULA
    DIADT( ' DATA ' )
    Parâmetros
    N/A
    • DATA → Data para selecionar o dia
    Exemplo
    DATANULA(

    DIADT('24/10/2018')

    Retorno
    01/01/2000
    24

    DIASEMANA

    ULTDIAMES

           

    Função

    ULTDIAMES
    DIASEMANA
    DescriçãoRetorna o
    último
    dia
    do mês
    da semana de uma data. (1= Domingo | 2= Segunda | 3= Terça | 4=Quarta | 5=Quinta | 6=Sexta | 7= Sábado)

    Sintaxe

    ULTDIAMES
    DIASEMANA( ' DATA ' )
    Parâmetros
    • DATA → Data para selecionar o
    último
    • dia
    do mês
    • da semana
    Exemplo
    ULTDIAMES

    DIASEMANA('24/10/2018')

    Retorno
    31/10/2018
    4

    ESCREVELOG

    DIASEMANA

           

    Função

    DIASEMANA
    ESCREVELOG
    Descrição
    Retorna o dia da semana de uma data. (1= Domingo | 2= Segunda | 3= Terça | 4=Quarta | 5=Quinta | 6=Sexta | 7= Sábado)

    Escreve Log

    Sintaxe

    DIASEMANA
    ESCREVELOG( '
    DATA
    TEXTO ' )
    Parâmetros
    DATA → Data para selecionar o dia da semana
    • TEXTO → Texto a ser inserido no Log.
    Exemplo
    DIASEMANA

    ESCREVELOG('

    24/10/2018

    Log Adicionado')

    Retorno
    4

    Log Adicionado

    SUBSTR

    EXECSQL

           

    Função
    SUBSTR
    EXECSQL
    Descrição
    Copia a partir da posição início um número de caracteres de texto

    Executa uma Consulta SQL.

    Sintaxe

    SUBSTR
    EXECSQL( '
    TEXTO
    CÓDIGO '
    , INTEIRO1, INTEIRO2 INTEIRO2 → Quantidade de caracteres que você deseja selecionar
    )
    Parâmetros
  • TEXTO → Texto onde é desejado selecionar uma parte para cópia
  • INTEIRO1 → Caracter início
    • CÓDIGO → Código da Consulta SQL.
    Exemplo
    SUBSTR

    EXECSQL('

    Alô Mundo', 2,5

    CON001' )

    Retorno
    lô muCONCAT

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

    FALSO

           

    Função
    CONCAT
    FALSO
    Descrição
    Concatena os textos A e B

    Retorna 0.

    Sintaxe

    CONCAT( ' TEXTO A ' , ' TEXTO B ' TEXTO B → Segundo Texto
    FALSO( )
    Parâmetros
  • TEXTO A → Primeiro Texto

    • N/A

    Exemplo
    CONCAT('Mundo','Bonito'

    FALSO()

    Retorno
    MundoBonito

    0

    CONCAT2

    FOR

           

    Função
    CONCAT2
    FOR
    Descrição
    Concatena as strings A e B com um espaço entre elas

    Executa uma fórmula.

    Sintaxe

    CONCAT2
    FOR( '
    TEXTO A ' , ' TEXTO B ' TEXTO B → Segundo Texto
    CÓDIGO ' )
    Parâmetros
  • TEXTO A → Primeiro Texto
    • CÓDIGO → Código da fórmula.
    Exemplo
    CONCAT2

    FOR('

    Mundo','Bonito

    FOR001' )

    Retorno
    Mundo BonitoVAL

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

    FRAC

           

    Função
    VAL
    FRAC
    Descrição
    Converte um string para

    Retorna a parte fracionada de um valor.

    Sintaxe

    VAL
    FRAC(
    ' VALOR '
    NUM )
    Parâmetros
    VALOR
    • NUM →
    String para se converter em valor
    • Número para Operação
    Exemplo
    VAL('12,65'

    FRAC(24.73)

    Retorno
    12

    0,

    65

    73

    STRLEFT

    HOJE

           

    Função
    STRLEFT
    HOJE
    Descrição
    Copia o lado DIREITO de um string (texto) um número de caracteres (quantidade)
    Retorna a data de hoje.

    Sintaxe

    STRLEFT
    HOJE(
    ' TEXTO ' , INTEIRO
    )
    Parâmetros
    • TEXTO → String para fazer a cópia iniciando pelo lado Direito
    • INTEIRO → Quantidade de caracteres que deseja-se copiar

    N/A

    Exemplo

    HOJE(

    ExemploSTRLEFT('Mundo Bonito',10

    )

    Retorno
    ndo BonitoSTRRIGHT
    24/10/2018

    INCANO

           

    Função
    STRRIGHT
    INCANO
    Descrição
    Copia o lado ESQUERDO de um string (texto) um número de caracteres (quantidade).

    Sintaxe

    STRRIGHT( ' TEXTO ' , INTEIRO )Parâmetros
    • TEXTO → String para fazer a cópia iniciando pelo lado Esquerdo
    • INTEIRO → Quantidade de caracteres que deseja-se copiar
    Exemplo

    STRRIGHT('Mundo Bonito',10)

    RetornoMundo Boni
    Adiciona um número de meses a um mês/ano e retorna o ano do resultado.

    Sintaxe

    		INCANO(INTEIRO1,INTEIRO2,INTEIRO3)
    Parâmetros
    • INTEIRO1 → Mês da data inicial
    • INTEIRO2 → Ano da data inicial
    • INTEIRO3 → Quantidade de meses para adicionar na data inicial
    Exemplo

    INCANO(2,2018,26)

    Retorno2019

    INCMES

    TAMSTR

           

    Função

    TAMSTR
    INCMES
    Descrição
    Retorna o tamanho da string
    Adiciona uma quantidade de meses ( X meses) à um mês inicial (1 a 12).

    Sintaxe

    TAMSTR( ' TEXTO '
    INCMES(INTEIRO1,INTEIRO2)
    Parâmetros
    • INTEIRO1 → Mês inicial
    • TEXTO → String que é desejado saber a quantidade de caracteres
    • INTEIRO2 → Quantidade de meses para adicionar ao mês inicial
    Exemplo

    INCMES(2,19

    ExemploTAMSTR('Mundo Bonito'

    )

    Retorno
    12
    9
    RETIRACARACTERES

    INTTOSTRFORMAT

           

    Função
    RETIRACARACTERES
    INTTOSTRFORMAT
    Descrição
    Retira do texto todas as ocorrências dos caracteres da string chars

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

    Sintaxe

    RETIRACARACTERES
    INTTOSTRFORMAT(
    ' CHAR ' , ' TEXTO '
    INTEIRO , ZEROS )
    Parâmetros
  • CHAR → Caracteres que se deseja retirar.
    • INTEIRO → Valor a ser convertido.
    • ZEROS→ Quantidade de Zeros.
    TEXTO → String que é desejado retirar os caracteres
    Exemplo
    RETIRACARACTERES

    INTTOSTRFORMAT(

    'o','Mundo Bonito'

    27,5)

    Retorno
    Mund Bnit

    00027

    STR

    MAX

           

    Função
    STR

    Sintaxe

    STR( VALOR , ' MASK ' )Parâmetros
    • VALOR → Valor decimal a ser formatado.
    • MASK → Máscara que será aplicada no valor.
    Exemplo

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

    Retorno

    027
    12,00
    05.00
    05:20
    370:20

    INTTOSTRFORMAT

    MAX
    Descrição

    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.

    o maior número.

    Sintaxe

    		MAX( NUM A , NUM B )
    Parâmetros
    • NUM A → Número para comparação
    • NUM B → Número para comparação
    Exemplo

    MAX(17,12)

    Retorno

    17'

    MEMORIA

           

    Função
    INTTOSTRFORMAT
    MEMORIA
    Descrição
    Converte um valor inteiro para string (texto) preenchendo com zeros

    Retorna o valor de uma memória.

    Sintaxe

    INTTOSTRFORMAT
    MEMORIA(
    INTEIRO , ZEROS ZEROS→ Quantidade de Zeros.
    CHAVE )
    Parâmetros
  • INTEIRO → Valor a ser convertido.
    • CHAVE → Chave da memória
    Exemplo
    INTTOSTRFORMAT(27,5

    MEMORIA('MEMORIA001')

    Retorno
    00027

    Mundo Bonito

    FOR

    MESDT

           

    Função
    FOR
    MESDT
    Descrição
    Executa uma fórmula
    Retorna o mês de uma data.

    Sintaxe

    FOR
    MESDT( '
    CÓDIGO
    DATA ' )
    Parâmetros
    CÓDIGO → Código da fórmula.
    • DATA → Data para selecionar o mês
    Exemplo
    FOR

    MESDT('

    FOR001

    24/10/2018')

    Retorno

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

    10

    MIN

    EXECSQL

           

    Função

    EXECSQL
    MIN
    Descrição
    Executa uma Consulta SQL

    Retorna o menor número.

    Sintaxe

    EXECSQL( ' CÓDIGO '
    MIN( NUM A , NUM B )
    Parâmetros
    CÓDIGO → Código da Consulta SQL.
    • NUM A → Número para comparação
    • NUM B → Número para comparação
    Exemplo

    EXECSQL('CON001' )

    Retorno

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

    MIN(17,12)

    Retorno

    12

    MTDATA

    PROXREGSQL

           

    Função

    PROXREGSQL
    MTDATA
    Descrição
    Avança um registro na Consulta SQL executada
    Monta uma data a partir de um dia, mês e ano.

    Sintaxe

    PROXREGSQL( ' CÓDIGO '
    MTDATA(INTEIRO1,INTEIRO2,INTEIRO3)
    Parâmetros
    CÓDIGO → Código da Consulta SQL.
    • INTEIRO1 → Dia da data
    • INTEIRO2 → Mês da data
    • INTEIRO3 → Ano da data
    Exemplo
    PROXREGSQL('CON001'

    MTDATA(17,11,1989)

    Retorno

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

    17/11/1989

    PAR

    RESULTSQL

           

    Função

    RESULTSQL
    PAR
    Descrição

    Retorna o

    valor de um campo de um resultado da Consulta SQL

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

    Sintaxe

    RESULTSQL( ' CÓDIGO ' , ' CAMPO ' )Parâmetros
  • CÓDIGO → Código da Consulta SQL
    • PAR( )
    Parâmetros

    N/A

    CAMPO → Campo desejado

    Exemplo
    RESULTSQL('CON001','CODUSUARIO'

    PAR()

    Retorno

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

    Conteúdo do parâmetro armazenado

    PARMQRY

    MIN

           

    Função

    MIN
    PARMQRY
    Descrição

    Retorna o

    menor número

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

    Sintaxe

    MIN( NUM A , NUM B
    PARMQRY( ' CAMPO ' )
    Parâmetros
    • NUM A → Número para comparação
    • NUM B → Número para comparação
    • CAMPO → Nome do Campo
    Exemplo

    PARMQRY('CODUSUARIO'

    ExemploMIN(17,12

    )

    Retorno
    12

    IgorMC

    MAX

    POTENCIA

           

    Função
    MAX
    POTENCIA
    Descrição

    Retorna

    o maior número

    a potência.

    Sintaxe

    MAX
    POTENCIA( NUM A , NUM B )
    Parâmetros
    • NUM
    A → Número para comparação
    • A→ Base da potência
    • NUM B→ Expoente da potência
    NUM B → Número para comparação
    Exemplo
    MAX

    POTENCIA(

    17

    2,

    12

    4)

    Retorno
    17'

    16

    RAIZ

    PROXREGSQL

           

    Função
    RAIZ
    PROXREGSQL
    Descrição
    Retorna a raiz quadrada de um valor

    Avança um registro na Consulta SQL executada.

    Sintaxe

    RAIZ
    PROXREGSQL(
    NUM
    ' CÓDIGO ' )
    Parâmetros
    NUM → Número para Operação
    • CÓDIGO → Código da Consulta SQL.
    Exemplo
    RAIZ

    PROXREGSQL(

    25

    'CON001' )

    Retorno

    5

    TETO

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

    RAIZ

           

    Função
    TETO
    RAIZ
    Descrição

    Retorna

    o valor truncado mais um

    a raiz quadrada de um valor.

    Sintaxe

    TETO
    RAIZ( NUM )
    Parâmetros
    • NUM → Número para Operação
    Exemplo
    TETO

    RAIZ(

    24.03

    25)

    Retorno
    25

    5

    FRAC

    RESULTSQL

           

    Função
    FRAC
    RESULTSQL
    Descrição

    Retorna

    a parte fracionada

    o valor de um campo de um

    valor

    resultado da Consulta SQL.

    Sintaxe

    FRAC( NUM )Parâmetros
    • NUM → Número para Operação
    Exemplo

    FRAC(24.73)

    Retorno

    0,73

    RESULTSQL( ' CÓDIGO ' , ' CAMPO ' )
    Parâmetros
    • CÓDIGO → Código da Consulta SQL
    • CAMPO → Campo desejado
    Exemplo

    RESULTSQL('CON001','CODUSUARIO' )

    Retorno

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

    RETIRACARACTERES

    TRUNCVALOR

           

    Função

    TRUNCVALOR
    RETIRACARACTERES
    Descrição
    Trunca um valor com casas decimaisTRUNCVALOR( NUM A , NUM B
    Retira do texto todas as ocorrências dos caracteres da string chars.

    Sintaxe

    TRUNCVALOR( NUM A ) ou
    RETIRACARACTERES( ' CHAR ' , ' TEXTO ' )
    Parâmetros
  • NUM A→ Número para Operação
    • CHAR → Caracteres que se deseja retirar.
    • TEXTO → String que é desejado retirar os caracteres
    NUM B→ Quantidade de casas Decimais
    Exemplo
    TRUNCVALOR(24.83)
    TRUNCVALOR(24.83, 1

    RETIRACARACTERES('o','Mundo Bonito')

    Retorno

    24
    24,8

    Mund Bnit

    SETVAR

    POTENCIA

           

    Função

    POTENCIA
    SETVAR
    Descrição
    Retorna a potência

    Atribui um valor a uma variável.

    Sintaxe

    POTENCIA( NUM A , NUM B
    SETVAR( ' VAR ' , CONTEUDO)
    Parâmetros
  • NUM A→ Base da potência
    • VAR → Variável
    • CONTEUDO → Conteúdo para adicionar na variável
    NUM B→ Expoente da potência
    Exemplo
    POTENCIA

    SETVAR(

    2

    'var1',

    4

    200)

    Retorno
    16

    200

    MEMORIA

           

    FunçãoMEMORIA
    Descrição

    Retorna o valor de uma memória.

    Sintaxe

    MEMORIA( CHAVE )Parâmetros
    • CHAVE → Chave da memória
    Exemplo

    MEMORIA('MEMORIA001')

    Retorno

    Mundo Bonito

    SETVAR

           

    FunçãoSETVAR
    Descrição

    Atribui um valor a uma variável.

    Sintaxe

    SETVAR( ' VAR ' , CONTEUDO)Parâmetros
    • VAR → Variável
    • CONTEUDO → Conteúdo para adicionar na variável
    Exemplo

    SETVAR('var1', 200)

    Retorno

    200

    STR

           

    FunçãoSTR
    Descrição

    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

    		STR( VALOR , ' MASK ' )
    Parâmetros
    • VALOR → Valor decimal a ser formatado.
    • MASK → Máscara que será aplicada no valor.
    Exemplo

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

    Retorno

    027
    12,00
    05.00
    05:20
    370:20

    STRLEFT

    VERDADE

           

    FunçãoVERDADEDescrição

    Retorna 1.

    Sintaxe

    VERDADE ( )Parâmetros

    N/A

    Exemplo

    VERDADE()

    Retorno

    1

    FALSO

           

    Função

    FALSO
    STRLEFT
    Descrição
    Retorna 0
    Copia o lado DIREITO de um string (texto) um número de caracteres (quantidade).

    Sintaxe

    FALSO
    STRLEFT( ' TEXTO ' , INTEIRO )
    Parâmetros
    • TEXTO → String para fazer a cópia iniciando pelo lado Direito
    • INTEIRO → Quantidade de caracteres que deseja-se copiar
    N/A
    Exemplo
    FALSO(

    STRLEFT('Mundo Bonito',10)

    Retorno
    0

    ndo Bonito

    COTACAOMOEDA

    STRRIGHT

           

    FunçãoSTRRIGHT
    COTACAOMOEDADescriçãoCotação de uma moeda
    DescriçãoCopia o lado ESQUERDO de um string (texto) um número de caracteres (quantidade).

    Sintaxe

    COTACAOMOEDA
    STRRIGHT( '
    SIMBOLO
    TEXTO ' ,
    'DATA'
    INTEIRO )
    Parâmetros
  • SIMBOLO → Símbolo da moeda
    • TEXTO → String para fazer a cópia iniciando pelo lado Esquerdo
    • INTEIRO → Quantidade de caracteres que deseja-se copiar
    DATA→ Data da cotação
    Exemplo
    COTACAOMOEDA

    STRRIGHT('

    US$

    Mundo Bonito',

    '25/

    10

    /2018'

    )

    Retorno

    3,724

    Mundo Boni

    SUBSTR

    USUARIOCORRENTE

           

    Função

    USUARIOCORRENTE
    SUBSTR
    Descrição
    Retorna o usuário corrente
    Copia a partir da posição início um número de caracteres de texto.

    Sintaxe

    USUARIOCORRENTE(
    SUBSTR( ' TEXTO ' , INTEIRO1, INTEIRO2 )
    Parâmetros
    • TEXTO → Texto onde é desejado selecionar uma parte para cópia
    • INTEIRO1 → Caracter início
    • INTEIRO2 → Quantidade de caracteres que você deseja selecionar.
    N/A
    Exemplo
    USUARIOCORRENTE(

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

    Retorno
    IgorMC
    lô mu
    COLIGADACORRENTE

    SUBTRAIDATAS

           

    Função
    COLIGADACORRENTE
    SUBTRAIDATAS
    Descrição

    Retorna a

    coligada corrente.

    subtração entre duas datas

    Sintaxe

    COLIGADACORRENTE
    SUBTRAIDATAS( DATA1 , DATA2 )
    Parâmetros

    N/A

    Exemplo
    • DATA1 → Data inicial
    • DATA2 → Data para subtrair
    Exemplo

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

    COLIGADACORRENTE(

    )

    Retorno
    1

    33

    PARMQRY

    TABCOLIG

           

    Função
    PARMQRY
    TABCOLIG
    Descrição

    Retorna o

    conteúdo

    valor de um campo da coligada.

    Utilizada no Gerador de Relatórios (RMGerador.dll).

    Sintaxe

    PARMQRY
    TABCOLIG( ' CAMPO ' )
    Parâmetros
    • CAMPO → Nome do Campo
    Exemplo
    PARMQRY

    TABCOLIG('

    CODUSUARIO

    NOMEFANTASIA')

    Retorno
    IgorMC

    TOTVS SA

    TABCOLIG

    TABCOLIGADA

           

    Função
    TABCOLIG
    TABCOLIGADA
    Descrição

    Retorna o valor de

    um campo

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

    Sintaxe

    TABCOLIG
    TABCOLIGADA( ' CAMPO ' )
    Parâmetros
    • CAMPO → Nome do Campo
    Exemplo
    TABCOLIG

    TABCOLIGADA('

    NOMEFANTASIA

    Numero')

    Retorno
    TOTVS SA

    2664

    TABCOLIGADA

    TAMSTR

           

    Função
    TABCOLIGADA
    TAMSTR
    DescriçãoRetorna o
    valor de uma Coluna da tabela GCOLIGADA da coligada corrente que o usuário tem acesso na GPERMISS
    tamanho da string.

    Sintaxe

    TABCOLIGADA
    TAMSTR( '
    CAMPO
    TEXTO ' )
    Parâmetros
    CAMPO → Nome do Campo
    • TEXTO → String que é desejado saber a quantidade de caracteres
    Exemplo
    TABCOLIGADA

    TAMSTR('

    Numero

    Mundo Bonito')

    Retorno
    2664
    12
    PAR

    TETO

           

    Função
    PAR
    TETO
    Descrição

    Retorna

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

    o valor truncado mais um.

    Sintaxe

    PAR
    TETO( NUM )
    Parâmetros
    N/A
    • NUM → Número para Operação
    Exemplo
    PAR

    TETO(24.03)

    Retorno

    Conteúdo do parâmetro armazenado

    25

    TRUNCVALOR

    CONTEMVALOR

           

    Função

    CONTEMVALOR
    TRUNCVALOR
    Descrição
    Procura

    Trunca um

    determinado valor em um conjunto de dados

    valor com casas decimais.

    Sintaxe

    CONTEMVALOR( ' CONJUNTO ' , VALOR , ' TIPO '
    TRUNCVALOR( NUM A ) ou TRUNCVALOR( NUM A , NUM B )
    Parâmetros
    • 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

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

    TRUNCVALOR(24.83)
    TRUNCVALOR(24.83, 1)

    Retorno

    24
    24,8

    ULTDIAMES

    Exemplo

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

    Retorno

    1

    SUBTRAIDATAS

           

    Função

    SUBTRAIDATAS
    ULTDIAMES
    DescriçãoRetorna
    a subtração entre duas datas
    o último dia do mês de uma data.

    Sintaxe

    SUBTRAIDATAS( DATA1 , DATA2 )Parâmetros
    • DATA1 → Data inicial
    • DATA2 → Data para subtrair
    ExemploSUBTRAIDATAS
    ULTDIAMES( ' DATA ' )
    Parâmetros
    • DATA → Data para selecionar o último dia do mês
    Exemplo

    ULTDIAMES('24/10

    /2018','21/09

    /2018')

    Retorno

    33

    ESCREVELOG
    31/10/2018

    USUARIOCORRENTE

           

    Função
    ESCREVELOG
    USUARIOCORRENTE
    Descrição

    Escreve Log

    Sintaxe

    ESCREVELOG( ' TEXTO ' )Parâmetros
    • TEXTO → Texto a ser inserido no Log.
    Exemplo

    ESCREVELOG(' Log Adicionado')

    Retorno

    Log Adicionado

    Informações
    iconfalse
    Informações
    iconfalse

    Produto: Framework

    Informações
    iconfalse

    Versão: 12.01.XX

    Informações
    iconfalse

    Processo: Filtros de Visão

    Informações
    iconfalse
    Informações
    iconfalse

    Status: Finalizado

    Informações
    iconfalse

    Data: 25/10/2018

    Informações
    iconfalse

    Autores:

    Carlos Philippe de Farias Marques

    Carlos Roberto Pereira Garcia

    Diogo Damiani Ferreira

    Fábio Augusto Amaral Melo Nunes

    Igor Macedo Cardoso

    Karina Dos Santos Costa

    Stella Gleyse Macedo Vilaca

    TIAGO ANDRADE GOMES SILVEIRA

    Retorna o usuário corrente.

    Sintaxe

    		USUARIOCORRENTE( )
    Parâmetros

    N/A

    Exemplo

    USUARIOCORRENTE()

    Retorno

    IgorMC

    VAL

           

    FunçãoVAL
    DescriçãoConverte um string para valor.

    Sintaxe

    		VAL( ' VALOR ' )
    Parâmetros
    • VALOR → String para se converter em valor
    Exemplo

    VAL('12,65')

    Retorno12,65

    VERDADE

           

    FunçãoVERDADE
    Descrição

    Retorna 1.

    Sintaxe

    		VERDADE ( )
    Parâmetros

    N/A

    Exemplo

    VERDADE()

    Retorno

    1

    Informações
    iconfalse

    Versão: 12.01.XX