home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 26 / CD_ASCQ_26_1295.iso / vrac / hebrd103.zip / HEBRDATE.DOC < prev    next >
Text File  |  1995-10-06  |  11KB  |  213 lines

  1.                           HebrDate 1.03
  2.                       Hebrew Date Calculator
  3.        Copyright (c) Irving Maron 1995  All Rights Reserved
  4.  
  5. (1) Introduction.
  6.   
  7. HEBRDATE.EXE operates under MS-DOS, or compatible. It can obtain the current
  8. system clock date (common or Gregorian date), convert it to the current
  9. Hebrew date, and print the Hebrew date to the screen. It can be used to 
  10. calculate conversions between Hebrew date, Gregorian date and Julian date,
  11. and to calculate the Gregorian dates of Hebrew anniversaries. It can process 
  12. text files to find lines containing dates, and to append defined date 
  13. conversions to each line. It can provide a list of Jewish holidays for any 
  14. Gregorian year, or for any Julian year before 1921. (The Julian calendar was 
  15. in use in Russia as late as 1917, and in England and the colonies until 
  16. 1752.) 
  17.  
  18.  
  19. (2) HebrDate Command Summary.
  20.  
  21. Syntax:  [drive:][path]hebrdate [Command]
  22.  
  23. Command         Output (to screen)
  24. ----------------------------------------------------------------------------
  25. No command      Current Hebrew date.
  26. /c              Opens date calculator. Follow directions on screen.
  27. /g, /gs         Command line Gregorian date to Hebrew date.
  28. /h, /hs         Command line Hebrew date to Gregorian date.
  29. /j, /js         Command line Julian date to Hebrew date.
  30. /<year>         List of Jewish holidays for Gregorian <year> (e.g., /1492)
  31. /<year>j        List of Jewish holidays for Julian <year> (e.g., /1492j)
  32. /y              List of Jewish holidays for current (Gregorian) year.
  33. /m              List of Jewish holidays for current month, plus holidays.
  34.                 for next month if current day-of-month 15th or greater.
  35. /? or /help     Command summary (also displayed if command unrecognized).
  36. ----------------------------------------------------------------------------
  37. NOTE: Commands /h and /hs, above, are new in Version 1.03; commands /y and 
  38.       /m were /h and /hr in Version 1.02.
  39.       
  40.  
  41.  
  42. (3) Detailed Description of HebrDate Commands.
  43.   
  44. (3.1) Command: no command
  45. For the current Hebrew date, enter [drive:][path]hebrdate at the DOS prompt,
  46. or add [drive:][path]hebrdate at the end of AUTOEXEC.BAT to see the current
  47. Hebrew date on the screen at bootup (if you don't boot up directly into
  48. WINDOWS or some application, of course). 
  49.  
  50. (3.2) Command: /c
  51. To use HebrDate as a calculator, enter the command [drive:][path]hebrdate/c 
  52. at the DOS prompt, and follow the directions on the screen.  Whenever
  53. HebrDate is used as a calculator, all computing activity is written to an 
  54. ASCII text file, named HEBRDATE.LOG, in the current directory.
  55.  
  56. (3.3) Commands: /g, /gs, /h, /hs, /j, /js
  57. Converting from Gregorian or Julian date to Hebrew date and Hebrew date to
  58. Gregorian date can also be done on the command line (i.e., at the DOS 
  59. prompt). To do this, enter the command [drive:][path]hebrdate/x, where "x"
  60. is "g", "h" or "j", and then, at the blinking cursor prompt, enter the date 
  61. to be converted in mm-dd-yyyy or mm/dd/yyyy format. The corresponding 
  62. Hebrew date will be printed in response to the "g" or "j" commands, or
  63. Gregorian date in response to the "h" command, and the cursor will then
  64. blink for another input. Command returns to DOS when you default (i.e., 
  65. press Enter with nothing typed on the line). The format for the date in 
  66. response to the /g, /h or/j commands consists of "name-of-month, day year". 
  67. For dates in the mm-dd-yyyy or mm/dd/yyyy format, append "s" to the 
  68. commands, as shown above.
  69.  
  70. These commands can also be used to process Gregorian, Hebrew or Julian 
  71. dates contained in text (ASCII) files, appending the corresponding 
  72. converted dates to each line of text where a date appears. The dates to be 
  73. converted must be in the mm-dd-yyyy or mm/dd/yyyy format. To do the text 
  74. file processing for a Gregorian to Hebrew conversion, enter (at DOS prompt)
  75.         "[drive:][path]hebrdate/g < infile.txt > outfile.txt"
  76. (without the double quote symbols, of course), where infile.txt is the name
  77. of the file containing the input data, and outfile.txt is the name assigned
  78. to the results file (where infile.txt and outfile.txt can be replaced by
  79. whatever filenames you prefer). The outfile.txt file will contain all the
  80. data in infile.txt plus additional entries at the end of each line,
  81. consisting of the Hebrew date corresponding to each Gregorian date in the 
  82. line.
  83.  
  84. To do text file processing for Julian date to Hebrew date, use "/j" instead 
  85. of "/g" in the command at the DOS prompt; for processing Hebrew date to 
  86. Gregorian, use /h.
  87.  
  88. To print the converted dates in the mm-dd-yyyy or mm/dd/yyyy formats, use 
  89. /gs, /hs or /js (i.e., append "s" to the basic command). To print the date
  90. within parentheses, add a "p" after the "s".
  91.  
  92. Text File Processing Caveats: 
  93.   Dates in the input file must be preceded and followed by at least one 
  94. space.
  95.   A comma in any line of data acts as a signal to the program not to process 
  96. any dates that may be present in the line. Lines containing a comma will be
  97. flagged in the output file by the comment "Comma noted ...". 
  98.   Any date in the input text file that is invalid or is out-of-range
  99. (earlier than 1/1/1 of the Gregorian calendar) will be ignored.
  100.  
  101. Text File Processing Example: Let infile.txt consist of the following:
  102.  
  103. Ref.No.  Name  Date-of-Birth Birthplace Date-of-Death
  104. ------------------------------------------------------
  105. 102.34   Joe1    1/25/1904    Russia      9/12/1976
  106. 203.45   Joe2    4/14/1911    Poland     12/14/1984
  107.   .       .          .           .            .
  108.   .       .          .           .            .
  109.   .       .          .           .            .
  110. 591.76   JoeN   12/23/1898    Germany     4/19/1943
  111.  
  112.  
  113. Then outfile.txt will be (in response to the /gs command):
  114.  
  115.  Ref.No.  Name  Date-of-Birth Birthplace Date-of-Death
  116.  ------------------------------------------------------
  117.  102.34   Joe1    1/25/1904    Russia      9/12/1976  11/08/5664  06/17/5736
  118.  203.45   Joe2    4/14/1911    Poland     12/14/1984  01/16/5671  09/20/5745
  119.    .       .          .           .            .
  120.    .       .          .           .            .
  121.    .       .          .           .            .
  122.  591.76   JoeN   12/23/1898    Germany     4/19/1943  10/10/5659  01/14/5703
  123.  
  124. The 6th column in outfile.txt is the Hebrew "Date-of-Birth" column, and the
  125. 7th column is the Hebrew "Date-of-Death" column.
  126.  
  127.  
  128. (3.4) Commands: /<year>, /<year>j, /y, /m
  129. To obtain a list of Jewish holidays in any Gregorian year, enter
  130. [drive:][path]hebrdate/<year> at the DOS prompt, where <year> is the
  131. numerical year (e.g., 1492 or 1995 or 350).
  132.  
  133. For a list of Jewish holidays in the current Gregorian (Common) year,
  134. replace /<year> with /y. For a list of Jewish holidays in the current month,
  135. plus the holidays in the following month if the current day-of-month is the
  136. 15th or greater, use /m instead of /y.
  137.  
  138. To obtain a list of Jewish holidays in a Julian year, proceed as above but
  139. append the letter "j" to the numerical year (e.g., 1492j instead of 1492). 
  140.  
  141. The holiday lists can be saved to a file or printed out to hardcopy by
  142. redirecting the output of the commands to a file or printer, using the
  143. greater-than sign (>) and name of file or device (lpt1 for printer
  144. connected to lpt1), the same as with MS-DOS commands.
  145.  
  146.  
  147. (4) Note on Earliest Observance of Jewish Holidays.
  148.  
  149. For the religious holidays not described in the Torah, the earliest year in 
  150. which each holiday appears in the various holiday lists produced by HebrDate 
  151. is intended to be more-or-less historically correct, but is based only on
  152. the search of a few reference sources. Any corrections anyone wants to offer
  153. will be appreciated. The information on the earliest observance for the
  154. Israeli national holidays was obtained from the Government of Israel
  155. Information Service. The earliest observances used in HebrDate are as
  156. follows:
  157. (Since HebrDate goes back only to the Gregorian year 1, any earliest 
  158. observance prior to that date is noted as "no problem". Dates are 
  159. Gregorian, or C.E.)
  160.  
  161.   Tu B'Shevat - 200 (Date when Rabbi Judah HaNasi published traditions
  162.                      of Mishna, where Tu B'Shevat is discussed.)
  163.   Purim, Pesach - no problem
  164.   Yom Ha'Shoah - 1950
  165.   Yom Hazikaron - 1948
  166.   Yom Ha'Atzma'ut - 1948
  167.   Lag Ba'Omer - 138  (Marks pause in Hadrian's oppression after Bar Kochba
  168.                       revolt of 131-5; Hadrian died in 138.)
  169.   Yom Yerushalayim - 1967
  170.   Shavuot, Tisha B'Av, Rosh Hashana, Yom Kippur - no problem
  171.   Sukkot, Shemini Atzeret, Hanukkah - no problem
  172.   Simchat Torah - no problem  (Although Simchat Torah in its present form
  173.                               was not defined until a few hundred years ago,
  174.                               it apparently started with the 1 year cycle of
  175.                               Torah reading during the Babylonian exile, and 
  176.                               was no doubt brought back to Israel with the
  177.                               returning exiles.)
  178.  
  179.  
  180. (5) Slightly Technical Note on Holidays in the Distant Future.
  181.  
  182. The Jewish holidays for Gregorian years are produced by this program only 
  183. for years up to the Gregorian year 6460. (This should cover most early 
  184. planning needs.) The current Hebrew calendar drifts forward relative to the 
  185. Gregorian calendar (and the seasons) at the average rate of 4.32 days per 
  186. thousand years (based upon a least-squares straight-line fit to the  
  187. Gregorian day-of-year corresponding to fixed Hebrew dates, using yearly data 
  188. from Gregorian 1 to Gregorian 7000). By the Gregorian year 6461 (Hebrew year
  189. 10222), the drift will have amounted to 28 days since year 1 of the 
  190. Gregorian calendar. There will no doubt be a one-time calendar fix
  191. instituted at that time to slip back 28 days (e.g., by dropping Adar-II 
  192. from the year 10222 and adding one day to Adar-I to make a 31-day Adar), 
  193. but until we know for sure, we'll quit at 6460 CE.
  194.  
  195.                         * * * * * * * * * * 
  196.  
  197. The date calculation source coding for HEBRDATE.EXE is based upon algorithms 
  198. described by the Lisp code in "Calendrical Calculations" by Nachum Dershowitz 
  199. and Edward M. Reingold, Software---Practice & Experience, vol. 20, no. 9
  200. (September, 1990), pp. 899--928 (with 5/19/93 correction by EMR).
  201.  
  202. HEBRDATE.EXE is freeware. Permission is granted for unrestricted
  203. noncommercial use.
  204.  
  205. Irving Maron
  206. Mount Laurel, NJ
  207.  
  208. Compuserve address: 76614,2666
  209. e-mail address: 76614.2666@compuserve.com
  210.  
  211. October 5, 1995
  212. Tishri 11, 5756
  213.