Datentyp GregorianCalendar

Wertebereich des Datentyps GregorianCalendar

Für Berechnungen mit Datums- und Zeitwerten stellt FirstSpirit den Datentyp GregorianCalendar zur Verfügung. Dieser Datentyp stellt einen gregorianischen Kalendar dar und ermöglicht eine Interpretation unterschiedlicher Datumsformate als Jahr, Monat, Tag, Stunde, Minute und Sekunde. Der Datentyp bietet Zugriff auf eine Reihe von Methoden, die auf den Kalender und auf relevante Gebietsschema-Einstellungen des Betriebssystems (z.B. Datumsformate) zurückgreifen und damit eine Formatierung in unterschiedliche, beispielsweise länderspezifische, Datumsformate und ein Parsing ermöglichen.

Der Datentyp GregorianCalendar kann auch in der API-Dokumentation von Sun nachgeschlagen werden:

java.util.GregorianCalendar

Definition über die Standard-Eingabekomponenten

Innerhalb des Formularbereichs von Vorlagen werden Eingabekomponenten definiert, mit deren Hilfe die Redakteure später die eigentlichen redaktionellen Inhalte in die Seite einfügen können. Die von FirstSpirit unterstützten Standard-Eingabekomponenten liefern unterschiedliche Datentypen zurück.

Die Standard-Eingabekomponente CMS_INPUT_DATE liefert ein Objekt vom Datentyp Date zurück. Bei der Ausgabe der Werte wird der Datentyp Date in GregorianCalendar geändert.

Auf diesem Objekt lassen sich dann mithilfe einer $CMS_VALUE(...)$-Anweisung Methoden anwenden:

$CMS_VALUE(BEZEICHNER.METHODE)$

Methoden auf GregorianCalendar-Objekten

In der unten angegebenen Tabelle werden alle Methoden aufgelistet, die auf Objekten von Datentyp GregorianCalendar aufgerufen werden können:

add(int, int)

Übersicht

add(String, int)

Übersicht

add(String, Number)

Übersicht

after(Date)

Übersicht

after(Object)

Übersicht

before(Date)

Übersicht

before(Object)

Übersicht

clear

Übersicht

clear(int)

Übersicht

compareTo(Date)

Übersicht

compareTo(Calendar)

Übersicht

compareTo(Object)

Übersicht

equals(Date)

Übersicht

equals(Object)

Übersicht

format(String)

Mit der Methode format(String) kann festgelegt werden, wie Zeit- und Datumsangaben dargestellt werden.

Dazu werden verschiedene Buchstaben als Formatierungssymbole verwendet. Derselbe Buchstabe in Groß- oder Kleinschreibung kann dabei unterschiedliche Funktionen haben. Prinzipiell umfasst ein Formatierungssymbol einen Buchstaben, durch die Angabe von mehreren (maximal bis zu vier) gleichen Buchstaben kann die Formatierung der Zeit- bzw. Datumsangabe beeinflusst werden.

Die folgende Liste enthält alle zur Verfügung stehenden Formatierungssymbole, zunächst häufig benötigte:

• Angabe des Jahres
  • yy: Jahresangabe zweistellig (z.B. "96")
  • yyyy: Jahresangabe vierstellig (z.B. "2010")
• Angabe des Monats
  • MM: Monatsangabe, bei einstelligen mit führender 0 (z.B. "03")
  • MMM: Monatsangabe, dreibuchstabige sprachspezifische Abkürzung (z.B. "Mrz")
  • MMMM: Monatsangabe lang, sprachspezifisch (z.B. "März")
• Angabe des Tages
  • d: Tag im Monat (z.B. "26")
  • D: Tag im Jahr (z.B. "145")
  • E: Wochentag-Name, zweibuchstabige sprachspezifische Abkürzung (z.B. "Mi")
  • EEEE: Wochentag-Name lang, sprachspezifisch (z.B. "Mittwoch")
  • F: Wochentag im Monat (z.B. "2", d.h. 2. Tag im Monat x)
• Angabe der Stunde
  • K: Stunde des Tages, 12-Stunden-Zählung (0-11) (z.B. "0")
  • h: Stunde des Tages, 12-Stunden-Zählung (1-12) (z.B. "12")
  • H: Stunde des Tages, 24-Stunden-Zählung (0-23) (z.B. "0")
  • k: Stunde des Tages, 24-Stunden-Zählung (1-24) (z.B. "24")
  • a: Angabe von AM / PM (Vormittag / Nachmittag) (z.B. "PM")
• Angabe der Minute
  • m: Minutenangabe einstellig (0-59) (z.B. "2")
  • mm: Minutenangabe zweistellig, wenn einstellig mit führender 0 (0-59) (z.B. "02")
• Angabe der Sekunde
  • s: Sekundenangabe einstellig (0-59) (z.B. "2")
  • ss: Sekundenangabe zweistellig, wenn einstellig mit führender 0 (0-59) (z.B. "02")
• Angabe der Woche
  • w: Kalenderwoche (1-52) (z.B. "12")
  • W: Woche des Monats (1-5) (z.B. "2")
• Angabe der Zeitzone
  • Z: Zeitzone nach RFC 822 (z.B. "+0200")
  • z: allgemeine Zeitzonenbezeichnung, sprachspezifische Abkürzung (z.B. "MESZ")
  • zzzz: allgemeine Zeitzonenbezeichnung, lang, sprachspezifisch (z.B. "Mitteleuropäische Sommerzeit")
