Funções

Uma função do ACLScript é uma rotina computadorizada do Analytics, com escopo limitado, que executa uma tarefa ou cálculo específico e retorna um valor.

Por exemplo, a função ALLTRIM( ) remove qualquer espaço à esquerda ou direita dos valores de textos em um campo.

Lista de funções

Veja a seguir uma lista completa dos comandos disponíveis no Analytics, organizados alfabeticamente ou por categoria.

Também são fornecidas as convenções usadas na sintaxe da função e na documentação das funções, bem como alguns detalhes de uso geral.

Funções em ordem alfabética

Função Descrição

ABS( )

Retorna o valor absoluto de uma expressão numérica. O valor absoluto de um número é o número sem seu sinal.

AGE( )

Retorna o número de dias decorridos (idade) entre uma data específica e uma data limite específica ou a data atual do sistema operacional ou o número de dias decorridos entre quaisquer duas datas.

ALLTRIM( )

Retorna uma cadeia com os espaços iniciais e finais removidos da cadeia de entrada.

ASCII( )

Retorna o código ASCII de um caractere especificado.

AT( )

Retorna um número especificando a localização inicial de uma determinada ocorrência de uma subcadeia dentro de um valor de caracteres.

BETWEEN( )

Retorna um valor lógico que indica se o valor especificado está dentro de um intervalo.

BINTOSTR( )

Retorna os dados de caracteres Unicode convertidos de dados de caracteres ZONED ou EBCDIC. Abreviação de "Binário para Cadeia".

BIT( )

Retorna a representação binária para a posição de byte especificada no registro atual como uma cadeia de oito caracteres.

BLANKS( )

Retorna uma cadeia que contém um número especificado de espaços em branco.

BYTE( )

Retorna o caractere armazenado numa determinada posição no byte do registro atual.

CDOW( )

Retorna o nome do dia da semana para uma data ou datahora especificada. Abreviação de "Caractere Dia da Semana".

CHR( )

Retorna o caractere associado ao código ASCII especificado.

CLEAN( )

Substitui o primeiro caractere inválido e todos os caracteres subsequentes em uma cadeia por espaços em branco.

CMOY( )

Retorna o nome do mês do ano para uma data ou datahora especificada. Abreviação de "Caractere para o Mês do Ano".

COS( )

Retorna o cosseno de um ângulo expresso em radianos, com uma precisão de 15 casas decimais.

CTOD( )

Converte um valor em caractere ou numérico de data em uma data. Também é possível extrair a data de um valor de datahora em formato de caracteres ou numérico e retorná-lo como uma data. Abreviação de "Caractere para Data".

CTODT( )

Converte um valor em caractere ou numérico de datahora em uma datahora. Abreviação de "Caractere para Datahora".

CTOT( )

Converte um valor em caractere ou numérico de hora em uma hora. Também é possível extrair a hora de um valor de datahora em formato de caracteres ou numérico e retorná-lo como uma hora. Abreviação de "Caractere para Hora".

CUMIPMT( )

Retorna os juros cumulativos pagos de um empréstimo durante um intervalo de períodos.

CUMPRINC( )

Retorna o principal cumulativo pago de um empréstimo durante um intervalo de períodos.

DATE( )

Extrai a data a partir de uma data ou datahora específica e retorna como sequência de caracteres. Também pode retornar a data atual do sistema operacional.

DATETIME( )

Converte uma datahora em uma sequência de caracteres. Também pode retornar a datahora atual do sistema operacional.

DAY( )

Extrai o dia de um mês a partir de uma data ou datahora específica e retorna o dia como valor numérico (1 a 31).

DBYTE( )

Retorna o caractere Unicode localizado em uma posição determinada de byte em um registro.

DEC( )

Retorna um valor ou o resultado de uma expressão numérica com um número especificado de casas decimais.

DHEX( )

Converte uma cadeia Unicode em formato hexadecimal.

DICECOEFFICIENT( )

Retorna o coeficiente de Dice entre duas cadeias especificadas, que é uma medida de quanto as duas cadeias são similares.

DIGIT( )

Retorna o dígito superior ou inferior de um byte de tipo de dados Packed (Compactado).

DOW( )

Retorna um valor numérico (1 a 7) representando o dia da semana para uma data ou datahora especificada. Abreviação de "Dia da Semana".

DTOU( )

Converte um valor de data do Analytics para uma cadeia Unicode no idioma e no formato de localidade especificados. Abreviação de "Data para Unicode".

EBCDIC( )

Retorna uma cadeia que foi convertida para a codificação de caracteres EBCDIC.

EFFECTIVE( )

Retorna a taxa de juros efetiva anual de um empréstimo.

EOMONTH( )

Retorna a data do último dia do mês que é o número específico de meses antes ou depois de uma data específica.

EXCLUDE( )

Retorna uma cadeia que exclui os caracteres especificados.

EXP( )

Retorna o valor exponencial (base 10) de uma expressão numérica com um número específico de casas decimais.

FILESIZE( )

Retorna o tamanho do arquivo especificado em bytes, ou -1, caso o arquivo não exista.

FIND( )

Retorna um valor lógico indicando se a cadeia de caracteres especificada está presente em um campo específico ou em qualquer local no registro.

FINDMULTI( )

Retorna um valor lógico indicando se qualquer cadeia em um conjunto de uma ou mais cadeias especificadas está presente em um campo específico ou em qualquer local no registro.

