Weitere aktuelle Java-Titel finden Sie bei dpunkt.
 Inhaltsverzeichnis   Vorhergehendes Paket   Seite Zurück   Seite Vor   Nächstes Paket   Paketübersicht   Index

Klasse java.util.Calendar1.1

java.lang.Object
   |
   +--java.util.Calendar

Deklaration

public abstract class Calendar
extends java.lang.Object
implements java.io.Serializable, java.lang.Cloneable

Beschreibung

Die abstrakte Klasse Calendar dient als Basis für Klassen, die einen Kalender eines bestimmten Zeitrechnungssystems implementieren. Jedes Calendar-Objekt stellt einen bestimmten Zeitpunkt in der Zeitrechnung dar, wobei Parameter wie Zeitzone und Sommerzeit berücksichtigt werden.


 
Datenelemente
public final static intERA
public final static intYEAR
public final static intMONTH
public final static intWEEK_OF_YEAR
public final static intWEEK_OF_MONTH
public final static intDATE
public final static intDAY_OF_MONTH
public final static intDAY_OF_YEAR
public final static intDAY_OF_WEEK
public final static intDAY_OF_WEEK_IN_MONTH
public final static intAM_PM
public final static intHOUR
public final static intHOUR_OF_DAY
public final static intMINUTE
public final static intSECOND
public final static intMILLISECOND
public final static intZONE_OFFSET
public final static intDST_OFFSET
public final static intFIELD_COUNT
public final static intSUNDAY
public final static intMONDAY
public final static intTUESDAY
public final static intWEDNESDAY
public final static intTHURSDAY
public final static intFRIDAY
public final static intSATURDAY
public final static intJANUARY
public final static intFEBRUARY
public final static intMARCH
public final static intAPRIL
public final static intMAY
public final static intJUNE
public final static intJULY
public final static intAUGUST
public final static intSEPTEMBER
public final static intOCTOBER
public final static intNOVEMBER
public final static intDECEMBER
public final static intUNDECIMBER
public final static intAM
public final static intPM
protected booleanareFieldsSet
protected int[]fields
protected boolean[]isSet
protected longtime
protected booleanisTimeSet
 
Konstruktoren
protectedCalendar()
protectedCalendar(TimeZone zone, Locale aLocale)
 
Methoden
public abstract voidadd(int field, int amount)
public abstract booleanafter(Object when)
public abstract booleanbefore(Object when)
public final voidclear()
public final voidclear(int field)
public Objectclone()
protected voidcomplete()
protected abstract voidcomputeFields()
protected abstract voidcomputeTime()
public abstract booleanequals(Object when)
public final intget(int field)
public static Locale[]getAvailableLocales()
public intgetFirstDayOfWeek()
public abstract intgetGreatestMinimum(int field)
public static synchronized CalendargetInstance()
public static synchronized CalendargetInstance(Locale aLocale)
public static synchronized CalendargetInstance(TimeZone zone)
public static synchronized CalendargetInstance(TimeZone zone, Locale aLocale)
public abstract intgetLeastMaximum(int field)
public abstract intgetMaximum(int field)
public intgetMinimalDaysInFirstWeek()
public abstract intgetMinimum(int field)
public final DategetTime()
protected longgetTimeInMillis()
public TimeZonegetTimeZone()
protected final intinternalGet(int field)
public booleanisLenient()
public final booleanisSet(int field)
public voidroll(int field, int amount)     [1.2]
public abstract voidroll(int field, boolean up)
public final voidset(int field, int value)
public final voidset(int year, int month, int date)
public final voidset(int year, int month, int date, int hour, int minute)
public final voidset(int year, int month, int date, int hour, int minute, int second)
public voidsetFirstDayOfWeek(int value)
public voidsetLenient(boolean lenient)
public voidsetMinimalDaysInFirstWeek(int value)
public final voidsetTime(Date date)
protected voidsetTimeInMillis(long millis)
public voidsetTimeZone(TimeZone value)
public StringtoString()     [1.2]


 

