INDICE
include | [A//C//B//D//E].* |
---|
style | none |
---|
separator | | |
---|
|
Índice |
---|
include | [F//G//H//I//J//K//L//M//N//O//P//Q].* |
---|
exclude | INDICE |
---|
style | none |
---|
|
| Índice |
---|
include | [R//S//T//U//V//X//Y//W//Z].* |
---|
style | none |
---|
|
| 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ção | ABS |
---|
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
Pivot Table |
---|
id | 1540493104555_-278309129 |
---|
|
Função | ANODT |
---|
Descrição | Retorna o ano de uma data. |
Sintaxe | ANODT( ' DATA ' ) |
Parâmetros | - DATA → Data para selecionar o ano
|
Exemplo | ANODT('24/10/2018') |
Retorno | 2018 |
ARRED
Função | ARRED
|
---|
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ção | ARREDONDA
|
---|
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 correnteCOLIGADACORRENTEN/A | Exemplo | COLIGADACORRENTE(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
| Exemplo | CONCAT2('Mundo','BonitoMundo BonitoCONTEMVALORCONTEMVALORProcura determinado valor em um conjunto de dadosCONTEMVALOR( ' CONJUNTO ' , VALOR , ' TIPO ' | Exemplo | CONTEMVALOR( 'casa/geladeira/mesa/gato/gaiola ', 'gato', 'S1COTACAOMOEDACOTACAOMOEDACotação de uma moedaCOTACAOMOEDA( ' SIMBOLO ' , 'DATA' - SIMBOLO → Símbolo da moeda
- DATA→ Data da cotação
| Exemplo | COTACAOMOEDA('US$','25/10/2018'3,724DATANULADATANULARetorna a data mínima do sistema.DATANULA(N/A | Exemplo | DATANULA(01/01/2000 | DECANODECANOSubtrai 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) |
Retorno | 2015 |
DECMESDECMESSubtrai 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) |
Retorno | 6 |
DIADTDIADTRetorna o dia dataDIADTDATA Data para selecionar o diaDIADT('24)Retorno | 24 |
DIASEMANA
Função | DIASEMANA |
---|
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) |
Sintaxe | DIASEMANA( ' DATA ' ) |
Parâmetros | - DATA → Data para selecionar o dia da semana
|
Exemplo | DIASEMANA('24/10/2018') |
Retorno | 4 |
ESCREVELOGESCREVELOGEscreve 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 0FALSON/A | Exemplo | FALSO(0FORFORExecuta uma fórmula.FOR CÓDIGO CÓDIGO → Código da fórmula.FORFOR001Será o retorno da fórmula 'FOR001'. | FRACFRACRetorna a parte fracionada de um valor.FRAC NUM NUM → Número para OperaçãoFRAC(24.730,73 | HOJEHOJERetorna a data de hojeHOJEN/AHOJE24/10/2018 | INCANOINCANOAdiciona 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 inicialINTEIRO1 → Mês da data inicialINTEIRO2 → Ano da data inicialINCANO2,2018,262019INCMESINCMESAdiciona uma quantidade de meses ( X meses) à um mês inicial (1 a 12)INCMES(INTEIRO1,INTEIRO2INTEIRO1 → Mês inicialINTEIRO2 → Quantidade de meses para adicionar ao mês inicialINCMES(2,199 | INTTOSTRFORMATINTTOSTRFORMATConverte inteiro para string (texto) preenchendo com zerosINTTOSTRFORMAT INTEIRO , ZEROS INTEIRO → Valor a ser convertido.ZEROS→ Quantidade de Zeros.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
| Exemplo | MAX(17,1217' | MEMORIAMEMORIA
| Descrição | Retorna 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çãoNUM 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
| Exemplo | MTDATA(17,11,1989/11/1989PARPAR que foi armazenado na propriedade de parâmetros genéricos de fórmulaPARN/APARConteú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çãoRAIZ255 | 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
| Exemplo | SETVAR('var1', 200200 | 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.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 DireitoINTEIRO → Quantidade de caracteres que deseja-se copiarSTRLEFTMundo Bonito10ndo BonitoSTRRIGHTSTRRIGHT
| 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) |
Retorno | Mundo Boni |
SUBSTRSUBSTR a partir da posição início de textoSUBSTR INTEIRO1, INTEIRO2 Texto onde é desejado selecionar uma parte para cópiaINTEIRO1 → Caracter inícioINTEIRO2 → você selecionar.SUBSTRAlô 2,5lô muSUBTRAIDATASSUBTRAIDATAS | Descrição | Retorna a subtração entre duas datas |
Sintaxe | SUBTRAIDATAS( DATA1 , DATA2 DATA1 → Data inicialDATA2 → Data para subtrairSUBTRAIDATAS('24/10/2018','21/09/2018'33TABCOLIGTABCOLIGRetorna o valor de um campo da coligadaTABCOLIG ' CAMPO ' )Parâmetros | |
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 decimaisULTDIAMES
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/2018 | USUARIOCORRENTEUSUARIOCORRENTERetorna o usuário correnteUSUARIOCORRENTE( N/AUSUARIOCORRENTE(IgorMCVALVALConverte um string para valorVAL VALOR VALOR String para se converter em valorVAL12,6512,65 | VERDADEVERDADE 1VERDADE VERDADE1 Informações |
---|
|
Informações |
---|
| Produto: Framework |
Informações |
---|
| Versão: 12.01.XX |
Informações |
---|
| Processo: Filtros de Visão |
|
Informações |
---|
|
Informações |
---|
|
Status: Finalizado |
Informações |
---|
|
Data: 25/10/2018 |
Informações |
---|
|
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