# Examples
Get current date/time in UTC and RFC 3339 format:
```text
$ dtg
!run:../target/release/dtg
```
Get current date/time in the local timezone and default format:
```text
$ dtg -l
!run:../target/release/dtg -l
```
Get current date/time in explicit timezone and default format:
```text
$ dtg -z MST
!run:../target/release/dtg -z MST
```
```text
$ dtg -z America/Los_Angeles
!run:../target/release/dtg -z America/Los_Angeles
```
Get current date/time in UTC and specific format:
```text
$ dtg -f %A
!run:../target/release/dtg -f %A
```
```text
$ dtg -f %s.%f
!run:../target/release/dtg -f %s.%f
```
Get current date/time in local timezone and specific format:
```text
$ dtg -l -f %A
!run:../target/release/dtg -l -f %A
```
Get current date/time in explicit timezone and specific format:
```text
$ dtg -z MST -f %A
!run:../target/release/dtg -z MST -f %A
```
Get current date/time in "a" format:
```text
$ dtg -a
!run:../target/release/dtg -a
```
Get current date/time in explicit timezone and "a" format:
```text
$ dtg -a -z MST
!run:../target/release/dtg -a -z MST
```
Get current date/time in "x" format:
```text
$ dtg -x
!run:../target/release/dtg -x
```
Get a specific date / time in UTC and RFC 3339 format:
```text
$ dtg 1606447276.941324100
!run:../target/release/dtg 1606447276.941324100
```
Get a specific date/time in the local timezone and default format:
```text
$ dtg -l 1606447276.941324100
!run:../target/release/dtg 1606447276.941324100
```
Get a specific date/time in explicit timezone and default format:
```text
$ dtg -z MST 1606447276.941324100
!run:../target/release/dtg -z MST 1606447276.941324100
```
```text
$ dtg -z America/Los_Angeles 1606447276.941324100
!run:../target/release/dtg -z America/Los_Angeles 1606447276.941324100
```
Get specific date/time in UTC and specific format:
```text
$ dtg -f %A 1606447276.941324100
!run:../target/release/dtg -f %A 1606447276.941324100
```
Get specific date/time in local timezone and specific format:
```text
$ dtg -l -f %A -- 1606447276.941324100
!run:../target/release/dtg -l -f %A -- 1606447276.941324100
```
Get specific date/time in explicit timezone and specific format:
```text
$ dtg -z MST -f %A -- 1606447276.941324100
!run:../target/release/dtg -z MST -f %A -- 1606447276.941324100
```
Get a specific date/time in "a" format:
```text
$ dtg -a 1606447276.941324100
!run:../target/release/dtg -a 1606447276.941324100
```
Get a specific date/time in explicit timezone and "a" format:
```text
$ dtg -a -z MST 1606447276.941324100
!run:../target/release/dtg -a -z MST 1606447276.941324100
```
Get a specific date/time in "x" format:
```text
$ dtg -x 1606447276.941324100
!run:../target/release/dtg -x 1606447276.941324100
```
Get a specific date / time from "x" format in RFC 3339 format:
```text
$ dtg -X XeAQ3LG
!run:../target/release/dtg -X XeAQ3LG
```
Get a specific date / time from "x" format in the local timezone and default format:
```text
$ dtg -X -l XeAQ3LG
!run:../target/release/dtg -X -l XeAQ3LG
```
Get a specific date / time from "x" format in explicit timezone and default format:
```text
$ dtg -X -z MST XeAQ3LG
!run:../target/release/dtg -X -z MST XeAQ3LG
```
Get a specific date / time from "x" format in specific format:
```text
$ dtg -f '%a %d %b %Y %H:%M:%S %Z' -X XeAQ3LG
!run:../target/release/dtg -f '%a %d %b %Y %H:%M:%S %Z' -X XeAQ3LG
```
Get a specific date / time from "x" format in local timezone and specific
format:
```text
$ dtg -l -f '%a %d %b %Y %H:%M:%S %Z' -X XeAQ3LG
!run:../target/release/dtg -l -f '%a %d %b %Y %H:%M:%S %Z' -X XeAQ3LG
```
Get a specific date / time from "x" format in explicit timezone and specific
format:
```text
$ dtg -z MST -f '%a %d %b %Y %H:%M:%S %Z' -X XeAQ3LG
!run:../target/release/dtg -z MST -f '%a %d %b %Y %H:%M:%S %Z' -X XeAQ3LG
```
List available time zones:
```text
$ dtg -Z
!run:../target/release/dtg -Z
```
Search for a timezone:
```text
$ dtg -Z ca/w
!run:../target/release/dtg -Z ca/w
```
Multiple timezones:
```text
$ dtg -z UTC,EST5EDT,CST6CDT,MST7MDT,PST8PDT -f '%Z%n%H:%M:%S%n' -f '%Z%n%Y-%m-%d%n'
!run:../target/release/dtg -z UTC,EST5EDT,CST6CDT,MST7MDT,PST8PDT -f '%Z%n%H:%M:%S%n' -f '%Z%n%Y-%m-%d%n'
```
*Note the above prints each format for each timezone... to print each timezone for each format,
use a single format and `%n`:*
```text
$ dtg -z UTC,EST5EDT,CST6CDT,MST7MDT,PST8PDT -f '%Z%n%H:%M:%S%n%n%Z%n%Y-%m-%d%n'
!run:../target/release/dtg -z UTC,EST5EDT,CST6CDT,MST7MDT,PST8PDT -f '%Z%n%H:%M:%S%n%n%Z%n%Y-%m-%d%n'
```
Use a custom separator between formats/timezones:
```text
$ dtg -z PST8PDT,MST7MDT,CST6CDT,EST5EDT,UTC -f '[%Z %H:%M:%S]' -s ' '
!run:../target/release/dtg -z PST8PDT,MST7MDT,CST6CDT,EST5EDT,UTC -f '[%Z %H:%M:%S]' -s ' '
```
Named formats:
* a, all
* bcd
* cd, compact-date
* cdt, compact-date-time
* ct, compact-time
* d, default
* i, r, rfc, rfc-3339
* x
```text
$ dtg -l -n all
!run:../target/release/dtg -l -n all
```
```text
$ dtg -n bcd
!run:../target/release/dtg -n bcd
```
```text
$ dtg -l -n bcd
!run:../target/release/dtg -l -n bcd
```
```text
$ dtg -z MST7MDT -n bcd
!run:../target/release/dtg -z MST7MDT -n bcd
```
```text
$ dtg -n compact-date
!run:../target/release/dtg -n compact-date
```
```text
$ dtg -n compact-date-time
!run:../target/release/dtg -n compact-date-time
```
```text
$ dtg -n compact-time
!run:../target/release/dtg -n compact-time
```
```text
$ dtg -n default
!run:../target/release/dtg -n default
```
```text
$ dtg -n rfc-3339
!run:../target/release/dtg -n rfc-3339
```
```text
$ dtg -n x
!run:../target/release/dtg -n x
```
Ordered named formats:
```text
$ dtg -x -a
!run:../target/release/dtg -x -a
$ dtg -a -x
!run:../target/release/dtg -a -x
$ dtg -n x -n all
!run:../target/release/dtg -n x -n all
$ dtg -n all -n x
!run:../target/release/dtg -n all -n x
```