net.openhft.chronicle.wire

Class ServicesTimestampLongConverter

java.lang.Object

net.openhft.chronicle.wire.ServicesTimestampLongConverter

All Implemented Interfaces:

LongConverter

public class ServicesTimestampLongConverter
extends Object
implements LongConverter

This is the ServicesTimestampLongConverter class implementing the LongConverter interface. The class is specifically designed to convert timestamps representing service times across different units: nanoseconds (ns), microseconds (us), and milliseconds (ms). The preferred time unit can be specified system-wide using the 'service.time.unit' system property. If not explicitly set, the default unit will be nanoseconds.

Field Summary

Fields

Modifier and Type	Field and Description
static ServicesTimestampLongConverter	INSTANCE

Constructor Summary

Constructors

Constructor and Description
ServicesTimestampLongConverter()

Method Summary

Modifier and Type	Method and Description
void	append(net.openhft.chronicle.bytes.Bytes<?> bytes, long value) Appends a representation of the provided long timestamp (in the system-configured time unit) to the provided Bytes.
void	append(StringBuilder text, long value) Appends a representation of the provided long timestamp (in the system-configured time unit) to the provided StringBuilder.
static long	currentTime() Fetches the current time in the system-configured time unit using the default CLOCK.
static long	currentTime(net.openhft.chronicle.core.time.TimeProvider clock) Fetches the current time in the system-configured time unit using the provided TimeProvider.
long	parse(CharSequence text) Parses the provided CharSequence into a timestamp in the configured time unit.
long	parse(CharSequence text, int beginIndex, int endIndex) Parses a part of the provided CharSequence using the underlying converter.
static TimeUnit	timeUnit() Returns the current system-configured time unit.
static long	toTime(long arg) Converts a timestamp to the service's configured time unit.

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, lengthCheck, maxParseLength, maxParseLength

Field Detail

INSTANCE

@UsedViaReflection
public static final ServicesTimestampLongConverter INSTANCE

Constructor Detail

ServicesTimestampLongConverter

public ServicesTimestampLongConverter()

Method Detail

toTime

public static long toTime(long arg)

Converts a timestamp to the service's configured time unit.

Parameters:

arg - The timestamp value, typically nanoseconds since epoch (from System.nanoTime() or TimeProvider.currentTimeNanos()), to be converted to the service time unit.

Returns:

The converted long value based on the system-configured time unit.

currentTime

public static long currentTime()

Fetches the current time in the system-configured time unit using the default CLOCK.

Returns:

The current time in the system-configured time unit.

currentTime

public static long currentTime(net.openhft.chronicle.core.time.TimeProvider clock)

Fetches the current time in the system-configured time unit using the provided TimeProvider.

Parameters:

clock - The TimeProvider instance used to obtain the current time. This allows for custom time sources, for example in tests.

Returns:

The current time in the system-configured time unit.

timeUnit

public static TimeUnit timeUnit()

Returns the current system-configured time unit.

Returns:

The time unit as an instance of TimeUnit.

parse

public long parse(CharSequence text)

Parses the provided CharSequence into a timestamp in the configured time unit.

Specified by:

parse in interface LongConverter

Parameters:

text - The character sequence representing a date-time string, which will be parsed by the underlying timestamp converter (for example NanoTimestampLongConverter or MicroTimestampLongConverter) based on the service time unit configuration.

Returns:

The parsed timestamp as a long value in the configured time unit.

parse

public long parse(CharSequence text,
                  int beginIndex,
                  int endIndex)

Parses a part of the provided CharSequence using the underlying converter.

Specified by:

parse in interface LongConverter

Parameters:

text - The character sequence containing the date-time string to parse.

beginIndex - The starting index (inclusive) of the subsequence in text to be parsed.

endIndex - The ending index (exclusive) of the subsequence in text to be parsed.

Returns:

the parsed timestamp as a long value in the configured time unit.

append

public void append(StringBuilder text,
                   long value)

Appends a representation of the provided long timestamp (in the system-configured time unit) to the provided StringBuilder.

Specified by:

append in interface LongConverter

Parameters:

text - The StringBuilder to which the formatted string representation of the timestamp value will be appended, using the service's configured time unit and associated formatter.

value - The timestamp value, in the service's configured time unit, to be formatted and appended.

append

public void append(net.openhft.chronicle.bytes.Bytes<?> bytes,
                   long value)

Appends a representation of the provided long timestamp (in the system-configured time unit) to the provided Bytes.

Specified by:

append in interface LongConverter

Parameters:

bytes - The Bytes instance to which the formatted string representation of the timestamp value will be appended, using the service's configured time unit and associated formatter.

value - The timestamp value, in the service's configured time unit, to be formatted and appended.