WebSVN – XServices – Diff – /xservices/trunk/src/java/net/brutex/xservices/ws/DateService.java


/*
 *   Copyright 2011 Brian Rosenberger (Brutex Network)
 *
 *   Licensed under the Apache License, Version 2.0 (the "License");
 *   you may not use this file except in compliance with the License.
 *   You may obtain a copy of the License at
 *
 *       http://www.apache.org/licenses/LICENSE-2.0
 *
 *   Unless required by applicable law or agreed to in writing, software
 *   distributed under the License is distributed on an "AS IS" BASIS,
 *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 *   See the License for the specific language governing permissions and
 *   limitations under the License.
 */
 
package net.brutex.xservices.ws;
 
import java.math.BigInteger;
import java.util.GregorianCalendar;
 
import javax.jws.WebMethod;
import javax.jws.WebParam;
import javax.jws.WebService;
import javax.xml.bind.annotation.XmlElement;
 
import net.brutex.xservices.types.DateFormatType;
import net.brutex.xservices.types.DateTimeUnits;
import net.brutex.xservices.util.BrutexNamespaces;
 
import org.apache.cxf.annotations.WSDLDocumentation;
import org.apache.cxf.annotations.WSDLDocumentationCollection;
 
/**
 * Date and time related services.
 * @author Brian Rosenberger
 *
 */
@WebService(targetNamespace = BrutexNamespaces.WS_XSERVICES)
@WSDLDocumentationCollection(
    {
    	@WSDLDocumentation(value = BrutexNamespaces.BRUTEX_COPYRIGHT, placement = WSDLDocumentation.Placement.TOP)
    }
)
public interface DateService {
	
	public static final String SERVICE_NAME = "DateService";
	final String OPERATION_GETDATE = "getDate";
	final String OPERATION_GETTIMESTAMP = "getTimestamp";
	final String OPERATION_GETINTIMEZONE = "getInTimezone";
	final String OPERATION_FORMATDATE = "formatDate";
	final String OPERATION_FORMATDATEADVANCED = "formatDateAdvanced";	
	final String OPERATION_PARSEDATE = "parseDate";
	final String OPERATION_PARSEDATEADVANCED = "parseDateAdvanced";
	final String OPERATION_DATETIMEDIFF = "dateTimeDiff";
	final String OPERATION_DATETIMEDIFF2 = "dateTimeDiff2";
	final String OPERATION_DATEADD = "dateAdd";
	
	final String PARAM_TIMEZONE = "timezone";
	final String PARAM_DATETIME = "datetime";
	final String PARAM_FORMAT = "format";
	final String PARAM_UNIT = "unit";
	
	/**
	 * Get current date and time.
	 * 
	 * @param timezone Optional timezone. Defaults to server timezone.
	 * @return Current date and time.
	 * @throws XServicesFault 
	 */
	@WebMethod(operationName=OPERATION_GETDATE)
	@WSDLDocumentation(value="Get current date and time.")
	public abstract GregorianCalendar getDate(
			@WebParam(name=PARAM_TIMEZONE) String timezone) throws XServicesFault;
	
	/**
	 * Get milliseconds since 01.01.1970.
	 * 
	 * @return timestamp milliseconds
	 */
	@WebMethod(operationName=OPERATION_GETTIMESTAMP)
	@WSDLDocumentation(value="Get milliseconds since 01.01.1970 (Unix timestap).")
	public abstract BigInteger getTimestamp();
	
	/**
	 * Display a date time with a different time zone. 
	 * Changes representation only (no conversion).
	 * 
	 * @param cal date time.
	 * @param timezone time zone
	 * @return date time
	 * @throws XServicesFault
	 */
	@WebMethod(operationName=OPERATION_GETINTIMEZONE)
	public abstract GregorianCalendar getInTimezone(
			@WebParam(name=PARAM_DATETIME) @XmlElement(required=true) GregorianCalendar cal,
			@WebParam(name=PARAM_TIMEZONE) @XmlElement(required=true) String timezone) throws XServicesFault;
	
	/**
	 * Formats a date with pre-defined patterns.
	 * 
	 * @param cal date time to be formatted
	 * @param format Pattern to be used for date formating
	 * @return formatted date/time string
	 * @throws XServicesFault
	 */
	@WebMethod(operationName=OPERATION_FORMATDATE)
	public abstract String formatDate(
			@WebParam(name=PARAM_DATETIME) @XmlElement(required=true) GregorianCalendar cal,
			@WebParam(name=PARAM_FORMAT) @XmlElement(required=true) DateFormatType format) throws XServicesFault;
	