FREQUENCY( )

Retorna a frequência de Benford esperada para dígitos numéricos positivos iniciais sequenciais com uma precisão de oito casas decimais.

FTYPE( )

Retorna um caractere identificando a categoria de dados de um campo ou variável, ou o tipo de um item do projeto do Analytics.

FVANNUITY( )

Retorna o valor futuro de uma série de pagamentos, calculado usando uma taxa de juros constante. O valor futuro é a soma dos pagamentos mais os juros compostos acumulados.

FVLUMPSUM( )

Retorna o valor futuro de um valor de um único pagamento atual, calculado usando uma taxa de juros constante.

FVSCHEDULE( )

Retorna o valor futuro de um valor de um único pagamento atual, calculado usando uma série de taxas de juros.

GETOPTIONS( )

Retorna a configuração atual para a opção do Analytics especificada (configuração da caixa de diálogo Opções).

GOMONTH( )

Retorna a data que é o número específico de meses antes ou depois de uma data específica.

HASH( )

Retorna um hash criptográfico originado baseado no valor de entrada.

HEX( )

Converte uma cadeia ASCII em uma cadeia hexadecimal.

HOUR( )

Extrai a hora de uma hora ou datahora específica e retorna como valor numérico usando o relógio 24 horas.

HTOU( )

Converte uma string hexadecimal em formato Unicode. Abreviação de "Hexadecimal para Unicode".

INCLUDE( )

Retorna uma cadeia que inclui apenas os caracteres especificados.

INSERT( )

Retorna a cadeia original com um texto especificado inserido em um local de byte específico.

INT( )

Retorna o valor inteiro de uma expressão numérica ou valor de campo.

IPMT( )

Retorna os juros pagos em um empréstimo para um único período.

ISBLANK( )

Retorna um valor lógico que indica se o valor da entrada está em branco.

ISDEFINED( )

Retorna T (verdadeiro) se o campo ou variável especificado for definido, caso contrário, retorna F (falso).

ISFUZZYDUP( )

Retorna um valor lógico que indica se uma cadeia é uma duplicata parcial de uma cadeia de comparação.

LAST( )

Retorna um número especificado de caracteres do final de uma cadeia.

LEADING( )

Retorna uma cadeia que contém um número especificado de dígitos iniciais.

LEADINGZEROS( )

Adiciona zeros à esquerda a uma cadeia de caracteres ou a um número.

LENGTH( )

Retorna o número de caracteres em uma cadeia.

LEVDIST( )

Retorna a distância de Levenshtein entre duas cadeias especificadas, que é uma medida de quanto as duas cadeias são diferentes.

LOG( )

Retorna o logaritmo (base 10) de uma expressão numérica ou de um valor de campo com um número específico de casas decimais.

LOWER( )

Retorna uma cadeia com caracteres alfabéticos convertidos em minúsculas.

LTRIM( )

Retorna uma cadeia com os espaços iniciais removidos do valor de entrada.

MAP( )

Retorna uma valor lógico que indica se uma cadeia de caracteres corresponde a uma cadeia de formatação especificada que contém caracteres curinga, caracteres literais ou ambos.

MASK( )

Executa uma operação AND de bits nos primeiros bytes de duas cadeias de caracteres.

MATCH( )

Retorna um valor lógico indicando se o valor especificado corresponde a algum dos valores com os quais está sendo comparado.

MAXIMUM( )

Retorna o valor máximo em um conjunto de valores numéricos ou o valor mais recente em um conjunto de valores de datahora.

MINIMUM( )

Retorna o valor mínimo em um conjunto de valores numéricos ou o valor mais antigo em um conjunto de valores de datahora.

MINUTE( )

Extrai os minutos de uma hora ou datahora específica e retorna como valor numérico.

MOD( )

Retorna o resto de divisão de dois números.

MONTH( )

Extrai o mês de uma data ou datahora específica e retorna o mês como valor numérico (1 a 12).

NOMINAL( )

Retorna a taxa de juros nominal anual de um empréstimo.

NORMDIST( )

Retorna a probabilidade de uma variável aleatória de um conjunto de dados distribuído normalmente ser menor ou igual a um valor especificado, ou exatamente igual a um valor especificado.

NORMSINV( )

Retorna a pontuação z associada a uma probabilidade especificada em uma distribuição normal padrão. A pontuação z é o número de desvios padrão que um valor está distante da média de uma distribuição normal padrão.

NOW( )

Retorna a hora atual do sistema operacional como um tipo de dados Datahora.

NPER( )

Retorna o número dos períodos necessários para liquidar um empréstimo.

OCCURS( )

Retorna a contagem de quantas vezes um trecho de cadeia ocorre em um valor de caracteres especificado.

OFFSET( )

Retorna o valor de um campo com a posição inicial deslocada por um número especificado de bytes.

OMIT( )

Retorna uma cadeia com um ou mais subcadeias especificadas removidas.

PACKED( )

Retorna os dados numéricos convertidos para tipo de dados Packed (Compactado).

PI( )

Retorna o valor de pi com 15 casas decimais.

PMT( )

Retorna o tamanho dos pagamentos periódicos (principal + juros) necessários para liquidar um empréstimo.

PPMT( )

Retorna o principal pago em um empréstimo para um único período.

PROPER( )