• Angabe von Millisekunden
  • S - SSS: Millisekunde (0-999) (z.B. "978")
• Angabe des Zeitalters
  • G: Zeitalter / Zeitrechnung, sprachspezifisch (z.B. "n. Chr.")

Diese Symbole können einzeln und in Kombination miteinander verwendet werden. Als Trennzeichen können z.B. Leerzeichen, Punkte, Doppelpunkte, Kommata, Binde-/Querstriche etc. eingesetzt werden. Für eine noch individuellere Ausgabe von Datums- und Uhrzeitinformationen kann zusätzlicher Text mithilfe von einfachen Hochkommata maskiert werden, z.B. 'am' dd.MM.yyyy 'um' HH:mm. Für die Ausgabe eines einfachen Hochkommas muss '' (zwei Hochkommata) angegeben werden.

Beispiele:

• "dd.MM.yyyy G 'um' hh:mm:ss 'Uhr' z"
  Ausgabe: 20.06.2010 n. Chr. um 05:41:53 Uhr MESZ
• "EEE, MMM d, ''yy"
  Ausgabe: So, Jun 20, '10
• "h:mm a"
  Ausgabe: 5:43 PM
• "hh 'Uhr,' zzzz"
  Ausgabe: 05 Uhr, Mitteleuropäische Sommerzeit
• "K:mm a, z"
  Ausgabe: 5:44 PM, MESZ
• "yyyy.MMMM.dd G hh:mm a"
  Ausgabe: 2010.Juni.20 n. Chr. 05:45 PM
• "dd.MM.yyyy HH:mm:ss.SSS"
  Ausgabe: 20.06.2010 17:59:23.208

Übersicht

format(String, Locale)

Übersicht

format(String, String)

Übersicht

from(ZonedDateTime)

Übersicht

get(int)

Übersicht

getActualMaximum(int)

Übersicht

getActualMinimum(int)

Übersicht

getAvailableCalendarTypes

Übersicht

getAvailableLocales

Übersicht

getCalendarType

Übersicht

getClass

Die Methode .getClass() (in Bean-Syntax: .class) liefert die Klasse des aufrufendes Objektes zurück (vgl. java.lang.Class).

Aufruf:

$CMS_VALUE(myString.class)$
$CMS_VALUE(myString.getClass())$

Ausgabe:

java.lang.String

Übersicht

getDisplayName(int, int, Locale)

Übersicht

getDisplayNames(int, int, Locale)

Übersicht

getFirstDayOfWeek

Übersicht

getGreatestMinimum(int)

Übersicht

getGregorianChange

Übersicht

getInstance

Übersicht

getInstance(TimeZone)

Übersicht

getInstance(Locale)

Übersicht

getInstance(TimeZone, Locale)

Übersicht

getLeastMaximum(int)

Übersicht

getMaximum(int)

Übersicht

getMinimalDaysInFirstWeek

Übersicht

getMinimum(int)

Übersicht

getTime

Übersicht

getTimeInMillis

Übersicht

getTimeZone

Übersicht

getWeekYear

Übersicht

getWeeksInWeekYear

Übersicht

isCase(Object)

Übersicht

isLeapYear(int)

Übersicht

isLenient

Übersicht

isNull

Die Methode .isNull() (in Bean-Syntax: .isNull) prüft, ob ein Ausdruck bzw. Objekt Null ist, z. B. storeElement.isNull(). Bei Objekten mit komplexen Werten oder Objekten entscheidet das Objekt, wann es null ist. Der Datentyp DomElement enthält beispielsweise immer ein leeres Dokument, ist also nie null. Die Prüfung einer leeren DOM-Editor-Eingabekomponente mit der Methode .isNull() liefert daher den Wert false, während die Prüfung der Komponente auf .isEmpty() den Wert true liefern würde.

Die Methode .isNull() gibt einen booleschen Wert als Ergebnis der Prüfung zurück. true (=wahr) ist die Prüfung, wenn der Ausdruck bzw. das Objekt Null ist und false (=unwahr) wenn nicht.

Übersicht

isSet(int)

Übersicht

isWeekDateSupported

Übersicht

milliseconds

Übersicht

minus(long)

Übersicht

plus(long)

Übersicht

print

Übersicht

roll(int, int)

Übersicht

roll(int, boolean)

Übersicht

set(int, int)

Übersicht

set(String, Number)

Übersicht

set(String, Object)

Übersicht

set(int, int, int)

Übersicht

set(int, int, int, int, int)

Übersicht

set(int, int, int, int, int, int)

Übersicht

setFirstDayOfWeek(int)

Übersicht

setGregorianChange(Date)

Übersicht

setLenient(boolean)

Übersicht

setMinimalDaysInFirstWeek(int)

Übersicht

setTime(Date)

Übersicht

setTimeInMillis(long)

Übersicht

setTimeZone(TimeZone)

Übersicht

setTimeZone(String)

Übersicht

setTimezone(TimeZone)

Übersicht

setTimezone(String)

Übersicht

setWeekDate(int, int, int)

Übersicht

toInstant

Übersicht

toJSON

Übersicht

toString

Übersicht

toZonedDateTime

Übersicht

type

Übersicht