Fresh Fish 8/FreshFishVol8-CD2.bin/bbs/dev/date-33.088.lha/Date/doc/Date.doc

Text File | 1994-08-11 | 61KB | 2,549 lines

TABLE OF CONTENTS

Date/--background--
Date/--history--
Date/_DateInit
Date/GregorianDayDiff
Date/GregorianDayGreater
Date/GregorianDaysAfterWeekday
Date/GregorianDaysBeforeWeekday
Date/GregorianDaySmaller
Date/GregorianDiffDate
Date/GregorianEaster
Date/GregorianLeapYear
Date/GregorianMonthDays
Date/GregorianMoonAge
Date/GregorianToJD
Date/GregorianWeek
Date/GregorianWeekday
Date/GregorianYearDays
Date/GSYearToJD
Date/GYearToScaliger
Date/HeisDayDiff
Date/HeisDayGreater
Date/HeisDaysAfterWeekday
Date/HeisDaysBeforeWeekday
Date/HeisDaySmaller
Date/HeisDiffDate
Date/HeisLeapYear
Date/HeisMonthDays
Date/HeisToJD
Date/HeisWeek
Date/HeisWeekday
Date/HeisYearDays
Date/HSYearToJD
Date/HYearToScaliger
Date/JDtoMJD
Date/JDToTime
Date/JSYearToJD
Date/JulianDayDiff
Date/JulianDayGreater
Date/JulianDaysAfterWeekday
Date/JulianDaysBeforeWeekday
Date/JulianDaySmaller
Date/JulianDiffDate
Date/JulianLeapYear
Date/JulianMonthDays
Date/JulianToJD
Date/JulianWeek
Date/JulianWeekday
Date/JulianYearDays
Date/JYearToScaliger
Date/LMT
Date/MJDtoJD
Date/ScaligerYearToG
Date/ScaligerYearToH
Date/ScaligerYearToJ
Date/SecToTime
Date/TimeToJD
Date/TimeToSec
Date/TimeZoneFactor
Date/--background--                                       Date/--background--

   NAME
    Date -- This module was designed to help calc. calendar dates (V33)

   FUNCTION
    I know about the date routines in the Amiga-OS(TM), but I decided
    not to use them because of their limited functionalities and of
    the portability of this module!

   NOTES
    A tropical year is 365.2422 days! / 365d, 5h, 48min, 46sec
    A moon month is 29.53059 days! / 29d, 12h, 44min, 2.9 sec
    A moon phase is 7.38265 days!

    (German) Books which helped me creating this library:
        Kleine Naturwissenschaftliche Bibliothek, Band 23
        Ewige Kalender
        A.W. Butkewitsch & M.S. Selikson
        5. Auflage
        Teubner, Leipzig 1974
        ISBN 3-322-00393-0

        Tag und Woche, Monat und Jahr: eine Kulturgeschichte des
        Kalenders
        Rudolf Wendorff
        Westdeutscher, Opladen 1993
        ISBN 3-531-12417-X

        Kalender und Chronologie: Bekanntes & Unbekanntes aus der
        Kalenderwissenschaft
        Heinz Zemanek
        4. Auflage
        Oldenbourg, München 1987
        ISBN 3-486-20447-5

        Meyers Handbuch
        über das Weltall
        Karl Schaifers & Gerhard Traving
        5. Auflage
        Bibliographisches Institut Mannheim 1973
        ISBN 3-411-00940-3

    (English) Books which helped me creating this library:
        Mathematical Astronomy with a Pocket Calculator
        Aubrey Jones Fras
        unknown(first) Edition
        David & Charles Newton Abbot, London 1978
        ISBN 0-7153-7675-6

   COPYRIGHT
    This module is Copyright 1994 by Kai Hofmann - all rights reserved!
    For private use, Public Domain, Gift Ware, Freeware and Shareware
    you could use this module under following conditions:
    - You send me a little gift (money is very welcome :)
        For Bank Account see below - but *ONLY* send in DM
        to this Bank Account!!!
      Other nice gifts: all Amiga hardware, and I am searching for a
      good old 1541 (C64 floppy)
    - You include a notice in your product, that you use this library
      and that it is Copyright by Kai Hofmann!
    If you want to redistribute this library read the following points:
    - Redistribution warranty is given to:
        Fred Fish for his great Amiga-Software-Library
        The German SAAR AG PD-Library
        The German AMOK PD-Library
        All public accessible INTERNET servers and PHONE boxes!
        All others who do NOT take more than DM 5.- for one disk
        ALL others who do NOT take more than DM 50.- for one CD
    For commercial use send me DM 200.-
    But if you are Apple or Microsoft you have to send (20000.- US$)

   DISCLAIMER

      THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
   APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
   HOLDER AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
   OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
   THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
   PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
   PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE
   COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.

      IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
   WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY REDISTRIBUTE THE
   PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
   GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
   USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS
   OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR
   THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
   PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
   POSSIBILITY OF SUCH DAMAGES.

   ADDITIONAL INFORMATIONS
    I have tried to make portable/useful and I hope bugfree software
    for eternity - but this seems to be impossible (sorry!) :)
    So I hope you will pay a fee for this.

   AUTHOR
    Kai Hofmann
    Arberger Heerstraße 92
    28307 Bremen
    Germany
    EMail: [e-mail]
    (no phone - I hate it!)

    Bank account : 1203 7503
    Account owner: Kai Hofmann
    Bank code    : 290 501 01
    Bank name    : Sparkasse in Bremen

    THANX
    Thanx are going to the following people:
    Danial Armor        - For his hint about the Oberon-2 SHORT
                  command
    Heinz Zemanek        - For his great book
    Christian Schaefer    - For spending time on this lib with his
                  Borland C++ 4.0 compiler
    Rita Reichl        - For correcting my bad english ;-)

