se.entra.phantom.server.http

Class HttpDate

java.lang.Object

se.entra.phantom.server.http.HttpDate

public class HttpDate
extends Object

Date/Time Formats (Full Date). For more information, see RFC 2616 HTTP/1.1 June, 1999.

HTTP applications have historically allowed three different formats for the representation of date/time stamps:

   Sun, 06 Nov 1994 08:49:37 GMT    ; RFC 822, updated by RFC 1123
   Sunday, 06-Nov-94 08:49:37 GMT   ; RFC 850, obsoleted by RFC 1036
   Sun Nov 6 08:49:37 1994          ; ANSI C's asctime() format
 

The first format is preferred as an Internet standard and represents a fixed-length subset of that defined by RFC 1123 [8] (an update to RFC 822 [9]). The second format is in common use, but is based on the obsolete RFC 850 [12] date format and lacks a four-digit year. HTTP/1.1 clients and servers that parse the date value MUST accept all three formats (for compatibility with HTTP/1.0), though they MUST only generate the RFC 1123 format for representing HTTP-date values in header fields.

All HTTP date/time stamps MUST be represented in Greenwich Mean Time (GMT), without exception. For the purposes of HTTP, GMT is exactly equal to UTC (Coordinated Universal Time). This is indicated in the first two formats by the inclusion of "GMT" as the three-letter abbreviation for time zone, and MUST be assumed when reading the asctime format. HTTP-date is case sensitive and MUST NOT include additional LWS beyond that specifically included as SP in the grammar.

   HTTP-date = rfc1123-date | rfc850-date | asctime-date
   rfc1123-date = wkday "," SP date1 SP time SP "GMT"
   rfc850-date = weekday "," SP date2 SP time SP "GMT"
   asctime-date = wkday SP date3 SP time SP 4DIGIT
   date1 = 2DIGIT SP month SP 4DIGIT           ; day month year (e.g., 02 Jun 1982)
   date2 = 2DIGIT "-" month "-" 2DIGIT         ; day-month-year (e.g., 02-Jun-82)
   date3 = month SP ( 2DIGIT | ( SP 1DIGIT ))  ; month day (e.g., Jun 2)
   time = 2DIGIT ":" 2DIGIT ":" 2DIGIT         ; 00:00:00 - 23:59:59
   wkday = "Mon" | "Tue" | "Wed" | "Thu" | "Fri" | "Sat" | "Sun"
   weekday = "Monday" | "Tuesday" | "Wednesday" | "Thursday" | "Friday" | "Saturday" | "Sunday"
   month = "Jan" | "Feb" | "Mar" | "Apr" | "May" | "Jun" | "Jul" | "Aug" | "Sep" | "Oct" | "Nov" | "Dec"
 

Note: HTTP requirements for the date/time stamp format apply only to their usage within the protocol stream. Clients and servers are not required to use these formats for user presentation, request logging, etc.

Constructor Summary

Constructors

Constructor and Description
HttpDate()

Method Summary

Modifier and Type	Method and Description
static String	getCurrentUTC() Gets the current UTC date/time string according to RFC1123 date.
static String	getCurrentUTC(Date date) Gets the current UTC date/time string according to RFC1123 date.
static Date	getDate(String date) Gets a date from a string in either formats available in the HTTP/1.1 specification.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

HttpDate

public HttpDate()

Method Detail

getCurrentUTC

public static String getCurrentUTC(Date date)

Gets the current UTC date/time string according to RFC1123 date.

getCurrentUTC

public static String getCurrentUTC()

Gets the current UTC date/time string according to RFC1123 date.

getDate

public static Date getDate(String date)

Gets a date from a string in either formats available in the HTTP/1.1 specification.

   Sun, 06 Nov 1994 08:49:37 GMT    ; RFC 822, updated by RFC 1123
   Sunday, 06-Nov-94 08:49:37 GMT   ; RFC 850, obsoleted by RFC 1036
   Sun Nov 6 08:49:37 1994          ; ANSI C's asctime() format
 

Returns:

Date with the parsed date or null if error.