# Date Time Formatter

## Overview

![](https://879976444-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MIspkFTPkuGkv4UgQGs-41739140%2Fuploads%2Fgit-blob-ab2b05cafeee90e5d3faf1fee363a9847bf3822e%2Fnode-date-time-formatter.png?alt=media)

**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**](https://docs.incari.com/incari-studio/2.0/toolbox/datetime)
* [**Timezone Value**](https://docs.incari.com/incari-studio/2.0/toolbox/datetime/timezone-value)
* [**Now (UTC)**](https://docs.incari.com/incari-studio/2.0/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.