# 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: 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:

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

The question should be specific, self-contained, and written in natural language.
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.