DCONV(1)

NAME
dconv - Convert dates between calendars or time zones

SYNOPSIS
dconv [OPTION]... [DATE/TIME]...

DESCRIPTION
dconv 0.2.7

Convert DATE/TIMEs between calendrical systems. If DATE/TIME is omitted date/times are read from stdin.

DATE/TIME can also be one of the following specials

- `now'
    interpreted as the current (UTC) time stamp

- `time'
    the time part of the current (UTC) time stamp

- `today'
    the current date (according to UTC)

- `tomo[rrow]'
    tomorrow's date (according to UTC)

- `y[ester]day'
    yesterday's date (according to UTC)

-h, --help
    Print help and exit

-V, --version
    Print version and exit

-q, --quiet
    Suppress message about date/time and duration parser errors.

-f, --format=STRING
    Output format. This can either be a specifier string (similar to strftime()'s FMT) or the name of a calendar.

-i, --input-format=STRING
    Input format, can be used multiple times. Each date/time will be passed to the input format parsers in the order they are given, if a date/time can be read successfully with a given input format specifier string, that value will be used.

--default=DT
    For underspecified input use DT as a fallback to fill in missing fields. Must be a date/time in ISO8601 format. If omitted the default value is the current date/time.

-e, --backslash-escapes
    Enable interpretation of backslash escapes in the output and input format specifier strings.

-S, --sed-mode
    Copy parts from the input before and after a matching date/time. Note that all occurrences of date/times within a line will be processed.

--from-zone=ZONE
    Interpret dates on stdin or the command line as coming from the time zone ZONE.

-z, --zone=ZONE
    Convert dates printed on stdout to time zone ZONE, default: UTC.

EXAMPLES
  $ dconv 2012-03-01
  2012-03-01
  $
  $ dconv -i "%d/%b/%y" 01/Mar/12
  2012-03-01
  $
  $ dconv -f "%d/%b/%y" 2012-03-01
  01/Mar/12
  $
  $ dconv -f "%d/%b/%y" -i "%OY %Om %Od" "MCMXCVIII IX XVII"
  17/Sep/98
  $
  $ dconv 12:03:01
  12:03:01
  $
  $ dconv -i "%I:%M:%S %p" "11:22:33 PM"
  23:22:33
  $
  $ dconv '2012-03-01 00:00:00'
  2012-03-01T00:00:00
  $
  $ dconv 2012-03-01T12:34:56
  2012-03-01T12:34:56
  $
  $ dconv --zone America/Chicago <<EOF
  2012-03-01T07:05:06
  2012-03-01T08:12:34
  2012-03-11T01:05:06
  2012-03-11T02:05:06
  2012-03-11T07:05:06
  2012-03-11T08:05:06
  2012-03-11T17:05:06
  EOF
  2012-03-01T01:05:06
  2012-03-01T02:12:34
  2012-03-10T19:05:06
  2012-03-10T20:05:06
  2012-03-11T01:05:06
  2012-03-11T03:05:06
  2012-03-11T12:05:06
  $
  $ dconv --from-zone America/Chicago <<EOF
  2012-03-01T01:05:06
  2012-03-01T02:12:34
  2012-03-10T19:05:06
  2012-03-10T20:05:06
  2012-03-11T01:05:06
  2012-03-11T03:05:06
  2012-03-11T12:05:06
  EOF
  2012-03-01T07:05:06
  2012-03-01T08:12:34
  2012-03-11T01:05:06
  2012-03-11T02:05:06
  2012-03-11T07:05:06
  2012-03-11T08:05:06
  2012-03-11T17:05:06
  $
  $ dconv --from-zone America/Chicago -z Europe/Berlin '2012-03-01 12:00' -i '%F %H:%M' -f '%F %T'
  2012-03-01 19:00:00
  $

AUTHOR
Written by Sebastian Freundt <freundt@fresse.org>

REPORTING BUGS
Report bugs to: https://github.com/hroptatyr/dateutils/issues

SEE ALSO
The full documentation for dconv is maintained as a Texinfo manual. If the info and dconv programs are properly installed at your site, the command

    info (dateutils)dconv

should give you access to the complete manual.