# CMS: usar expressões do CMS para manipular strings de texto

Source: https://support.wix.com/pt/article/cms-usar-express%C3%B5es-do-cms-para-manipular-strings-de-texto (updated 2026-11-12)
Related: Wix developer documentation, https://dev.wix.com/docs/llms.txt; Help Center index, https://support.wix.com/en/llms.txt

Use expressões do CMS para desbloquear todo o potencial do seu CMS sem usar o Velo ou o código JS.

 As expressões permitem combinar texto estático com valores dinâmicos de vários campos de coleção em uma única string de texto. Aplique formatação a datas, horários e números dinâmicos para exibi-los conforme necessário. Construa equações matemáticas que usam campos numéricos em seus cálculos. Você pode até combinar funções na mesma expressão para desbloquear infinitas possibilidades.

![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/10/20/87851581-aedf-4eda-9da3-a7b9e6e4c3cb/62bcb248-ff35-473e-932b-ecbc84ee6e47.png)

> Para ter uma visão geral desse processo, confira nosso [vídeo Ultimate CMS Guide](https://youtu.be/S2AgB6wGnk4?t=1082&si=8UMbKTpQiqVStyMv).

---

## Sobre as funções de expressão do CMS

Uma expressão do CMS combina funções, valores textuais e valores de campo de coleção para apresentar dados no seu site de novas maneiras. 

  
 Após [conectar um elemento de página compatível a um conjunto de dados](https://support.wix.com/pt/article/cms-conectar-elementos-a-uma-coleção-usando-um-conjunto-de-dados), você pode conectar seus valores de texto a uma expressão do CMS. Depois você pode criar uma expressão que consiste em funções, IDs de campo, strings, números e outra sintaxe. O texto no elemento conectado exibe os resultados do cálculo da expressão.

### As expressões consistem na seguinte estrutura:

* **Funções:** definem como calcular os valores que aparecem entre parênteses após a função, com valores separados por vírgulas (por exemplo: **MULTIPLY(price, count)**, **DAYS(\_createdDate, NOW())**, **CONCAT("Created on ", \_created Date))**.
* **IDs de campo:** os identificadores exclusivos de cada campo da coleção (por exemplo: **title**, **\_createdDate**, **clientName**).
* **Strings:** uma sequência de caracteres que pode incluir letras, números, símbolos e espaços.  
   * **Literais de string:** uma sequência de caracteres entre aspas usadas para mostrar texto estático (por exemplo: **"Olá"**, **'Olá'**, **'"Errata" de Bruno Costa'**, **"\\"Errata\\" de Bruno Costa"**, **"barra invertida é \\\\, barra é /"**).  
   * **Literais numéricos:** valores numéricos usados pela função (por exemplo: **123**, **1000**, **3.14**).  
   * **Literais de array:** uma forma de expressar um array, que é uma coleção ordenada de valores, normalmente do mesmo tipo, entre colchetes (por exemplo: **\[1,2,3\]**, **\["gato", "cachorro", "rato"\]**).
* **Constantes especiais:** valores predefinidos que têm um significado específico dentro do escopo da função (por exemplo: **true**, **false**, **undefined**, **null**).

Lembre-se de que as expressões diferenciam maiúsculas de minúsculas. Ao usar campos dentro de expressões, use IDs de campo em vez de nomes de campo e lembre-se de que os IDs de campo também diferenciam maiúsculas de minúsculas.

  
 À medida que você digita suas expressões, você recebe sugestões para ajudar você a usar corretamente as funções e os IDs do campo. Para facilitar a visualização dos IDs do campo no seu editor, [ative o modo avançado](https://dev.wix.com/docs/develop-websites/articles/getting-started/resources/getting-started-with-velo-by-wix).

> **Informações importantes sobre como escrever expressões:**
>
> * Insira IDs de campo em vez de nomes de campo ao referenciar campos de coleção. Os IDs de campo são identificadores exclusivos para cada campo de coleção, ao contrário dos nomes de campo.
> * Funções e IDs de campo diferenciam maiúsculas de minúsculas. Preste atenção na primeira letra usada em ambos.
> * Para funções **CONCAT**, coloque os valores de literais de string "estáticos" entre aspas. Isso inclui sinais de pontuação estáticos e espaços entre campos referenciados.
> * Se a função não funcionar, verifique a mensagem de erro na parte inferior do campo **Expressão** para obter dicas de como corrigir o problema.

---

## Conectar elementos a expressões no conjunto de dados

Para começar, conecte o elemento relevante ao CMS e escolha a opção Conexão de expressão. Em seguida, insira a expressão que deseja usar. Veja as próximas seções para obter ajuda na criação da sua expressão.

**Editor Wix:**

1. No seu Editor, clique no elemento que você deseja conectar ao CMS (por exemplo: texto, botão, galeria).
2. Clique no ícone Conectar ao CMS ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/06/16/2d484f5d-e1bf-4d48-9e42-82216e8b88de/08e74518-edad-42f8-b007-c974ba767eb6.png).
3. Clique no dropdown **Escolha um conjunto de dados** e selecione um conjunto de dados existente que se conecte à sua coleção. Se preferir, clique em **Criar um novo conjunto de dados** e escolha a coleção que deseja conectar.
4. Clique no dropdown relevante em **Opções de conexão** e selecione **Expressão**.

![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/10/16/8ed50326-9354-4ee4-9f31-4a2704a136db/159945a6-121e-469a-ae64-a85ef6e8af8e.png)

1. Clique no campo **Expressão**.
2. Insira o nome da função que você deseja usar (por exemplo: **CONCAT**, **DATE**, **TEXT**, **PRICE**).  
**Dica:** depois de começar a digitar, você pode selecionar em uma lista de funções possíveis de usar.

![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/10/16/fb769bab-d400-4b74-95a3-32f98915e35e/5af6d198-1c6c-4949-9a44-4c2d6b40517e.png)

1. Insira um parêntese de abertura: **(**
2. Insira os IDs ou valores do campo que deseja usar na expressão. À medida que você digita, uma lista de IDs de campo correspondentes aparece para você selecionar.
3. Insira um parêntese de fechamento: **)**

![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/12/05/17d5cee4-f94b-4010-9b47-f7180719a1a4/71e8f536-8b34-4b5f-b35b-fada5f17caaa.png)

**Editor do Wix Studio:**

1. No seu Editor, clique no elemento que você deseja conectar ao CMS (por exemplo: texto, botão, galeria).
2. Clique no ícone Conectar ao CMS ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/06/16/2d484f5d-e1bf-4d48-9e42-82216e8b88de/08e74518-edad-42f8-b007-c974ba767eb6.png).
3. Clique no dropdown **Escolha um conjunto de dados** e selecione um conjunto de dados existente que se conecte à sua coleção. Se preferir, clique em **Criar um novo conjunto de dados** e escolha a coleção que deseja conectar.
4. Clique no dropdown relevante em **Opções de conexão** e selecione **Expressão**.

![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/10/20/10f54333-cfdd-4341-a4e6-647f8397cfee/0bcabbee-9976-46e9-96f6-30cc80ec7d4e.png)

1. Clique no campo **Expressão**.
2. Insira a primeira parte da função (por exemplo **CONCAT**, **DATE**, **TEXT**, **PRICE**).  
**Dica:** depois de começar a digitar, você pode selecionar em uma lista de fórmulas possíveis de usar.

![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/10/20/b0d98587-856c-45f8-ad80-3a1cb8b16280/7680345d-4ba7-4d03-aa7d-5f6a7cb7a95d.png)

1. Insira um parêntese de abertura: **(**
2. Insira os IDs ou valores do campo que deseja usar na expressão. À medida que você digita, uma lista de IDs de campo correspondentes aparece para você selecionar.
3. Insira um parêntese de fechamento: **)**

![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/10/20/056d9ec3-d628-487d-bdbd-58ac70a8b71a/b395fa51-4571-4de4-9ac2-57d84290ab04.png)

---

## Exemplos de expressão

Confira os exemplos para escrever diferentes tipos de expressões nas seções a seguir.

## Combinar valores de vários campos usando concatenação de strings

Use a função **CONCAT** para combinar valores de vários campos de coleção diferentes em um único campo de texto. Adicione seu próprio texto à função para combinar caracteres estáticos com valores dinâmicos. Os caracteres estáticos não mudam, enquanto os valores dinâmicos mudam com base no item recuperado pelo conjunto de dados. Certifique-se de colocar todo o texto estático entre aspas, incluindo espaços e sinais de pontuação (por exemplo: **" "** ou **","**).

 Você pode usar diferentes funções para fazer coisas semelhantes e também pode combinar funções dentro de funções para tarefas mais avançadas. Se houver um problema com a expressão, verifique a mensagem de erro para obter dicas sobre como resolvê-lo.

Um exemplo de uso da função **CONCAT** é criar um texto personalizado para a introdução de uma página dinâmica de item. O texto pode apresentar cada membro pelo nome, mencionar seu cargo e há quanto tempo ele está na empresa. Veja como essa expressão ficaria:

```html
CONCAT("Nosso ",jobTitle,", ",title,", trabalha aqui desde ",date,".")
```

> **Neste exemplo:** O ID do campo **jobTitle** representa o campo da coleção com o cargo de cada membro. O ID do campo de **title** é para o campo com os nomes de cada membro. A chave **hireDate** é de um campo com a data de início do funcionário de cada membro. Observe como todo o texto estático e a pontuação estão entre aspas.

![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/12/05/d7ed6d5b-ba7c-4405-aa3c-4fb193143379/ea71f8e5-2992-45f0-8a64-2a670a9194a5.png)

**Confira como combinar funções e exibir o ano sem o mês ou dia**

Nesse exemplo básico da função **CONCAT** acima, os meses e dias são exibidos. Isso ocorre porque a função faz referência a um campo de data que as inclui.

  
 Para formatar a data de forma diferente, pode ser que você precise combinar outra função na expressão. Por exemplo, você pode adicionar a função **YEAR** antes da chave **hireDate** para exibir apenas o ano a partir do campo de data. A expressão ficaria assim: 

  
 CONCAT("Nosso ",jobTitle,", ",title,", trabalha aqui desde ",YEAR(hireDate),".")

![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/12/05/e8c20893-5225-4f0d-8a91-44ba737dc5a3/00dd1a22-5b44-49a1-a5a4-94ed9679ddd1.png) 

  
 Veja opções adicionais na [seção de formatação de data e horário abaixo](https://support.wix.com/pt/article/cms-usar-expressões-do-cms-para-manipular-strings-de-texto#datetime-formatting).

**Confira a tabela abaixo para mais exemplos básicos de uso da função CONCAT:**

| Caso de uso | Expressão | Exemplo | Resultado |
| --- | --- | --- | --- |
| Combinar valores de campo sem espaços ou pontuação | CONCAT(value,value) | CONCAT(title,jobTitle) | Gabriel CardosoVP Produto |
| Combinar valores de campo separados por uma vírgula e um espaço | CONCAT(value,", ",value) | CONCAT(title,", ",jobTitle) | Gabriel Cardoso, VP Produto |
| Combinar texto estático com valores de campo | CONCAT("Olá, ",value) | CONCAT("Olá, ",title) | Olá, Gabriel Cardoso |
| Combine valores de campo com texto estático no início e no final | CONCAT("Olá, ",value,", bem-vindo.") | CONCAT("Olá, ",title,", bem-vindo.") | Olá, Gabriel Cardoso, bem-vindo. |

---

## Formatação de data/horário

Quando você quiser controlar como as datas e horários são formatados no seu site online ou calcular valores a partir de datas, use as funções de data/horário. Essas funções funcionam com os tipos de campo Data, Horário e Número.

![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/12/05/22212665-be31-4cd0-8e7f-fb4e4a340660/b1f0db6b-3a05-4bd2-9277-7c2af2002103.png)

> **No exemplo acima:** A função **DAYS** retorna o número de dias entre um campo dinâmico **dueDate** e a data de hoje. Observe como ele combina a função **DAYS** com a função **TODAY**, assim como a função **CONCAT** usada para mesclar texto estático e dinâmico.

**Clique na função relevante abaixo para saber mais sobre ela:**

**DATE**

Use a função **DATE** quando quiser combinar vários tipos de campos numéricos para exibir em um formato de data/horário. 

  
* **Expressão:** DATE(year,month,date)
* **Exemplo:** DATE(year,month,date)
* **Resultados:** dom. 08 de julho de 2008 00:00:00 GMT-0700 (Hora padrão do Pacífico)

**DATEVALUE**

Use a função **DATEVALUE** quando quiser exibir um tipo de campo Texto em um formato de data/hora.

  
* **Expressão:** DATEVALUE(date\_string)
* **Exemplo:** DATEVALUE(textDate)
* **Resultado:** seg. 22 de agosto de 2011 00:00:00 GMT-0700 (Hora padrão do Pacífico)

**YEAR**

Use a função **YEAR** quando quiser exibir apenas o ano em um tipo de campo Data.

  
* **Expressão:** YEAR(date)
* **Exemplo:** YEAR(\_createdDate)
* **Resultado:** 2008

**MONTH**

Use a função **MONTH** quando quiser exibir apenas o mês em um tipo de campo Data. O mês é exibido em um formato numérico de 1 a 12 (por exemplo: "1" para janeiro). 

  
* **Expressão:** MONTH(date)
* **Exemplo:** MONTH(\_createdDate)
* **Resultado:** 2

**DAY**

Use a função **DAY** quando quiser exibir apenas o dia em um tipo de campo Data. O dia é exibido como um número de 1 a 31\. 

  
* **Expressão:** DAY(date)
* **Exemplo:** DAY(\_createdDate)
* **Resultado:** 2

**HOUR**

Use a função **HOUR** quando quiser exibir apenas a hora em um campo do tipo Data. A hora é exibida em formato numérico de 0 (12:00am) a 23 (11:00pm). Se o campo Data não incluir um horário, o resultado será 0.

  
* **Expressão:** HOUR(time)
* **Exemplo:** HOUR(\_createdDate)
* **Resultado:** 2

**MINUTE**

Use a função **MINUTE** quando quiser exibir apenas o minuto em um tipo de campo Data. O minuto é exibido em formato numérico de 0 a 59.

  
* **Expressão:** MINUTE(time)
* **Exemplo:** MINUTE(\_createdDate)
* **Resultado:** 30

**SECOND**

Utilize a função **SECOND** quando quiser exibir apenas os segundos em um tipo de campo Data. Os segundos são exibidos em formato numérico de 0 a 59.

  
* **Expressão:** SECOND(time)
* **Exemplo:** SECOND(\_createdDate)
* **Resultado:** 23

**DAYS**

Use a função **DAYS** quando quiser calcular o número de dias entre duas datas de tipos de campo de data separados. 

  
* **Expressão:** DAYS(end\_date,start\_date)
* **Exemplo:** DAYS(\_createdDate,\_updatedDate)
* **Resultado:** 46

**DAYS360**

Use a função **DAYS360** quando quiser calcular o número de dias entre duas datas, com base em um ano de 360 dias (12 meses x 30 dias). Essa função funciona com tipos de campo de data e pode ser útil para muitos cálculos de juros contábeis e financeiros.

  
* **Expressão:** DAYS360(start\_date,end\_date)
* **Exemplo:** DAYS360(\_createdDate,\_updatedDate)
* **Resultado:** 360

**EDATE**

Use a função **EDATE** quando quiser calcular o número de meses antes ou depois de outra data. Essa função funciona com os tipos de campo Data. 

  
* **Expressão:** EDATE(start\_date,months)
* **Exemplo:** EDATE(\_createdDate,\_updatedDate)
* **Resultado:** 3

**EOMONTH**

Use a função **EOMONTH** quando quiser calcular uma data de expiração/vencimento que cai no último dia de um mês. Dentro dos parênteses, insira o campo de data, seguido pelo número de meses antes ou depois da data. Use um valor positivo para calcular datas futuras ou um valor negativo para datas passadas. Essa função funciona com os tipos de campo Data. 

  
* **Expressão:** EDATE(start\_date,months)
* **Exemplo:** EDATE(\_createdDate,\_updatedDate)
* **Resultado:** ter. 31 de out. de 2023 00:00:00 GMT-0700 (Horário de verão do Pacífico)

**NETWORKDAYS**

Use a função **NETWORKDAYS** quando quiser calcular o número de dias úteis, excluindo fins de semana e feriados, entre dois campos de Data. Dentro dos parênteses, insira as datas de início e término, seguidas das datas de feriados que você deseja excluir do total. 

  
* **Expressão:** NETWORKDAYS(start\_date,end\_date,\[holidays\])
* **Exemplo:** NETWORKDAYS(start\_date,end\_date,\['11/23/2023','11/24/2023'\])
* **Resultado:** 87

**NETWORKDAYSINTL**

Use a função **NETWORKDAYSINTL** quando desejar calcular o número de dias úteis entre duas datas e especificar quais finais de semana e feriados serão excluídos. Dentro dos parênteses, insira as datas de início e término, seguidas pelo número ou string do fim de semana e datas de feriado que você deseja excluir do total. 

  
 Você pode usar o método string ou number ao definir os fins de semana:

* **String:** use sete 0s e 1s para especificar fins de semana. O primeiro número no conjunto representa segunda-feira e o último número é domingo. Zero representa um dia útil e 1 indica um fim de semana. Por exemplo, 0000011 define sábados e domingos no período como fins de semana.
* **Número:** use um único número para indicar os fins de semana. Exemplos para esse padrão incluem:  
   * 1 representa fins de semana com sábado/domingo  
   * 2 representa fins de semana com domingo/segunda-feira  
   * 7 representa fins de semana com sexta-feira/sábado  
   * 11 representa domingo como o único dia do fim do semana  
   * 12 representa segunda-feira como o único dia do fim do semana  
   * 17 representa sábado como o único dia do fim do semana

  
* **Expressão:** NETWORKDAYSINTL(start\_date,end\_date,\[weekend\],\[holidays\])
* **Exemplo:** NETWORKDAYSINTL(start\_date,end\_date,7,\['11/23/2023','11/24/2023'\])
* **Resultado:** 64

**NOW**

Use a função **NOW** quando quiser exibir a data e hora atuais. 

  
* **Expressão:** NOW()
* **Exemplo:** NOW()
* **Resultado:** qui 20 de fev. de 2020 23:02:55 GMT+0100 (Horário Padrão da Europa Central)

**TODAY**

Use a função **TODAY** quando quiser exibir a data do dia atual e a hora em que o dia começou (meia-noite 00:00:00 \[fuso horário\]). 

  
* **Expressão:** TODAY()
* **Exemplo:** TODAY()
* **Resultado:** qua 18 de out. de 2023 00:00:00 GMT-0700 (Horário de Verão do Pacífico)

  
**Observação:** se você quiser mostrar a data de hoje sem a hora, use a seguinte função **CONCAT**: CONCAT(YEAR(TODAY()), '-', MONTH(TODAY()), '-', DAY(TODAY()))

**TIME**

Use a função **TIME** quando quiser converter um valor de hora, minuto e segundo para um valor decimal entre 0 e 0,999988426.

  
* **Expressão:** TIME(hour,minute,second)
* **Exemplo:** TIME(number, number2, number3)
* **Resultado:** 0,120555555

**TIMEVALUE**

Use a função **TIMEVALUE** quando quiser converter um valor de data em um valor decimal. Por exemplo, 12:00 é representado como 0,5 porque é metade de um dia. 

  
* **Expressão:** TIMEVALUE(time\_string)
* **Exemplo:** TimeValue(\_createdDate)
* **Resultado:** 0,370034722

**WEEKDAY**

Use a função **WEEKDAY** quando quiser converter um valor de data em um número que representa o dia da semana. Por exemplo, por definição, domingo é representado como 1 e sábado como 7\. 

  
 Dentro dos parênteses, insira o valor da data que deseja converter. Você pode adicionar um valor opcional de "tipo" para escolher qual dia é usado para começar a semana. Insira o tipo como "2" para fazer de segunda-feira o início da semana, representado como "1", com domingo representado como "7". Saiba mais sobre como [usar a função WEEKDAY](https://support.microsoft.com/pt-br/office/função-dia-da-semana-60e44483-2ed1-439f-8bd0-e404c190949a). 

  
* **Expressão:** WEEKDAY(date,type\])
* **Exemplo:** WEEKDAY(\_createdDate,2)
* **Resultado:** 3

**ISOWEEKNUM**

Use a função **ISOWEEKNUM** quando quiser mostrar a semana do ano no formato da ISO (Organização Internacional para Padronização) para uma determinada data. Saiba mais sobre a [função ISOWEEKNUM](https://support.microsoft.com/en-us/office/isoweeknum-function-1c2d0afe-d25b-4ab1-8894-8d0520e90e0e).

  
* **Expressão:** ISOWEEKNUM(date)
* **Exemplo:** ISOWEEKNUM(\_createdDate)
* **Resultado:** 42

**WEEKNUM**

Use a função **WEEKNUM** quando quiser mostrar a semana do ano para uma determinada data. Por definição, o "tipo" opcional é definido como 1 para indicar que a semana começa no domingo. Você pode fazer com que a semana comece na segunda-feira definindo "2" como o tipo. Saiba mais sobre como [usar a função WEEKNUM](https://support.microsoft.com/pt-br/office/númsemana-função-númsemana-e5c43a03-b4ab-426c-b411-b18c13c75340).

  
* **Expressão:** WEEKNUM(date, type\])
* **Exemplo:** WEEKNUM(\_createdDate,2)
* **Resultado:** 33

**WORKDAY**

Use a função **WORKDAY** quando quiser mostrar uma data após um número especificado de dias úteis. Dentro dos parênteses, insira a data de início, seguida do número de dias úteis para adicionar (número positivo) ou subtrair (número negativo). Você pode adicionar um intervalo de datas opcional "feriados" para excluir esses dias do cálculo. Saiba mais sobre como [usar a função WORKDAY](https://support.microsoft.com/en-us/office/workday-function-f764a5b7-05fc-4494-9486-60d494efbf33). 

  
* **Expressão:** WORKDAY(start\_date,num\_days)  
 ou
* **Expressão:** WORKDAY(start\_date,num\_days,holidays)
* **Exemplo:** WORKDAY(\_createdDate,3,"2023-12-25","2023-12-26"\])
* **Resultado:** qua 18 de out. de 2023 00:00:00 GMT-0700 (Horário de Verão do Pacífico)

**WORKDAYINTL**

Use a função **WORKDAYINTL** quando quiser mostrar uma data após um número especificado de dias úteis com feriados personalizados e parâmetros de fim de semana. Dentro dos parênteses, insira a data de início, seguida do número de dias úteis para adicionar (número positivo) ou subtrair (número negativo). Você pode adicionar os parâmetros opcionais de fim de semana e feriados para excluir esses dias do cálculo. Saiba mais sobre como [usar a função WORKDAYINTL](https://support.microsoft.com/en-us/office/workday-intl-function-a378391c-9ba7-4678-8a39-39611a9bf81d). 

  
* **Expressão:** WORKDAYINTL(start\_date,num\_days,holidays)
* **Exemplo:** WORKDAYINTL(\_createdDate,3,1,"2023-12-25","2023-12-26"\])
* **Resultado:** qua. 18 de out. de 2023 08:52:51 GMT-0700 (Horário de Verão do Pacífico)

**YEARFRAC**

Use a função **YEARFRAC** quando quiser calcular o número de anos fracionários entre duas datas. Você pode usar uma convenção de contagem de dias opcional no final da expressão. Saiba mais sobre como [trabalhar com a função YEARFRAC](https://support.microsoft.com/en-us/office/yearfrac-function-3844141e-c76d-4143-82b6-208454ddc6a8). 

  
* **Expressão:** YEARFRAC(start\_date,end\_date,day\_count\_convention)
* **Exemplo:** YEARFRAC(\_updatedDate,\_createdDate,1)
* **Resultado:** 0.5780821918

---

## Formatar números com a função TEXT

Use a função **TEXT** para aplicar formatação aos números. Por exemplo, você pode formatar valores de um tipo de campo Número como moeda ou porcentagem.

![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/10/20/fad63bb2-7846-4b2b-81b1-a5700ae9e8d1/9d689888-ee4a-41d5-964a-373d81c21fc4.png)

> **No exemplo acima:** A função **TEXT** formata um tipo de campo Número (**preço**) como um valor em dólares. Observe como a função **TEXT** é inserida dentro de uma função **CONCAT**, que adiciona o texto estático antes do preço.

**Clique abaixo para ver exemplos de uso da função TEXT:**

**Converter um número para um formato de moeda**

Use a função **TEXT** com um formato padrão entre aspas ("") para converter um campo Número em um formato de moeda. Você pode usar a expressão abaixo para converter um número em um formato de moeda com um separador de milhares e duas decimais (por exemplo: $ 1.234,57).

  
* **Expressão:** TEXT(value,"$#,##0.00")
* **Exemplo:** TEXT(9876.54,"$#,##0.00")
* **Resultado:** $9876,54

  
![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/10/18/649446db-2a2a-4c17-bdaf-06c6caf8b39e/923f0761-bff6-4c1e-8947-ce88b70cb6a5.png)

**Converter um número para um formato de porcentagem (%)**

Use a função **TEXT** com um formato padrão entre aspas ("") para converter um campo Número em uma porcentagem. 

  
* **Expressão::** TEXT(value,"0.0%")
* **Exemplo:** TEXT(3.21,"0.0%")
* **Resultado:** 321.00%

  
![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/10/18/3c1bbbe7-0644-480e-b79c-fb5e6df3c6b7/0a017e49-4c6f-4da4-ab1a-bf72a17583af.png)

---

## Exibir preços com a função PRICE

Use a função PRICE para exibir o valor do campo "Número" como um preço formatado usando a moeda do seu site. Essa é a maneira mais rápida de mostrar preços com o símbolo de moeda e a formatação corretos, sem precisar de strings de padrão ou funções adicionais.

  
 A função PRICE funciona com campos de número em coleções criadas pelos usuários, incluindo [coleções de catálogo](https://support.wix.com/pt/article/cms-vender-itens-de-coleções-do-catálogo). Ela não funciona com [coleções de apps do Wix,](https://support.wix.com/pt/article/cms-antigo-gerenciador-de-dados-trabalhar-com-coleções-de-aplicativos-wix) como Wix Stores ou Wix Bookings.

![Captura de tela da expressão price sendo usada em uma conexão do conjunto de dados.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2026/05/13/ae52db1b-1729-424b-8e0e-8a4853358eb4/4d743012-2ea5-47d6-9d96-28ff7578f4ec.png)

> **No exemplo acima:** A função **PRICE** pega o campo de **preço** da coleção e o exibe como **R$ 85,00**, formatado com a moeda do site.

**Clique abaixo para obter detalhes sobre como usar a função PRICE:**

**Usar a função PRICE**

Use a função **PRICE** quando quiser exibir um valor do campo "Número" formatado como um preço com o símbolo da moeda do site. A função aplica automaticamente o formato de moeda com base nas [configurações de moeda do seu site](https://support.wix.com/pt/article/configurar-sua-moeda-para-aceitar-pagamentos).

* **Expressão:** PRICE(fieldName)
* **Exemplo:** PRICE(price)
* **Resultados:** R$ 85,00

**Usar PRICE com CONCAT**

Você pode combinar a função **PRICE** com **CONCAT** para adicionar contexto ao preço formatado. Por exemplo, para exibir "Apenas R$ 85,00 por item" no seu site:

* **Expressão:** CONCAT("Apenas ", PRICE(price), " por item")
* **Exemplo de resultado:** Apenas R$ 85,00 por item

**Qual é a diferença de PRICE e o uso da função TEXT para formatação de moeda?**

A função **PRICE** usa automaticamente o símbolo de moeda e a formatação do seu site. Com a função **TEXT**, você precisa definir manualmente o padrão da moeda (por exemplo: TEXT(price,"R$#,##0,00")). Use **PRICE** quando quiser que a formatação corresponda automaticamente às configurações de moeda do seu site.

---

## Funções matemáticas

Você pode usar funções matemáticas para executar cálculos com base em diferentes tipos de campo numérico e/ou números estáticos.

![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/10/20/5f98210b-c451-4853-a56f-9ee1862f9ff2/a5d7470e-d14f-4496-b05f-d33d690e75b8.png)

> **No exemplo acima:** A função **MINUS** calcula 20-11=9\. O valor 20 é estático, enquanto o valor do campo Número (**rewardPoints**) é dinâmico. Observe como a expressão insere a função **MINUS** dentro da função **CONCAT**, combinando o texto estático com valores dinâmicos.

**Confira a tabela abaixo para mais exemplos de uso de expressões matemáticas:**

| Caso de uso | Expressão | Exemplos | Resultados |
| --- | --- | --- | --- |
| Calcula a soma de 2 números | ADD(value,value) | ADD(number1,number2)       ADD(4,20) | 24 |
| Calcula a diferença entre 2 números | MINUS(value,value) | MINUS(number1,number2)       MINUS(100,1) | 99 |
| Calcula a multiplicação de 2 números | MULTIPLY(value,value) | MULTIPLY(number1,number2)       MULTIPLY(2,4) | 6 |
| Calcula 1 número dividido por outro | DIVIDE(value,value) | DIVIDE(number1,number2)       DIVIDE(10,2) | 5 |
| Retorna "true" se 2 valores forem iguais e "false" caso contrário | EQ(value,value) | EQ(number1,number2)       EQ(200,200) | true |
| Eleva um número ('x') à potência de outro número ('y') | POW(x,y) | POW(2,3)  POW(3,3) | 8  27 |
| Verifica se dois valores são iguais | EQ (Igual) | EQ(5,5) | true |
| Verifica se dois valores não são iguais | NE (Não igual) | NE(5,7) | true |
| Verifica se um valor é maior que outro | GB (Maior que) | GT(7,5)     GT(7,7) | true     false |
| Verifica se um valor é menor que outro | LT (Menor que) | LT(5,7)     LT(7,5) | true     false |
| Verifica se um valor é maior ou igual a outro | GTE (Maior que ou igual a) | GTE(7,5)     GTE(5,5)     GTE(5,4) | true    true     false |
| Verifica se um valor é menor ou igual a outro | LTE (Menor que ou igual) | LTE(5,7)     LTE(5,5)     LTE(5,4) | true     true     false |

---

## Perguntas frequentes

Clique abaixo para obter respostas a perguntas comuns sobre o uso de expressões.

**Com quais elementos posso usar expressões?**

Você pode usar expressões com quaisquer elementos que tenham valores de texto que você pode conectar aos campos de coleção do CMS. Por exemplo, caixas de texto, etiquetas de botão ou títulos, descrições e alt text nas galerias. Você pode até conectar imagens a expressões e escrever funções que calculam os URLs das imagens. Saiba mais sobre os [elementos compatíveis e os campos de coleção aos quais eles podem se conectar](https://support.wix.com/pt/article/cms-antigo-gerenciador-de-dados-elementos-e-os-campos-da-coleção-aos-quais-eles-podem-se-conectar).

  
 Se você tiver um elemento de entrada definido para [coletar conteúdo](https://support.wix.com/pt/article/cms-criar-um-formulário-personalizado-com-elementos-de-entrada-que-enviam-para-sua-coleção), que permite que você conecte uma lista de itens, você pode conectá-los a expressões. Por exemplo, você pode usar a função **CONCAT** para adicionar "Dr." antes de uma lista de nomes que aparecem em um elemento de entrada dropdown.

  
![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/12345678-1234-1234-1234-1234567890ab/2023/12/05/b9aff73d-4d3b-43a5-89f7-992501913316/0d80324c-4d19-46b2-aa91-a2068599062a.png)

**Onde encontro os IDs dos campos?**

Você precisa dos IDs dos campos, que são identificadores exclusivos para cada campo de coleção, ao adicionar campos a expressões. 

  
 Para visualizar os IDs dos campos, [ative o Modo avançado](https://dev.wix.com/docs/develop-websites/articles/getting-started/about-velo-by-wix) no seu editor e clique no ícone **Bancos de dados** ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/10/20/5f3a8d76-d780-45d1-9777-cba33a8363d1/58e56fb0-89ec-4778-ab4d-1e9f33c42757.png) no [menu lateral do Velo](https://dev.wix.com/docs/develop-websites/articles/getting-started/about-velo-by-wix). A partir daí, você pode clicar para expandir a coleção relevante e visualizar os IDs dos campos entre parênteses ao lado de cada campo.

  
![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/10/20/4aedcbed-36ed-42f7-8976-65b259ef23ed/af74d8f6-1142-4a3b-8f70-407d0ba663a0.png)