Retorna uma cadeia com o primeiro caractere de cada palavra em letra maiúscula e os caracteres restantes em minúsculas.

PROPERTIES( )

Retorna informações sobre as propriedades do item do projeto do Analytics especificado.

PVANNUITY( )

Retorna o valor presente de uma série de pagamentos futuros, calculado usando uma taxa de juros constante. O valor presente é o valor atual para um único pagamento.

PVLUMPSUM( )

Retorna o valor presente necessário para gerar o valor de um único pagamento futuro calculado usando uma taxa de juros contínua. O valor presente é o valor atual para um único pagamento.

PYDATE( )

Retorna um valor de data calculado por uma função em um script do Python externo. O processamento de dados no Python é externo ao Analytics.

PYDATETIME( )

Retorna um valor de datahora calculado por uma função em um script do Python externo. O processamento de dados no Python é externo ao Analytics.

PYLOGICAL( )

Retorna um valor lógico calculado por uma função em um script do Python externo. O processamento de dados no Python é externo ao Analytics.

PYNUMERIC( )

Retorna um valor numérico calculado por uma função em um script do Python externo. O processamento de dados no Python é externo ao Analytics.

PYSTRING( )

Retorna um valor de caracteres calculado por uma função em um script do Python externo. O processamento de dados no Python é externo ao Analytics.

PYTIME( )

Retorna um valor de hora calculado por uma função em um script do Python externo. O processamento de dados no Python é externo ao Analytics.

RAND( )

Retorna um número aleatório dentro de um intervalo especificado.

RATE( )

Retorna a taxa de juros por período.

RDATE( )

Retorna um valor de data calculado por uma função ou script do R. O processamento de dados no R é externo ao Analytics.

RDATETIME( )

Retorna um valor de datahora calculado por uma função ou script do R. O processamento de dados no R é externo ao Analytics.

RECLEN( )

Retorna o comprimento do registro atual.

RECNO( )

Retorna o número do registro atual.

RECOFFSET( )

Retorna o valor de um campo de um registro que está a um número especificado de registros a partir do registro atual.

REGEXFIND( )

Retorna um valor lógico que indica se o padrão especificado por uma expressão regular ocorre em uma cadeia.

REGEXREPLACE( )

Substitui todas as ocorrências de cadeias que correspondem a uma expressão regular com uma nova cadeia.

REMOVE( )

Retorna uma cadeia que inclui apenas os caracteres especificados.

REPEAT( )

Retorna uma cadeia que repete uma subcadeia por um número especificado de vezes.

REPLACE( )

Substitui todas as instâncias de uma cadeia de caracteres especificada por uma nova cadeia de caracteres.

REVERSE( )

Retorna uma cadeia com os caracteres na ordem invertida.

RJUSTIFY( )

Retorna uma cadeia alinhada à direita com o mesmo comprimento que a cadeia especificada, com todos os espaços finais movidos para a esquerda da cadeia.

RLOGICAL( )

Retorna um valor lógico calculado por uma função ou script do R. O processamento de dados no R é externo ao Analytics.

RNUMERIC( )

Retorna um valor numérico calculado por uma função ou script do R. O processamento de dados no R é externo ao Analytics.

ROOT( )

Retorna a raiz quadrada de uma expressão numérica.

ROUND( )

Retorna um número inteiro arredondado para um valor numérico.

RSTRING( )

Retorna um valor de cadeia calculado por uma função ou script do R. O processamento de dados no R é externo ao Analytics.

RTIME( )

Retorna um valor de hora calculado por uma função ou script do R. O processamento de dados no R é externo ao Analytics.

SECOND( )

Extrai os segundos de uma hora ou datahora específica e retorna como valor numérico.

SHIFT( )

Retorna uma cadeia de caracteres única, com os bits do primeiro caractere do valor de entrada deslocados para a esquerda ou direita.

SIN( )

Retorna o seno de um ângulo expresso em radianos, com uma precisão de 15 casas decimais.

SORTWORDS( )

Retorna uma cadeia com palavras individuais ordenadas sequencialmente.

SOUNDEX( )

Retorna o código soundex para a cadeia especificada, que pode ser usado para comparações fonéticas com outras cadeias.

SOUNDSLIKE( )

Retorna um valor lógico que indica se uma cadeia corresponde foneticamente à cadeia de comparação.

SPLIT( )

Retorna um segmento especificado de uma cadeia.

STOD( )

Converte uma data serial, ou seja, uma data expressa como um inteiro, em um valor de data. É abreviação de "Serial to Date".

STODT( )

Converte uma datahora serial, ou seja, uma datahora expressa como um inteiro e uma fração de 24 horas, em um valor de datahora. É abreviação de "Serial to Datetime".

STOT( )

Converte uma hora em série, ou seja, uma hora expressa como uma fração de 24 horas, sendo 24 horas representando 1, para um valor de hora. Abreviação de "Série para hora".

STRING( )

Converte um valor numérico em uma sequência de caracteres.

SUBSTR( )

Retorna uma subcadeia especificada de uma cadeia.

TAN( )

Retorna a tangente de um ângulo expresso em radianos, com uma precisão de 15 casas decimais.

TEST( )

Retorna um valor lógico que indica se uma cadeia especificada ocorre em uma posição de byte específica no registro.

TIME( )

