> For the complete documentation index, see [llms.txt](https://wyne.gitbook.io/wyne-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wyne.gitbook.io/wyne-docs/datetimeformatexpansion/zoned-date-and-time.md).

# Zoned date and time

%dtf\_zoned\_…% shows the current date and time in a time zone of your choice—with its offset, if you want it.

```
%dtf_zoned_<adjuster>_<time>_<zone>_<format>_[locale]%
```

Works like [`%dtf_local_…%`](/wyne-docs/datetimeformatexpansion/local-date-and-time.md), with one more argument: the time zone. The current date and time are taken in that zone, then moved and formatted the same way. `<adjuster>`, `<time>` and `<locale>` are exactly as described there.

```
%dtf_zoned_NOW_NOW_Asia/Tokyo_HH:mm%
```

shows the time in Tokyo, whatever the server's own zone is.

## Zone

| Zone                                             | Means                                                                                                                                |
| ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------ |
| `NOW`                                            | The server's time zone.                                                                                                              |
| A region, such as `Europe/Berlin`                | That region's time, daylight saving included. See the [list of zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). |
| An offset, such as `UTC`, `GMT+5` or `UTC-03:00` | A fixed offset from UTC.                                                                                                             |
| A short ID, such as `EST` or `CET`               | Java's [short zone IDs](https://docs.oracle.com/javase/8/docs/api/java/time/ZoneId.html#SHORT_IDS).                                  |

Zones are case-sensitive: `Europe/Berlin`, not `europe/berlin`. An unknown zone is an error—see [When something is wrong](/wyne-docs/datetimeformatexpansion/formats-and-nesting.md#when-something-is-wrong).

{% hint style="warning" %}
A region with `_` in its name, such as `America/New_York` or `America/Los_Angeles`, can't be used: the `_` splits it into two arguments. Pick another region in the same zone instead—`America/Toronto` keeps New York's time, daylight saving included, and `America/Vancouver` keeps Los Angeles's.
{% endhint %}

## Format

Patterns work as on the [local page](/wyne-docs/datetimeformatexpansion/local-date-and-time.md#patterns), plus the zone letters of `DateTimeFormatter`: `XXX` for the offset (`+04:00`), `z` for the zone's short name, `VV` for its ID (`Asia/Yerevan`).

The predefined formats include the zone. The examples show 8 December 2025, 22:04:06 in `Asia/Yerevan`:

| Key                    | Shows                                               |
| ---------------------- | --------------------------------------------------- |
| `BASIC-ISO-DATE`       | `20251208+0400`                                     |
| `ISO-LOCAL-DATE`       | `2025-12-08`                                        |
| `ISO-OFFSET-DATE`      | `2025-12-08+04:00`                                  |
| `ISO-DATE`             | `2025-12-08+04:00`                                  |
| `ISO-LOCAL-TIME`       | `22:04:06.034735454`                                |
| `ISO-OFFSET-TIME`      | `22:04:06.034735454+04:00`                          |
| `ISO-TIME`             | `22:04:06.034735454+04:00`                          |
| `ISO-LOCAL-DATE-TIME`  | `2025-12-08T22:04:06.034735454`                     |
| `ISO-OFFSET-DATE-TIME` | `2025-12-08T22:04:06.034735454+04:00`               |
| `ISO-ZONED-DATE-TIME`  | `2025-12-08T22:04:06.034735454+04:00[Asia/Yerevan]` |
| `ISO-DATE-TIME`        | `2025-12-08T22:04:06.034735454+04:00[Asia/Yerevan]` |
| `ISO-ORDINAL-DATE`     | `2025-342+04:00`                                    |
| `ISO-WEEK-DATE`        | `2025-W50-1+04:00`                                  |
| `ISO-INSTANT`          | `2025-12-08T18:04:06.034735454Z`, always in UTC     |
| `RFC-1123-DATE-TIME`   | `Mon, 8 Dec 2025 22:04:06 +0400`                    |

## Examples

| Placeholder                                       | Shows                          |
| ------------------------------------------------- | ------------------------------ |
| `%dtf_zoned_NOW_NOW_UTC_RFC-1123-DATE-TIME%`      | `Mon, 8 Dec 2025 18:04:06 GMT` |
| `%dtf_zoned_NOW_NOW_Europe/Berlin_HH:mm%`         | `19:04`                        |
| `%dtf_zoned_NOW_NOW_America/Toronto_HH:mm%`       | `13:04`, New York's time       |
| `%dtf_zoned_NOW_NOW_NOW_d-MMM-yyyy_ja%`           | `8-12月-2025`                   |
| `%dtf_zoned_NEXT-SATURDAY_18:00_UTC_ISO-INSTANT%` | `2025-12-13T18:00:00Z`         |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://wyne.gitbook.io/wyne-docs/datetimeformatexpansion/zoned-date-and-time.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.