Datenelemente im Detail

public final static int ERA
Zeitfeldkonstante für die Epoche des Kalenders.
public final static int YEAR
Zeitfeldkonstante für das Jahr.
public final static int MONTH
Zeitfeldkonstante für den Monat.
public final static int WEEK_OF_YEAR
Zeitfeldkonstante für die Kalenderwoche.
public final static int WEEK_OF_MONTH
Zeitfeldkonstante für die Woche im Monat.
public final static int DATE
Zeitfeldkonstante für das Datum.
public final static int DAY_OF_MONTH
Zeitfeldkonstante für das Datum.
public final static int DAY_OF_YEAR
Zeitfeldkonstante für den Tag im Jahr.
public final static int DAY_OF_WEEK
Zeitfeldkonstante für den Wochentag.
public final static int DAY_OF_WEEK_IN_MONTH
Zeitfeldkonstante für den Wochentag.
public final static int AM_PM
Zeitfeldkonstante für Vormittag/Nachmittag.
public final static int HOUR
Zeitfeldkonstante für die Stunde.
public final static int HOUR_OF_DAY
Zeitfeldkonstante für die Stunde des Tages.
public final static int MINUTE
Zeitfeldkonstante für die Minute.
public final static int SECOND
Zeitfeldkonstante für die Sekunde.
public final static int MILLISECOND
Zeitfeldkonstante für die Millisekunden.
public final static int ZONE_OFFSET
Zeitfeldkonstante für die Zeitverschiebung der Zeitzone.
public final static int DST_OFFSET
Zeitfeldkonstante für die Zeitverschiebung der Sommerzeit.
public final static int FIELD_COUNT
Die Anzahl der Zeitfelder.
public final static int SUNDAY
Konstante für DAY_OF_WEEK.
public final static int MONDAY
Konstante für DAY_OF_WEEK.
public final static int TUESDAY
Konstante für DAY_OF_WEEK.
public final static int WEDNESDAY
Konstante für DAY_OF_WEEK.
public final static int THURSDAY
Konstante für DAY_OF_WEEK.
public final static int FRIDAY
Konstante für DAY_OF_WEEK.
public final static int SATURDAY
Konstante für DAY_OF_WEEK.
public final static int JANUARY
Konstante für MONTH.
public final static int FEBRUARY
Konstante für MONTH.
public final static int MARCH
Konstante für MONTH.
public final static int APRIL
Konstante für MONTH.
public final static int MAY
Konstante für MONTH.
public final static int JUNE
Konstante für MONTH.
public final static int JULY
Konstante für MONTH.
public final static int AUGUST
Konstante für MONTH.
public final static int SEPTEMBER
Konstante für MONTH.
public final static int OCTOBER
Konstante für MONTH.
public final static int NOVEMBER
Konstante für MONTH.
public final static int DECEMBER
Konstante für MONTH.
public final static int UNDECIMBER
Konstante für MONTH.
public final static int AM
Konstante für HOUR.
public final static int PM
Konstante für HOUR.
protected boolean areFieldsSet
Signalisiert, ob die Zeitfelder gefüllt sind.
protected int[] fields
Die Zeitfelder.
protected boolean[] isSet
Flag-Array, das angibt, ob die einzelnen Zeitfelder richtig gefüllt sind.
protected long time
Enthält den dargestellten Zeitpunkt des Kalenders.
protected boolean isTimeSet
Ist true, wenn alle Zeitfelder richtig gesetzt sind, oder false, wenn noch Überlaufkorrekturen vorzunehmen sind.

 

Konstruktoren im Detail

protected Calendar()
Erzeugt ein neues Calendar-Objekt für die voreingestellte Zeitzone und die voreingestellten länderspezifischen Einstellungen.
protected Calendar(TimeZone zone, Locale aLocale)
Erzeugt ein neues Calendar-Objekt für die Zeitzone zone mit den länderspezifischen Einstellungen aLocale.

 