Extrai a hora a partir de uma hora ou datahora específica e retorna como sequência de caracteres. Também pode retornar a hora atual do sistema operacional.

TODAY( )

Retorna a data atual do sistema operacional como um tipo de dados Datahora.

TRANSFORM( )

Inverte a ordem de exibição do texto bidirecional dentro de uma cadeia especificada.

TRIM( )

Retorna uma cadeia com os espaços finais removidos da cadeia de entrada.

UNSIGNED( )

Retorna os dados numéricos convertidos para tipo de dados Unsigned (Sem sinal).

UPPER( )

Retorna uma cadeia com caracteres alfabéticos convertidos em maiúsculas.

UTOD( )

Converte uma cadeia Unicode que contém uma data formatada em um valor de data do Analytics. É abreviação de "Unicode to Date".

VALUE( )

Converte uma sequência de caracteres em um valor numérico.

VERIFY( )

Retorna um valor lógico que indica se os dados no campo de dados físicos são válidos.

WORKDAY( )

Retorna o número de dias úteis entre duas datas.

YEAR( )

Extrai o ano de uma data ou datahora específica e retorna como valor numérico usando o formato AAAA.

ZONED( )

Converte dados numéricos em dados de caracteres e adiciona zeros à esquerda na saída.

ZSTAT( )

Retorna a estatística Z padrão.

Pesquisar, substituir

Função Descrição

AT( )

Retorna um número especificando a localização inicial de uma determinada ocorrência de uma subcadeia dentro de um valor de caracteres.

BETWEEN( )

Retorna um valor lógico que indica se o valor especificado está dentro de um intervalo.

CLEAN( )

Substitui o primeiro caractere inválido e todos os caracteres subsequentes em uma cadeia por espaços em branco.

FIND( )

Retorna um valor lógico indicando se a cadeia de caracteres especificada está presente em um campo específico ou em qualquer local no registro.

FINDMULTI( )

Retorna um valor lógico indicando se qualquer cadeia em um conjunto de uma ou mais cadeias especificadas está presente em um campo específico ou em qualquer local no registro.

ISBLANK( )

Retorna um valor lógico que indica se o valor da entrada está em branco.

MAP( )

Retorna uma valor lógico que indica se uma cadeia de caracteres corresponde a uma cadeia de formatação especificada que contém caracteres curinga, caracteres literais ou ambos.

MATCH( )

Retorna um valor lógico indicando se o valor especificado corresponde a algum dos valores com os quais está sendo comparado.

OCCURS( )

Retorna a contagem de quantas vezes um trecho de cadeia ocorre em um valor de caracteres especificado.

REGEXFIND( )

Retorna um valor lógico que indica se o padrão especificado por uma expressão regular ocorre em uma cadeia.

REGEXREPLACE( )

Substitui todas as ocorrências de cadeias que correspondem a uma expressão regular com uma nova cadeia.

REPLACE( )

Substitui todas as instâncias de uma cadeia de caracteres especificada por uma nova cadeia de caracteres.

TEST( )

Retorna um valor lógico que indica se uma cadeia especificada ocorre em uma posição de byte específica no registro.

Comparação

Função Descrição

DICECOEFFICIENT( )

Retorna o coeficiente de Dice entre duas cadeias especificadas, que é uma medida de quanto as duas cadeias são similares.

ISFUZZYDUP( )

Retorna um valor lógico que indica se uma cadeia é uma duplicata parcial de uma cadeia de comparação.

LEVDIST( )

Retorna a distância de Levenshtein entre duas cadeias especificadas, que é uma medida de quanto as duas cadeias são diferentes.

SOUNDEX( )

Retorna o código soundex para a cadeia especificada, que pode ser usado para comparações fonéticas com outras cadeias.

SOUNDSLIKE( )

Retorna um valor lógico que indica se uma cadeia corresponde foneticamente à cadeia de comparação.

Conversão

Função Descrição

BINTOSTR( )

Retorna os dados de caracteres Unicode convertidos de dados de caracteres ZONED ou EBCDIC. Abreviação de "Binário para Cadeia".

CTOD( )

Converte um valor em caractere ou numérico de data em uma data. Também é possível extrair a data de um valor de datahora em formato de caracteres ou numérico e retorná-lo como uma data. Abreviação de "Caractere para Data".

CTODT( )

Converte um valor em caractere ou numérico de datahora em uma datahora. Abreviação de "Caractere para Datahora".

CTOT( )

Converte um valor em caractere ou numérico de hora em uma hora. Também é possível extrair a hora de um valor de datahora em formato de caracteres ou numérico e retorná-lo como uma hora. Abreviação de "Caractere para Hora".

DATE( )

Extrai a data a partir de uma data ou datahora específica e retorna como sequência de caracteres. Também pode retornar a data atual do sistema operacional.

DATETIME( )

Converte uma datahora em uma sequência de caracteres. Também pode retornar a datahora atual do sistema operacional.

DTOU( )

Converte um valor de data do Analytics para uma cadeia Unicode no idioma e no formato de localidade especificados. Abreviação de "Data para Unicode".

EBCDIC( )

Retorna uma cadeia que foi convertida para a codificação de caracteres EBCDIC.

HASH( )

Retorna um hash criptográfico originado baseado no valor de entrada.

LEADINGZEROS( )

Adiciona zeros à esquerda a uma cadeia de caracteres ou a um número.

PACKED( )

