> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.itential.com/itential-platform/2023-2/studio/tasks/reference/converttimezone/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.itential.com/_mcp/server.

# convertTimezone

> Use the convertTimezone task to offset a timestamp by a specified number of whole hours.

The `convertTimezone` task converts a timestamp by offsetting the input value in whole hour increments. This task does not take true UTC time into account — the input time is always treated as the `0:00` marker (no offset), and the output is the chosen offset applied to the input value. The output format matches the format specified in the input time.

## Potential use case

Use this task when your workflow imports a timestamp from a device in a different time zone and you need to offset it to blend chronologically with log file history from devices in your time zone.

## Properties

| Incoming      | Type   | Description                                                                             |
| :------------ | :----- | :-------------------------------------------------------------------------------------- |
| `inputTime`   | Object | Required. The date/timestamp to convert.                                                |
| `NewTimezone` | Enum   | Required. An hour offset applied to the `inputTime` value to produce the new time zone. |

| Outgoing        | Type   | Description                                           |
| :-------------- | :----- | :---------------------------------------------------- |
| `convertedTime` | Object | The `inputTime` converted to the `NewTimezone` value. |

## Example 1

In this example:

* The `inputTime` comes from the `getTime` reference task. The reference variable is `time`.
* The `NewTimezone` is set to `+01:00` (a one-hour increment).
* If the `inputTime` was `03:00`, the `convertedTime` would be `04:00`.

![](/_fern-img/592c800f81de643f801b6685b3e9d56a8408d68acd844b26ecfe35fef770354a.webp)

## Example 2

In this example:

* The `inputTime` comes from the `getTime` reference task. The reference variable is `time`.
* The `NewTimezone` is set to `-02:00` (a two-hour difference).
* If the `inputTime` was `03:00`, the `convertedTime` would be `01:00`.

![](/_fern-img/784084ae2ede5315b0795c2e19976eafb4a14050b4df168ddeb3334738ab2267.webp)

## Example 3

In this example:

* The `inputTime` comes from the `getTime` reference task. The reference variable is `time`.
* The `NewTimezone` is set to `+00:00` (no offset).
* If the `inputTime` was `03:00`, the `convertedTime` would remain `03:00`.

![](/_fern-img/75b2eab8d9d21c7c6404c8a5a00ce32e05512290f16db6a2bc7809087fdef073.webp)

## Manual reference variable entry

To enter the `inputTime` object manually, use the Year-Month-Date-Time format (`yyyy-MM-dd 'T' HH:mm:ss.SSSZ`):

```json
{"time": "2021-02-26T15:00:00.000Z"}
```

This displays as:

```
2021-02-25 03:00.00
```

> Use the convertTimezone task to offset a timestamp by a specified number of whole hours.