Histórico da Página
Versões comparadas
Chave
- Esta linha foi adicionada.
- Esta linha foi removida.
- A formatação mudou.
INDICE
Índice | |||||||
---|---|---|---|---|---|---|---|
|
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:
INCMESABS
Função |
---|
ABS |
---|
Descrição |
Retorna o valor absoluto de um número. |
Sintaxe |
ABS( NUM ) |
Parâmetros |
|
Exemplo |
ABS(-17) |
Retorno |
17 |
ANODT
Função |
---|
ANODT |
---|
Descrição |
Retorna o ano de uma data. |
Sintaxe |
ANODT( ' DATA ' ) |
Parâmetros |
|
Exemplo |
ANODT('24/10/2018') |
Retorno |
2018 |
ARRED
Função |
---|
ARRED |
---|
Descrição |
Arredonda um valor sem casas decimais. |
Sintaxe |
ARRED( NUM ) |
Parâmetros |
- INTEIRO1 → Mês da data inicial
- INTEIRO2 → Ano da data inicial
- INTEIRO3 → Quantidade de meses para adicionar na data inicial
INCANO(2,2018,26)
| |
Exemplo | ARRED(24.73) |
Retorno | 25 |
ARREDONDA
Função |
---|
ARREDONDA |
---|
Descrição |
Arredonda um valor. | |
Sintaxe | ARREDONDA( NUM A, NUM B |
Sintaxe
) |
Parâmetros |
- INTEIRO1 → Mês da data inicial
- INTEIRO2 → Ano da data inicial
- INTEIRO3 → Quantidade de meses para subtrair da data inicial
| |
Exemplo | ARREDONDA(24.33568784,3 |
) |
Retorno |
24,336 |
ARREDVALOR
Função |
---|
ARREDVALOR |
---|
Descrição |
Arredonda um valor Independente de Sistema. |
Sintaxe |
ARREDVALOR( |
NUM A, NUM B ) |
Parâmetros |
- INTEIRO1 → Dia da data
- INTEIRO2 → Mês da data
- INTEIRO3 → Ano da data
| |
Exemplo | ARREDVALOR(24.33,1 |
) |
Retorno |
25 |
ASCII
Função |
---|
ASCII | |
---|---|
Descrição | Retorna o |
valor que representa um determinado caractere na tabela ASCII. |
Sintaxe |
ASCII( ' |
CHAR ' ) |
Parâmetros |
|
Exemplo |
ASCII(' |
o') |
Retorno |
111 |
ATRIBUI
Função |
---|
ATRIBUI |
---|
Descrição |
Atribui um valor à uma memoria. |
Sintaxe |
ATRIBUI( CHAVE , CONTEUDO) |
Parâmetros |
| |
Exemplo |
ATRIBUI( |
'MEMORIA001','Mundo bonito') |
Retorno |
Mundo Bonito |
INCMES
Função |
---|
INCMES |
---|
Descrição |
Adiciona uma quantidade de meses ( X meses) à um mês inicial (1 a 12). |
Sintaxe |
INCMES(INTEIRO1,INTEIRO2) |
Parâmetros |
|
Exemplo |
INCMES(2,19) |
Retorno |
9 |
DECMES
Função |
---|
DECMES |
---|
Descrição |
Subtrai uma quantidade de meses ( X meses) de um mês inicial (1 a 12). |
Sintaxe |
DECMES(INTEIRO1,INTEIRO2) |
Parâmetros |
| |
Exemplo |
DECMES(11,5) |
Retorno |
6 |
INCANO
Função |
---|
INCANO |
---|
Descrição |
Adiciona um número de meses a um mês/ano e retorna o ano do resultado. |
Sintaxe |
INCANO(INTEIRO1,INTEIRO2,INTEIRO3) |
Parâmetros |
| |
Exemplo |
INCANO(2,2018,26) |
Retorno |
2019 |
DECANO
Função |
---|
DECANO |
---|
Descrição |
Subtrai um número de meses de um mês/ano e retorna o ano do resultado. |
Sintaxe |
DECANO(INTEIRO1,INTEIRO2,INTEIRO3) |
Parâmetros |
- DATA → Data para selecionar o último dia do mês
ULTDIAMES('24/10/2018')
| |
Exemplo | DECANO(2,2018,26) |
Retorno | 2015 |
MTDATA
Função |
---|
MTDATA |
---|
Descrição |
Monta uma data a partir de um dia, mês e ano. |
Sintaxe
- DATA → Data para selecionar o dia da semana
DIASEMANA('24/10/2018')
Sintaxe | MTDATA(INTEIRO1,INTEIRO2,INTEIRO3) |
Parâmetros |
|
Exemplo | MTDATA(17,11,1989) |
Retorno | 17/11/1989 |
DIADT
Função |
---|
DIADT |
---|
Descrição |
Retorna o dia de uma data. |
Sintaxe |
DIADT( ' |
DATA ' |
) |
Parâmetros |
- TEXTO → Texto onde é desejado selecionar uma parte para cópia
- INTEIRO1 → Caracter início
- INTEIRO2 → Quantidade de caracteres que você deseja selecionar.
| |
Exemplo | DIADT('24/10/2018' |
) |
Retorno |
24 |
MESDT
Função |
---|
MESDT |
---|
Descrição |
Retorna o mês de uma data. |
Sintaxe |
MESDT( ' |
DATA ' ) |
Parâmetros |
|
Exemplo |
MESDT(' |
24/10/2018') |
Retorno |
10 |
HOJE
Função |
---|
HOJE |
---|
Descrição |
Retorna a data de hoje. |
Sintaxe |
HOJE() |
Parâmetros |
N/A |
Exemplo |
HOJE() |
Retorno |
24/10/2018 |
DATANULA
Função |
---|
DATANULA |
---|
Descrição |
Retorna a data mínima do sistema. |
Sintaxe |
DATANULA( |
) |
Parâmetros |
N/A |
Exemplo |
DATANULA( |
) |
Retorno |
01/01/2000 |
ULTDIAMES
Função |
---|
ULTDIAMES |
---|
Descrição |
Retorna o último dia do mês de uma data. |
Sintaxe |
ULTDIAMES( ' |
DATA ' |
) |
Parâmetros |
|
STRLEFT('Mundo Bonito',10)
| |
Exemplo | ULTDIAMES('24/10/2018') |
Retorno | 31/10/2018 |
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 ' |
Sintaxe
) |
Parâmetros |
|
| |
Exemplo | DIASEMANA('24/10/2018' |
) |
Retorno |
4 |
SUBSTR
Função |
---|
SUBSTR |
---|
Descrição |
Copia a partir da posição início um número de caracteres de texto. |
Sintaxe |
SUBSTR( ' TEXTO ' , INTEIRO1, INTEIRO2 ) | |
Parâmetros |
|
|
| |
Exemplo | SUBSTR('Alô Mundo', 2,5 |
) |
Retorno |
lô mu |
CONCAT
Função | RETIRACARACTERESCONCAT |
---|---|
DescriçãoRetira do texto todas as ocorrências dos caracteres da string chars. | Concatena os textos A e B |
Sintaxe | RETIRACARACTERESCONCAT( ' CHAR TEXTO A ' , ' TEXTO B ' ) |
Parâmetros |
|
Exemplo | RETIRACARACTERESCONCAT('oMundo','Mundo Bonito') |
Retorno | Mund BnitMundoBonito |
CONCAT2
Função | ASCIICONCAT2 |
---|---|
DescriçãoRetorna | o valor que representa um determinado caractere na tabela ASCIIConcatena as strings A e B com um espaço entre elas. |
Sintaxe | ASCIICONCAT2( ' CHAR ' TEXTO A ' , ' TEXTO B ' ) |
Parâmetros |
|
Exemplo | ASCIICONCAT2('Mundo'o,'Bonito') |
Retorno111 | Mundo Bonito |
VAL
Função | STRVAL |
---|---|
Descrição | Retorna número de acordo com máscara informada, que pode ser composta da seguinte forma: |
Sintaxe | STR( VALOR , ' MASK ' ) |
Parâmetros |
|
Exemplo | STR(27, '000') |
Retorno | 027 |
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
Converte um string para valor. | |
Sintaxe | VAL( ' VALOR ' ) |
Parâmetros |
|
Exemplo | VAL('12,65') |
Retorno | 12,65 |
STRLEFT
Função | STRLEFT |
---|---|
Descrição | Copia o lado DIREITO de um string (texto) um número de caracteres (quantidade). |
Sintaxe | STRLEFT( ' TEXTO ' , INTEIRO ) |
Parâmetros |
|
Exemplo | STRLEFT('Mundo Bonito',10) |
Retorno | ndo Bonito |
STRRIGHT
Função | STRRIGHT |
---|---|
Descrição | Copia o lado ESQUERDO de um string (texto) um número de caracteres (quantidade). |
Sintaxe | STRRIGHT( ' TEXTO ' , INTEIRO ) |
Parâmetros |
|
Exemplo | STRRIGHT('Mundo Bonito',10) |
Retorno | Mundo Boni |
TAMSTR
FOR
Função | FORTAMSTR |
---|---|
DescriçãoExecuta | uma fórmulaRetorna o tamanho da string. |
Sintaxe | FORTAMSTR( ' CÓDIGO TEXTO ' ) |
Parâmetros |
|
Exemplo | FORTAMSTR('FOR001Mundo Bonito') |
Retorno | Será o retorno da fórmula 'FOR001'. |
12 |
RETIRACARACTERES
Função | EXECSQLRETIRACARACTERES |
---|---|
Descrição | Retira do texto todas as ocorrências dos caracteres da string chars. |
Sintaxe | RETIRACARACTERES( ' CHAR ' , ' TEXTO ' ) |
Parâmetros |
|
Exemplo | RETIRACARACTERES('o','Mundo Bonito') |
Retorno | Mund Bnit |
STR
Função | STR |
---|---|
Descrição | Retorna número de acordo com máscara informada, que pode ser composta da seguinte forma: |
Sintaxe | EXECSQLSTR( VALOR , ' CÓDIGO MASK ' ) |
Parâmetros |
|
Exemplo | EXECSQL('CON001' ) |
Retorno | Será o retorno (Se tiver) da Consulta SQL 'CON001'. |
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'.
| |
Exemplo | STR(27, '000') |
Retorno | 027 |
INTTOSTRFORMAT
RESULTSQL
Função | RESULTSQLINTTOSTRFORMAT |
---|---|
Descrição | Retorna o valor de um campo de um resultado da Consulta SQLConverte um valor inteiro para string (texto) preenchendo com zeros. |
Sintaxe | RESULTSQLINTTOSTRFORMAT( ' CÓDIGO ' , ' CAMPO ' INTEIRO , ZEROS ) |
Parâmetros |
|
Exemplo | RESULTSQLINTTOSTRFORMAT('CON001','CODUSUARIO' 27,5) |
Retorno | Retorna o valor do campo CODUSUARIO do resultado da Consulta SQL 'CON001'. |
00027 |
FOR
Função | MINFOR |
---|---|
Descrição | Retorna o menor númeroExecuta uma fórmula. |
Sintaxe | MIN( NUM A , NUM B FOR( ' CÓDIGO ' ) |
Parâmetros |
|
Exemplo | MIN(17,12FOR('FOR001' ) |
Retorno | 12 |
Será o retorno da fórmula 'FOR001'. |
EXECSQL
Função | MAXEXECSQL |
---|---|
Descrição | Retorna o maior númeroExecuta uma Consulta SQL. |
Sintaxe | MAX( NUM A , NUM B EXECSQL( ' CÓDIGO ' ) |
Parâmetros |
|
Exemplo | MAX(17,12EXECSQL('CON001' ) |
Retorno | 17 |
Será o retorno (Se tiver) da Consulta SQL 'CON001'. |
PROXREGSQL
Função | ABSPROXREGSQL |
---|---|
Descrição | Avança um registro na Consulta SQL executadaRetorna o valor absoluto de um número. |
Sintaxe | ABSPROXREGSQL( NUM ' CÓDIGO ' ) |
Parâmetros |
|
Exemplo | ABS(-17PROXREGSQL('CON001' ) |
Retorno | 17 |
Avança um registro na Consulta SQL 'CON001'. |
RESULTSQL
Função | RAIZRESULTSQL |
---|---|
Descrição | Retorna a raiz quadrada de um valoro valor de um campo de um resultado da Consulta SQL. |
Sintaxe | RAIZ( NUM RESULTSQL( ' CÓDIGO ' , ' CAMPO ' ) |
Parâmetros |
|
Exemplo | RAIZ(25RESULTSQL('CON001','CODUSUARIO' ) |
Retorno | 5 |
Retorna o valor do campo CODUSUARIO do resultado da Consulta SQL 'CON001'. |
MIN
Função | TETOMIN |
---|---|
Descrição | Retorna o valor truncado mais ummenor número. |
Sintaxe | TETOMIN( NUM A , NUM B ) |
Parâmetros |
|
Exemplo | TETO(24.03MIN(17,12) |
Retorno | 2512 |
MAX
Função | FRACMAX |
---|---|
Descrição | Retorna a parte fracionada de um valoro maior número. |
Sintaxe | FRACMAX( NUM A , NUM B ) |
Parâmetros |
|
Exemplo | FRAC(24.73MAX(17,12) |
Retorno | 0,73 |
17' |
RAIZ
Função | RAIZARRED |
---|---|
Descrição | Arredonda Retorna a raiz quadrada de um valor sem casas decimais. |
Sintaxe | ARREDRAIZ( NUM ) |
Parâmetros |
|
Exemplo | ARRED(24.73) |
Retorno | 25524 |
TETO
ARREDONDA
Função | ARREDONDATETO |
---|---|
Descrição | Retorna o valor truncado mais umArredonda um valor. |
Sintaxe | ARREDONDATETO( NUM A, NUM B ) |
Parâmetros |
|
Exemplo | ARREDONDATETO(24.33568784,303) |
Retorno | 24,33625 |
FRAC
Função | ARREDVALORFRAC |
---|---|
Descrição | Arredonda Retorna a parte fracionada de um valor Independente de Sistema. |
Sintaxe | ARREDVALORFRAC( NUM A, NUM B ) |
Parâmetros |
|
Exemplo | ARREDVALORFRAC(24.33,173) |
Retorno | 250,73 |
TRUNCVALOR
Função | TRUNCVALOR |
---|---|
Descrição | Trunca um valor com casas decimais. |
Sintaxe | TRUNCVALOR( NUM A ) ou TRUNCVALOR( NUM A , NUM B ) |
Parâmetros |
|
Exemplo | TRUNCVALOR(24.83) |
Retorno | 24 |
POTENCIA
Função | POTENCIA |
---|---|
Descrição | Retorna a potência. |
Sintaxe | POTENCIA( NUM A , NUM B ) |
Parâmetros |
|
Exemplo | POTENCIA(2,4) |
Retorno | 16 |
ATRIBUI
| |
Exemplo | POTENCIA(2,4) |
Retorno | 16 |
Função | ATRIBUI |
---|---|
Descrição | Atribui um valor à uma memoria. |
Sintaxe | ATRIBUI( CHAVE , CONTEUDO) |
Parâmetros |
|
Exemplo | ATRIBUI('MEMORIA001','Mundo bonito') |
Retorno | Mundo Bonito |
MEMORIA
Função | MEMORIA |
---|---|
Descrição | Retorna o valor de uma memória. |
Sintaxe | MEMORIA( CHAVE ) |
Parâmetros |
|
Exemplo | MEMORIA('MEMORIA001') |
Retorno | Mundo Bonito |
SETVAR
Função | SETVAR |
---|---|
Descrição | Atribui um valor a uma variável. |
Sintaxe | SETVAR( ' VAR ' , CONTEUDO) |
Parâmetros |
|
Exemplo | SETVAR('var1', 200) |
Retorno | 200 |
VERDADE
Função | VERDADE |
---|---|
Descrição | Retorna 1. |
Sintaxe | VERDADE ( ) |
Parâmetros | N/A |
Exemplo | VERDADE() |
Retorno | 1 |
FALSO
Função | FALSO |
---|---|
Descrição | Retorna 0. |
Sintaxe | FALSO( ) |
Parâmetros | N/A |
Exemplo | FALSO() |
Retorno | 0 |
COTACAOMOEDA
Função | COTACAOMOEDA |
---|---|
Descrição | Cotação de uma moeda. |
Sintaxe | COTACAOMOEDA( ' SIMBOLO ' , 'DATA' ) |
Parâmetros |
|
Exemplo | COTACAOMOEDA('US$','25/10/2018') |
Retorno | 3,724 |
USUARIOCORRENTE
Função | USUARIOCORRENTE |
---|---|
Descrição | Retorna o usuário corrente. |
Sintaxe | USUARIOCORRENTE( ) |
Parâmetros | N/A |
Exemplo | USUARIOCORRENTE() |
Retorno | IgorMC |
COLIGADACORRENTE
Função | COLIGADACORRENTE |
---|---|
Descrição | Retorna a coligada corrente. |
Sintaxe | COLIGADACORRENTE( ) |
Parâmetros | N/A |
Exemplo | COLIGADACORRENTE() |
Retorno | 1 |
PARMQRY
Função | PARMQRY |
---|---|
Descrição | Retorna o conteúdo de um campo. |
Sintaxe | PARMQRY( ' CAMPO ' ) |
Parâmetros |
|
Exemplo | PARMQRY('CODUSUARIO') |
Retorno | IgorMC |
TABCOLIG
Função | TABCOLIG |
---|---|
Descrição | Retorna o valor de um campo da coligada. |
Sintaxe | TABCOLIG( ' CAMPO ' ) |
Parâmetros |
|
Exemplo | TABCOLIG('NOMEFANTASIA') |
Retorno | TOTVS SA |
TABCOLIGADA
Função | TABCOLIGADA |
---|---|
Descrição | Retorna o valor de uma Coluna da tabela GCOLIGADA da coligada corrente que o usuário tem acesso na GPERMISS. |
Sintaxe | TABCOLIGADA( ' CAMPO ' ) |
Parâmetros |
|
Exemplo | TABCOLIGADA('Numero') |
Retorno | 2664 |
PAR
Função | PAR |
---|---|
Descrição | Retorna o que foi armazenado na propriedade de parâmetros genéricos de fórmula. |
Sintaxe | PAR( ) |
Parâmetros | N/A |
Exemplo | PAR() |
Retorno | Conteúdo do parâmetro armazenado |
CONTEMVALOR
Função | CONTEMVALOR |
---|---|
Descrição | Procura um determinado valor em um conjunto de dados. |
Sintaxe | CONTEMVALOR( ' CONJUNTO ' , VALOR , ' TIPO ' ) |
Parâmetros |
|
Exemplo | CONTEMVALOR( 'casa/geladeira/mesa/gato/gaiola ', 'gato', 'S') |
Retorno | 1 |
SUBTRAIDATAS
Função | SUBTRAIDATAS |
---|---|
Descrição | Retorna a subtração entre duas datas |
Sintaxe | SUBTRAIDATAS( DATA1 , DATA2 ) |
Parâmetros |
|
Exemplo | SUBTRAIDATAS('24/10/2018','21/09/2018') |
Retorno | 33 |
ESCREVELOG
Função | ESCREVELOG |
---|---|
Descrição | Escreve Log |
Sintaxe | ESCREVELOG( ' TEXTO ' ) |
Parâmetros |
|
Exemplo | ESCREVELOG(' Log Adicionado') |
Retorno | Log Adicionado |
Informações | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||
|
Informações | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||
|