Date/--history--                                             Date/--history--

   NAME
    history -- This is the development history of the Date module

   VERSION
    $VER: Date 33.088 (11.08.1994)

   HISTORY
    16.01.1994 -    Procedures: JulianLeapYear, GregorianLeapYear &
            HeisLeapYear initiated.
    22.01.1994 -    Procedures: JulianMonthDays, GregorianMonthDays,
            HeisMonthDays, JulianYearDays, GregorianYearDays,
            HeisYearDays, JulianDayDiff, GregorianDayDiff,
            HeisDayDiff, JulianDaySmaller, GregorianDaySmaller,
            HeisDaySmaller, JulianWeekday, GregorianWeekday,
            HeisWeekday, JulianDaysBeforeWeekday,
            GregorianDaysBeforeWeekday, HeisDaysBeforeWeekday,
            JulianDaysAfterWeekday, GregorianDaysAfterWeekday,
            HeisDaysAfterWeekday JulianDiffDate, FreeDate
            initiated.
            Types: Weekdays, Date, DatePtr initiated.
            Vars of Gregorian reform initiated
            (for changing to different countries)
    23.01.1994 -    Procedures: JulianDiffDate finished,
            GregorianDiffDate, HeisDiffDate, JYearToScaliger,
            GYearToScaliger, HYearToScaliger, ScaligerYearToJ,
            ScaligerYearToG, ScaligerYearToH, JSYearToJD,
            GSYearToJD, HSYearToJD, JDtoMJD, MJDtoJD, JulianToJD,
            GregorianToJD, HeisToJD, TimeToJD, JDToTime, FreeTime
            initiated.
            Types: Time, TimePtr initiated.
    28.01.1994 -    Procedures: GregorianMoonAge, MoonMonthAge,
            GregorianEaster initiated.
    30.01.1994 -    Procedures: JulianDiffDate, GregorianDiffDate,
            HeisDiffDate, JDtoTime, GregorianEaster edited
            (changing return value from ptr to VAL variables).
            Procedures: FreeDate, FreeTime deleted.
            Types: Date, DatePtr, Time, TimePtr deleted (not
            longer needed, because of the procedure changes).
            Procedures: GregorianMoonAge, GregorianEaster changed
            year parameter from CARDINAL to INTEGER (this is more
            consistent to the rest of the library).
            Bugs removed: GregorianWeekday, HeisWeekday
            (before removing, the weekday for leapyears was
            wrong)
            Procedure: GregorianEaster finished.
    30.01.1994 -    Ported to Oberon-2
    31.01.1994 -    Compiled with Oberon-2 V3.11
    12.02.1994 -    Procedures: TimeZoneFactor, LMT, TimeToSec, SecToTime
            initiated.
            Version-String installed :)
    12.02.1994 -    Starting translation to SAS C 6.51
            Date.h translated
    13.02.1994 -    Continuation of C translation
    17.02.1994 -    New Oberon-2 Port, because yesterday Daniel Armor
            gives me a small hint about the SHORT command
            (I did not know about this!)
    17.02.1994 -    Small bug in Autodocs removed
            making this text as Date/--history-- autodoc
    17.02.1994 -