Bestimmung der Zeitpunkte von Ereignissen
ulrich
2023-03-19 8cf8493e4b918cece529fef978d50c8b9835d230
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
/*
  Zeitrechnung - a class library to determine calendar events
  Copyright (c) 1984-2023 Ulrich Hilger, http://uhilger.de
 
  This program is free software: you can redistribute it and/or modify
  it under the terms of the GNU Affero General Public License as published by
  the Free Software Foundation, either version 3 of the License, or
  (at your option) any later version.
 
  This program is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  GNU Affero General Public License for more details.
 
  You should have received a copy of the GNU Affero General Public License
  along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */
package de.uhilger.zeitrechnung.kalender;
 
import de.uhilger.zeitrechnung.Datum;
import de.uhilger.zeitrechnung.Definition;
 
/**
 * Die Klasse JulianischerKalender dient zur Umwandlung von generischem 
 * Datum zu julianischem Datum und umgekehrt.
 * 
 * <p>
 * Diese Klasse modelliert das Julianische Kalendersystem. Das hiermit  
 * berechnete generische Datum ist nicht das Julianische Datum, wie es in 
 * der Astronomie verwendet wird .
 * </p>
 * 
 * @author Ulrich Hilger
 */
public class JulianischerKalender extends BasisKalender implements Wandler {
  
    /** 
   * Als Starttag wird der 1. Jaunuar 1 im julianischen Kalender festgelegt.
   * 1. Januar 1 (jul) entspricht dem 30. Dezember 0 (greg). 
   */
    public static final long STARTTAG = 
          new ISOKalender().zuTagen(0, Definition.DEZEMBER, 30);
 
  /* ------- Schnittstelle Wandler -------------- */
  
  /**
   * Ein Datum im julianischen Kalender zu einem generischen Datum wandeln
   * 
   * @param jahr das Jahr im julianischen Kalender, 
   *    negative Zahlen entsprechen 'v. Chr.' bzw. 'vor unserer Zeit / v.u.Z.' 
   *    oder engl. before common era / BCE,
   * @param monat der Monat im julianischen Kalender
   * @param tag der Tag im julinaischen Kalender
   * @return das generische Datum
   */
  @Override
  public long zuTagen(long jahr, int monat, int tag) {
        long y = jahr < 0 ? jahr + 1 : jahr;
        return STARTTAG - 1
            + 365 * (y - 1)
            + ganzzahlQuotient(y - 1, 4)
            + ganzzahlQuotient(367 * monat - 362, 12)
            + (monat <= 2 ? 0 :
                (schaltjahr(jahr) ? -1 : -2))
            + tag;
  }
 
  /**
   * Ein Datum im julianischen Kalender zu einem generischen Datum wandeln
   * 
   * @param d das Datum im julianischen Kalender
   * @return das generische Datum
   */
  @Override
  public long zuTagen(Datum d) {
    return zuTagen(d.getJahr(), d.getMonat(), d.getTag());
  }
 
  /**
   * Das julianische Datum aus einem generischen Datum bestimmen 
   * 
   * @param tage das generische Datum
   * @return  das julianische Datum
   */
  @Override
  public Datum vonTagen(long tage) {
        long approx = ganzzahlQuotient(4 * (tage - STARTTAG) + 1464, 1461);
    long jahr = approx <= 0 ? approx - 1 : approx;
        long tageDavor = tage - zuTagen(jahr, Definition.JANUAR, 1);
        int korrektur = tage < zuTagen(jahr, Definition.MAERZ, 1) ? 0 : (schaltjahr(jahr) ? 1 : 2);
        int monat = (int)ganzzahlQuotient(12 * (tageDavor + korrektur) + 373, 367);
        int tag = (int)(tage - zuTagen(jahr, monat, 1) + 1);
    return new Datum(jahr, monat, tag);
  }
  
  /* ------------ Besonderheiten des Julianischen Kalenders ---------- */
  
  /**
   * Julianisches Schaltjahr
   * @param jYear julianisches Jahr
   * @return true, wenn Schaltjahr, false wenn nicht
   */
    public boolean schaltjahr(long jYear) {
        return modulo(jYear, 4) == (jYear > 0 ? 0 : 3);
    }
      
    public long BCE(long n) {
        return -n;
    }
 
    public long CE(long n) {
        return n;
    }
}