Lista de funções disponíveis | Central de Ajuda da Zazos

ABS

Retorna valor absoluto de um número, com sinal positivo.

Tipos de entrada: Número

Tipos de saída: Número

ABS(-3) -> 3

AND

Retorna verdadeiro (true) se todos os valores fornecidos forem verdadeiros (true). Caso contrário, retorna falso (false).

Tipos de entrada: Booleano

Tipos de saída: Booleano

AND(true, true) -> true 
AND(true, false) -> false 
AND(false, false) -> false 
AND(true, true, true, true) -> true

ARRAYCOMPACT

Remove os valores nulos (nil) e os textos vazios (’’) de uma coleção, achatando a em um único nível.

Tipos de entrada: Coleção

Tipos de saída: Coleção

:([1, 2, nil, 4, '', 6]) -> [1, 2, 4, 6]
arraycompact(1, 'hello', '', nil, ['world', nil, '!', '']) -> [1, 'hello', 'world', '!']

ARRAYFLATTEN

Achata coleções aninhadas, transformando-os em uma coleção de um único nível.

Tipos de entrada: Coleção

Tipos de saída: Coleção

arrayflatten([1, [2, 3], [4, [5, 6]]]) -> [1, 2, 3, 4, 5, 6]
arrayflatten(1, ['a', 'b'], [['c'], ['d', ['e', 'f']]]) -> [1, 'a', 'b', 'c', 'd', 'e', 'f']

ARRAYJOIN

Retorna um texto concatenando os itens da coleção, usando o segundo argumento como separador. Se nenhum separador for definido, usa "; " como padrão.

Tipos de entrada: Coleção, Texto (opcional)

Tipos de saída: Texto

ARRAYJOIN(@buscar_campo) -> "item1; item2" 
ARRAYJOIN(@buscar_campo, ", ") -> "item1, item2"

ARRAYLEFT

Extrai os primeiros itens de uma coleção. O primeiro argumento corresponde à coleção, e o segundo argumento (opcional) corresponde ao número de itens a serem extraídos. Caso o segundo argumento não seja fornecido, o primeiro item da coleção será retornado.

Primeiro argumento: Coleção da qual os itens serão extraídos. Tipo: Coleção.

Segundo argumento (opcional): Número de itens a extrair. Tipo: Número. Padrão: 1.

Tipo de saída: Coleção

// suponha que @coleção seja um campo de link:
// @coleção -> ['Caio Carvalho', 'Giulia Valente', 'Isabela Rodrigues']
ARRAYLEFT(@coleção) -> 'Caio Carvalho'
ARRAYLEFT(@coleção, 2) -> ['Caio Carvalho', 'Giulia Valente']

ARRAYRIGHT

Extrai os últimos itens de uma coleção. O primeiro argumento corresponde à coleção, e o segundo argumento (opcional) corresponde ao número de itens a serem extraídos. Caso o segundo argumento não seja fornecido, o último item da coleção será retornado.

Primeiro argumento: Coleção da qual os itens serão extraídos. Tipo: Coleção.

Segundo argumento (opcional): Número de itens a extrair. Tipo: Número. Padrão: 1.

Tipo de saída: Coleção

// suponha que @coleção seja um campo de link:
// @coleção -> ['Caio Carvalho', 'Giulia Valente', 'Isabela Rodrigues']
ARRAYRIGHT(@coleção) -> 'Isabela Rodrigues'
ARRAYRIGHT(@coleção, 2) -> ['Giulia Valente', 'Isabela Rodrigues']

ARRAYUNIQUE

Remove valores duplicados de um Buscar Campo ou Referência Encadeada.

Tipos de entrada: Coleção

Tipos de saída: Coleção

// suponha que @buscar_campo tenha os valores [1, 4, 6, 4, 1, 2] 

ARRAYUNIQUE(@buscar_campo) -> [1, 4, 6, 2]

AVERAGE

Retorna a média de uma coleção de números.

Tipos de entrada: Coleção de Números

Tipos de saída: Número

// suponha que @buscar_campo tenha os valores [1, 4, 6, 4, 1, 2] 

AVERAGE(@buscar_campo) -> 3

CEILING

Arredonda um número pra cima. O segundo parâmetro é opcional e indica a quantidade de casas decimais do resultado. Se não for fornecido, o padrão é zero.

Tipos de entrada: Número, Número (opcional)

Tipos de saída: Número

CEILING(1.01) -> 2 
CEILING(1.01, 1) -> 1.1

CONTAINS

