Package com.iizix

Class RFCDate

java.lang.Object
com.iizix.RFCDate

public class RFCDate 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.

Author:
Christopher Mindus
  • Constructor Details

    • RFCDate

      public RFCDate()
  • Method Details

    • getCurrentUTC

      public static String getCurrentUTC(Date date)
      Gets the current UTC date/time string according to RFC1123 date.
      Parameters:
      date - The date.
      Returns:
      The string.
    • getCurrentUTC

      public static String getCurrentUTC()
      Gets the current UTC date/time string according to RFC1123 date.
      Returns:
      Current date string.
    • 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
       
      Parameters:
      date - The date string.
      Returns:
      Date with the parsed date or null if error.