DateTime

Represents a date combined with a time value.

• Kotlin Definition: DateTimeDefinition
• Kotlin Value: LocalDateTime
• Maryk Yaml Definition: DateTime

Usage options

• Value
• Map key or value
• Inside List/Set

Validation Options

• required - default true
• final - default false
• unique - default false
• minValue - default false. Minimum value
• maxValue - default false. Maximum value

Other options

• default - the default value to be used if value was not set.
• precision - The precision to which the time is stored and transported. SECONDS (default), MILLIS or NANOS.

Examples

Example of a DateTime property definition for use within a Model

val startDateTime by dateTime(
    index = 1u,
    required = false,
    final = true,
    unique = true,
    default = LocalDateTime(LocalDate(2018, 10, 1), LocalTime(9, 30)),
    minValue = LocalDateTime(LocalDate(2017, 12, 1), LocalTime(8, 30)),
    maxValue = LocalDateTime(LocalDate(2022, 12, 1), LocalTime(18, 0)),
    precision = TimePrecision.MILLIS
)

Example of a separate Kotlin DateTime property definition

val def = DateTimeDefinition(
    required = false,
    final = true,
    unique = true,
    default = LocalDateTime(Date(2018, 10, 1),Time(9, 30)),
    minValue = LocalDateTime(Date(2017, 12, 1),Time(8, 30)),
    maxValue = LocalDateTime(Date(2022, 12, 1),Time(18, 0)),
    precision = TimePrecision.MILLIS
)

Storage Byte representation

It depends on the precision of the Time how it will be stored

• SECONDS - 7 byte integer counting the seconds from midnight January 1st 1970
• MILLIS - 9 byte combined integer with 7 bits counting the seconds from midnight January 1st 1970 and 2 bytes for the milliseconds
• NANOS - 11 byte integer with 7 bits counting the seconds from midnight January 1st 1970 and 4 bytes for the nanoseconds

Transport Byte representation

The bytes are transported in a different way depending on the precision of time.

• SECONDS - VarInt integer counting the seconds from midnight January 1st 1970
• MILLIS - VarInt integer counting the milliseconds from midnight January 1st 1970
• NANOS - VarInt integer counting the nanoseconds from midnight January 1st 1970

String representation

ISO8601 String YYYY-MM-DDTHH:MM:SS.SSSSSSSSS