DragonFly On-Line Manual Pages

DCONV(1)                         User Commands                        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.

dateutils 0.2.7                  November 2015                        DCONV(1)