quickfix.field.converter

Class UtcTimestampConverter

java.lang.Object

quickfix.field.converter.UtcTimestampConverter

public class UtcTimestampConverter
extends Object

Convert between a timestamp and a String. A timestamp includes both a date and a time.

Constructor Summary

Constructors

Constructor and Description
UtcTimestampConverter()

Method Summary

Modifier and Type	Method and Description
protected static void	assertDigitSequence(String value, int i, int j, String type)
protected static void	assertLength(String value, int i, String type)
protected static void	assertLength(String value, String type, int... lengths)
protected static void	assertSeparator(String value, int offset, char ch, String type)
static String	convert(Date d, boolean includeMilliseconds) Convert a timestamp (represented as a Date) to a String.
static String	convert(LocalDateTime d, UtcTimestampPrecision precision) Convert a timestamp (represented as a LocalDateTime) to a String.
static Date	convert(String value) Convert a timestamp string into a Date.
static LocalDateTime	convertToLocalDateTime(String value) Convert a timestamp string into a LocalDateTime object.
protected DateFormat	createDateFormat(String format)
protected static DateTimeFormatter	createDateTimeFormat(String format)
static Date	getDate(LocalDateTime localDateTime)
protected static void	throwFieldConvertError(String value, String type)

Methods inherited from class java.lang.Object

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

Constructor Detail

UtcTimestampConverter

public UtcTimestampConverter()

Method Detail

convert

public static String convert(Date d,
                             boolean includeMilliseconds)

Convert a timestamp (represented as a Date) to a String.

Parameters:

d - the date to convert

includeMilliseconds - controls whether milliseconds are included in the result

Returns:

the formatted timestamp

convert

public static String convert(LocalDateTime d,
                             UtcTimestampPrecision precision)

Convert a timestamp (represented as a LocalDateTime) to a String.

Parameters:

d - the date to convert

precision - controls whether seconds, milliseconds, microseconds or nanoseconds are included in the result

Returns:

the formatted timestamp

convert

public static Date convert(String value)
                    throws FieldConvertError

Convert a timestamp string into a Date. Date has up to millisecond precision.

Parameters:

value - the timestamp String

Returns:

the parsed timestamp

Throws:

FieldConvertError - raised if timestamp is an incorrect format.

convertToLocalDateTime

public static LocalDateTime convertToLocalDateTime(String value)
                                            throws FieldConvertError

Convert a timestamp string into a LocalDateTime object. LocalDateTime has up to nanosecond precision.

Parameters:

value - the timestamp String

Returns:

the parsed timestamp

Throws:

FieldConvertError - raised if timestamp is an incorrect format.

getDate

public static Date getDate(LocalDateTime localDateTime)

Parameters:

localDateTime -

Returns:

a java.util.Date filled from LocalDateTime (truncated to milliseconds).

assertLength

protected static void assertLength(String value,
                                   int i,
                                   String type)
                            throws FieldConvertError

Throws:

FieldConvertError

assertLength

protected static void assertLength(String value,
                                   String type,
                                   int... lengths)
                            throws FieldConvertError

Throws:

FieldConvertError

assertDigitSequence

protected static void assertDigitSequence(String value,
                                          int i,
                                          int j,
                                          String type)
                                   throws FieldConvertError

Throws:

FieldConvertError

assertSeparator

protected static void assertSeparator(String value,
                                      int offset,
                                      char ch,
                                      String type)
                               throws FieldConvertError

Throws:

FieldConvertError

throwFieldConvertError

protected static void throwFieldConvertError(String value,
                                             String type)
                                      throws FieldConvertError

Throws:

FieldConvertError

createDateFormat

protected DateFormat createDateFormat(String format)

createDateTimeFormat

protected static DateTimeFormatter createDateTimeFormat(String format)