net.openhft.chronicle.wire

Class MicroTimestampLongConverter

java.lang.Object

net.openhft.chronicle.wire.AbstractTimestampLongConverter

net.openhft.chronicle.wire.MicroTimestampLongConverter

All Implemented Interfaces:

LongConverter

Direct Known Subclasses:

WatermarkedMicroTimestampLongConverter

public class MicroTimestampLongConverter
extends AbstractTimestampLongConverter

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

Field Summary

Fields

Modifier and Type	Field and Description
static MicroTimestampLongConverter	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
MicroTimestampLongConverter() Constructs a new MicroTimestampLongConverter with the default zone ID (fetched from the system property or UTC).
MicroTimestampLongConverter(String zoneId) Constructs a new MicroTimestampLongConverter with the specified zone ID.
MicroTimestampLongConverter(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 MicroTimestampLongConverter INSTANCE

The singleton instance of this converter.

Constructor Detail

MicroTimestampLongConverter

public MicroTimestampLongConverter()

Constructs a new MicroTimestampLongConverter with the default zone ID (fetched from the system property or UTC). Supports the old system property for micro timestamps specifically.

MicroTimestampLongConverter

public MicroTimestampLongConverter(String zoneId)

Constructs a new MicroTimestampLongConverter with the specified zone ID.

Parameters:

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

MicroTimestampLongConverter

@Deprecated
public MicroTimestampLongConverter(String zoneId,
                                               boolean includeZoneSuffixForUTC)

Deprecated.

Constructs a new MicroTimestampLongConverter 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

appendFraction

protected void appendFraction(DateTimeFormatterBuilder builder)

Description copied from class: AbstractTimestampLongConverter

Appends the fraction of the second to the provided DateTimeFormatterBuilder.

Specified by:

appendFraction in class AbstractTimestampLongConverter

Parameters:

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

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 microseconds. A debug log is printed if the timestamp is in microseconds 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