Retorna os dados numéricos convertidos para tipo de dados Packed (Compactado).

STOD( )

Converte uma data serial, ou seja, uma data expressa como um inteiro, em um valor de data. É abreviação de "Serial to Date".

STODT( )

Converte uma datahora serial, ou seja, uma datahora expressa como um inteiro e uma fração de 24 horas, em um valor de datahora. É abreviação de "Serial to Datetime".

STOT( )

Converte uma hora em série, ou seja, uma hora expressa como uma fração de 24 horas, sendo 24 horas representando 1, para um valor de hora. Abreviação de "Série para hora".

STRING( )

Converte um valor numérico em uma sequência de caracteres.

TIME( )

Extrai a hora a partir de uma hora ou datahora específica e retorna como sequência de caracteres. Também pode retornar a hora atual do sistema operacional.

UNSIGNED( )

Retorna os dados numéricos convertidos para tipo de dados Unsigned (Sem sinal).

UTOD( )

Converte uma cadeia Unicode que contém uma data formatada em um valor de data do Analytics. É abreviação de "Unicode to Date".

VALUE( )

Converte uma sequência de caracteres em um valor numérico.

ZONED( )

Converte dados numéricos em dados de caracteres e adiciona zeros à esquerda na saída.

Texto

Função Descrição

ALLTRIM( )

Retorna uma cadeia com os espaços iniciais e finais removidos da cadeia de entrada.

BINTOSTR( )

Retorna os dados de caracteres Unicode convertidos de dados de caracteres ZONED ou EBCDIC. Abreviação de "Binário para Cadeia".

BLANKS( )

Retorna uma cadeia que contém um número especificado de espaços em branco.

DATETIME( )

Converte uma datahora em uma sequência de caracteres. Também pode retornar a datahora atual do sistema operacional.

DTOU( )

Converte um valor de data do Analytics para uma cadeia Unicode no idioma e no formato de localidade especificados. Abreviação de "Data para Unicode".

EBCDIC( )

Retorna uma cadeia que foi convertida para a codificação de caracteres EBCDIC.

EXCLUDE( )

Retorna uma cadeia que exclui os caracteres especificados.

INCLUDE( )

Retorna uma cadeia que inclui apenas os caracteres especificados.

INSERT( )

Retorna a cadeia original com um texto especificado inserido em um local de byte específico.

LAST( )

Retorna um número especificado de caracteres do final de uma cadeia.

LEADINGZEROS( )

Adiciona zeros à esquerda a uma cadeia de caracteres ou a um número.

LENGTH( )

Retorna o número de caracteres em uma cadeia.

LOWER( )

Retorna uma cadeia com caracteres alfabéticos convertidos em minúsculas.

LTRIM( )

Retorna uma cadeia com os espaços iniciais removidos do valor de entrada.

OMIT( )

Retorna uma cadeia com um ou mais subcadeias especificadas removidas.

PROPER( )

Retorna uma cadeia com o primeiro caractere de cada palavra em letra maiúscula e os caracteres restantes em minúsculas.

REMOVE( )

Retorna uma cadeia que inclui apenas os caracteres especificados.

REPEAT( )

Retorna uma cadeia que repete uma subcadeia por um número especificado de vezes.

REVERSE( )

Retorna uma cadeia com os caracteres na ordem invertida.

RJUSTIFY( )

Retorna uma cadeia alinhada à direita com o mesmo comprimento que a cadeia especificada, com todos os espaços finais movidos para a esquerda da cadeia.

SORTWORDS( )

Retorna uma cadeia com palavras individuais ordenadas sequencialmente.

SPLIT( )

Retorna um segmento especificado de uma cadeia.

STRING( )

Converte um valor numérico em uma sequência de caracteres.

SUBSTR( )

Retorna uma subcadeia especificada de uma cadeia.

TRANSFORM( )

Inverte a ordem de exibição do texto bidirecional dentro de uma cadeia especificada.

TRIM( )

Retorna uma cadeia com os espaços finais removidos da cadeia de entrada.

UPPER( )

Retorna uma cadeia com caracteres alfabéticos convertidos em maiúsculas.

ZONED( )

Converte dados numéricos em dados de caracteres e adiciona zeros à esquerda na saída.

Matemáticas

Função Descrição

ABS( )

Retorna o valor absoluto de uma expressão numérica. O valor absoluto de um número é o número sem seu sinal.

COS( )

Retorna o cosseno de um ângulo expresso em radianos, com uma precisão de 15 casas decimais.

DEC( )

Retorna um valor ou o resultado de uma expressão numérica com um número especificado de casas decimais.

EXP( )

Retorna o valor exponencial (base 10) de uma expressão numérica com um número específico de casas decimais.

FREQUENCY( )

Retorna a frequência de Benford esperada para dígitos numéricos positivos iniciais sequenciais com uma precisão de oito casas decimais.

INT( )

Retorna o valor inteiro de uma expressão numérica ou valor de campo.

LEADING( )

Retorna uma cadeia que contém um número especificado de dígitos iniciais.

LOG( )

Retorna o logaritmo (base 10) de uma expressão numérica ou de um valor de campo com um número específico de casas decimais.

MAXIMUM( )

Retorna o valor máximo em um conjunto de valores numéricos ou o valor mais recente em um conjunto de valores de datahora.

MINIMUM( )

