Skip to main content
Skip table of contents

TimeHelper (Veraltet)

Die Datums-/Uhrzeitfunktionen der Java-Klasse de.softproject.xsl.TimeHelperDate zur Verwendung innerhalb von XSL-Mappings sind veraltet und werden in künftigen Versionen der X4 BPMS abgekündigt.

Die Java-Klasse de.softproject.xsl.TimeHelperDate befindet sich innerhalb der X4 Server-Bibliothek x4-client.jar (<X4>\Server\<wildfly>\modules\system\layers\base\de\softproject\x4\client\main).

Ein XSL-Mapping, das diese Hilfsklasse verwendet, kann nicht in der Transformations-Vorschau des Mapping Editor ausgeführt werden.

Datum/Uhrzeit-Methoden

addDay(
java.util.Date date,
int amount)

Fügt einem java.util.Date-Objekt eine beliebige ganzzahlige Anzahl an Tagen hinzu und gibt ein Objekt vom Typ static java.util.Date zurück

addHour(
java.util.Date date,
int amount)

Fügt einem java.util.Date-Objekt eine beliebige ganzzahlige Anzahl an Stunden hinzu und gibt ein Objekt vom Typ static java.util.Date zurück

addMillisecond(
java.util.Date date,
int amount)

Fügt einem java.util.Date -Objekt eine beliebige ganzzahlige Anzahl an Millisekunden hinzu und gibt ein Objekt vom Typ static java.util.Date zurück

addMinute(
java.util.Date date,
int amount)

Fügt einem java.util.Date-Objekt eine beliebige ganzzahlige Anzahl an Minuten hinzu und gibt ein Objekt vom Typ static java.util.Date zurück

addMonth(
java.util.Date date,
int amount)

Fügt einem java.util.Date-Objekt eine beliebige ganzzahlige Anzahl an Monaten hinzu und gibt ein Objekt vom Typ static java.util.Date zurück

addSecond(
java.util.Date date,
int amount)

Fügt einem java.util.Date-Objekt eine beliebige ganzzahlige Anzahl an Sekunden hinzu und gibt ein Objekt vom Typ static java.util.Date zurück

addYear(
java.util.Date date,
int amount)

Fügt einem java.util.Date-Objekt eine beliebige ganzzahlige Anzahl an Jahren hinzu und gibt ein Objekt vom Typ static java.util.Date zurück

asMilliseconds(
java.util.Date date)

Gibt ein java.util.Date-Objekt als Zeit in Millisekunden seit dem 1.1.1970 als Zahl vom Typ   static long   zurück

canParse(
java.lang.String format,
[java.lang.String timezone,]
java.lang.String value)

Überprüft das Format einer Datums mit optionalem Parameter timezone für die Zeitzone und gibt ein Objekt vom Typ static boolean zurück


UNBEKANNTER ANHANG Hier wird lediglich das Format und nicht die Gültigkeit des Ergebnisses überprüft.

canParseDefaultFormat(
[java.lang.String timezone,]
java.lang.String value)

Überprüft, ob das verwendete Datumsformat mit optionalem Parameter timezone für die Zeitzone dem Standardformat entspricht und gibt ein Objekt vom Typ static boolean zurück

createDefaultFormat(
[java.lang.String timezone])

Gibt das aktuelle Datum (mit optionalem Parameter timezone für eine spezifische Zeitzone) als Standardformat vom Typ static java.text.SimpleDateFormat aus

createFormat(
java.lang.String format, [
java.lang.String timezone])

Gibt das aktuelle Datum ( mit optionalem Parameter timezone für eine spezifische Zeitzone) in einem Format vom Typ static java.text.SimpleDateFormat aus


UNBEKANNTER ANHANG Mehr Informationen zu den Datums-/Zeitformaten siehe http://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html

differenceInMilliseconds(
java.util.Date from,
java.util.Date to)

Berechnet den Unterschied zwischen zwei java.util.Date - Objekten in Millisekunden und gibt eine Zahl vom Typ static long zurück

format(
java.lang.String format,
[java.lang.String timezone,]
java.util.Date date)

Formatiert ein java.util.Date - Objekt mit optionalem Parameter timezone für die Zeitzone in ein Objekt vom Typ static java.lang. String

formatDefaultFormat(
[java.lang.String timezone,] java.util.Date date)

Formatiert ein java.util.DateObjekt mit optionalem Parameter timezone für die Zeitzone in ein Standardformat vom Typ static java.lang.String

