Startseite / Vorlagenentwicklung / Vorlagensyntax / Datentypen / Date (Datum)

Datentyp Date

Wertebereich des Datentyps Date

Wichtig Bei der Verwendung in Vorlagen wird der Datentyp Date in GregorianCalendar geändert.
Aus diesem Grund sind in Vorlagen die Methoden des Datentyps GregorianCalendar zu verwenden.

Für die Bearbeitung von Werten, die ein Datum und/oder eine Uhrzeit repräsentieren, stellt FirstSpirit den Datentyp Date zur Verfügung. Dieser Datentyp 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 Date kann auch in der API-Dokumentation von Sun nachgeschlagen werden:

java.util.Date

Definition

In FirstSpirit wird bei der Definition eines Datums ein Date-Objekt der Klasse java.util.Date erzeugt. Üblicherweise wird dieser Datentyp mittels der Eingabekomponente CMS_INPUT_DATE erzeugt. Unabhängig davon, kann über die Methode .now des Systemobjektes #global ein neues Datumsobjekt erzeugt werden:

CMS_SET(myDate, #global.now)$

Der Ausdruck #global.now liefert in diesem Fall das aktuelle Datum zurück.

Definition über die Standard-Eingabekomponenten

Innerhalb des Formularbereichs einer Seiten- oder Absatzvorlage 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 folgenden Standard-Eingabekomponenten liefern ein Objekt vom Datentyp Date zurück:

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

$CMS_VALUE(BEZEICHNER.METHODE)$

Mit BEZEICHNER ist der Bezeichner gemeint, der im Parameter resultname der Eingabekomponente definiert wurde.

Methoden auf Date-Objekten

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

Objekt wird von folgenden Formular-Objekten erzeugt:
CMS_INPUT_DATE
Methodenname Rückgabetyp Kurzbeschreibung Verfügbar seit
after(Date) boolean
before(Date) boolean
compareTo(Date) int
compareTo(Object) int
equals(Object) boolean
from(Instant) Date
getClass Class Klasse des aufrufenden Objektes
getTime long
hashCode int
isCase(Object) boolean
isNull boolean Prüft, ob ein Ausdruck Null ist
print void
set(String, Object) Object
setTime(long) void
toInstant Instant
toJSON String Convert to a JSON-compatible string representation including necessary quotes and escaping for immediate use. Handles Maps, Collections, Arrays, Numbers, Strings, Boolean, Date, and JsonElement. A date instance will be converted to an ISO-8601 formatted date string. Any object other than above will be converted using its 'toString()' value. 5.2.11
toString String
type String

after(Date)

Methodenname Rückgabetyp Verfügbar seit
after(Date) boolean

before(Date)

Methodenname Rückgabetyp Verfügbar seit
before(Date) boolean

compareTo(Date)

Methodenname Rückgabetyp Verfügbar seit
compareTo(Date) int

compareTo(Object)

Methodenname Rückgabetyp Verfügbar seit
compareTo(Object) int

equals(Object)

Methodenname Rückgabetyp Verfügbar seit
equals(Object) boolean

from(Instant)

Methodenname Rückgabetyp Verfügbar seit
from(Instant) Date

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
Methodenname Rückgabetyp Verfügbar seit
getClass Class

getTime

Methodenname Rückgabetyp Verfügbar seit
getTime long

hashCode

Methodenname Rückgabetyp Verfügbar seit
hashCode int

isCase(Object)

Methodenname Rückgabetyp Verfügbar seit
isCase(Object) boolean

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.

Methodenname Rückgabetyp Verfügbar seit
isNull boolean

print

Methodenname Rückgabetyp Verfügbar seit
print void

set(String, Object)

Methodenname Rückgabetyp Verfügbar seit
set(String, Object) Object

setTime(long)

Methodenname Rückgabetyp Verfügbar seit
setTime(long) void

toInstant

Methodenname Rückgabetyp Verfügbar seit
toInstant Instant

toJSON

Convert to a JSON-compatible string representation including necessary quotes and escaping for immediate use. Handles Maps, Collections, Arrays, Numbers, Strings, Boolean, Date, and JsonElement. A date instance will be converted to an ISO-8601 formatted date string. Any object other than above will be converted using its 'toString()' value.
Methodenname Rückgabetyp Verfügbar seit
toJSON String 5.2.11

toString

Methodenname Rückgabetyp Verfügbar seit
toString String

type

Methodenname Rückgabetyp Verfügbar seit
type String

© 2005 - 2024 Crownpeak Technology GmbH | Alle Rechte vorbehalten. | FirstSpirit 2024.4 | Datenschutz