INDICE

[F//G//H//I//J//K//L//M//N//O//P//Q//R//S//T//U//V//X//Y//W//Z].*

Índice

exclude	[A/C/B/D/E/R/S/T/U/V/X/Y/W/Z].*

	(CONTEÚDO\|0.*)

CONTEÚDO

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

Índice

exclude	[A//C//B//D//E//F//G//H//I//J//K//L//M//N//O//P//Q].*

OBJETIVO

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:

ABS

FunçãoABSDescriçã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çãoANODTDescriçã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

ARREDVALORARREDVALORArredonda um Independente SistemaARREDVALOR NUM A, B A OperaçãoNUM B → FatorARREDVALOR(24.33,125ASCII ASCII valor que representa um determinado caractere na tabela ASCIIASCII CHAR CHAR → Caracteres que se deseja retirar.ASCIIo111ATRIBUIATRIBUIAtribui à uma memoriaATRIBUI CHAVE , CONTEUDO

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

Exemplo

ATRIBUI('MEMORIA001','Mundo bonito')

Retorno

Mundo Bonito

COLIGADACORRENTECOLIGADACORRENTERetorna a coligada correnteCOLIGADACORRENTE

N/A

ExemploCOLIGADACORRENTE(1CONCATCONCATConcatena os textos A e BCONCAT ' TEXTO ' ' TEXTO ' TEXTO Primeiro TextoTEXTO Segundo TextoCONCAT('Mundo','Bonito'MundoBonitoCONCAT2CONCAT2Concatena as strings A e B com um espaço entre elasCONCAT2 TEXTO A ' , ' TEXTO B

TEXTO A → Primeiro Texto
TEXTO B → Segundo Texto

ExemploCONCAT2('Mundo','BonitoMundo BonitoCONTEMVALORCONTEMVALORProcura determinado valor em um conjunto de dadosCONTEMVALOR( ' CONJUNTO ' , VALOR , ' TIPO '

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

ExemploCONTEMVALOR( 'casa/geladeira/mesa/gato/gaiola ', 'gato', 'S1COTACAOMOEDACOTACAOMOEDACotação de uma moedaCOTACAOMOEDA( ' SIMBOLO ' , 'DATA'

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

ExemploCOTACAOMOEDA('US$','25/10/2018'3,724DATANULADATANULARetorna a data mínima do sistema.DATANULA(

N/A

ExemploDATANULA(01/01/2000DECANODECANOSubtrai um número de meses de um mês/ano e retorna o ano do resultadoDECANO(INTEIRO1,INTEIRO2,INTEIRO3)Parâmetros

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)

Retorno2015DECMESDECMESSubtrai uma quantidade de meses ( X meses) de um mês inicial (1 a 12)DECMES(INTEIRO1,INTEIRO2

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

Exemplo

DECMES(11,5)

Retorno6DIADTDIADTRetorna o dia dataDIADTDATA Data para selecionar o diaDIADT('24)Retorno24

DIASEMANA

Sintaxe

DIASEMANA( ' DATA ' )Parâmetros

DATA → Data para selecionar o dia da semana

Exemplo

DIASEMANA('24/10/2018')

Retorno4ESCREVELOGESCREVELOGEscreve LogESCREVELOG( ' TEXTO ' TEXTO → Texto a ser inserido no Log.ESCREVELOG(' Log Adicionado'Log AdicionadoEXECSQLEXECSQLExecuta uma Consulta SQLEXECSQL( ' CÓDIGO ' CÓDIGO → Código da Consulta SQL.EXECSQL('CON001'

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

FALSOFALSO 0FALSO

N/A

ExemploFALSO(0FORFORExecuta uma fórmula.FOR CÓDIGO CÓDIGO → Código da fórmula.FORFOR001

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

FRACFRACRetorna a parte fracionada de um valor.FRAC NUM NUM → Número para OperaçãoFRAC(24.73

0,73

HOJEHOJERetorna a data de hojeHOJEN/AHOJE24/10/2018INCANOINCANOAdiciona um número de meses a um mês/ano e retorna o ano do resultadoINCANOINTEIRO1,INTEIRO2,INTEIRO3INTEIRO3 → Quantidade de meses para adicionar na data inicial

INTEIRO1 → Mês da data inicial

INTEIRO2 → Ano da data inicial

INCANO2,2018,262019INCMESINCMESAdiciona uma quantidade de meses ( X meses) à um mês inicial (1 a 12)INCMES(INTEIRO1,INTEIRO2

INTEIRO1 → Mês inicial

INTEIRO2 → Quantidade de meses para adicionar ao mês inicialINCMES(2,199INTTOSTRFORMATINTTOSTRFORMATConverte inteiro para string (texto) preenchendo com zerosINTTOSTRFORMAT INTEIRO , ZEROS ZEROS→ Quantidade de Zeros.

INTEIRO → Valor a ser convertido.

INTTOSTRFORMAT(27,500027MAXMAX o maior númeroMAX NUM A , NUM B

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

ExemploMAX(17,12

17'

MEMORIAMEMORIA
DescriçãoRetorna o valor de uma memóriaMEMORIA( CHAVE CHAVE → Chave da memóriaMEMORIA('MEMORIA001'Mundo BonitoMESDTMESDTRetorna o mês de uma dataMESDT( ' DATA ' DATA → Data para selecionar o mêsMESDT('24/10/2018'10MINMINRetorna o menor númeroMIN NUM A NUM B

NUM A → Número para comparação

NUM B → Número para comparaçãoMIN171212MTDATAMTDATAMonta uma data a partir de um dia, mês e anoMTDATAINTEIRO1,INTEIRO2,INTEIRO3

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

ExemploMTDATA(17,11,1989/11/1989PARPAR que foi armazenado na propriedade de parâmetros genéricos de fórmulaPARN/APAR

Conteúdo do parâmetro armazenado

PARMQRYPARMQRY conteúdo de um campo.
Utilizada no Gerador de Relatórios (RMGerador.dll)PARMQRY CAMPO CAMPO → Nome do CampoPARMQRYCODUSUARIOIgorMCPOTENCIAPOTENCIA a potênciaPOTENCIA A→ Base da potênciaNUM B→ Expoente da potênciaPOTENCIA2416PROXREGSQLPROXREGSQLAvança um registro na Consulta SQL executadaPROXREGSQL( ' CÓDIGO '

CÓDIGO → Código da Consulta SQL.

Exemplo

PROXREGSQL('CON001' )

Retorno

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

RAIZRAIZ a raiz quadrada de um valorRAIZ NUM NUM → Número para OperaçãoRAIZ25

5

RESULTSQLRESULTSQL valor de um resultado da Consulta SQLRESULTSQL CÓDIGO ' , '

CÓDIGO → Código da Consulta SQL

desejadoRESULTSQLCON001','

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

RETIRACARACTERESRETIRACARACTERESRetira do texto todas as ocorrências dos caracteres da string charsRETIRACARACTERES( ' CHAR ' , ' TEXTO '

CHAR → Caracteres que se deseja retirar.

TEXTO → String que é desejado retirar os caracteresRETIRACARACTERES'o','Mundo Bonito'Mund BnitSETVARSETVARAtribui um valor a uma variávelSETVAR VAR , CONTEUDO

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

ExemploSETVAR('var1', 200

200

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

a raiz quadrada de um valor.
Sintaxe	RAIZ( NUM )
Parâmetros	NUM → Número para Operação
Exemplo	RAIZ(25)
Retorno	5

RESULTSQL

Função	RESULTSQL
Descrição	Retorna o valor de um campo de um resultado da Consulta SQL.
Sintaxe	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

Função	RETIRACARACTERES
Descrição	Retira do texto todas as ocorrências dos caracteres da string chars.
Sintaxe	RETIRACARACTERES( ' CHAR ' , ' TEXTO ' )
Parâmetros	CHAR → Caracteres que se deseja retirar. TEXTO → String que é desejado retirar os caracteres
Exemplo	RETIRACARACTERES('o','Mundo Bonito')
Retorno	Mund Bnit

SETVAR

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

STRLEFTSTRLEFTCopia o lado DIREITO de um string (texto) um número de caracteres (quantidade)STRLEFT TEXTO INTEIRO

TEXTO → String para fazer a cópia iniciando pelo lado Direito

INTEIRO → Quantidade de caracteres que deseja-se copiarSTRLEFTMundo Bonito10ndo BonitoSTRRIGHTSTRRIGHT
DescriçãoCopia 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

	STR
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

SUBSTRSUBSTR a partir da posição início de textoSUBSTR INTEIRO1, INTEIRO2 Texto onde é desejado selecionar uma parte para cópia

INTEIRO1 → Caracter início

INTEIRO2 → você selecionar.SUBSTRAlô 2,5lô muSUBTRAIDATASSUBTRAIDATASDescrição

Retorna a subtração entre duas datas

Sintaxe

SUBTRAIDATAS( DATA1 , DATA2

DATA1 → Data inicial

DATA2 → Data para subtrairSUBTRAIDATAS('24/10/2018','21/09/2018'33TABCOLIGTABCOLIGRetorna o valor de um campo da coligadaTABCOLIG ' CAMPO ' )Parâmetros

CAMPO → Nome do Campo

Exemplo

TABCOLIG('NOMEFANTASIA')

Retorno

TOTVS SA

TABCOLIGADATABCOLIGADA o valor de uma Coluna da tabela GCOLIGADA da coligada corrente que o usuário tem acesso na GPERMISS.TABCOLIGADA( ' CAMPO ' CAMPO → Nome do CampoTABCOLIGADANumero2664TAMSTRTAMSTR tamanho da stringTAMSTR TEXTO TEXTO → String que é desejado saber a quantidade de caracteresTAMSTRMundo Bonito12TETOTETO truncado mais umTETO NUM NUM → Número para OperaçãoTETO(24.0325TRUNCVALORTRUNCVALORTrunca um valor com casas decimais

ULTDIAMES

TRUNCVALOR( NUM A ) ou TRUNCVALOR( NUM A , NUM B )Parâmetros

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 último dia do mês de uma dataULTDIAMES ' DATA ' DATA Data para selecionar o último dia do mêsULTDIAMES'24/10/2018'31/10/2018USUARIOCORRENTEUSUARIOCORRENTERetorna o usuário correnteUSUARIOCORRENTE( N/AUSUARIOCORRENTE(IgorMCVALVALConverte um string para valorVAL VALOR VALOR String para se converter em valorVAL12,6512,65VERDADEVERDADE 1VERDADE VERDADE1

Informações

icon	false

Informações

icon	false

Produto: Framework

Informações

icon	false

Versão: 12.01.XX

Informações

icon	false

Processo: Filtros de Visão

Informações

icon	false

Informações

icon	false

Status: Finalizado

Informações

icon	false

Data: 25/10/2018

Informações

icon	false

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

VAL

Função	VAL
Descrição	Converte um string para valor.
Sintaxe	VAL( ' VALOR ' )
Parâmetros	VALOR → String para se converter em valor
Exemplo	VAL('12,65')
Retorno	12,65

VERDADE

Função	VERDADE
Descrição	Retorna 1.
Sintaxe	VERDADE ( )
Parâmetros	N/A
Exemplo	VERDADE()
Retorno	1

Informações

icon	false

Versão: 12.01.XX

	INTEIRO1 → Dia da data INTEIRO2 → Mês da data INTEIRO3 → Ano da data
Exemplo	MTDATA(17,11,1989)
Retorno	17/11/1989

Atalhos

Páginas filhas

Histórico da Página

Versões comparadas

Versão antiga 39

Nova versão Atual

Chave

INDICE

CONTEÚDO

01. VISÃO GERAL

02. FUNÇÕES

ABS

OBJETIVO

ABS

ANODT

ARRED

ARREDONDA

Função

ANODT

ARRED

ARREDONDA

Função

ARREDVALOR

ASCII

ATRIBUI

COLIGADACORRENTE

CONCAT

CONCAT2

Função

CONTEMVALOR

Função

COTACAOMOEDA

Função

DIASEMANA

DATANULA

DECANO

Função

DECMES

DIADT

Função

DIASEMANA

ESCREVELOG

Função

EXECSQL

Função

FALSO

Função

FOR

FRAC

HOJE

INCANO

Função

INCMES

INTTOSTRFORMAT

MAX

MEMORIA

Função

MESDT

Função

MIN

MTDATA

PAR

Função

PARMQRY

POTENCIA

Função

PROXREGSQL

RAIZ

RESULTSQL

RETIRACARACTERES

SETVAR

Função

STR

STRLEFT

Função

STRRIGHT

SUBSTR

SUBTRAIDATAS

Função

TABCOLIG