home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / cpm / turbopas / weekday.lbr / WEEKDAY.DQC / WEEKDAY.DOC
Text File  |  1986-04-28  |  3KB  |  54 lines
  1.  
  2. WEEKDAY.COM - A Julian date calculation program by Kevin Smith.
  3.  
  4.     The Julian day number as well as the day of the week are calculated
  5. for any date.  The menu driven program also has options for determining
  6. the number of days between two dates (ever wonder how many days old you
  7. were?),  as well as the number of days between a date and the beginning
  8. of that year.
  9.  
  10.     Years are entered by putting the month number first (i.e., 7 = July),
  11. followed by any delimiter (other than a number, plus or minus sign), the
  12. day number of that month, a delimiter, and finally the entire year number.
  13. Examples - April 6, 1985 could be entered as 4/6/1985 or even  4 6 1985.
  14.          - Jan. 1, B.C. 7 as 1/1/-7
  15.          - Jan. 1, A.D. 7 as 1/1/7 or 1/1/+7
  16.  
  17.     Upon entering a date value (in the program), the date is always check-
  18. ed for validity.  If an invalid date is entered, the date prompt will re-
  19. appear, and this will continue until a valid date is finally entered.
  20. Obviously a month value greater than 12 or less than 1 is invalid.  As well
  21. as day values greater than 31 or less than 1.  Further if the month is one
  22. that only has 30 days, then putting 31 is invalid; the same applies for
  23. February with the value of 28, except for the fact that if the year entered
  24. was a leap year, then a day value of 29 is accepted.  The year value can
  25. be any value except 0 (the year before 1 A.D. was 1 B.C.) [Since the year
  26. is represented as a two-byte integer, the year values should be kept within
  27. plus or minus 32000].
  28.  
  29.     Since WEEKDAY.COM is menu driven, there is little need to explain the
  30. operation of the program, just give it a try.
  31.  
  32.     While the program will calculate the desired information for ANY date,
  33. it should be kept in mind that due to the readjustments that took place in
  34. the Julian calendar, very old dates are not guaranteed to be correct.  I
  35. have tried a couple of dates that were over 1500 years ago that all resolved
  36. to the correct values, but this in no way is meant to imply that all dates
  37. back that far will evaluate correctly.
  38.  
  39.     No run time options are required in running WEEKDAY.COM, and in fact any
  40. run time options included will be ignored.  The source should be found
  41. included in the .LBR.  The program was written using  the CP/M version of
  42. TURBO Pascal Ver. 3.0.  It has been compiled using the General Installation
  43. program offered by Borland International, so to run the program on another
  44. CP/M machine with an incompatible screen, running WDAYINST.COM will allow
  45. you to customize the object code to your computer (without re-compiling, in
  46. fact, having TURBO Pascal is unnecessary).  Documentation on running WDAYINST
  47. is found in WDAYINST.DOC (but the file will probably have to be printed
  48. rather than displayed).
  49.  
  50.     A machine running PC-DOC or MS-DOS can, of course, re-compile the source,
  51. assuming that the owner of the machine has TURBO.  But since I used two CP/M
  52. dependant standard function calls (v.z., Ptr & Addr), the source will have
  53. to be changed in the couple of places that they are used.
  54.