Class LocalDateAttributeConverter

  • All Implemented Interfaces:
    AttributeConverter<LocalDate>

    @ThreadSafe
    @Immutable
    public final class LocalDateAttributeConverter
    extends Object
    implements AttributeConverter<LocalDate>
    A converter between LocalDate and AttributeValue.

    This stores and reads values in DynamoDB as a String.

    LocalDates are stored in the official LocalDate format "[-]YYYY-MM-DD", where:

    1. Y is a year between Year.MIN_VALUE and Year.MAX_VALUE (prefixed with - if it is negative)
    2. M is a 2-character, zero-prefixed month between 01 and 12
    3. D is a 2-character, zero-prefixed day between 01 and 31
    See LocalDate for more details on the serialization format.

    This is unidirectional format-compatible with the LocalDateTimeAttributeConverter, allowing values stored as LocalDate to be retrieved as LocalDateTimes.

    This serialization is lexicographically orderable when the year is not negative.

    Examples:

    • LocalDate.of(1988, 5, 21) is stored as as an AttributeValue with the String "1988-05-21"
    • LocalDate.of(0, 1, 1) is stored as as an AttributeValue with the String "0000-01-01"

    This can be created via create().