> For the complete documentation index, see [llms.txt](https://docs.sprinthub.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sprinthub.com/estrategias/tokens/utilizando-tokens-de-data-e-hora.md).

# Utilizando Tokens de Data e Hora

## Sobre o Tipo do Campo

Na Sprinthub, você pode trabalhar com diversos tokens relacionados a data e hora. Por padrão, os valores de data são armazenados no formato **ISO**, sempre no fuso **UTC** — por exemplo: `2024-10-11T16:12:47.750Z`. No entanto, é possível **formatar essas datas** ou até mesmo gerar **datas relativas**, como veremos ao longo deste artigo.

Além disso, a plataforma permite criar **campos customizados** de **Data e Hora** ou apenas de **Data**, oferecendo flexibilidade para se adaptar às necessidades do seu processo, como mostra o exemplo abaixo:

<figure><img src="/files/NgzAAzqCNYRSfGnOP5WJ" alt=""><figcaption><p><em>Campo 'Aula Experimental' na listagem de campos.</em></p></figcaption></figure>

<figure><img src="/files/MNIW5ghg29NiQdlnx0pv" alt=""><figcaption><p><em>Campo 'Aula Experimental' em dados completos do lead.</em></p></figcaption></figure>

## Formatando Campos do Lead

Para formatar um campo do tipo **Data e Hora**, você pode utilizar diferentes opções de token:

* **\[date]** → exibe apenas dia, mês e ano no formato brasileiro.
* **\[datetime]** → funciona como o `[date]`, mas inclui também as horas.
* **\[yyyy-mm-dd]** → mantém o padrão internacional (ISO 8601).
* **\[yyyy-dd-mm]** → inverte a ordem de dia e mês no padrão de ano primeiro.&#x20;
* **\[unix]** → converte a data para o formato *Unix Timestamp* (total de segundos desde 01/01/1970), ideal para integrações via API ou bancos de dados.
* **\[month]** → extrai apenas o número do mês (01 a 12).
* **\[year]** → extrai apenas o ano com quatro dígitos.
* **\[day]** → extrai apenas o dia do mês.
* **\[time]** → exibe apenas o horário (horas e minutos), ignorando a data.

O valor entre colchetes deve ser colocado **antes do alias do token** no momento da substituição.\
Por exemplo:

```
{contactfield=[date]aula_experimental}
```

A seguir, está um exemplo prático mostrando como esse token é substituído em cada uma das formatações:

<figure><img src="/files/o1N6o6b6VrDImO9qP2Pc" alt=""><figcaption><p><em>Tokens utilizados em um atendimento do SAC360.</em></p></figcaption></figure>

## Funções de Data

Em alguns casos, pode ser útil gerar datas relativas em tempo real, por exemplo, pegar a **data de hoje** no momento em que uma automação é executada, calcular **o dia seguinte** ou até mesmo **uma semana à frente**.

Isso é feito por meio dos **tokens** **`function`**.

* À **direita do sinal de igual** fica a **referência temporal** (ex.: `yesterday`, `tomorrow`).
* A **formatação** (opcional) pode ser colocada no **meio do token**.

#### Exemplos comuns:

* Um ano atrás → `{function=lastYear}`
* Mês passado → `{function=lastMonth}`
* Ontem → `{function=yesterday}`
* Semana passada → `{function=lastWeek}`
* Hoje → `{function=today}`
* Também funciona para `nextYear`, `nextMonth`, `tomorrow`, etc.

#### Exemplo com formatação, sendo executado 27/09/2025:

```
{function=[date]tomorrow} -> 28/09/2025
```

Esses tokens podem ser usados em diferentes pontos da Sprinthub, como em atendimentos, automações de envio de mensagens ou até mesmo em integrações via Webhook para plataformas externas.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.sprinthub.com/estrategias/tokens/utilizando-tokens-de-data-e-hora.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.