Retorna o valor mínimo em um conjunto de valores numéricos ou o valor mais antigo em um conjunto de valores de datahora.

MOD( )

Retorna o resto de divisão de dois números.

NORMDIST( )

Retorna a probabilidade de uma variável aleatória de um conjunto de dados distribuído normalmente ser menor ou igual a um valor especificado, ou exatamente igual a um valor especificado.

NORMSINV( )

Retorna a pontuação z associada a uma probabilidade especificada em uma distribuição normal padrão. A pontuação z é o número de desvios padrão que um valor está distante da média de uma distribuição normal padrão.

PI( )

Retorna o valor de pi com 15 casas decimais.

RAND( )

Retorna um número aleatório dentro de um intervalo especificado.

ROOT( )

Retorna a raiz quadrada de uma expressão numérica.

ROUND( )

Retorna um número inteiro arredondado para um valor numérico.

SIN( )

Retorna o seno de um ângulo expresso em radianos, com uma precisão de 15 casas decimais.

TAN( )

Retorna a tangente de um ângulo expresso em radianos, com uma precisão de 15 casas decimais.

VALUE( )

Converte uma sequência de caracteres em um valor numérico.

ZONED( )

Converte dados numéricos em dados de caracteres e adiciona zeros à esquerda na saída.

ZSTAT( )

Retorna a estatística Z padrão.

Data e hora

Função Descrição

AGE( )

Retorna o número de dias decorridos (idade) entre uma data específica e uma data limite específica ou a data atual do sistema operacional ou o número de dias decorridos entre quaisquer duas datas.

CDOW( )

Retorna o nome do dia da semana para uma data ou datahora especificada. Abreviação de "Caractere Dia da Semana".

CMOY( )

Retorna o nome do mês do ano para uma data ou datahora especificada. Abreviação de "Caractere para o Mês do Ano".

CTOD( )

Converte um valor em caractere ou numérico de data em uma data. Também é possível extrair a data de um valor de datahora em formato de caracteres ou numérico e retorná-lo como uma data. Abreviação de "Caractere para Data".

CTODT( )

Converte um valor em caractere ou numérico de datahora em uma datahora. Abreviação de "Caractere para Datahora".

CTOT( )

Converte um valor em caractere ou numérico de hora em uma hora. Também é possível extrair a hora de um valor de datahora em formato de caracteres ou numérico e retorná-lo como uma hora. Abreviação de "Caractere para Hora".

DATE( )

Extrai a data a partir de uma data ou datahora específica e retorna como sequência de caracteres. Também pode retornar a data atual do sistema operacional.

DATETIME( )

Converte uma datahora em uma sequência de caracteres. Também pode retornar a datahora atual do sistema operacional.

DAY( )

Extrai o dia de um mês a partir de uma data ou datahora específica e retorna o dia como valor numérico (1 a 31).

DOW( )

Retorna um valor numérico (1 a 7) representando o dia da semana para uma data ou datahora especificada. Abreviação de "Dia da Semana".

EOMONTH( )

Retorna a data do último dia do mês que é o número específico de meses antes ou depois de uma data específica.

GOMONTH( )

Retorna a data que é o número específico de meses antes ou depois de uma data específica.

HOUR( )

Extrai a hora de uma hora ou datahora específica e retorna como valor numérico usando o relógio 24 horas.

MAXIMUM( )

Retorna o valor máximo em um conjunto de valores numéricos ou o valor mais recente em um conjunto de valores de datahora.

MINIMUM( )

Retorna o valor mínimo em um conjunto de valores numéricos ou o valor mais antigo em um conjunto de valores de datahora.

MINUTE( )

Extrai os minutos de uma hora ou datahora específica e retorna como valor numérico.

MONTH( )

Extrai o mês de uma data ou datahora específica e retorna o mês como valor numérico (1 a 12).

NOW( )

Retorna a hora atual do sistema operacional como um tipo de dados Datahora.

SECOND( )

Extrai os segundos de uma hora ou datahora específica e retorna como valor numérico.

STOD( )

Converte uma data serial, ou seja, uma data expressa como um inteiro, em um valor de data. É abreviação de "Serial to Date".

STODT( )

Converte uma datahora serial, ou seja, uma datahora expressa como um inteiro e uma fração de 24 horas, em um valor de datahora. É abreviação de "Serial to Datetime".

STOT( )

Converte uma hora em série, ou seja, uma hora expressa como uma fração de 24 horas, sendo 24 horas representando 1, para um valor de hora. Abreviação de "Série para hora".

TIME( )

Extrai a hora a partir de uma hora ou datahora específica e retorna como sequência de caracteres. Também pode retornar a hora atual do sistema operacional.

TODAY( )

Retorna a data atual do sistema operacional como um tipo de dados Datahora.

UTOD( )

Converte uma cadeia Unicode que contém uma data formatada em um valor de data do Analytics. É abreviação de "Unicode to Date".

WORKDAY( )

Retorna o número de dias úteis entre duas datas.

YEAR( )

Extrai o ano de uma data ou datahora específica e retorna como valor numérico usando o formato AAAA.

Financeiro

Função Descrição

CUMIPMT( )

Retorna os juros cumulativos pagos de um empréstimo durante um intervalo de períodos.

CUMPRINC( )

Retorna o principal cumulativo pago de um empréstimo durante um intervalo de períodos.

EFFECTIVE( )

