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