# Translate DateTime Format

Convert a date (ISO8601 format ex:yyyy-MM-dd'T'HH:mm:ssZZ) into a different timezone and format. Translate DateTime Format lives in the **Date & Time** category of the `fx` menu.

## Parameters

| Parameter            | Type   | Required | Default                   | Description                                            |
| -------------------- | ------ | -------- | ------------------------- | ------------------------------------------------------ |
| Input                | string | yes      | —                         | Value to transform. Previous step output or a literal. |
| Input Format         | string | no       | `yyyy-MM-dd'T'HH:mm:ssZZ` | The format of the input date (optional)                |
| Source Timezone      | string | yes      | `UTC`                     | The source timezone of the input date                  |
| Target Timezone      | string | yes      | `UTC`                     | The target timezone to convert the date to             |
| Output Format        | string | no       | `DDDD HH:mm:ss ZZ`        | The format of the output date (optional)               |
| Locale output Format | string | no       | `en-GB`                   | The locale of the output date (optional)               |

`Input` is the primary value (previous step output or a literal).

## Returned value

| Type     | Description                                             |
| -------- | ------------------------------------------------------- |
| `string` | Result of the Translate DateTime Format transformation. |

## Example

<details>
<summary>Run Translate DateTime Format</summary>

Convert a date (ISO8601 format ex:yyyy-MM-dd'T'HH:mm:ssZZ) into a different timezone and format. Adjust optional parameters when the defaults do not match your payload.

1. Set **Input** to the value to transform (previous step output or a literal).

2. Review **Input Format**, **Source Timezone**, **Target Timezone**, **Output Format**, **Locale output Format** and keep defaults unless your format requires otherwise.

3. Confirm **Output value** shows the transformed result.

</details>