	/**
	 * Formats a date with a free form pattern.
	 * Uses SimpleDateFormat patterns
	 * The following pattern letters are defined (all other characters from 'A' to 'Z' and from 'a' to 'z' are reserved):
 
    Letter	Date or Time Component	Presentation	Examples
    G	Era designator	Text	AD
    y	Year	Year	1996; 96
    M	Month in year	Month	July; Jul; 07
    w	Week in year	Number	27
    W	Week in month	Number	2
    D	Day in year	Number	189
    d	Day in month	Number	10
    F	Day of week in month	Number	2
    E	Day in week	Text	Tuesday; Tue
    a	Am/pm marker	Text	PM
    H	Hour in day (0-23)	Number	0
    k	Hour in day (1-24)	Number	24
    K	Hour in am/pm (0-11)	Number	0
    h	Hour in am/pm (1-12)	Number	12
    m	Minute in hour	Number	30
    s	Second in minute	Number	55
    S	Millisecond	Number	978
    z	Time zone	General time zone	Pacific Standard Time; PST; GMT-08:00
    Z	Time zone	RFC 822 time zone	-0800
	 * @param cal Date time to be formatted
	 * @param format Format string
	 * @return Date time formatted according to format string
	 * @throws XServicesFault
	 */
	@WebMethod(operationName=OPERATION_FORMATDATEADVANCED)
	public abstract String formatDateAdvanced(
			@WebParam(name=PARAM_DATETIME) @XmlElement(required=true) GregorianCalendar cal,
			@WebParam(name=PARAM_FORMAT) @XmlElement(required=true) String format) throws XServicesFault;
	
	/**
	 * Converts a string into date using pre-defined date formats.
	 * 
	 * @param s Date/ time as string
	 * @param format date format
	 * @param timezone timezone
	 * @return XML Date
	 * @throws XServicesFault
	 */
	@WebMethod(operationName=OPERATION_PARSEDATE)
	public abstract GregorianCalendar parseDate(
			@WebParam(name=PARAM_DATETIME) @XmlElement(required=true) String s,
			@WebParam(name=PARAM_FORMAT) @XmlElement(required=true) DateFormatType format,
			@WebParam(name=PARAM_TIMEZONE) String timezone) throws XServicesFault;
	
	/**
	 * Converts a string into date using any format.
	 * @param s date/ time as string
	 * @param format date format
	 * @param timezone timezone
	 * @return XML Date
	 * @throws XServicesFault
	 */
	@WebMethod(operationName=OPERATION_PARSEDATEADVANCED)
	public abstract GregorianCalendar parseDateAdvanced(
			@WebParam(name=PARAM_DATETIME) @XmlElement(required=true) String s,
			@WebParam(name=PARAM_FORMAT) @XmlElement(required=true) String format,
			@WebParam(name=PARAM_TIMEZONE) String timezone) throws XServicesFault;
	
	/**
	 * Calculate elapsed time between two dates.
	 * @param fromCal First date.
	 * @param toCal Second date.
	 * @return Elapsed time in milliseconds
	 * @throws XServicesFault
	 */
	@WebMethod(operationName=OPERATION_DATETIMEDIFF)
	public abstract BigInteger dateTimeDiff(
			@WebParam(name="fromDateTime") @XmlElement(required=true) GregorianCalendar fromCal,
			@WebParam(name="toDateTime") @XmlElement(required=true) GregorianCalendar toCal) throws XServicesFault;
	
	/**
	 * Fully elapsed units between two dates.
	 * 4:15:10-4:15:55 in minutes = 0 and in seconds = 45
	 * 
	 * @param fromCal
	 * @param toCal
	 * @param unit
	 * @return Date/time difference in unit
	 * @throws XServicesFault
	 */
	@WebMethod(operationName=OPERATION_DATETIMEDIFF2)
	@WSDLDocumentation(value="Get elapsed time between to dates.")
	public abstract BigInteger dateTimeDiff2(
			@WebParam(name="fromDateTime") @XmlElement(required=true) GregorianCalendar fromCal,
			@WebParam(name="toDateTime") @XmlElement(required=true) GregorianCalendar toCal,
			@WebParam(name="PARAM_UNIT") DateTimeUnits unit) throws XServicesFault;
	