Verifica se uma coleção contém algum item, ou se um texto contém outro texto. Caso o primeiro argumento seja uma coleção, o segundo argumento pode ter qualquer tipo exceto coleção (como número, texto, data, etc.). Caso o primeiro argumento seja um texto, o segundo argumento também deverá ser um texto.

Primeiro argumento: Tipo: Coleção ou Texto.

Segundo argumento: Tipo: Qualquer exceto coleção.

Tipo de saída: Booleano

// Suponha que @nomes seja um campo do tipo texto:
// @nomes -> ['Caio', 'Isadora', 'Giulia', 'Silvia']
CONTAINS(@nomes, "Caio") -> true
CONTAINS([0, 2, 3, 5], 2) -> true
CONTAINS('2023Q1', '2023') -> true

CONTAINS([0, 2, 4, 6], 1) -> false

CONTAINSALL

Verifica se uma coleção contém todos os elementos de outra coleção.

Primeiro argumento: Tipo: Coleção.

Segundo argumento: Tipo: Coleção.

Tipo de saída: Booleano.

CONTAINSALL([5, 2, 0, -3, 1], [-3, 0, 1, 2, 5]) -> true
CONTAINSALL([5, 2, 0, -3, 1], [3]) -> false

CONTAINSANY

Verifica se uma coleção contém pelo menos um elemento de outra coleção.

Primeiro argumento: Tipo: Coleção.

Segundo argumento: Tipo: Coleção.

Tipo de saída: Booleano.

CONTAINSANY([5, 2, 0, -3, 1], [1, 10, 11, 15]) -> true
CONTAINSANY(['Caio', 'Isadora', 'Giulia', 'Silvia'], ['Maurício']) -> false

COUNT

Retorna a quantidade de números contidos em uma coleção.

Tipos de entrada: Coleção

Tipos de saída: Número

// suponha que @buscar_campo tenha os valores [1, 4, 6, 4, 1, 2] 

COUNT(@buscar_campo) -> 6 
COUNT(1,19,30,"texto","") -> 3

COUNTA

Similar a COUNT, mas retorna apenas a quantidade de itens não vazios e não nulos contidos em uma coleção.

Tipos de entrada: Coleção

Tipos de saída: Número

COUNTA(1,19,30,"texto","") -> 4

COUNTALL

Similar a COUNT, mas retorna a quantidade de itens contidos em uma coleção, incluindo itens vazios ou nulos.

Tipos de entrada: Coleção

Tipos de saída: Número

COUNTALL(1,19,30,"texto","") -> 5

COUNTIF

Similar a COUNT, mas considera somente os itens que atendam a um dado critério. O critério é definido como um operador (exemplo: >) e um valor de referência (exemplo: 7).

Vale destacar que para operações com textos é necessário encapsular o texto usando barras e aspas (\"). Por exemplo: =\"Ativo\".

Tipos de entrada: Texto, Coleção

Tipos de saída: Número

// suponha que @notas_avaliação tenha valor [8, 7, 9, 5, 3, 10] 
COUNTIF(">7", @notas_avaliação) -> 3

// suponha que @status_avaliações seja ["Em aberto", "Encerrada"]
COUNTIF("=\"Encerrada\"", @status_avaliações) -> 1

Operadores suportados

> maior que
>= maior ou igual a
< menor que
<= menor ou igual a
= igual a
!= diferente de

DATE

Cria um objeto do tipo Data a partir de um texto, ou a partir de um ano, um mês e um dia. Usado em operações como diferença entre datas, soma de data com número de dias, etc.

Primeiro argumento: campo de data (tipo: Data), data no formato ISO (tipo: Texto) ou ano (tipo: Número)

Segundo argumento (opcional): mês (tipo: Número)

Terceiro argumento (opcional): dia (tipo: Número)

Tipo de saída: Data

DATE("2023-10-02") -> "2023-10-02"
DATE(2023, 10, 2) -> "2023-10-02"

// Suponha que @campo_data tenha valor "2023-10-02"
DATE(@campo_data) -> "2023-10-02"

DATE_DIFF

Calcula a diferença entre duas datas.

Primeiro argumento: data mais recente; tipo de entrada: Data

Segundo argumento: data mais antiga; tipo de entrada: Data

Terceiro argumento: formato da resposta; tipo de entrada: Texto

Essa função calcula a diferença (data mais recente) - (data mais antiga) e retorna o resultado no formato indicado pelo terceiro argumento. Ela pode ser usada, por exemplo, em conjunto com a função TODAY para calcular quanto tempo passou desde uma certa data.