Retorna a taxa de juros efetiva anual de um empréstimo.

FVANNUITY( )

Retorna o valor futuro de uma série de pagamentos, calculado usando uma taxa de juros constante. O valor futuro é a soma dos pagamentos mais os juros compostos acumulados.

FVLUMPSUM( )

Retorna o valor futuro de um valor de um único pagamento atual, calculado usando uma taxa de juros constante.

FVSCHEDULE( )

Retorna o valor futuro de um valor de um único pagamento atual, calculado usando uma série de taxas de juros.

IPMT( )

Retorna os juros pagos em um empréstimo para um único período.

NOMINAL( )

Retorna a taxa de juros nominal anual de um empréstimo.

NPER( )

Retorna o número dos períodos necessários para liquidar um empréstimo.

PMT( )

Retorna o tamanho dos pagamentos periódicos (principal + juros) necessários para liquidar um empréstimo.

PPMT( )

Retorna o principal pago em um empréstimo para um único período.

PVANNUITY( )

Retorna o valor presente de uma série de pagamentos futuros, calculado usando uma taxa de juros constante. O valor presente é o valor atual para um único pagamento.

PVLUMPSUM( )

Retorna o valor presente necessário para gerar o valor de um único pagamento futuro calculado usando uma taxa de juros contínua. O valor presente é o valor atual para um único pagamento.

RATE( )

Retorna a taxa de juros por período.

Campo e registro

Função Descrição

FTYPE( )

Retorna um caractere identificando a categoria de dados de um campo ou variável, ou o tipo de um item do projeto do Analytics.

HASH( )

Retorna um hash criptográfico originado baseado no valor de entrada.

ISDEFINED( )

Retorna T (verdadeiro) se o campo ou variável especificado for definido, caso contrário, retorna F (falso).

OFFSET( )

Retorna o valor de um campo com a posição inicial deslocada por um número especificado de bytes.

RECLEN( )

Retorna o comprimento do registro atual.

RECNO( )

Retorna o número do registro atual.

RECOFFSET( )

Retorna o valor de um campo de um registro que está a um número especificado de registros a partir do registro atual.

VERIFY( )

Retorna um valor lógico que indica se os dados no campo de dados físicos são válidos.

Tabela, arquivo e projeto

Função Descrição

FILESIZE( )

Retorna o tamanho do arquivo especificado em bytes, ou -1, caso o arquivo não exista.

FTYPE( )

Retorna um caractere identificando a categoria de dados de um campo ou variável, ou o tipo de um item do projeto do Analytics.

GETOPTIONS( )

Retorna a configuração atual para a opção do Analytics especificada (configuração da caixa de diálogo Opções).

PROPERTIES( )

Retorna informações sobre as propriedades do item do projeto do Analytics especificado.

Teste de variável

Função Descrição

FTYPE( )

Retorna um caractere identificando a categoria de dados de um campo ou variável, ou o tipo de um item do projeto do Analytics.

ISDEFINED( )

Retorna T (verdadeiro) se o campo ou variável especificado for definido, caso contrário, retorna F (falso).

Python

Função Descrição
PYDATE( )

Retorna um valor de data calculado por uma função em um script do Python externo. O processamento de dados no Python é externo ao Analytics.

PYDATETIME( )

Retorna um valor de datahora calculado por uma função em um script do Python externo. O processamento de dados no Python é externo ao Analytics.

PYLOGICAL( )

Retorna um valor lógico calculado por uma função em um script do Python externo. O processamento de dados no Python é externo ao Analytics.

PYNUMERIC( )

Retorna um valor numérico calculado por uma função em um script do Python externo. O processamento de dados no Python é externo ao Analytics.

PYSTRING( )

Retorna um valor de caracteres calculado por uma função em um script do Python externo. O processamento de dados no Python é externo ao Analytics.

PYTIME( )

Retorna um valor de hora calculado por uma função em um script do Python externo. O processamento de dados no Python é externo ao Analytics.

R

Função Descrição
RDATE( )

Retorna um valor de data calculado por uma função ou script do R. O processamento de dados no R é externo ao Analytics.

RDATETIME( )

Retorna um valor de datahora calculado por uma função ou script do R. O processamento de dados no R é externo ao Analytics.

RLOGICAL( )

Retorna um valor lógico calculado por uma função ou script do R. O processamento de dados no R é externo ao Analytics.

RNUMERIC( )

Retorna um valor numérico calculado por uma função ou script do R. O processamento de dados no R é externo ao Analytics.

RSTRING( )

Retorna um valor de cadeia calculado por uma função ou script do R. O processamento de dados no R é externo ao Analytics.

RTIME( )

Retorna um valor de hora calculado por uma função ou script do R. O processamento de dados no R é externo ao Analytics.

Codificação de bits e caracteres

Função Descrição

ASCII( )

Retorna o código ASCII de um caractere especificado.

BIT( )

Retorna a representação binária para a posição de byte especificada no registro atual como uma cadeia de oito caracteres.

BYTE( )

Retorna o caractere armazenado numa determinada posição no byte do registro atual.

CHR( )

Retorna o caractere associado ao código ASCII especificado.

DBYTE( )

Retorna o caractere Unicode localizado em uma posição determinada de byte em um registro.

DHEX( )

Converte uma cadeia Unicode em formato hexadecimal.

DIGIT( )

