`date to-timezone` for date

Convert a date to a given time zone.

Signature

> date to-timezone {flags} (time zone)

Parameters

time zone: Time zone description.

Input/output types:

input	output
datetime	datetime
string	datetime
list<datetime>	list<datetime>
list<string>	list<datetime>

Examples

Get the current date in UTC+05:00.

> date now | date to-timezone '+0500'

Get the current date in the local time zone.

> date now | date to-timezone local

Get the current date in Hawaii.

> date now | date to-timezone US/Hawaii

Get a date in a different time zone, from a string.

> "2020-10-10 10:00:00 +02:00" | date to-timezone "+0500"
Sat, 10 Oct 2020 13:00:00 +0500 (5 years ago)

Get a date in a different time zone, from a datetime.

> "2020-10-10 10:00:00 +02:00" | into datetime | date to-timezone "+0500"
Sat, 10 Oct 2020 13:00:00 +0500 (5 years ago)

Convert a list of datetimes to a given time zone.

> [2021-10-22T10:00:00+02:00, 2021-10-23T10:00:00+02:00] | date to-timezone "+0500"
╭───┬─────────────╮
│ 0 │ 4 years ago │
│ 1 │ 4 years ago │
╰───┴─────────────╯

Convert a list of date strings to a given time zone.

> ["2020-10-10 10:00:00 +02:00", "2020-10-10 12:00:00 +02:00"] | date to-timezone "+0500"
╭───┬─────────────╮
│ 0 │ 5 years ago │
│ 1 │ 5 years ago │
╰───┴─────────────╯

Notes