fromMilliseconds(
long milli)

Konvertiert eine Zeitangabe in Millisekunden in e in Objekt vom Typ static java.util.Date

getDay(
java.util.Date date, [
java.lang.String timezone])

Ermittelt den Tag aus einem java.util.Date -Objekt mit optionalem Parameter timezone für die Zeitzone, und gibt diesen als Objekt vom Typ   static int zurück

getDayOfWeek(
java.util.Date date, [
java.lang.String timezone])

Ermittelt den Wochentag aus einem java.util.Date -Objekt mit optionalem Parameter timezone für die Zeitzone, und gibt diesen als Objekt vom Typ static int   zurück


UNBEKANNTER ANHANG Die Zählung der Wochentage beginnt bei Sonntag mit 1:

  • Sonntag: 1

  • Montag: 2

  • Dienstag: 3

  • Mittwoch: 4

  • Donnerstag: 5

  • Freitag: 6

  • Samstag: 7

getDayOfWeekInMonth(
java.util.Date date, [
java.lang.String timezone])

Ermittelt den Wochentag im Monat (z.B. "der wievielte Dienstag im Monat") aus einem java.util.Date -Objekt mit optionalem Parameter timezone für die Zeitzone, und gibt diesen als g anze Zahl vom Typ static int   zurück

getDayOfYear(
java.util.Date date, [
java.lang.String timezone])

Ermittelt den Tag des Jahres aus einem java.util.Date -Objekt mit optionalem Parameter timezone für die Zeitzone, und gibt diesen als g anze Zahl vom Typ static int   zurück

getHour(
java.util.Date date, [
java.lang.String timezone])

Ermittelt die Stunden aus einemjava.util.Date-Objekt mit optionalem Parameter timezone die Zeitzone, und gibt diese als ganze Zahl vom Typ static int zurück

getMilliSecond(
java.util.Date date, [
java.lang.String timezone])

Ermittelt die Millisekunden aus einem java.util.Date -Objekt mit optionalem Parameter timezone für die Zeitzone, und gibt diese als g anze Zahl vom Typ static int   zurück

getMinute(
java.util.Date date, [
java.lang.String timezone])

Ermittelt die Minuten aus einem java.util.Date -Objekt mit optionalem Parameter timezone für die Zeitzone , und gibt diese als g anze Zahl vom Typ static int zurück

getMonth(
java.util.Date date, [
java.lang.String timezone])  

Ermittelt den Monat aus einem java.util.Date -Objekt mit optionalem Parameter timezone für die Zeitzone , und gibt diesen als g anze Zahl vom Typ   static int zurück


UNBEKANNTER ANHANG Die Zählung der Monate beginnt mit 0:

  • Januar: 0

  • Februar: 1

  • März: 2

  • April: 3

  • Mai: 4

  • Juni: 5

  • Juli: 6

  • August: 7

  • September: 8

  • Oktober: 9

  • November: 10

  • Dezember: 11

getSecond(
java.util.Date date, [
java.lang.String timezone])

Ermittelt die Sekunden aus einem java.util.Date-Objekt mit optionalem Parameter timezone für die Zeitzone, und gibt diese als g anze Zahl vom Typ static int zurück

getWeekOfMonth(
java.util.Date date, [
java.lang.String timezone])

Ermittelt die Woche des Monats aus einem java.util.Date-Objekt mit optionalem Parameter timezone für die Zeitzone , und gibt diese als g anze Zahl vom Typ static int zurück

getWeekOfYear(
java.util.Date date, [
java.lang.String timezone])

Ermittelt die Kalenderwoche aus einem java.util.Date-Objekt mit optionalem Parameter timezone für die Zeitzone, und gibt diese als g anze Zahl vom Typ static int zurück

getYear(
java.util.Date date, [
java.lang.String timezone])

Ermittelt das Jahr aus einem java.util.Date-Objekt mit optionalem Parameter timezone für die Zeitzone , und gibt dieses als g anze Zahl vom Typ static int zurück

isAfter(
java.util.Date date,
java.util.Date reference)

Überprüft, ob ein java.util.Date -Objekt vor einem Referenzobjekt desselben Typs liegt, und gibt ein Objekt vom Typ boolean zurück

isBefore(
java.util.Date date,
java.util.Date reference)

Überprüft, ob sich ein java.util.Date -Objekt zeitlich nach einem Referenzobjekt desselben Typs befindet, und gibt ein Objekt vom Typ boolean zurück