	/**
	 * Add or subtract a time span from a date.
	 * 
	 * @param cal The initial date.
	 * @param value The amount to add.
	 * @param unit The unit the amount is defined in.
	 * @return New date and time.
	 * @throws XServicesFault
	 * 
	 */
	@WebMethod(operationName=OPERATION_DATEADD)
	@WSDLDocumentation(value="Add or substract a time span from a date.")
	public abstract GregorianCalendar dateAdd(
			@WebParam(name=PARAM_DATETIME) @XmlElement(required=true) GregorianCalendar cal,
			@WebParam(name="value") @XmlElement(required=true) BigInteger value,
			@WebParam(name=PARAM_UNIT) @XmlElement(required=true) DateTimeUnits unit) throws XServicesFault;
	
}

Subversion Repositories XServices

(root)/xservices/trunk/src/java/net/brutex/xservices/ws/DateService.java @ 81 – Rev 69 → 70

Rev 69		Rev 70
1	`/*`	1	`/*`
2	`* Copyright 2011 Brian Rosenberger (Brutex Network)`	2	`* Copyright 2011 Brian Rosenberger (Brutex Network)`
3	`*`	3	`*`
4	`* Licensed under the Apache License, Version 2.0 (the "License");`	4	`* Licensed under the Apache License, Version 2.0 (the "License");`
5	`* you may not use this file except in compliance with the License.`	5	`* you may not use this file except in compliance with the License.`
6	`* You may obtain a copy of the License at`	6	`* You may obtain a copy of the License at`
7	`*`	7	`*`
8	`* http://www.apache.org/licenses/LICENSE-2.0`	8	`* http://www.apache.org/licenses/LICENSE-2.0`
9	`*`	9	`*`
10	`* Unless required by applicable law or agreed to in writing, software`	10	`* Unless required by applicable law or agreed to in writing, software`
11	`* distributed under the License is distributed on an "AS IS" BASIS,`	11	`* distributed under the License is distributed on an "AS IS" BASIS,`
12	`* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.`	12	`* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.`
13	`* See the License for the specific language governing permissions and`	13	`* See the License for the specific language governing permissions and`
14	`* limitations under the License.`	14	`* limitations under the License.`
15	`*/`	15	`*/`
16		16
17	`package net.brutex.xservices.ws;`	17	`package net.brutex.xservices.ws;`
18		18
19	`import java.math.BigInteger;`	19	`import java.math.BigInteger;`
20	`import java.util.GregorianCalendar;`	20	`import java.util.GregorianCalendar;`
21		21
22	`import javax.jws.WebMethod;`	22	`import javax.jws.WebMethod;`
23	`import javax.jws.WebParam;`	23	`import javax.jws.WebParam;`
24	`import javax.jws.WebService;`	24	`import javax.jws.WebService;`
25	`import javax.xml.bind.annotation.XmlElement;`	25	`import javax.xml.bind.annotation.XmlElement;`
26		26
27	`import net.brutex.xservices.types.DateFormatType;`	27	`import net.brutex.xservices.types.DateFormatType;`
28	`import net.brutex.xservices.types.DateTimeUnits;`	28	`import net.brutex.xservices.types.DateTimeUnits;`
29	`import net.brutex.xservices.util.BrutexNamespaces;`	29	`import net.brutex.xservices.util.BrutexNamespaces;`
30		30
31	`import org.apache.cxf.annotations.WSDLDocumentation;`	31	`import org.apache.cxf.annotations.WSDLDocumentation;`
32	`import org.apache.cxf.annotations.WSDLDocumentationCollection;`	32	`import org.apache.cxf.annotations.WSDLDocumentationCollection;`
33		33
34	`/**`	34	`/**`
35	`* Date and time related services.`	35	`* Date and time related services.`
36	`* @author Brian Rosenberger`	36	`* @author Brian Rosenberger`
37	`*`	37	`*`
38	`*/`	38	`*/`
39	`@WebService(targetNamespace = BrutexNamespaces.WS_XSERVICES)`	39	`@WebService(targetNamespace = BrutexNamespaces.WS_XSERVICES)`
40	`@WSDLDocumentationCollection(`	40	`@WSDLDocumentationCollection(`
41	`{`	41	`{`
42	`@WSDLDocumentation(value = BrutexNamespaces.BRUTEX_COPYRIGHT, placement = WSDLDocumentation.Placement.TOP)`	42	`@WSDLDocumentation(value = BrutexNamespaces.BRUTEX_COPYRIGHT, placement = WSDLDocumentation.Placement.TOP)`
43	`}`	43	`}`
44	`)`	44	`)`
45	`public interface DateService {`	45	`public interface DateService {`
46		46
47	`public static final String SERVICE_NAME = "DateService";`	47	`public static final String SERVICE_NAME = "DateService";`
48	`final String OPERATION_GETDATE = "getDate";`	48	`final String OPERATION_GETDATE = "getDate";`
49	`final String OPERATION_GETTIMESTAMP = "getTimestamp";`	49	`final String OPERATION_GETTIMESTAMP = "getTimestamp";`
50	`final String OPERATION_GETINTIMEZONE = "getInTimezone";`	50	`final String OPERATION_GETINTIMEZONE = "getInTimezone";`
51	`final String OPERATION_FORMATDATE = "formatDate";`	51	`final String OPERATION_FORMATDATE = "formatDate";`
52	`final String OPERATION_FORMATDATEADVANCED = "formatDateAdvanced";`	52	`final String OPERATION_FORMATDATEADVANCED = "formatDateAdvanced";`
53	`final String OPERATION_PARSEDATE = "parseDate";`	53	`final String OPERATION_PARSEDATE = "parseDate";`
54	`final String OPERATION_PARSEDATEADVANCED = "parseDateAdvanced";`	54	`final String OPERATION_PARSEDATEADVANCED = "parseDateAdvanced";`
55	`final String OPERATION_DATETIMEDIFF = "dateTimeDiff";`	55	`final String OPERATION_DATETIMEDIFF = "dateTimeDiff";`
56	`final String OPERATION_DATETIMEDIFF2 = "dateTimeDiff2";`	56	`final String OPERATION_DATETIMEDIFF2 = "dateTimeDiff2";`
57	`final String OPERATION_DATEADD = "dateAdd";`	57	`final String OPERATION_DATEADD = "dateAdd";`
58		58
59	`final String PARAM_TIMEZONE = "timezone";`	59	`final String PARAM_TIMEZONE = "timezone";`
60	`final String PARAM_DATETIME = "datetime";`	60	`final String PARAM_DATETIME = "datetime";`
61	`final String PARAM_FORMAT = "format";`	61	`final String PARAM_FORMAT = "format";`
62	`final String PARAM_UNIT = "unit";`	62	`final String PARAM_UNIT = "unit";`
63		63
64	`/**`	64	`/**`
65	`* Get current date and time.`	65	`* Get current date and time.`
66	`*`	66	`*`
67	`* @param timezone Optional timezone. Defaults to server timezone.`	67	`* @param timezone Optional timezone. Defaults to server timezone.`
68	`* @return Current date and time.`	68	`* @return Current date and time.`
69	`* @throws XServicesFault`	69	`* @throws XServicesFault`
70	`*/`	70	`*/`
71	`@WebMethod(operationName=OPERATION_GETDATE)`	71	`@WebMethod(operationName=OPERATION_GETDATE)`
72	`@WSDLDocumentation(value="Get current date and time.")`	72	`@WSDLDocumentation(value="Get current date and time.")`
73	`public abstract GregorianCalendar getDate(`	73	`public abstract GregorianCalendar getDate(`
74	`@WebParam(name=PARAM_TIMEZONE) String timezone) throws XServicesFault;`	74	`@WebParam(name=PARAM_TIMEZONE) String timezone) throws XServicesFault;`
75		75
76	`/**`	76	`/**`
77	`* Get milliseconds since 01.01.1970.`	77	`* Get milliseconds since 01.01.1970.`
78	`*`	78	`*`
79	`* @return timestamp milliseconds`	79	`* @return timestamp milliseconds`
80	`*/`	80	`*/`
81	`@WebMethod(operationName=OPERATION_GETTIMESTAMP)`	81	`@WebMethod(operationName=OPERATION_GETTIMESTAMP)`
82	`@WSDLDocumentation(value="Get milliseconds since 01.01.1970 (Unix timestap).")`	82	`@WSDLDocumentation(value="Get milliseconds since 01.01.1970 (Unix timestap).")`
83	`public abstract BigInteger getTimestamp();`	83	`public abstract BigInteger getTimestamp();`
84		84
85	`/**`	85	`/**`
86	`* Display a date time with a different time zone.`	86	`* Display a date time with a different time zone.`
87	`* Changes representation only (no conversion).`	87	`* Changes representation only (no conversion).`
88	`*`	88	`*`
89	`* @param cal date time.`	89	`* @param cal date time.`
90	`* @param timezone time zone`	90	`* @param timezone time zone`
91	`* @return date time`	91	`* @return date time`
92	`* @throws XServicesFault`	92	`* @throws XServicesFault`
93	`*/`	93	`*/`
94	`@WebMethod(operationName=OPERATION_GETINTIMEZONE)`	94	`@WebMethod(operationName=OPERATION_GETINTIMEZONE)`
95	`public abstract GregorianCalendar getInTimezone(`	95	`public abstract GregorianCalendar getInTimezone(`
96	`@WebParam(name=PARAM_DATETIME) @XmlElement(required=true) GregorianCalendar cal,`	96	`@WebParam(name=PARAM_DATETIME) @XmlElement(required=true) GregorianCalendar cal,`
97	`@WebParam(name=PARAM_TIMEZONE) @XmlElement(required=true) String timezone) throws XServicesFault;`	97	`@WebParam(name=PARAM_TIMEZONE) @XmlElement(required=true) String timezone) throws XServicesFault;`
98		98
99	`/**`	99	`/**`
100	`* Formats a date with pre-defined patterns.`	100	`* Formats a date with pre-defined patterns.`
101	`*`	101	`*`
102	`* @param cal date time to be formatted`	102	`* @param cal date time to be formatted`
103	`* @param format Pattern to be used for date formating`	103	`* @param format Pattern to be used for date formating`
104	`* @return formatted date/time string`	104	`* @return formatted date/time string`
105	`* @throws XServicesFault`	105	`* @throws XServicesFault`
106	`*/`	106	`*/`
107	`@WebMethod(operationName=OPERATION_FORMATDATE)`	107	`@WebMethod(operationName=OPERATION_FORMATDATE)`
108	`public abstract String formatDate(`	108	`public abstract String formatDate(`
109	`@WebParam(name=PARAM_DATETIME) @XmlElement(required=true) GregorianCalendar cal,`	109	`@WebParam(name=PARAM_DATETIME) @XmlElement(required=true) GregorianCalendar cal,`
110	`@WebParam(name=PARAM_FORMAT) @XmlElement(required=true) DateFormatType format) throws XServicesFault;`	110	`@WebParam(name=PARAM_FORMAT) @XmlElement(required=true) DateFormatType format) throws XServicesFault;`
111		111
112	`/**`	112	`/**`
113	`* Formats a date with a free form pattern.`	113	`* Formats a date with a free form pattern.`
114	`* Uses SimpleDateFormat patterns`	114	`* Uses SimpleDateFormat patterns`
115	`* The following pattern letters are defined (all other characters from 'A' to 'Z' and from 'a' to 'z' are reserved):`	115	`* The following pattern letters are defined (all other characters from 'A' to 'Z' and from 'a' to 'z' are reserved):`
116		116
117	`Letter Date or Time Component Presentation Examples`	117	`Letter Date or Time Component Presentation Examples`
118	`G Era designator Text AD`	118	`G Era designator Text AD`
119	`y Year Year 1996; 96`	119	`y Year Year 1996; 96`
120	`M Month in year Month July; Jul; 07`	120	`M Month in year Month July; Jul; 07`
121	`w Week in year Number 27`	121	`w Week in year Number 27`
122	`W Week in month Number 2`	122	`W Week in month Number 2`
123	`D Day in year Number 189`	123	`D Day in year Number 189`
124	`d Day in month Number 10`	124	`d Day in month Number 10`
125	`F Day of week in month Number 2`	125	`F Day of week in month Number 2`
126	`E Day in week Text Tuesday; Tue`	126	`E Day in week Text Tuesday; Tue`
127	`a Am/pm marker Text PM`	127	`a Am/pm marker Text PM`
128	`H Hour in day (0-23) Number 0`	128	`H Hour in day (0-23) Number 0`
129	`k Hour in day (1-24) Number 24`	129	`k Hour in day (1-24) Number 24`
130	`K Hour in am/pm (0-11) Number 0`	130	`K Hour in am/pm (0-11) Number 0`
131	`h Hour in am/pm (1-12) Number 12`	131	`h Hour in am/pm (1-12) Number 12`
132	`m Minute in hour Number 30`	132	`m Minute in hour Number 30`
133	`s Second in minute Number 55`	133	`s Second in minute Number 55`
134	`S Millisecond Number 978`	134	`S Millisecond Number 978`
135	`z Time zone General time zone Pacific Standard Time; PST; GMT-08:00`	135	`z Time zone General time zone Pacific Standard Time; PST; GMT-08:00`
136	`Z Time zone RFC 822 time zone -0800`	136	`Z Time zone RFC 822 time zone -0800`
137	`* @param cal Date time to be formatted`	137	`* @param cal Date time to be formatted`
138	`* @param format Format string`	138	`* @param format Format string`
139	`* @return Date time formatted according to format string`	139	`* @return Date time formatted according to format string`
140	`* @throws XServicesFault`	140	`* @throws XServicesFault`
141	`*/`	141	`*/`
142	`@WebMethod(operationName=OPERATION_FORMATDATEADVANCED)`	142	`@WebMethod(operationName=OPERATION_FORMATDATEADVANCED)`
143	`public abstract String formatDateAdvanced(`	143	`public abstract String formatDateAdvanced(`
144	`@WebParam(name=PARAM_DATETIME) @XmlElement(required=true) GregorianCalendar cal,`	144	`@WebParam(name=PARAM_DATETIME) @XmlElement(required=true) GregorianCalendar cal,`
145	`@WebParam(name=PARAM_FORMAT) @XmlElement(required=true) String format) throws XServicesFault;`	145	`@WebParam(name=PARAM_FORMAT) @XmlElement(required=true) String format) throws XServicesFault;`
-		146
-		147	`/**`
-		148	`* Converts a string into date using pre-defined date formats.`
-		149	`*`
-		150	`* @param s Date/ time as string`
-		151	`* @param format date format`
-		152	`* @param timezone timezone`
-		153	`* @return XML Date`
-		154	`* @throws XServicesFault`
146		155	`*/`
147	`@WebMethod(operationName=OPERATION_PARSEDATE)`	156	`@WebMethod(operationName=OPERATION_PARSEDATE)`
148	`public abstract GregorianCalendar parseDate(`	157	`public abstract GregorianCalendar parseDate(`
149	`@WebParam(name=PARAM_DATETIME) @XmlElement(required=true) String s,`	158	`@WebParam(name=PARAM_DATETIME) @XmlElement(required=true) String s,`
150	`@WebParam(name=PARAM_FORMAT) @XmlElement(required=true) DateFormatType format,`	159	`@WebParam(name=PARAM_FORMAT) @XmlElement(required=true) DateFormatType format,`
151	`@WebParam(name=PARAM_TIMEZONE) String timezone) throws XServicesFault;`	160	`@WebParam(name=PARAM_TIMEZONE) String timezone) throws XServicesFault;`
-		161
-		162	`/**`
-		163	`* Converts a string into date using any format.`
-		164	`* @param s date/ time as string`
-		165	`* @param format date format`
-		166	`* @param timezone timezone`
-		167	`* @return XML Date`
-		168	`* @throws XServicesFault`
152		169	`*/`
153	`@WebMethod(operationName=OPERATION_PARSEDATEADVANCED)`	170	`@WebMethod(operationName=OPERATION_PARSEDATEADVANCED)`
154	`public abstract GregorianCalendar parseDateAdvanced(`	171	`public abstract GregorianCalendar parseDateAdvanced(`
155	`@WebParam(name=PARAM_DATETIME) @XmlElement(required=true) String s,`	172	`@WebParam(name=PARAM_DATETIME) @XmlElement(required=true) String s,`
156	`@WebParam(name=PARAM_FORMAT) @XmlElement(required=true) String format,`	173	`@WebParam(name=PARAM_FORMAT) @XmlElement(required=true) String format,`
157	`@WebParam(name=PARAM_TIMEZONE) String timezone) throws XServicesFault;`	174	`@WebParam(name=PARAM_TIMEZONE) String timezone) throws XServicesFault;`
158		175
159	`/**`	176	`/**`
160	`* Calculate elapsed time between two dates.`	177	`* Calculate elapsed time between two dates.`
161	`* @param fromCal First date.`	178	`* @param fromCal First date.`
162	`* @param toCal Second date.`	179	`* @param toCal Second date.`
163	`* @return Elapsed time in milliseconds`	180	`* @return Elapsed time in milliseconds`
164	`* @throws XServicesFault`	181	`* @throws XServicesFault`
165	`*/`	182	`*/`
166	`@WebMethod(operationName=OPERATION_DATETIMEDIFF)`	183	`@WebMethod(operationName=OPERATION_DATETIMEDIFF)`
167	`public abstract BigInteger dateTimeDiff(`	184	`public abstract BigInteger dateTimeDiff(`
168	`@WebParam(name="fromDateTime") @XmlElement(required=true) GregorianCalendar fromCal,`	185	`@WebParam(name="fromDateTime") @XmlElement(required=true) GregorianCalendar fromCal,`
169	`@WebParam(name="toDateTime") @XmlElement(required=true) GregorianCalendar toCal) throws XServicesFault;`	186	`@WebParam(name="toDateTime") @XmlElement(required=true) GregorianCalendar toCal) throws XServicesFault;`
170		187
171	`/**`	188	`/**`
172	`* Fully elapsed units between two dates.`	189	`* Fully elapsed units between two dates.`
173	`* 4:15:10-4:15:55 in minutes = 0 and in seconds = 45`	190	`* 4:15:10-4:15:55 in minutes = 0 and in seconds = 45`
174	`*`	191	`*`
175	`* @param fromCal`	192	`* @param fromCal`
176	`* @param toCal`	193	`* @param toCal`
177	`* @param unit`	194	`* @param unit`
178	`* @return Date/time difference in unit`	195	`* @return Date/time difference in unit`
179	`* @throws XServicesFault`	196	`* @throws XServicesFault`
180	`*/`	197	`*/`
181	`@WebMethod(operationName=OPERATION_DATETIMEDIFF2)`	198	`@WebMethod(operationName=OPERATION_DATETIMEDIFF2)`
182	`@WSDLDocumentation(value="Get elapsed time between to dates.")`	199	`@WSDLDocumentation(value="Get elapsed time between to dates.")`
183	`public abstract BigInteger dateTimeDiff2(`	200	`public abstract BigInteger dateTimeDiff2(`
184	`@WebParam(name="fromDateTime") @XmlElement(required=true) GregorianCalendar fromCal,`	201	`@WebParam(name="fromDateTime") @XmlElement(required=true) GregorianCalendar fromCal,`
185	`@WebParam(name="toDateTime") @XmlElement(required=true) GregorianCalendar toCal,`	202	`@WebParam(name="toDateTime") @XmlElement(required=true) GregorianCalendar toCal,`
186	`@WebParam(name="PARAM_UNIT") DateTimeUnits unit) throws XServicesFault;`	203	`@WebParam(name="PARAM_UNIT") DateTimeUnits unit) throws XServicesFault;`
187		204
188	`/**`	205	`/**`
189	`* Add or subtract a time span from a date.`	206	`* Add or subtract a time span from a date.`
190	`*`	207	`*`
191	`* @param cal The initial date.`	208	`* @param cal The initial date.`
192	`* @param value The amount to add.`	209	`* @param value The amount to add.`
193	`* @param unit The unit the amount is defined in.`	210	`* @param unit The unit the amount is defined in.`
194	`* @return New date and time.`	211	`* @return New date and time.`
195	`* @throws XServicesFault`	212	`* @throws XServicesFault`
196	`*`	213	`*`
197	`*/`	214	`*/`
198	`@WebMethod(operationName=OPERATION_DATEADD)`	215	`@WebMethod(operationName=OPERATION_DATEADD)`
199	`@WSDLDocumentation(value="Add or substract a time span from a date.")`	216	`@WSDLDocumentation(value="Add or substract a time span from a date.")`
200	`public abstract GregorianCalendar dateAdd(`	217	`public abstract GregorianCalendar dateAdd(`
201	`@WebParam(name=PARAM_DATETIME) @XmlElement(required=true) GregorianCalendar cal,`	218	`@WebParam(name=PARAM_DATETIME) @XmlElement(required=true) GregorianCalendar cal,`
202	`@WebParam(name="value") @XmlElement(required=true) BigInteger value,`	219	`@WebParam(name="value") @XmlElement(required=true) BigInteger value,`
203	`@WebParam(name=PARAM_UNIT) @XmlElement(required=true) DateTimeUnits unit) throws XServicesFault;`	220	`@WebParam(name=PARAM_UNIT) @XmlElement(required=true) DateTimeUnits unit) throws XServicesFault;`
204		221
205	`}`	222	`}`