io.debezium.time

Class NanoTimestamp

java.lang.Object

io.debezium.time.NanoTimestamp

public class NanoTimestamp
extends Object

A utility for converting various Java time representations into the signed INT64 number of nanoseconds past epoch, and for defining a Kafka Connect Schema for timestamp values with no timezone information.

Author:

Randall Hauch

See Also:

Timestamp, MicroTimestamp, ZonedTimestamp

Field Summary

Fields

Modifier and Type	Field and Description
static String	SCHEMA_NAME

Constructor Summary

Constructors

Modifier	Constructor and Description
private	NanoTimestamp()

Method Summary

Modifier and Type	Method and Description
static org.apache.kafka.connect.data.SchemaBuilder	builder() Returns a SchemaBuilder for a NanoTimestamp.
static org.apache.kafka.connect.data.Schema	schema() Returns a Schema for a NanoTimestamp but with all other default Schema settings.
private static long	toEpochNanos(LocalDate date) Get the number of nanoseconds past epoch of the given LocalDate.
private static long	toEpochNanos(LocalDateTime timestamp) Get the number of nanoseconds past epoch of the given LocalDateTime.
static long	toEpochNanos(Object value, TemporalAdjuster adjuster) Get the number of nanoseconds past epoch of the given LocalDateTime, LocalDate, LocalTime, Date, Date, Time, or Timestamp.

Methods inherited from class java.lang.Object

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

Field Detail

SCHEMA_NAME

public static final String SCHEMA_NAME

See Also:

Constant Field Values

Constructor Detail

NanoTimestamp

private NanoTimestamp()

Method Detail

builder

public static org.apache.kafka.connect.data.SchemaBuilder builder()

Returns a SchemaBuilder for a NanoTimestamp. The resulting schema will describe a field with the "io.debezium.time.NanoTimestamp" as the name and INT64 for the literal type storing the number of nanoseconds past midnight.

You can use the resulting SchemaBuilder to set or override additional schema settings such as required/optional, default value, and documentation.

Returns:

the schema builder

schema

public static org.apache.kafka.connect.data.Schema schema()

Returns a Schema for a NanoTimestamp but with all other default Schema settings. The schema describes a field with the "io.debezium.time.NanoTimestamp" as the name and INT64 for the literal type storing the number of nanoseconds past midnight.

Returns:

the schema

See Also:

builder()

toEpochNanos

public static long toEpochNanos(Object value,
                                TemporalAdjuster adjuster)

Get the number of nanoseconds past epoch of the given LocalDateTime, LocalDate, LocalTime, Date, Date, Time, or Timestamp.

Parameters:

value - the local or SQL date, time, or timestamp value; may not be null

adjuster - the optional component that adjusts the local date value before obtaining the epoch day; may be null if no adjustment is necessary

Returns:

the epoch nanoseconds

Throws:

IllegalArgumentException - if the value is not an instance of the acceptable types

toEpochNanos

private static long toEpochNanos(LocalDateTime timestamp)

Get the number of nanoseconds past epoch of the given LocalDateTime.

Parameters:

timestamp - the Java timestamp value

Returns:

the epoch nanoseconds

toEpochNanos

private static long toEpochNanos(LocalDate date)

Get the number of nanoseconds past epoch of the given LocalDate.

Parameters:

date - the Java date value

Returns:

the epoch nanoseconds