io.debezium.data

Class IsoTimestamp

java.lang.Object

io.debezium.data.IsoTimestamp

public class IsoTimestamp
extends Object

An ISO8601 timestamp that includes the time zone. The logical values for this schema type are represented with the standard OffsetDateTime, which represents an instant with the offset from UTC/Greenwich. OffsetDateTime has a well-defined ordering and thus is more suitable to be persisted; the ZonedDateTime has built-in support for time zone rules (e.g., daylight savings time and other anomalies) and therefore does not have a well-defined ordering. Typically, an OffsetDateTime that is read from a persisted state can be converted to a ZonedDateTime or other time representations for a specific time zone with proper time zone handling, including handling daylight savings time.

The encoded representation is the UFT-8 byte representation of an ISO8601 string.

Author:

Randall Hauch

Field Summary

Fields

Modifier and Type	Field and Description
private static Charset	CHARSET
private static DateTimeFormatter	FORMATTER
static String	LOGICAL_NAME

Constructor Summary

Constructors

Constructor and Description
IsoTimestamp()

Method Summary

Modifier and Type	Method and Description
static org.apache.kafka.connect.data.SchemaBuilder	builder() Returns a SchemaBuilder for an IsoTimestamp.
static byte[]	fromLogical(org.apache.kafka.connect.data.Schema schema, OffsetDateTime value) Convert a value from its logical format (OffsetDateTime) to it's encoded format.
static org.apache.kafka.connect.data.Schema	schema() Returns a Schema for an IsoTimestamp but with all other default Schema settings.
static OffsetDateTime	toLogical(org.apache.kafka.connect.data.Schema schema, byte[] value) Convert a value from its encoded format into its logical format (OffsetDateTime).

Methods inherited from class java.lang.Object

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

Field Detail

FORMATTER

private static final DateTimeFormatter FORMATTER

CHARSET

private static final Charset CHARSET

LOGICAL_NAME

public static final String LOGICAL_NAME

See Also:

Constant Field Values

Constructor Detail

IsoTimestamp

public IsoTimestamp()

Method Detail

builder

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

Returns a SchemaBuilder for an IsoTimestamp. You can use the resulting SchemaBuilder to set 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 an IsoTimestamp but with all other default Schema settings.

Returns:

the schema

See Also:

builder()

fromLogical

public static byte[] fromLogical(org.apache.kafka.connect.data.Schema schema,
                                 OffsetDateTime value)

Convert a value from its logical format (OffsetDateTime) to it's encoded format.

Parameters:

schema - the schema

value - the logical value

Returns:

the encoded value

toLogical

public static OffsetDateTime toLogical(org.apache.kafka.connect.data.Schema schema,
                                       byte[] value)

Convert a value from its encoded format into its logical format (OffsetDateTime).

Parameters:

schema - the schema

value - the encoded value

Returns:

the logical value