# Date Time Formatter

## Overview

![](/files/-MIxaUr-VOwF8Swe4rIf)

**Date Time Formatter** outputs a *date* and/or *time* in a specified format. By using a combination of special *format characters*, many different date/time formats can be created. This is used mostly for localization, however, it could also be used for formatting based on user preferences.

For more information about *formatting strings*, please see the external links at the [bottom of this page](#external-links).

## Attributes

### Input

| Attribute          | Type          | Description                                                            |
| ------------------ | ------------- | ---------------------------------------------------------------------- |
| `Default Timezone` | **Drop-down** | The timezone that will be used, which is an offset of the UTC.         |
| `Default DST`      | **Drop-down** | Determines whether or not Daylight Savings Time is taken into account. |

### Output

| Attribute         | Type          | Description                                                                                             |
| ----------------- | ------------- | ------------------------------------------------------------------------------------------------------- |
| `Format Examples` | **Drop-down** | A selection of pre-defined formats. By selecting `Custom`, you can create a custom *formatting string*. |
| `Custom Format`   | **String**    | The *formatting string* which will determine how the date and/or time is represented.                   |

## Inputs

| Input                  | Type       | Description                                                                           |
| ---------------------- | ---------- | ------------------------------------------------------------------------------------- |
| *Pulse Input* (►)      | **Pulse**  | A standard input **Pulse**, to trigger the execution of the **Node**.                 |
| `UTC Unix (ms)`        | **Int**    | The UTC in Unix format.                                                               |
| `Timezone Offset (ms)` | **Int**    | The time offset in milliseconds.                                                      |
| `DST`                  | **Bool**   | Determines whether or not Daylight Savings Time is taken into account.                |
| `Format`               | **String** | The *formatting string* which will determine how the date and/or time is represented. |

## Outputs

| Output             | Type       | Description                                                                                                                            |
| ------------------ | ---------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| *Pulse Output* (►) | **Pulse**  | A standard output **Pulse**, to move onto the next **Node** along the **Logic Branch**, once this **Node** has finished its execution. |
| `Output`           | **String** | The formatted date/time.                                                                                                               |

## See Also

* [**DateTime**](/incari-studio/2021.2/toolbox/datetime.md)
* [**Timezone Value**](/incari-studio/2021.2/toolbox/datetime/timezone-value.md)
* [**Now (UTC)**](https://docs.incari.com/incari-studio/toolbox/datetime/now-utc)

## External Links

* [*Formatting Date and Time*](https://wordpress.org/support/article/formatting-date-and-time/) on WordPress.org.
* [*PHP: date - Manual*](https://www.php.net/manual/en/function.date.php) on PHP.net.
* [*UTC - The World's Time Standard*](https://www.timeanddate.com/time/aboututc.html) on timeanddate.com.


---

# 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.incari.com/incari-studio/2021.2/toolbox/datetime/date-time-formatter.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.