01: /**
02: * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
03: * Unpublished - rights reserved under the Copyright Laws of the United States.
04: * Copyright © 2003 Sun Microsystems, Inc. All rights reserved.
05: * Copyright © 2005 BEA Systems, Inc. All rights reserved.
06: *
07: * Use is subject to license terms.
08: *
09: * This distribution may include materials developed by third parties.
10: *
11: * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
12: *
13: * Module Name : JSIP Specification
14: * File Name : DateHeader.java
15: * Author : Phelim O'Doherty
16: *
17: * HISTORY
18: * Version Date Author Comments
19: * 1.1 08/10/2002 Phelim O'Doherty
20: *~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
21: */package javax.sip.header;
22:
23: import java.util.*;
24:
25: /**
26: * The Date header field reflects the time when the request or response is
27: * first sent. Retransmissions have the same Date header field value as the
28: * original. The Date header field contains the date and time. Unlike
29: * HTTP/1.1, SIP only supports the most recent
30: * <a href = "http://www.ietf.org/rfc/rfc1123.txt">RFC 1123</a> format for dates.
31: * SIP restricts the time zone in SIP-date to "GMT", while RFC 1123 allows any
32: * time zone.
33: * <p>
34: * The Date header field can be used by simple end systems without a
35: * battery-backed clock to acquire a notion of current time. However, in its
36: * GMT form, it requires clients to know their offset from GMT.
37: * <p>
38: * Example:<br>
39: * Date: Sat, 13 Nov 2010 23:29:00 GMT
40: *
41: * @author BEA Systems, NIST
42: * @version 1.2
43: */
44:
45: public interface DateHeader extends Header {
46:
47: /**
48:
49: * Sets date of DateHeader. The date is repesented by the Calendar object.
50:
51: *
52:
53: * @param date the Calendar object date of this header.
54:
55: */
56:
57: public void setDate(Calendar date);
58:
59: /**
60:
61: * Gets the date of DateHeader. The date is repesented by the Calender
62:
63: * object.
64:
65: *
66:
67: * @return the Calendar object representing the date of DateHeader
68:
69: */
70:
71: public Calendar getDate();
72:
73: /**
74:
75: * Name of DateHeader
76:
77: */
78:
79: public final static String NAME = "Date";
80:
81: }
|