Module io.helidon.http

Package io.helidon.http

Class DateTime

java.lang.Object

io.helidon.http.DateTime

public final class DateTime
extends Object

Support for HTTP date formats based on RFC2616.

Field Summary

Fields

Modifier and Type	Field	Description
static final DateTimeFormatter	ASCTIME_DATE_TIME	The ANSI C's asctime() format, such as 'Sun Nov 6 08:49:37 1994'.
static final DateTimeFormatter	RFC_1123_DATE_TIME	The RFC1123 date-time formatter, such as 'Tue, 3 Jun 2008 11:05:30 GMT'.
static final DateTimeFormatter	RFC_850_DATE_TIME	The RFC850 date-time formatter, such as 'Sunday, 06-Nov-94 08:49:37 GMT'.

Method Summary

Modifier and Type	Method	Description
static byte[]	http1Bytes()	Formatted date time terminated by carriage return and new line.
static ZonedDateTime	parse(String text)	Parse provided text to ZonedDateTime using any possible date / time format specified by RFC2616 Hypertext Transfer Protocol.
static String	rfc1123String()	Get current time as RFC-1123 string.
static ZonedDateTime	timestamp()	Last recorded timestamp.

Methods inherited from class java.lang.Object

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

Field Details

RFC_850_DATE_TIME

public static final DateTimeFormatter RFC_850_DATE_TIME

The RFC850 date-time formatter, such as 'Sunday, 06-Nov-94 08:49:37 GMT'.

This is obsolete standard (obsoleted by RFC1036). Headers MUST NOT be generated in this format. However it should be used as a fallback for parsing to achieve compatibility with older HTTP standards.

Since the format accepts 2 digits year representation formatter works well for dates between (now - 50 Years) and (now + 49 Years).

RFC_1123_DATE_TIME

public static final DateTimeFormatter RFC_1123_DATE_TIME

The RFC1123 date-time formatter, such as 'Tue, 3 Jun 2008 11:05:30 GMT'.

This is standard for RFC2616 and all created headers MUST be in this format! However implementation must accept headers also in RFC850 and ANSI C asctime() format.

This is just copy of convenient copy of DateTimeFormatter.RFC_1123_DATE_TIME.

ASCTIME_DATE_TIME

public static final DateTimeFormatter ASCTIME_DATE_TIME

The ANSI C's asctime() format, such as 'Sun Nov 6 08:49:37 1994'.

Headers MUST NOT be generated in this format. However it should be used as a fallback for parsing to achieve compatibility with older HTTP standards.

Method Details

parse

public static ZonedDateTime parse(String text)

Parse provided text to ZonedDateTime using any possible date / time format specified by RFC2616 Hypertext Transfer Protocol.

Formats are specified by RFC_1123_DATE_TIME, RFC_850_DATE_TIME and ASCTIME_DATE_TIME.

Parameters:

text - a text to parse.

Returns:

parsed date time.

Throws:

DateTimeParseException - if not in any of supported formats.

timestamp

public static ZonedDateTime timestamp()

Last recorded timestamp.

Returns:

timestamp

rfc1123String

public static String rfc1123String()

Get current time as RFC-1123 string.

Returns:

formatted current time

See Also:

• RFC_1123_DATE_TIME

http1Bytes

public static byte[] http1Bytes()

Formatted date time terminated by carriage return and new line.

Returns:

date bytes for HTTP/1