now()

Ermittelt das aktuelle Datum und gibt dieses als Objekt vom Typ static java.util.Date zurück

parse(
java.lang.String format,
[java.lang.String timezone,]
java.lang.String value)

Liest eine Zeitangabe in java.lang.String -Format mit optionalem Parameter timezone für die Zeitzone aus, und gibt ein Objekt vom Typ static java.util.Date zurück

parseDefaultFormat(
[java.lang.String timezone,]
java.lang.String value)

Liest eine Zeitangabe in java.lang.String -Format mit optionalem Parameter timezone für die Zeitzone aus, und gibt ein Objekt vom Typ static java.util.Date im Standardformat zurück

setBeginOfDay(
java.util.Date date, [
java.lang.String timezone])

Liefert für das eingegebene java.util.Date -Objekt ( mit optionalem Parameter timezone für die Zeitzone) den Beginn des Tages als   static java.util.Date- Objekt

setBeginOfMonth(
java.util.Date date, [
java.lang.String timezone])

Liefert für das eingegebene java.util.Date-Objekt (mit optionalem Parameter timezone für die Zeitzone) den Beginn des Monats als   static java.util.Date- Objekt

setBeginOfYear(
java.util.Date date, [
java.lang.String timezone])

Liefert für das eingegebene java.util.Date -Objekt ( mit optionalem Parameter timezone für die Zeitzone) den Beginn des Jahres als   static java.util.Date- Objekt

setDay(
java.util.Date date,
[java.lang.String timezone,]
int amount)

Liefert für das eingegebene java.util.Date -Objekt ( mit optionalem Parameter timezone für die Zeitzone) den Tag des Monats als   static java.util.Date -Objekt


  UNBEKANNTER ANHANG Ist die eingegeben Zahl höher als die Anzahl der tatsächlichen Tage des Monats, wird die Differenz auf den/die Folgemonat(e) angerechnet.

setDayOfYear(
java.util.Date date,
[java.lang.String timezone,]
int amount)

Liefert für das eingegebene java.util.Date -Objekt mit optionalem Parameter timezone für die Zeitzone das Datum als   static java.util.Date- Objekt

setEndOfDay(
java.util.Date date, [
java.lang.String timezone])

Liefert für das eingegebene java.util.Date -Objekt ( mit optionalem Parameter timezone für die Zeitzone) das Ende des Tages als   static java.util.Date- Objekt

setEndOfMonth(
java.util.Date date, [
java.lang.String timezone])

Liefert für das eingegebene java.util.Date -Objekt ( mit optionalem Parameter timezone für die Zeitzone) das Ende des Monats als static java.util.Date- Objekt

setEndOfYear(
java.util.Date date, [
java.lang.String timezone])

Liefert für das eingegebene java.util.Date -Objekt ( mit optionalem Parameter timezone für die Zeitzone) das Ende des Jahres als static java.util.Date- Objekt

setHour(
java.util.Date date,
[java.lang.String timezone,]
int amount)

Liefert für das eingegebene java.util.Date -Objekt ( mit optionalem Parameter timezone für die Zeitzone) die Anzahl der Stunden als static java.util.Date- Objekt


UNBEKANNTER ANHANG Ist die eingegebene Zahl größer als 24, wird die Stundendifferenz auf den/die Folgetag(e) angerechnet.

setMillisecond(
java.util.Date date,
[java.lang.String timezone,]
int amount)

Liefert für das eingegebene java.util.Date -Objekt ( mit optionalem Parameter timezone für die Zeitzone) die Anzahl der Millisekunden als static java.util.Date-Objekt

setMinute(
java.util.Date date,
[java.lang.String timezone,]
int amount)

Liefert für das eingegebene java.util.Date -Objekt ( mit optionalem Parameter timezone für die Zeitzone) die Anzahl der Minuten als static java.util.Date-Objekt


UNBEKANNTER ANHANG Ist die eingegebene Zahl größer ist als 60, wird die Differenz auf die Folgestunde(n) angerechnet.

setMonth(
java.util.Date date,
[java.lang.String timezone,]
int amount)

Liefert für das eingegebene java.util.Date -Objekt mit optionalem Parameter timezone für die Zeitzone den Monat als static java.util.Date- Objekt

UNBEKANNTER ANHANG Die Zählung der Monate beginnt mit 0:

  • Januar: 0

  • Februar: 1

  • März: 2

  • April: 3

  • Mai: 4

  • Juni: 5

  • Juli: 6

  • August: 7

  • September: 8

  • Oktober: 9

  • November: 10

  • Dezember: 11

