Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   44335 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

DTEST(1)			 User Commands			      DTEST(1)

NAME
       dtest - Compare dates or times

SYNOPSIS
       dtest [OPTION]... DATE/TIME1 OP DATE/TIME2

DESCRIPTION
       dtest 0.2.7

       Like test(1) but for dates.

       -h, --help
	      Print help and exit

       -V, --version
	      Print version and exit

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

       -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.

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

	      Group: op

	      Following operations are supported

       --eq   DATE/TIME1 is the same as DATE/TIME2

       --ne   DATE/TIME1 is not the same as DATE/TIME2

       --gt   DATE/TIME1 is newer than DATE/TIME2

       --lt   DATE/TIME1 is older than DATE/TIME2

       --ge   DATE/TIME1 is newer than or equals DATE/TIME2

       --le   DATE/TIME1 is older than or equals DATE/TIME2

       --nt   DATE/TIME1 is newer than DATE/TIME2

       --ot   DATE/TIME1 is older than DATE/TIME2

       --cmp  compare  DATE/TIME1  to DATE/TIME2, return with 0 if equal, 1 if
	      left argument was newer and 2 if right argument was newer

EXAMPLES
	 $ dtest 2012-03-01 --gt 2012-03-02 || echo "false"
	 false
	 $

	 $ dtest 2012-03-01 --ot 2012-03-02 && echo "true"
	 true
	 $

	 $ dtest 2012-03-01 --cmp 2012-03-02; echo $?
	 2
	 $

	 $ dtest 2012-03-02 --cmp 2012-03-02; echo $?
	 0
	 $

	 $ dtest 2012-03-02 --cmp 2012-03-01; echo $?
	 1
	 $

	 $ dtest 12:00:04 --gt 11:22:33 && echo "true"
	 true
	 $

	 $ dtest 12:00:04 --lt 11:22:33 || echo "false"
	 false
	 $

	 $ dtest 12:00:04 --cmp 11:22:33; echo "$@{?@}"
	 1
	 $

	 $ dtest --cmp 11:22:33 12:00:04; echo "$@{?@}"
	 2
	 $

	 $ dtest --ne 2012-03-02T00:00:00 2012-03-02 || echo 'false'
	 false
	 $

	 $ dtest 2012-03-02T09:00:00 --ot 2012-03-02T10:00:00 && echo "true"
	 true
	 $

	 $ dtest 2012-03-02T07:00:00 --cmp 2012-03-02T09:30:00; echo "$@{?@}"
	 2
	 $

	 $ dtest --cmp 2012-03-02T12:00:00 2012-03-02T09:30:00; echo "$@{?@}"
	 1
	 $

	 $ dtest 2012-03-02T07:00:00 --cmp 09:30:00; echo "$@{?@}"
	 3
	 $

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 dtest is maintained as a Texinfo manual.  If
       the  info  and  dtest programs are properly installed at your site, the
       command

	      info (dateutils)dtest

       should give you access to the complete manual.

dateutils 0.2.7			 January 2014			      DTEST(1)

Vote for polarhome