home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 5 / FreshFish_July-August1994.bin / bbs / dev / date-33.087.lha / Date-33.087 / doc / Date.doc
Text File  |  1994-04-13  |  60KB  |  2,545 lines

  1. TABLE OF CONTENTS
  2.  
  3. Date/--background--
  4. Date/--history--
  5. Date/_DateInit
  6. Date/GregorianDayDiff
  7. Date/GregorianDayGreater
  8. Date/GregorianDaysAfterWeekday
  9. Date/GregorianDaysBeforeWeekday
  10. Date/GregorianDaySmaller
  11. Date/GregorianDiffDate
  12. Date/GregorianEaster
  13. Date/GregorianLeapYear
  14. Date/GregorianMonthDays
  15. Date/GregorianMoonAge
  16. Date/GregorianToJD
  17. Date/GregorianWeek
  18. Date/GregorianWeekday
  19. Date/GregorianYearDays
  20. Date/GSYearToJD
  21. Date/GYearToScaliger
  22. Date/HeisDayDiff
  23. Date/HeisDayGreater
  24. Date/HeisDaysAfterWeekday
  25. Date/HeisDaysBeforeWeekday
  26. Date/HeisDaySmaller
  27. Date/HeisDiffDate
  28. Date/HeisLeapYear
  29. Date/HeisMonthDays
  30. Date/HeisToJD
  31. Date/HeisWeek
  32. Date/HeisWeekday
  33. Date/HeisYearDays
  34. Date/HSYearToJD
  35. Date/HYearToScaliger
  36. Date/JDtoMJD
  37. Date/JDToTime
  38. Date/JSYearToJD
  39. Date/JulianDayDiff
  40. Date/JulianDayGreater
  41. Date/JulianDaysAfterWeekday
  42. Date/JulianDaysBeforeWeekday
  43. Date/JulianDaySmaller
  44. Date/JulianDiffDate
  45. Date/JulianLeapYear
  46. Date/JulianMonthDays
  47. Date/JulianToJD
  48. Date/JulianWeek
  49. Date/JulianWeekday
  50. Date/JulianYearDays
  51. Date/JYearToScaliger
  52. Date/LMT
  53. Date/MJDtoJD
  54. Date/ScaligerYearToG
  55. Date/ScaligerYearToH
  56. Date/ScaligerYearToJ
  57. Date/SecToTime
  58. Date/TimeToJD
  59. Date/TimeToSec
  60. Date/TimeZoneFactor
  61. Date/--background--                                       Date/--background--
  62.  
  63.    NAME
  64.     Date -- This module was designed to help calc. calendar dates (V33)
  65.  
  66.    FUNCTION
  67.     I know about the date routines in the Amiga-OS(TM), but i decided
  68.     not to use them, because of their limited functionality and of
  69.     the portability of this Module!
  70.  
  71.    NOTES
  72.     A tropical year is 365.2422 days! / 365d, 5h, 48min, 46sec
  73.     A moon month is 29.53059 days! / 29d, 12h, 44min, 2.9 sec
  74.     A moon phase is 7.38265 days!
  75.  
  76.     (german) Books who helped me creating this library:
  77.         Kleine Naturwissenschaftliche Bibliothek, Band 23
  78.         Ewige Kalender
  79.         A.W. Butkewitsch & M.S. Selikson
  80.         5. Auflage
  81.         Teubner, Leipzig 1974
  82.         ISBN 3-322-00393-0
  83.  
  84.         Tag und Woche, Monat und Jahr: eine Kulturgeschichte des
  85.         Kalenders
  86.         Rudolf Wendorff
  87.         Westdeutscher, Opladen 1993
  88.         ISBN 3-531-12417-X
  89.  
  90.         Kalender und Chronologie: Bekanntes & Unbekanntes aus der
  91.         Kalenderwissenschaft
  92.         Heinz Zemanek
  93.         4. Auflage
  94.         Oldenbourg, München 1987
  95.         ISBN 3-486-20447-5
  96.  
  97.         Meyers Handbuch
  98.         über das Weltall
  99.         Karl Schaifers & Gerhard Traving
  100.         5. Auflage
  101.         Bibliographisches Institut Mannheim 1973
  102.         ISBN 3-411-00940-3
  103.  
  104.     (english) Books who helped me creating this:
  105.         Mathematical Astronomy with a Pocket Calculator
  106.         Aubrey Jones Fras
  107.         unknown(first) Edition
  108.         David & Charles Newton Abbot, London 1978
  109.         ISBN 0-7153-7675-6
  110.  
  111.    COPYRIGHT
  112.     This module is Copyright 1994 by Kai Hofmann - all rights reserved!
  113.     For private use, Public Domain, Gift Ware, Freeware and Shareware
  114.     you could use this module under following conditions:
  115.     - You send me a little gift (money is very welcome :)
  116.         For Bank Accocunt see below - but *ONLY* send in DM
  117.         to this Bank Account!!!
  118.       Other nice gifts: all Amiga hardware, and i am searching for a
  119.       good old 1541 (C64 floppy)
  120.     - You include a notice in your product, that you use this library
  121.       and that it is Copyright by Kai Hofmann!
  122.     If you want to redistribute this library read the following points:
  123.     - Redistribution warranty is given to:
  124.         Fred Fish for his great Amiga-Software-Library
  125.         The german SAAR AG PD-Library
  126.         The german AMOK PD-Library
  127.         All public accessible INTERNET servers and PHONE boxes!
  128.         All other who NOT take more than DM 5.- for one disk
  129.         ALL other who NOT take more than DM 50.- for one CD
  130.     For commercial use send me DM 200.-
  131.     But if you are Apple or Microsoft you have to send (20000.- US$)
  132.  
  133.    DISCLAIMER
  134.  
  135.       THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
  136.    APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
  137.    HOLDER AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
  138.    OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
  139.    THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  140.    PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
  141.    PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE
  142.    COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
  143.  
  144.       IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
  145.    WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY REDISTRIBUTE THE
  146.    PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
  147.    GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
  148.    USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS
  149.    OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR
  150.    THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
  151.    PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
  152.    POSSIBILITY OF SUCH DAMAGES.
  153.  
  154.    ADDITIONAL INFORMATIONS
  155.     I have tried to make portable/usefull and i hope bugfree software
  156.     for eternity - but this seems to be impossible (sorry!) :)
  157.     So i hope YOU will pay a fee for this.
  158.  
  159.    AUTHOR
  160.     Kai Hofmann
  161.     Arberger Heerstraße 92
  162.     28307 Bremen
  163.     Germany
  164.     EMail: i07m@zfn.uni-bremen.de
  165.     (no phone - i hate it!)
  166.  
  167.     Bank account : 1203 7503
  168.     Account owner: Kai Hofmann
  169.     Bank code    : 290 501 01
  170.     Bank name    : Sparkasse in Bremen
  171.  
  172.     THANX
  173.     Thanx are going to the following people:
  174.     Danial Armor        - For his hint about the Oberon-2 SHORT
  175.                   command
  176.     Heinz Zemanek        - For his great book
  177.     Christian Schaefer    - For spending time on this lib with his
  178.                   Borland C++ 4.0 compiler
  179.  
  180. Date/--history--                                             Date/--history--
  181.  
  182.    NAME
  183.     history -- This is the development history of the Date module
  184.  
  185.    VERSION
  186.     $VER: Date 33.087 (10.04.1994)
  187.  
  188.    HISTORY
  189.     16.01.1994 -    Procedures: JulianLeapYear, GregorianLeapYear &
  190.             HeisLeapYear initiated.
  191.     22.01.1994 -    Procedures: JulianMonthDays, GregorianMonthDays,
  192.             HeisMonthDays, JulianYearDays, GregorianYearDays,
  193.             HeisYearDays, JulianDayDiff, GregorianDayDiff,
  194.             HeisDayDiff, JulianDaySmaller, GregorianDaySmaller,
  195.             HeisDaySmaller, JulianWeekday, GregorianWeekday,
  196.             HeisWeekday, JulianDaysBeforeWeekday,
  197.             GregorianDaysBeforeWeekday, HeisDaysBeforeWeekday,
  198.             JulianDaysAfterWeekday, GregorianDaysAfterWeekday,
  199.             HeisDaysAfterWeekday JulianDiffDate, FreeDate
  200.             initiated.
  201.             Types: Weekdays, Date, DatePtr initiated.
  202.             Vars of Gregorian reform initiated
  203.             (for changing to different countries)
  204.     23.01.1994 -    Procedures: JulianDiffDate finished,
  205.             GregorianDiffDate, HeisDiffDate, JYearToScaliger,
  206.             GYearToScaliger, HYearToScaliger, ScaligerYearToJ,
  207.             ScaligerYearToG, ScaligerYearToH, JSYearToJD,
  208.             GSYearToJD, HSYearToJD, JDtoMJD, MJDtoJD, JulianToJD,
  209.             GregorianToJD, HeisToJD, TimeToJD, JDToTime, FreeTime
  210.             initiated.
  211.             Types: Time, TimePtr initiated.
  212.     28.01.1994 -    Procedures: GregorianMoonAge, MoonMonthAge,
  213.             GregorianEaster initiated.
  214.     30.01.1994 -    Procedures: JulianDiffDate, GregorianDiffDate,
  215.             HeisDiffDate, JDtoTime, GregorianEaster edited
  216.             (changing return value from ptr to VAL variables).
  217.             Procedures: FreeDate, FreeTime deleted.
  218.             Types: Date, DatePtr, Time, TimePtr deleted (not
  219.             longer needed, because of the procedure changes).
  220.             Procedures: GregorianMoonAge, GregorianEaster changed
  221.             year parameter from CARDINAL to INTEGER (this is more
  222.             consistent to the rest of the library).
  223.             Bugs removed: GregorianWeekday, HeisWeekday
  224.             (before removing, the weekday for leapyears was
  225.             wrong)
  226.             Procedure: GregorianEaster finished.
  227.     30.01.1994 -    Ported to Oberon-2
  228.     31.01.1994 -    Compiled with Oberon-2 V3.11
  229.     12.02.1994 -    Procedures: TimeZoneFactor, LMT, TimeToSec, SecToTime
  230.             initiated.
  231.             Version-String installed :)
  232.     12.02.1994 -    Starting translation to SAS C 6.51
  233.             Date.h translated
  234.     13.02.1994 -    Continuation of C translation
  235.     17.02.1994 -    New Oberon-2 Port, because yesterday Daniel Armor
  236.             gives me a little hint about the SHORT command
  237.             (i was not knowing about this!)
  238.     17.02.1994 -    Little bug in Autodocs removed
  239.             making this text as Date/--history-- autodoc
  240.     17.02.1994 -    Continuation of C translation
  241.     18.02.1994 -    Finished with C tra