Ist die eingegebene Zahl größer als 11, wird die Differenz auf das/die Folgejahr(e) angerechnet.

setSecond(
java.util.Date date,
[java.lang.String timezone,]
int amount)

Liefert für das eingegebene java.util.Date -Objekt mit optionalem Parameter timezone für die Zeitzone die Sekunden als static java.util.Date- Objekt

UNBEKANNTER ANHANG Ist die eingegebene Zahl größer ist als 60, wird die Differenz auf die Folgeminute(n) angerechnet.

setYear(
java.util.Date date,
[java.lang.String timezone,]
int amount)

Liefert für das eingegebene java.util.Date -Objekt mit optionalem Parameter timezone für die Zeitzone das Jahr als static java.util.Date- Objekt

Beispiel

In diesem Beispiel werden stellvertretend für alle Methoden Variablen mit je einem Methodenaufruf initialisiert und deren Rückgabewert in einem entsprechend benannten XML-Element ausgegeben. Hierfür werden im Kopf des XSL-Stylesheets zunächst die Namensräume x4time für die TimeHelper-Klasse sowie sdf fürs Java-SimpleDateFormat definiert. Zudem werden in Variable date und from_date zwei Variablen mit einem java.util.Date-Objekt für den weiteren Gebrauch als Beispieldaten initialisiert.