Methoden im Detail

public abstract void add(int field, int amount)
Addiert eine Zeitspanne zum dargestellten Zeitpunkt. Die Einheit wird durch field und die Größe durch amount festgelegt. Für field können Konstanten wie YEAR oder MINUTE übergeben werden.
public abstract boolean after(Object when)
Liefert true, falls der von diesem Calendar-Objekt dargestellte Zeitpunkt nach dem des Objekts when liegt, sonst false. Für when wird üblicherweise ein Exemplar von Calendar oder einer Unterklasse übergeben.
public abstract boolean before(Object when)
Liefert true, falls der von diesem Calendar-Objekt dargestellte Zeitpunkt vor dem des Objekts when liegt, sonst false. Für when wird üblicherweise ein Exemplar von Calendar oder einer Unterklasse übergeben.
public final void clear()
Setzt die Werte des Objekts zurück.
public final void clear(int field)
Setzt den durch field spezifizierten Wert zurück. Für field wird eine der Zeitfeldkonstanten von ERA bis DST_OFFSET übergeben.
public Object clone()
Erzeugt eine Kopie des Objekts und liefert sie zurück.
protected void complete()
Berechnet und setzt noch fehlende Zeitfelder.
protected abstract void computeFields()
Setzt noch fehlende Zeitfelder.
protected abstract void computeTime()
Berechnet den dargestellten Zeitpunkt anhand der momentanen Werte der Zeitfelder.
public abstract boolean equals(Object when)
Liefert true, falls when ein Exemplar derselben Kalenderklasse ist, die denselben Zeitpunkt darstellt, sonst false.
public final int get(int field)
Liefert den Wert des durch field bestimmten Zeitfelds. Für field wird eine der Konstanten von ERA bis DST_OFFSET übergeben.
public static Locale[] getAvailableLocales()
Liefert alle länderspezifischen Einstellungen, für die spezielle Kalender-Objekte verfügbar sind.
public int getFirstDayOfWeek()
Liefert den Wochentag, der als erster Tag der Woche gilt.
public abstract int getGreatestMinimum(int field)
Liefert den größten Minimalwert für das mit field spezifizierte Zeitfeld, der im Lauf eines Jahres vorkommen kann.
public static synchronized Calendar getInstance()
Liefert eine Implementierung der Calendar-Klasse, wobei die Zeitzone und Länderspezifika den Voreinstellungen entsprechen. Standardmäßig werden Exemplare von GregorianCalendar geliefert.
public static synchronized Calendar getInstance(Locale aLocale)
Liefert eine Implementierung der Calendar-Klasse, wobei die voreingestellte Zeitzone und die Länderspezifika aLocale verwendet werden. Standardmäßig werden Exemplare von GregorianCalendar geliefert.
public static synchronized Calendar getInstance(TimeZone zone)
Liefert eine Implementierung der Calendar-Klasse, wobei die Zeitzone zone und die voreingestellten Länderspezifika verwendet werden. Standardmäßig werden Exemplare von GregorianCalendar geliefert.
public static synchronized Calendar getInstance(TimeZone zone, Locale aLocale)
Liefert eine Implementierung der Calendar-Klasse, wobei die Zeitzone zone und die Länderspezifika aLocale verwendet werden. Standardmäßig werden Exemplare von GregorianCalendar geliefert.
public abstract int getLeastMaximum(int field)
Liefert den kleinsten Maximalwert für das mit field spezifizierte Zeitfeld, der im Lauf eines Jahres vorkommen kann (z. B. 28 für DAY_OF_MONTH beim gregorianschen Kalender).
public abstract int getMaximum(int field)
Liefert den Maximalwert für das durch field festgelegte Zeitfeld. Für field wird eine der Konstanten von ERA bis DST_OFFSET übergeben.
public int getMinimalDaysInFirstWeek()
Liefert die Anzahl an Tagen, die die Woche am Jahresanfang haben muß, damit sie als erste Kalenderwoche gilt.
public abstract int getMinimum(int field)
Liefert den Minimalwert für das durch field festgelegte Zeitfeld. Für field wird eine der Konstanten von ERA bis DST_OFFSET übergeben.
public final Date getTime()
Liefert die dargestellten Zeitpunkt als Date-Objekt.
protected long getTimeInMillis()
Liefert den dargestellten Zeitpunkt in Millisekunden seit dem Bezugspunkt des Kalenders (z. B. 01.01.1970, 00.00h beim GregorianCalendar).
public TimeZone getTimeZone()
Liefert die Zeitzone des Kalenders.
protected final int internalGet(int field)
Wie get(int). Kann intern von Unterklassen zum effizienteren Zugriff benutzt werden.
public boolean isLenient()
Liefert true, falls Überschreitungen des normalen Wertebereichs der Zeitfelder zulässig sind oder false, wenn die Interpretation strikt ist. In diesem Fall lösen Überschreitungen eine Exception aus.
public final boolean isSet(int field)
Liefert true, falls das durch field festgelegte Zeitfeld einen Wert hat, sonst false. Für field wird eine der Konstanten von ERA bis DST_OFFSET übergeben.
public void roll(int field, int amount)     [1.2]
Verschiebt die durch field bezeichnete Einheit des Kalenders um amount Einheiten. Mit negativen Werten kann der Zeitpunkt rückwärts verschoben werden. Bei Über- oder Unterläufen werden die Zeitfelder entsprechend angepaßt. Für field wird eine der Konstanten von ERA bis DST_OFFSET übergeben.
public abstract void roll(int field, boolean up)
Zählt die durch field bezeichnete Einheit des Kalenders um eine Einheit hoch, falls up true ist, sonst runter. Bei Über- oder Unterläufen wird werden die Zeitfelder entsprechend angepaßt. Für field wird eine der Konstanten von ERA bis DST_OFFSET übergeben.
public final void set(int field, int value)
Setzt das durch field bestimmte Zeitfeld auf den Wert value. Für field wird eine der Konstanten von ERA bis DST_OFFSET übergeben.
public final void set(int year, int month, int date)
Setzt den dargestellten Zeitpunkt auf das übergebene Datum.
public final void set(int year, int month, int date, int hour, int minute)
Setzt den dargestellten Zeitpunkt auf die übergebenen Werte.
public final void set(int year, int month, int date, int hour, int minute, int second)
Setzt den dargestellten Zeitpunkt auf die übergebenen Werte.
public void setFirstDayOfWeek(int value)
Setzt den Tag, der als erster Tag der Woche gilt, auf value. Hierfür kann eine der Konstanten SUNDAY bis SATURDAY angegeben werden.
public void setLenient(boolean lenient)
Mit dieser Methode kann eingestellt werden, ob Überschreitungen des normalen Wertebereichs der Zeitfelder zulässig sind (d. h., Angaben wie 40. April sind erlaubt und bezeichnen den 39. Tag nach dem 1. April) oder ob die Interpretation strikt sein soll.
public void setMinimalDaysInFirstWeek(int value)
Setzt die Anzahl an Tagen, die die Woche am Jahresanfang haben muß, damit sie als erste Kalenderwoche gilt, auf value.
public final void setTime(Date date)
Setzt den dargestellten Zeitpunkt auf das übergebene Datum.
protected void setTimeInMillis(long millis)
Setzt den Zeitpunkt des Kalenders auf millis Millisekunden seit der Epoche des Kalenders.
public void setTimeZone(TimeZone value)
Setzt die Zeitzone des Kalenders auf value.
public String toString()     [1.2]
Liefert einen String, der die Einstellungen des Objekts enthält.


 Inhaltsverzeichnis   Vorhergehendes Paket   Seite Zurück   Seite Vor   Nächstes Paket   Paketübersicht   Index

Copyright © 2002 dpunkt.Verlag, Heidelberg. Alle Rechte vorbehalten.