Provided by: dateutils_0.2.5-1_amd64 
NAME
dconv - Convert dates between calendars or time zones
SYNOPSIS
dconv [OPTION]... [DATE/TIME]...
DESCRIPTION
dconv 0.2.5
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
FORMAT SPECS
Format specs in dateutils are similar to posix' strftime().
However, due to a broader range of supported calendars dateutils must employ different
rules.
Date specs:
%a The abbreviated weekday name
%A The full weekday name
%_a The weekday name shortened to a single character (MTWRFAS)
%b The abbreviated month name
%B The full month name
%_b The month name shortened to a single character (FGHJKMNQUVXZ)
%c The count of the weekday within the month (range 00 to 05)
%C The count of the weekday within the year (range 00 to 53)
%d The day of the month, 2 digits (range 00 to 31)
%D The day of the year, 3 digits (range 000 to 366)
%F Equivalent to %Y-%m-%d (ymd's canonical format)
%j Equivalent to %D
%m The month in the current calendar (range 00 to 19)
%Q The quarter of the year (range Q1 to Q4)
%q The number of the quarter (range 01 to 04)
%s The number of seconds since the Epoch.
%u The weekday as number (range 01 to 07, Sunday being 07)
%U The week count, first day of week is Sun (range 00 to 53)
%V The ISO week count, first day of week is Mon (range 01 to 53)
%w The weekday as number (range 00 to 06, Sunday being 00)
%W The week count, first day of week is Mon (range 00 to 53)
%y The year without a century (range 00 to 99)
%Y The year including the century
%Od The day as roman numerals
%Om The month as roman numerals
%Oy The two digit year as roman numerals
%OY The year including the century as roman numerals
%rs In time systems whose Epoch is different from the unix Epoch, this
selects the number of seconds since then.
%rY In calendars with years that don't coincide with the Gregorian
years, this selects the calendar's year.
%dth The day of the month as an ordinal number, 1st, 2nd, 3rd, etc.
%mth The month of the year as an ordinal number, 1st, 2nd, 3rd, etc.
%db The business day of the month (since last month's ultimo)
%dB Number of business days until this month's ultimo
Time specs:
%H The hour of the day using a 24h clock, 2 digits (range 00 to 23)
%I The hour of the day using a 12h clock, 2 digits (range 01 to 12)
%M The minute (range 00 to 59)
%N The nanoseconds (range 000000000 to 999999999)
%p The string AM or PM, noon is PM and midnight is AM.
%P Like %p but in lowercase
%S The second (range 00 to 60, 60 is for leap seconds)
%T Equivalent to %H:%M:%S
General specs:
%n A newline character
%t A tab character
%% A literal % character
Modifiers:
%O Modifier to turn decimal numbers into Roman numerals
%r Modifier to turn units into real units
th Suffix. Read and print ordinal numbers
b Treat date as business date
By design dates before 1601-01-01 are not supported.
For conformity here is a list of calendar spec names and their meaning:
ymd %Y-%m-%d
ymcw %Y-%m-%c-%w
ywd %rY-W%V-%u
bizda %Y-%m-%db
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.