net.openhft.chronicle.wire

Class MilliTimestampLongConverter

java.lang.Object

net.openhft.chronicle.wire.AbstractTimestampLongConverter

net.openhft.chronicle.wire.MilliTimestampLongConverter

All Implemented Interfaces:

LongConverter

public class MilliTimestampLongConverter
extends AbstractTimestampLongConverter

A MilliTimestampLongConverter is an implementation of AbstractTimestampLongConverter which handles conversions between long timestamps and date-time strings. The precision of this converter is to the millisecond. This converter is singleton, the instance can be accessed using the public field INSTANCE.

Field Summary

Fields

Modifier and Type	Field and Description
static MilliTimestampLongConverter	INSTANCE The singleton instance of this converter.

Fields inherited from class net.openhft.chronicle.wire.AbstractTimestampLongConverter

INCLUDE_ZONE_SUFFIX_WHEN_ZONE_IS_UTC_SYSTEM_PROPERTY, TIMESTAMP_LONG_CONVERTERS_ZONE_ID_SYSTEM_PROPERTY, UTC

Constructor Summary

Constructors

Constructor and Description
MilliTimestampLongConverter() Constructs a new MilliTimestampLongConverter with the default zone ID (fetched from the system property or UTC).
MilliTimestampLongConverter(String zoneId) Constructs a new MilliTimestampLongConverter with the specified zone ID.
MilliTimestampLongConverter(String zoneId, boolean includeZoneSuffixForUTC) Deprecated.

Method Summary

Modifier and Type	Method and Description
protected void	appendFraction(DateTimeFormatterBuilder builder) Appends the fraction of the second to the provided DateTimeFormatterBuilder.
protected long	parseFormattedDate(ZonedDateTime value) Parses a formatted date into a long timestamp.
protected long	parseTimestamp(long value, CharSequence text) Parses a long timestamp.

Methods inherited from class net.openhft.chronicle.wire.AbstractTimestampLongConverter

append, append, append, parse

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.openhft.chronicle.wire.LongConverter

addEncode, allSafeChars, asString, asText, asText, forSymbols, lengthCheck, maxParseLength, maxParseLength

Field Detail

INSTANCE

public static final MilliTimestampLongConverter INSTANCE

The singleton instance of this converter.

Constructor Detail

MilliTimestampLongConverter

public MilliTimestampLongConverter()

Constructs a new MilliTimestampLongConverter with the default zone ID (fetched from the system property or UTC).

MilliTimestampLongConverter

public MilliTimestampLongConverter(String zoneId)

Constructs a new MilliTimestampLongConverter with the specified zone ID.

Parameters:

zoneId - the zone ID to be used for the conversion of long values

MilliTimestampLongConverter

@Deprecated
public MilliTimestampLongConverter(String zoneId,
                                               boolean includeZoneSuffixForUTC)

Deprecated.

Constructs a new MilliTimestampLongConverter with the specified zone ID and flag for including zone suffix for UTC. This constructor is set to be deprecated in x.26 version.

Parameters:

zoneId - the zone ID to be used for the conversion of long values

includeZoneSuffixForUTC - the flag to indicate if 'Z' suffix should be included for UTC zone timestamps

Method Detail

parseFormattedDate

protected long parseFormattedDate(ZonedDateTime value)

Parses a formatted date into a long timestamp. This implementation uses the epoch day and time of the day to compute the long timestamp.

Specified by:

parseFormattedDate in class AbstractTimestampLongConverter

Parameters:

value - The parsed formatted date (in UTC zone)

Returns:

The value as a long timestamp

parseTimestamp

protected long parseTimestamp(long value,
                              CharSequence text)

Parses a long timestamp. The provided timestamp value is converted to milliseconds. A debug log is printed if the timestamp is in milliseconds or if it's a non-zero value.

Specified by:

parseTimestamp in class AbstractTimestampLongConverter

Parameters:

value - The parsed timestamp

text - The text version of the timestamp

Returns:

The value as a long timestamp

appendFraction

protected void appendFraction(DateTimeFormatterBuilder builder)

Appends the fraction of the second to the provided DateTimeFormatterBuilder. The fraction is defined in milliseconds and can be 0 to 3 digits long.

Specified by:

appendFraction in class AbstractTimestampLongConverter

Parameters:

builder - The builder after the initial date format has been added