HTML/XML
<xsl:stylesheet xmlns:sdf="java.text.SimpleDateFormat" xmlns:x4time="de.softproject.xsl.TimeHelperDate" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
 <xsl:output indent="yes" method="xml" media-type="text/xml"></xsl:output>
 <xsl:template match="/">
 
 <!-- Get date/time values -->
  	<xsl:variable select="x4time:now()" name="date"></xsl:variable>
  	<xsl:variable select="x4time:addDay($date, 1)" name="from_date"></xsl:variable>
  	
 
 <Output>
		<!-- Output method return values -->
		<now><xsl:value-of select="$date"></xsl:value-of></now>
		
		
 		<!-- method addDay -->
 		<xsl:variable select="x4time:addDay($date, 8)" name="addDayDate"></xsl:variable>
   	<addDay type="date">
    		 <xsl:value-of select="$addDayDate"></xsl:value-of>
   	</addDay>
 
  	<!-- method asMilliseconds -->
   	<xsl:variable select="x4time:asMilliseconds($date)" name="asMillisecondsDate"></xsl:variable>
   	<asMilliseconds type="date">
    		 <xsl:value-of select="$asMillisecondsDate"></xsl:value-of>
   	</asMilliseconds>
   	   	
   	<!-- method canParse with Timezone-->
   	<xsl:variable select="x4time:canParse('yyyy-MM-dd', 'CET','2013.07.111')" name="canParseWithTimezone"></xsl:variable>
   	<canParse type="withTimezone">
    		 <xsl:value-of select="$canParseWithTimezone"></xsl:value-of>
   	</canParse>
   	
   	<!-- method canParseDefaultFormat -->
   	<xsl:variable select="x4time:canParseDefaultFormat('2013-07-111 16:56:45.123')" name="canParseDefaultFormatSimple"></xsl:variable>
   	<canParseDefaultFormat type="simple">
    		 <xsl:value-of select="$canParseDefaultFormatSimple"></xsl:value-of>
   	</canParseDefaultFormat>
   	  
   	<!-- method createDefaultFormat with timezone -->
   	<xsl:variable select="x4time:createDefaultFormat('PST')" name="sdf_default_withTimezone"></xsl:variable>
   	<createDefaultFormatTz type="withTimezone">
    		 <xsl:value-of select="sdf:format($sdf_default_withTimezone, $date)"></xsl:value-of>
   	</createDefaultFormatTz>
   	
   	<!-- method createFormat with timezone -->
   	<xsl:variable select="x4time:createFormat('yyyy-MMM-dd EE','CET')" name="sdf_simpleWithTimezone"></xsl:variable>
   	<createFormatTz type="withTimezone">
    		 <xsl:value-of select="sdf:format($sdf_simpleWithTimezone, $date)"></xsl:value-of>
   	</createFormatTz>
   	
   	<!-- method differenceInMilliseconds: date to date --> 
   	<xsl:variable select="x4time:differenceInMilliseconds($date, $from_date)" name="differenceInMillisecondsDate"></xsl:variable>
   	<differenceInMilliseconds type="date">
    		 <xsl:value-of select="$differenceInMillisecondsDate"></xsl:value-of>
   	</differenceInMilliseconds>
   	   	
   	<!-- method format with Timezone -->
   	<xsl:variable select="x4time:format('yyyy-MM-dd z','CET',$date)" name="formatWithTimezone"></xsl:variable>
   	<formatTZ type="withTimezone">
    		 <xsl:value-of select="$formatWithTimezone"></xsl:value-of>
   	</formatTZ>  
   	  	
   	<!-- method formatDefaultFormat with timezone -->
   	<xsl:variable select="x4time:formatDefaultFormat('PST',$date)" name="formatDefaultFormatWithTimezone"></xsl:variable>
   	<formatDefaultFormat type="withTimezone">
    		 <xsl:value-of select="$formatDefaultFormatWithTimezone"></xsl:value-of>
   	</formatDefaultFormat> 
   	
   	
   	<!-- method fromMilliseconds -->
   	<xsl:variable select="x4time:fromMilliseconds(1374483531161)" name="fromMilliseconds"></xsl:variable>
   	<fromMilliseconds type="date">
    		 <xsl:value-of select="$fromMilliseconds"></xsl:value-of>
   	</fromMilliseconds>
   	   		
   	<!-- method getDayOfWeek with timezone -->
   	<xsl:variable select="x4time:getDayOfWeek($date, PST)" name="getDayOfWeekWithTimezone"></xsl:variable>
   	<getDayOfWeekTZ type="withTimezone">
    		 <xsl:value-of select="$getDayOfWeekWithTimezone"></xsl:value-of>
   	</getDayOfWeekTZ>
   	
  	<!-- method isAfter -->
   	<xsl:variable select="x4time:isAfter($date, $from_date)" name="isAfter"></xsl:variable>
   	<isAfter type="date">
    		 <xsl:value-of select="$isAfter"></xsl:value-of>
   	</isAfter>
  	
  	<!-- method now -->
 		<xsl:variable select="x4time:now()" name="now"></xsl:variable>
   	<now type="date">
    		 <xsl:value-of select="$now"></xsl:value-of>
   	</now>
   	  	 
   	<!-- method parse with timezone -->
 		<xsl:variable select="x4time:parse('yyyy-MM-dd','PST','2013-07-22')" name="parseWithTimezone"></xsl:variable>
   	<parseTZ type="withTimezone">
    		 <xsl:value-of select="$parseWithTimezone"></xsl:value-of>
   	</parseTZ>
   		   	
   	<!-- method parseDefaultFormat with timezone -->
 		<xsl:variable select="x4time:parseDefaultFormat('PST','2013-07-22 05:24:30.376')" name="parseDefaultFormatWithTimezone"></xsl:variable>
   	<parseDefaultFormatTZ type="withTimezone">
    		 <xsl:value-of select="$parseDefaultFormatWithTimezone"></xsl:value-of>
   	</parseDefaultFormatTZ>
   	
   	<!-- method setBeginOfDay -->
   	<xsl:variable select="x4time:setBeginOfDay($date)" name="setBeginOfDay"></xsl:variable>
   	<setBeginOfDay type="date">
    		 <xsl:value-of select="$setBeginOfDay"></xsl:value-of>
   	</setBeginOfDay>
   	
 		<!-- method setDay with timezone --> 
   	<xsl:variable select="x4time:setDay($date, 32, PST)" name="setDayDateWithTimezone"></xsl:variable>
   	<setDayTZ type="WithTimezone">
    		 <xsl:value-of select="$setDayDateWithTimezone"></xsl:value-of>
   	</setDayTZ>
  	  	
   	<!-- method setEndOfDay -->
   	<xsl:variable select="x4time:setEndOfDay($date)" name="setEndOfDay"></xsl:variable>
   	<setEndOfDay type="date">
    		 <xsl:value-of select="$setEndOfDay"></xsl:value-of>
   	</setEndOfDay>
   	
   	<!-- method setMinute with Timezone --> 
   	<xsl:variable select="x4time:setMinute($date, 72)" name="setMinuteDate"></xsl:variable>
   	<setMinuteTZ type="date">
    		 <xsl:value-of select="$setMinuteDate"></xsl:value-of>
   	</setMinuteTZ>
 </Output>
 </xsl:template>
</xsl:stylesheet>
JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.