uk.co.real_logic.artio.fields

Class UtcTimestampDecoder

java.lang.Object

uk.co.real_logic.artio.fields.UtcTimestampDecoder

public final class UtcTimestampDecoder
extends java.lang.Object

Parser for Fix's UTC timestamps.

Equivalent to a Java format string of "yyyyMMdd-HH:mm:ss[.SSS]". The builtin parsers could cope with this situation, but allocate and perform poorly.

If the final fraction of the second is expected to be in 3 characters and only supports up to millisecond precision then you can use the normal decode(AsciiBuffer, int, int, boolean) method. Support for microsecond precision, eg: "yyyyMMdd-HH:mm:ss[.SSSSSS]" is provided through the decodeMicros(AsciiBuffer, int, int, boolean) method.

Field Summary

Fields

Modifier and Type	Field and Description
static int	LENGTH_WITH_MICROSECONDS
static int	LENGTH_WITH_MILLISECONDS
static int	LENGTH_WITH_NANOSECONDS
static int	LENGTH_WITHOUT_MILLISECONDS
static long	MAX_EPOCH_MICROS
static long	MAX_EPOCH_MILLIS
static long	MAX_EPOCH_NANOS
static long	MIN_EPOCH_MICROS
static long	MIN_EPOCH_MILLIS
static long	MIN_EPOCH_NANOS

Constructor Summary

Constructors

Constructor and Description
UtcTimestampDecoder(boolean strict)

Method Summary

Modifier and Type	Method and Description
static long	decode(AsciiBuffer timestamp, int offset, int length, boolean strict)
long	decode(byte[] bytes)
long	decode(byte[] bytes, int length)
static long	decodeMicros(AsciiBuffer timestamp, int offset, int length, boolean strict)
long	decodeMicros(byte[] bytes)
long	decodeMicros(byte[] bytes, int length)
static long	decodeNanos(AsciiBuffer timestamp, int offset, int length, boolean strict)
long	decodeNanos(byte[] bytes)
long	decodeNanos(byte[] bytes, int length)

Methods inherited from class java.lang.Object

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

Field Detail

MIN_EPOCH_MILLIS

public static final long MIN_EPOCH_MILLIS

See Also:

Constant Field Values

MAX_EPOCH_MILLIS

public static final long MAX_EPOCH_MILLIS

See Also:

Constant Field Values

MIN_EPOCH_MICROS

public static final long MIN_EPOCH_MICROS

See Also:

Constant Field Values

MAX_EPOCH_MICROS

public static final long MAX_EPOCH_MICROS

See Also:

Constant Field Values

MIN_EPOCH_NANOS

public static final long MIN_EPOCH_NANOS

See Also:

Constant Field Values

MAX_EPOCH_NANOS

public static final long MAX_EPOCH_NANOS

See Also:

Constant Field Values

LENGTH_WITHOUT_MILLISECONDS

public static final int LENGTH_WITHOUT_MILLISECONDS

See Also:

Constant Field Values

LENGTH_WITH_MILLISECONDS

public static final int LENGTH_WITH_MILLISECONDS

See Also:

Constant Field Values

LENGTH_WITH_MICROSECONDS

public static final int LENGTH_WITH_MICROSECONDS

See Also:

Constant Field Values

LENGTH_WITH_NANOSECONDS

public static final int LENGTH_WITH_NANOSECONDS

See Also:

Constant Field Values

Constructor Detail

UtcTimestampDecoder

public UtcTimestampDecoder(boolean strict)

Parameters:

strict - if length of FIX encoded value has to be checked to match FIX specification

Method Detail

decode

public long decode(byte[] bytes,
                   int length)

decode

public long decode(byte[] bytes)

decodeMicros

public long decodeMicros(byte[] bytes,
                         int length)

decodeMicros

public long decodeMicros(byte[] bytes)

decodeNanos

public long decodeNanos(byte[] bytes,
                        int length)

decodeNanos

public long decodeNanos(byte[] bytes)

decode

public static long decode(AsciiBuffer timestamp,
                          int offset,
                          int length,
                          boolean strict)

Parameters:

timestamp - a buffer containing the FIX encoded value of the timestamp in ASCII

offset - the offset within the timestamp buffer where the value starts

length - the length of the FIX encoded value in bytes / ASCII characters

strict - if length of FIX encoded value has to be checked to match FIX specification

Returns:

the number of milliseconds since the Unix Epoch that represents this timestamp

Throws:

java.lang.NumberFormatException - if the value in the buffer isn't a valid timestamp.

decodeMicros

public static long decodeMicros(AsciiBuffer timestamp,
                                int offset,
                                int length,
                                boolean strict)

Parameters:

timestamp - a buffer containing the FIX encoded value of the timestamp in ASCII

offset - the offset within the timestamp buffer where the value starts

length - the length of the FIX encoded value in bytes / ASCII characters

strict - if length of FIX encoded value has to be checked to match FIX specification

Returns:

the number of microseconds since the Unix Epoch that represents this timestamp

Throws:

java.lang.NumberFormatException - if the value in the buffer isn't a valid timestamp.

decodeNanos

public static long decodeNanos(AsciiBuffer timestamp,
                               int offset,
                               int length,
                               boolean strict)

Parameters:

timestamp - a buffer containing the FIX encoded value of the timestamp in ASCII

offset - the offset within the timestamp buffer where the value starts

length - the length of the FIX encoded value in bytes / ASCII characters

strict - if length of FIX encoded value has to be checked to match FIX specification

Returns:

the number of nanoseconds since the Unix Epoch that represents this timestamp

Throws:

java.lang.NumberFormatException - if the value in the buffer isn't a valid timestamp.