home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / misc / family3.zip / DATECALC.DOC < prev    next >
Text File  |  1987-10-19  |  16KB  |  331 lines

  1.  
  2.  
  3.  
  4.       Appendix D: DATECALC, a RAM Resident Date Calculator Utility
  5.  
  6.       The program DATECALC.COM that has been placed on your Family History 
  7.       System program diskette (or in the \FAMILY sub-directory of your hard 
  8.       disk) is a program to assist you in performing some standard opera-
  9.       tions involving dates, including:
  10.  
  11.           Determining the day of the week on which a given date falls;
  12.           Computing the number of years, months and/or days between two 
  13.              given dates;
  14.           Determining the date that is a given number of years, months 
  15.              and/or days before or after another date;
  16.           Displaying a calendar for the month containing a given date;
  17.           Converting between "old style" and "new style" dates.
  18.  
  19.       In providing these functions, the DATECALC utility also permits you to 
  20.       select the format for dates entered or displayed from among:
  21.               DD MON YYYY   (e.g. 10 APR 1943)
  22.               MON DD, YYYY  (e.g. APR 10, 1943)
  23.               MM-DD-YYYY    (e.g. 04-10-1943)
  24.               DD.MM.YYYY    (e.g. 10.04.1943)
  25.               YYYY MM DD    (e.g. 1943 04 10)
  26.          or   YYYY DDD      (e.g. 1943 100).
  27.  
  28.       The "difference" or length of interval between dates can be displayed 
  29.       in several formats also, including:  
  30.                +/- Yr,Mon,Day   (+ 0044 Y  004 M  02 D)
  31.                +/- Yrs,Days     (+ 0044 Y  124 D)
  32.           or   +/- Days         (+ 016195 Days).
  33.       (A "-" before the date difference indicates that the second date 
  34.       occurs before the first one.)
  35.  
  36.       The DATECALC utility can be invoked in several ways.  If you are using 
  37.       DOS 2.1 or later and have sufficient RAM on your machine, you should 
  38.       be able to invoke it from the MainMenu of the Family History System 
  39.       by pressing the F7 key.  It can also be executed as a command from the 
  40.       DOS prompt, for example by entering:  A>datecalc
  41.       assuming the DATECALC.COM program is on the diskette in the "A" drive.
  42.       Finally it can be made memory resident by entering:  A>datecalc r
  43.       (again assuming the DATECALC.COM program is on the diskette in the "A" 
  44.       drive) after which it may be called up at just about any time by 
  45.       simultaneously pressing the ALT and CTRL keys.  The utility will not 
  46.       "pop up" when the screen is being used to display graphics and it may 
  47.       be incompatible with some other resident utilities or with some 
  48.       programs which take control of keyboard input.  
  49.  
  50.       The AUTOEXEC.BAT file created on program diskettes during the standard 
  51.       INSTALL procedure has a command line in it which will make this 
  52.       utility memory resident when you boot from those diskettes.  If you 
  53.       are running from a hard disk or do not boot from your Family History 
  54.       System program diskette, you may consider modifying the AUTOEXEC.BAT 
  55.       file used during your normal boot procedure to automatically make the 
  56.       DATECALC utility RAM resident.  Be aware that making the program 
  57.       resident in memory will "permanently" reduce the available memory for 
  58.       other programs by about 7k.
  59.  
  60.  
  61.                                      45
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.       When you invoke DATECALC in one of the above ways, it "pops" into 
  72.       view, overlaying the previous contents of the screen.  The utility's 
  73.       options are listed together with the function keys that are used to 
  74.       select them.  (Note that the ESCape key is used to exit from the 
  75.       program.  The previous contents of the screen are restored when you 
  76.       do.)  Below the list of options you will find the descriptions for the 
  77.       current formats for DATEs and Date DIFference.  If "old style" dates 
  78.       are being processed, then the characters "OS" will appear to the right 
  79.       of the literal describing the date format.  Near the bottom of the 
  80.       viewing area, on separate lines, appear two dates (DATE1, DATE2) and 
  81.       the computed DIF (calendar interval) between the dates.  The day of 
  82.       the week for each date is also shown for each date.  The first time 
  83.       the utility is used the dates will have the value of the current date 
  84.       (or 01 JAN 1980 if you don't have a clock calendar board and haven't 
  85.       previously corrected the date using the DOS DATE command or some other 
  86.       utility) and the computed DIF will be 0 years, 0 months and 0 days.
  87.  
  88.       You can use the cursor control keys (as well as the HOME, END, PGUP, 
  89.       PGDN keys) to move the viewing area for the utility to different 
  90.       locations on the screen.  This allows you to reveal any area on the 
  91.       screen in which a date appears that you may want to examine.  If you 
  92.       are running DATECALC as a memory resident utility, then the location 
  93.       of the viewing area will remain unchanged between separate invocations 
  94.       of the program.
  95.  
  96.       The list of program options appears as follows:
  97.               F1  Enter DATE1 (find DAY)
  98.               F2  Enter DATE2 (find DIF)
  99.               F3  Enter DIF   (find DATE2)
  100.               F4  Show Calendar for DATE1/2
  101.               F5  Change DATE Format/Style
  102.               F6  Change DIF Format
  103.               ESC  Exit
  104.  
  105.       USING THE DATE CALCULATOR:
  106.  
  107.       If you press function key F1 or F2 then a reverse video cursor will 
  108.       appear in the first position of the value field for the corresponding 
  109.       date at the bottom of the viewing area.  You can then type in the 
  110.       value you wish and press the Enter or RETURN key when you are through 
  111.       (or press the ESCape key to restore the previous value for the date).    
  112.       Month literals should be among: 
  113.               JAN,FEB,MAR,APR,MAY,JUN,JUL,AUG,SEP,OCT,NOV,DEC
  114.       Any other values entered will be changed to "JAN".  Lower case charac-
  115.       ters are automatically changed to upper case when entering these 
  116.       values.  If a value is entered for the day of the month which is 
  117.       greater than the "legal" number of days in the month, then the month 
  118.       and day (and year if necessary) will be automatically adjusted accor-
  119.       dingly.  For example an entered date of "MAR 35, 1987" will be changed 
  120.       to "APR 04, 1987".  Similarly, if a value greater than 12 is entered 
  121.       for the number of the month, then the month and year (and day value if 
  122.       necessary) will be adusted accordingly.  For example an entered date 
  123.       of "14-30-1987" will be changed to "03-01-1988".
  124.  
  125.  
  126.  
  127.                                      46
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.       If you press function key F3 then a reverse video cursor will appear 
  137.       in the first position of the value for the DIF field at the bottom of 
  138.       the viewing area.  The first character must be a + or - (indicating 
  139.       whether the computed value for DATE2 is to be after or before DATE1).  
  140.       Press the Enter or RETURN key when you are finished (or press the 
  141.       ESCape key to restore the previous value for DIF).
  142.  
  143.       When entering any of these values you can use the left and right 
  144.       cursor control keys to move the cursor and you can use the TAB key to 
  145.       move quickly to different parts of the field.  The cursor automatically 
  146.       skips over the "filler" characters (such as "-" or ",") so you don't 
  147.       have to enter these.
  148.  
  149.       If you have changed either DATE1 or DATE2, then the program will 
  150.       compute and display the day of the week and compute and redisplay the 
  151.       value of DIF, the difference between the two dates.  If you change the 
  152.       value of DIF, then the program will compute the value of DATE2 which 
  153.       is the specified interval before or after the current value of DATE1 
  154.       and will compute and redisplay the DIF between the dates.  Note that 
  155.       in computing date differences the following procedure is used:
  156.           The larger of the two dates is determined and the sign of the 
  157.               difference is set to - if DATE1>DATE2 and + otherwise;
  158.           The smaller date is subtracted from the larger, first days, then 
  159.               months and then years.
  160.       On the other hand, when DATE2 is computed from DATE1 the adjustment of 
  161.       the components of the date are made in the reverse order, first years, 
  162.       then months and then days.  (This is an important distinction and one 
  163.       which was not followed by an early version of the DATECALC utility.  
  164.       If the components of DATE2 are computed in days, months, years order 
  165.       then the computed DIF between DATE1 and the computed DATE2 will some-
  166.       times not match the original DIF value entered.)
  167.  
  168.       DISPLAYING A MONTHLY CALENDAR
  169.  
  170.       If you press the F4 key then the middle portion of the viewing area 
  171.       for the DATECALC utility will be cleared and a calendar will be 
  172.       displayed for the month of the year containing DATE1. (If instead you 
  173.       press the SHIFT and F4 keys simultaneously, then the calendar for 
  174.       DATE2 will be displayed.)  Once the calendar is displayed, you can 
  175.       scroll the calendar backward or forward by months by pressing the left 
  176.       or right cursor keys respectively.  The calendar may also be scrolled 
  177.       forward or backward by years by pressing the up or down cursor keys 
  178.       respectively.  The calendar display is terminated by pressing the 
  179.       ESCape key.  (Note: if you are currently using "old style" dates then 
  180.       the calendar will be computed using "old style" rules.)
  181.  
  182.       CHANGING DATE AND DIF FORMATS
  183.  
  184.       Pressing the F5 key causes the DATEs to cycle through the various 
  185.       formats described previously.  Both the literal describing the format 
  186.       and the values for DATE1 and DATE2 will automatically change.  All 
  187.       dates will be entered and displayed in the currently selected format.  
  188.  
  189.       Similarly, if you press the F6 key then the value for DIF will cycle 
  190.       through the various formats described above.  All DIFs will be entered 
  191.  
  192.  
  193.                                      47
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.       and displayed in the currently selected format.
  203.  
  204.       If you are running DATECALC as a memory resident utility, then the 
  205.       format for DATEs and DIF will be retained between invocations of the 
  206.       utility.
  207.  
  208.       CONVERTING BETWEEN "OLD" AND "NEW" STYLE DATES
  209.  
  210.       It is generally well known that the "standard" calendar year of 365 
  211.       days differs from the "solar" year by an amount that makes it neces-
  212.       sary to insert extra days occasionally (as a 29th day in the month of 
  213.       February) to get back in synch with the sun.  The years in which such 
  214.       days are added are called "leap years".  The rule for determining leap 
  215.       years that has been used in English speaking countries since 1752 (and 
  216.       from earlier dates in other enlightened areas of the world...in fact 
  217.       the new calendar is called a "Gregorian" calendar after Pope Gregory 
  218.       XIII who requested that Catholic countries begin using it in 1582) may 
  219.       be stated as follows:
  220.             A given year will be a leap year if it is evenly divisible by 4
  221.             UNLESS the year ends in "00" in which case it is NOT a leap year
  222.             UNLESS it is divisible by 400 in which case it IS a leap year.
  223.       Prior to the establishment of this leap rule, most of the Western 
  224.       world employed a rule which was just the first line in the above 
  225.       statement, that is every fourth year was a leap year.  The effect of 
  226.       using this simplified rule over a long period of time was that the
  227.       planting season, which is determined by the sun, would creep a 
  228.       calendar day earlier every 133 years or so.  By the Spring of 1752 
  229.       people were having to plant their potatoes the day after Groundhog Day 
  230.       instead of Valentine Day.  Therefore to correct the situation all 
  231.       English subjects were asked to go to bed the evening of 02 SEP 1752, 
  232.       get up the next morning on 14 SEP 1752, and from that day forward use 
  233.       the new leap year rule for constructing calendars.
  234.  
  235.       Today this calendar change is just a curiosity for most of us, but to 
  236.       people of that day and genealogists today who have to deal with dates 
  237.       both before and after this adjustment it is a problem which has been 
  238.       recognised by labeling dates based upon the old leap rule as "old 
  239.       style" dates and designating those following the new rule as "new 
  240.       style" dates.
  241.  
  242.       The calendar adjustment to "new style" dates occurred at different 
  243.       times in different countries so rather than just treating all dates 
  244.       prior to 14 SEP 1752 as "old style" dates, the DATECALC utility pro-
  245.       vides an option for converting between the two "styles".  Pressing the 
  246.       SHIFT and F5 keys simultaneously causes the program to shift between 
  247.       old and new style treatment of dates with a corresponding adjustment 
  248.       of displayed DATEs and DIF values.  When dates are being treated as 
  249.       "old style" dates the characters "OS" will appear to the right of the 
  250.       literal describing the current Date format.  When the new leap rule is 
  251.       in effect there is no special indicator to the right of the Date 
  252.       format descriptor (though genealogists will sometimes use an "NS" 
  253.       suffix for such dates).
  254.  
  255.       As an example, call up the DATECALC utility, press F1 and enter the 
  256.       new style date: 22 FEB 1732 (or equivalent for the date format you are 
  257.  
  258.  
  259.                                      48
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.       using).  You will find that George Washington was born on a Friday.  
  269.       But if you press F4, the "new style" calendar displayed will not be 
  270.       the one that George's parents used to mark his birth.  Instead, press 
  271.       ESCape (to erase the calendar display) and then SHIFT+F5 to switch to 
  272.       "old style" dates.  You will find that George's birthdate was actually 
  273.       11 FEB 1732 (still a Friday though) and if you then press F4 you will 
  274.       see the "old style" calendar that was in effect at the time. 
  275.  
  276.       Before ending this discussion, perhaps I should note another distinc-
  277.       tion between some old and new style dates.  Prior to the implementa-
  278.       tion of the new leap rule, the first day of the new year was con-
  279.       sidered variously as Jan 1, Mar 1 and Mar 25 (e.g. according to some, 
  280.       25 MAR 1645 was the day after 24 MAR 1644). This left some ambiguity 
  281.       concerning the year for such dates as:  11 FEB 1732 OS.  Therefore the 
  282.       custom was developed of using "double dating" to take note of the fact 
  283.       that this discrepancy had been considered.  The above date might then 
  284.       be written:  11 FEB 1731/2 OS.  You should be aware that the DATECALC 
  285.       utility will always assume JAN 1 to be the first day of the year.  You 
  286.       may even use this to determine the correct double dating for an event.  
  287.       For example, suppose it is known that a person was born on Saturday, 
  288.       30 JAN 1691 OS, but it is not known which new year rule was in effect.  
  289.       The DATECALC program will show that 30 JAN 1691 OS is a Friday but 
  290.       that 30 JAN 1692 OS is a Saturday.  Therefore the correct double-
  291.       dating would be:  30 JAN 1691/2 OS and the person who originally 
  292.       recorded the date was apparently using something other than JAN 1 as 
  293.       the date for the beginning of the new year.
  294.  
  295.  
  296.       For those wanting to find out more about various calendar systems I 
  297.       would recommend your reading the discussions in the books:
  298.          "Tracing Your ROOTS" by the editors of Consumer Guide and distri-
  299.              buted by Bell Publishing Company, New York  (p. 47)
  300.          "Ancestry's Guide to Research" by Johni Cerny & Arlene Eakle,
  301.              published by Ancestry, Inc., Salt Lake City
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.                                      49
  326.  
  327.  
  328.  
  329.  
  330.  
  331.