Date

Die Textfunktion Date gibt Datum und Uhrzeit für das Auffüllen eines Onlineberichts mit Daten oder Datum und Uhrzeit für das Speichern eines Snapshot-Berichts zurück. Datum und Uhrzeit werden vom Report Server abgerufen und entsprechen dem Land, in dem sich der Report Server befindet. Sie können Date in einem Textfeld, einer Textzelle oder einer Zeilen- oder Spaltenüberschrift verwenden.

Hinweis:

Das Datums- und Uhrzeitformat variiert je nach Gebietsschema. Die Beispiele in diesem Thema sind US-spezifische Beispiele.

Syntax:

<<Date("format,TimeZoneId")>>

Argument Beschreibung

Argument	Beschreibung
format	Standardwert ist die Benutzervoreinstellung für Datum und Uhrzeit. Gültig sind von Java `SimpleDateFormat` unterstützte Werte, "Benutzer" oder kein Wert ("Benutzer"). Bei den Zeichen für format von Datum und Uhrzeit muss die Groß-/Kleinschreibung beachtet werden.
TimeZoneId	Gültig sind von Java `TimeZone.getTimeZone()` unterstützte Werte oder die Zeitzone des Servers. Beispiel: Um mit der Funktion `TimeZone.getTimeZone()` die Zeitzone für die amerikanische Ostküste festzulegen, geben Sie "America/New_York" ein. Bei Verwendung von TimeZoneID muss der Parameter `format` in Anführungszeichen gesetzt werden. Dies gilt nur bei Angabe von TimeZoneId. Bereits vor der Erweiterung von TimeZoneId vorhandene Berichte müssen nicht aktualisiert werden.

format

Standardwert ist die Benutzervoreinstellung für Datum und Uhrzeit. Gültig sind von Java SimpleDateFormat unterstützte Werte, "Benutzer" oder kein Wert ("Benutzer").

Bei den Zeichen für format von Datum und Uhrzeit muss die Groß-/Kleinschreibung beachtet werden.

TimeZoneId

Gültig sind von Java TimeZone.getTimeZone() unterstützte Werte oder die Zeitzone des Servers. Beispiel: Um mit der Funktion TimeZone.getTimeZone() die Zeitzone für die amerikanische Ostküste festzulegen, geben Sie "America/New_York" ein.

Bei Verwendung von TimeZoneID muss der Parameter format in Anführungszeichen gesetzt werden. Dies gilt nur bei Angabe von TimeZoneId. Bereits vor der Erweiterung von TimeZoneId vorhandene Berichte müssen nicht aktualisiert werden.

Tabelle -14 Zeichen für das Datums- und Uhrzeitformat

Formatzeichen	Bedeutung	Datentyp	Beispiel
G	Bezeichnung der Epoche	Text	AD
M	Monat des Jahres	Text oder Zahl	Für den Monat Juli: M ergibt 7, MM ergibt 07, MMM ergibt Jul, MMMM ergibt Juli
d	Tag des Monats	Zahl	10
h	Stunde im 12-Stunden-Format (1-12)	Zahl	11
H	Stunde des Tages (0-23)	Zahl	22
m	Minute der Stunde	Zahl	30
s	Sekunde der Minute	Zahl	25
S	Millisekunde	Zahl	978
E	Wochentag	Text	E: Di EE: Dienstag
D	Tag des Jahres	Zahl	189
F	Wochentag des Monats	Zahl	<<Date("dd-MMM-yy ist der F. ' E 'im 'MMM")>> ergibt: 24-Dez-02 ist der 4. Di im Dez
w	Woche des Jahres	Zahl	27
W	Woche des Monats	Zahl	2
a	Kennzeichnung für am/pm	Text	PM
k	Stunde des Tages (1-24)	Zahl	23
K	Stunde im 12-Stunden-Format (0-11)	Zahl	Wenn die Uhrzeit 3:37 PM ist: 3
z	Zeitzone	Text	Pacific Standard Time
y	Jahr	Zahl	2002,02
'	Literaler Text	Text	<<Date(" D’the day of ’yyyy")>> ergibt: 105. Tag des Jahres 2002
' '	Zwei einfache Anführungszeichen, um ein einfaches Anführungszeichen zu erzeugen	Text	<<Date("k:mm 'O''Clock' a")>> ergibt: 6:15 O’Clock PM Hinweis: Ein einfaches Anführungszeichen oder ein Apostroph wie in O'Clock können Sie mit zwei einfachen Anführungszeichen erzeugen (O''Clock).

Hinweise zur Verwendung von Zeichen für format:

Die Anzahl der Zeichen für format bestimmt das Format:
- Bei Text bedeuten weniger als vier Musterbuchstaben, dass die Kurzform oder abgekürzte Form verwendet wird, sofern vorhanden.
- Bei vier oder mehr Musterbuchstaben wird die Langform verwendet.
- M oder MM bedeutet, dass der Monat als Zahl verwendet wird.
- MMM bedeutet, dass für den Monat die Abkürzung mit drei Buchstaben verwendet wird.
- MMMM bedeutet, dass der Monatsname ausgeschrieben wird.
Beispiel für den 24. April:

<<Date("dd-M-yy")>> ergibt 24-4-02

<<Date("dd-MM-yy)>> ergibt 24-04-02

<<Date("dd-MMM-yy")>> ergibt 24-Apr-02

<<Date("dd-MMMM-yy")>> ergibt 24-April-02
Bei Zahlen entspricht die Anzahl der Musterbuchstaben der Mindestanzahl der Stellen. Kürzere Zahlen werden mit Nullen aufgefüllt. Jahresangaben stellen einen Sonderfall dar. Wenn Sie "yy" verwenden, werden die letzten beiden Ziffern des Jahres angezeigt. Wenn Sie jedoch "yyyy" verwenden, wird die vierstellige Jahreszahl angezeigt.

Beispiel für Februar:

<<Date("MM-yyyy")>> ergibt 02-2002
Alle alphabetischen Zeichen in Groß- und Kleinschreibung werden als Muster behandelt, unabhängig davon, ob sie als Zeichen für format definiert wurden.
Literaler Text muss in einfache Anführungszeichen gesetzt werden. Wenn Sie einfache Anführungszeichen in literalem Text verwenden möchten, müssen Sie den gesamten literalen Text in einfache Anführungszeichen setzen und innerhalb des literalen Textes jeweils zwei einfache Anführungszeichen verwenden.

Das Format zum Drucken von 4 O'Clock (4 Uhr) ist zum Beispiel:

<<Date("hh 'o''clock' ")>>

Beispiele:

Datumsformat	Ergebnis
`<<Date("d/M/yy")>>`	23/3/02
`<<Date("d-MMM-yy")>>`	23-Mär-02
`<<Date("EEEE, MMMM dd, yyyy")>>`	Dienstag, März 23, 2002
`<<Date("h:mm:ss a")>>`	12:52:05 PM
`<<Date("h:mm:ss a zzzz")>>`	12:52:05 PM Eastern Standard Time
`<<Date("EEEE, MMMM dd, yyyy G 'time:' h:mm:ss a zzzz")>>`	Dienstag, März 23, 2002 AD Uhrzeit: 12:52:05 PM Eastern Standard Time
`<<Date("hh 'o’’clock' a, zzzz")>>`	12:00 PM, Eastern Standard Time Hinweis: Es müssen zwei einfache Anführungszeichen eingegeben werden, um ein einfaches Anführungszeichen im Text des formatierten Ergebnisses zu erzeugen.