Retorna o dígito superior ou inferior de um byte de tipo de dados Packed (Compactado).

HEX( )

Converte uma cadeia ASCII em uma cadeia hexadecimal.

HTOU( )

Converte uma string hexadecimal em formato Unicode. Abreviação de "Hexadecimal para Unicode".

MASK( )

Executa uma operação AND de bits nos primeiros bytes de duas cadeias de caracteres.

SHIFT( )

Retorna uma cadeia de caracteres única, com os bits do primeiro caractere do valor de entrada deslocados para a esquerda ou direita.

Convenções de sintaxe da função

Convenção

Descrição

parênteses ( )
  • Valores de entrada de função devem ser colocados entre parênteses:

    ALLTRIM(Nome_Fornecedor)
  • O parêntese de abertura deve seguir imediatamente o nome da função, sem espaços:

    ALLTRIM(Nome_Fornecedor)

    e não:

    ALLTRIM (Nome_Fornecedor)
  • Parênteses devem ser usados mesmo que nenhum valor de entrada seja especificado:

    RECNO( )
separadores
  • Valores de entrada de função devem ser separados por um caractere separador:

    SUBSTRING(ID_Produto;5;12)
  • Os caracteres separadores são espaço em branco, vírgula ou ponto e vírgula.

    O separador vírgula ou ponto e vírgula deve ser especificado na opção Separador de Lista na guia Numérico na caixa de diálogo Opções.

Dica

Para melhor legibilidade, você pode usar um espaço em branco e um dos outros caracteres separadores:

SUBSTRING(ID_produto; 5; 12)
qualificadores
  • Os valores de caracteres literais devem estar entre apóstrofos ou aspas:

    EXCLUDE(ID_produto; "#-")
  • Os valores datahora literais devem estar entre apóstrofos invertidos:

    AGE(Data_vencimento; `20141231`)
  • Valores numéricos não usam qualificadores:

    ABS(-7.2)
  • Valores lógicos (T/F) não usam qualificadores:

    LEVDIST(Nome_Fornecedor; Nome_Fornecedor_2; F)
  • Nenhum qualificador é usado com nomes de campos:

    ALLTRIM(Nome_Fornecedor)
formato de datahora literal
  • Valores de data literais devem ser inseridos em formato AAAAMMDD ou AAMMDD:
    • `20141231`
    • `141231`
  • Valores literais devem ser inseridos no formato hhmmss ou hhmm e precedidos por espaço, T ou t:
    • `t235959`
    • `20141231 2359`

Abreviando nomes de funções

Cuidado

A ACL recomenda que você não abrevie nomes de funções em campos calculados, expressões ou scripts e use a versão completa de cada nome.

A abreviação dificulta a leitura e a compreensão dos campos calculados, expressões ou scripts. Sem nomes completos das funções, fica mais difícil pesquisar comandos na ajuda on-line.

A abreviação é particularmente problemática se os projetos ou scripts do Analytics serão modificados ou herdados por outra pessoa que pode não estar familiarizada com as abreviações.

Ao especificar funções em campos calculados, expressões ou scripts, você pode abreviar seus nomes. Você deve incluir caracteres à esquerda suficientes em um nome de função para identificá-la unicamente entre todas as funções do Analytics.

Por exemplo:

  • MAX identifica unicamente a função MAXIMUM e, portanto, é uma abreviação válida.
  • MA não identifica unicamente a função MAXIMUM e gera uma mensagem de erro.

As abreviações podem ser bastante curtas, desde que identifiquem unicamente a função.

Por exemplo, todas as abreviações a seguir da função ALLTRIM são válidas:

  • ALLTR
  • ALLT
  • ALL
  • AL

Nota

Abreviações mais curtas dificultam o reconhecimento por outras pessoas.

Convenções de documentação de funções

Convenção

Usada para:

MAIÚSCULAS

O nome da função do Script do ACL.

Nota

Em toda a documentação do Analytics, os nomes de função são apresentados em maiúsculas. Isso é apenas uma convenção de formatação. O Analytics não exige que as funções sejam inseridas em maiúsculas.

itálico

Parâmetros de função fornecidos pelo usuário.

|

(barra vertical)

Separa itens de sintaxe entre chevrons ou chaves. Você só pode usar um dos itens.

< >

(chevrons)

Itens de sintaxe opcionais. Não digite os chevrons.

{ }

(chaves)

Itens de sintaxe obrigatórios. Não digite as chaves.

<;...n>

Indica que o item anterior pode ser repetido n vezes. As ocorrências são separadas por ponto e vírgula.

Termos de tipos de dados usados na documentação das funções

Os termos a seguir são usados para identificar o tipo de dado dos argumentos e parâmetros da função e retornam valores:

Termo

Significa que você pode usar:

Caractere Qualquer nome de campo, expressão ou variável que pertence à categoria Caractere (C) do Analytics ou um literal de cadeia
Numérico Qualquer nome de campo, expressão ou variável que pertence à categoria de dados Numérico (N) do Analytics ou um valor numérico
Datahora Qualquer nome de campo, expressão ou variável que pertence à categoria Datahora (D) do Analytics ou um literal de datahora
Lógico Qualquer nome de campo, expressão ou variável que pertence à categoria de dados Lógico (L) do Analytics ou um valor lógico
Campo O nome de um campo de qualquer categoria de dados do Analytics