# Criar ou Formatar

{% tabs %}
{% tab title="Parâmetros" %}

<div align="center" data-full-width="false"><figure><img src="https://215079342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F226k0cnPTn1PWu9xHcK8%2Fuploads%2FvnJVo8rCyklNumfKvT4C%2Fimage.png?alt=media&#x26;token=4e24be55-c843-4f64-ae25-4a35cd340274" alt=""><figcaption><p>Parâmetros de configuração (Criar)</p></figcaption></figure></div>

| Campo                         | Tipo           | Descrição                                                                                                                                                                                                                                                                                                   |
| ----------------------------- | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Descrição                     | Campo de texto | Descrição visual do conector na construção do fluxo.                                                                                                                                                                                                                                                        |
| Data                          | Seletor        | Permite selecionar entre criar uma nova data ou informar uma data existente para formatação.                                                                                                                                                                                                                |
| Valor de entrada              | Campo de texto | Campo disponível quando selecionada a opção **Valor de Entrada** em configuração **Data**. Permite informar o caminho da data, dentro do objeto msg, que será formatada.                                                                                                                                    |
| Formato de entrada            | Campo de texto | Campo disponível quando selecionada a opção **Valor de Entrada** em configuração **Data**. Permite definir como a data de entrada está formatada. Consulte a seção **Formatação de data/hora** para entender como as datas podem estar estruturadas.                                                        |
| Formato de saída              | Campo de texto | Permite definir como será formatada a data de saída. Consulte a seção **Formatação de data/hora** para entender como estruturar a data.                                                                                                                                                                     |
| Converter para timezone       | Seletor        | Permite definir se a data será convertida para um fuso horário específico. Na criação de uma nova data caso não seja optado pela conversão, a nova data será em UTC, ou seja, terá 3h a mais com base no horário de Brasília. Exemplo: ao criar uma data às 13h sem conversão, o horário final será de 16h. |
| Valor do timezone (-12 a +14) | Campo de texto | Campo disponível quando selecionada a opção **Converter** em **Converter Para Timezone**. Permite adicionar ou subtrair valores ao horário da data criada ou formatada, permitindo configurar a data para diferentes timezones.                                                                             |
| Locale customizado            | Campo de texto | Define o campo de configurações para a localização.                                                                                                                                                                                                                                                         |
| Output Path                   | Campo de texto | Refere-se ao caminho dentro do objeto msg onde o resultado da criação/modificação estará localizado. O objeto msg contém os dados gerados durante a execução do fluxo.                                                                                                                                      |
| {% endtab %}                  |                |                                                                                                                                                                                                                                                                                                             |

{% tab title="Payload" %}

## Sucesso

Por padrão, o conector retornará uma string contendo a data gerada de acordo com os parâmetros de configuração do conector.

<figure><img src="https://215079342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F226k0cnPTn1PWu9xHcK8%2Fuploads%2FQkc0r43Fhsz1PnwDDlS8%2Fimage.png?alt=media&#x26;token=9f8a2459-aa70-419f-afda-5e4db3ee91bd" alt=""><figcaption><p>Alteração de uma data para um novo formato</p></figcaption></figure>

<figure><img src="https://215079342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F226k0cnPTn1PWu9xHcK8%2Fuploads%2FHjllzbFwprjn4zQUJEB9%2Fimage.png?alt=media&#x26;token=dea87235-9caa-47b4-8ab9-4cedb70c6813" alt=""><figcaption><p>Criação de um nova data</p></figcaption></figure>
{% endtab %}

{% tab title="Instruções" %}

## Caracteres de formato personalizados

Para definir um formato de data/hora personalizado, use os caracteres a seguir na construção.

| Caractere     | Descrição                                                                                              |
| ------------- | ------------------------------------------------------------------------------------------------------ |
| D, DD         | Dia do mês de 1 a 31.                                                                                  |
| M, MM         | Mês do ano de 1 a 12.                                                                                  |
| YYYY          | Ano com quatro dígitos.                                                                                |
| YY            | Ano com dois dígitos.                                                                                  |
| MMM           | Nome do mês abreviado (por exemplo, "Jan").                                                            |
| MMMM          | Nome do mês por extenso (por exemplo, “Janeiro").                                                      |
| DDD           | Dia do ano de 1 a 365.                                                                                 |
| DDDD          | Dia do ano com zero à esquerda (001 a 365).                                                            |
| H, HH         | Hora no formato 24 horas de 00 a 23.                                                                   |
| m, mm         | Minutos de 0 a 59.                                                                                     |
| h, hh         | Hora no formato 12 horas com AM e PM.                                                                  |
| s, ss         | Segundos de 0 a 59.                                                                                    |
| S, SS, SSS    | Frações de segundo de 0 a 999.                                                                         |
| x             | UNIX timestamp (em milissegundos).                                                                     |
| X             | UNIX timestamp (em segundos).                                                                          |
| \[Texto]      | Texto entre colchetes será exibido exatamente como está, sem ser interpretado como um formato de data. |
| {% endtab %}  |                                                                                                        |
| {% endtabs %} |                                                                                                        |
