

utime2mdy User's Guide v1.1				27 Sec 2003
===========================

utime2mdy converts values between date/time format and unix time format.  
Values are passed on the command line.


Installation
============

The program may be installed in a directory of your choice. If you use it a 
lot, you should install it to a directory in the PATH.


Usage
=====

To run the run the program, invoke it with the values to be converted

Output will be written to stdout.  Error messages will be written to stderr.

There is only one command line switch.  Switches may begin with a dash (-) or 
a slash (/) and are not case-sensitive.  The switchis:

  -h	Display usage help

Values may be entered on the command line as

 - a date
 - a date and time
 - a unix time value

Dates are input as mm/dd/yy or mm/dd/yyy.

Times are entered as hh:mm:ss or hh:mm in 24 hour format.  The time defaults 
to midnight.

Unix time value are entered as decimal, octal or hexadecimal numbers.  
Hexadecimal values may have an optional leading 0x.  Octal values 
indicated by a leading 0 so decimal values may not have leading 0's.

Dates and times are relative to the time zone indicated by the TZ variable.

Some examples:

  Input				Output
  =============			=================

  4/24/2002			1019620800
  4/24/02 11:00			1019635200
  1019620800			4/24/2002 0:00:00
  3CC62DC0			4/24/2002 0:00:00


License
=======

This utility is placed in Public Domain as freeware.  This utility may not
be sold, hired or leased.


Warranty
========

EXCEPT AS OTHERWISE RESTRICTED BY LAW, THIS WORK IS PROVIDED WITHOUT ANY
EXPRESSED OR IMPLIED WARRANTIES OF ANY KIND, INCLUDING BUT NOT LIMITED TO,
ANY IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY
OR TITLE.  EXCEPT AS OTHERWISE PROVIDED BY LAW, NO AUTHOR, COPYRIGHT HOLDER
OR LICENSOR SHALL BE LIABLE TO YOU FOR DAMAGES OF ANY KIND, EVEN IF THEY
HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.


Support
=======

Please address support questions and enhancement requests to:

  Steven H. Levine
  steve53@earthlink.net

