Converta java.util.Date em Instant, OffsetDateTime ou ZonedDateTime de java.time

À medida que migramos para a estrutura java.time moderna , é essencial saber como converter objetos java.util.Date legados nos tipos java.time apropriados. Aqui está um resumo das equivalências:

java.util.Date to Instant

Ambos representam um momento no UTC, então a conversão é direta:

Instant instant = myUtilDate.toInstant();

java.util.Date myUtilDate = java.util.Date.from(instant);

java.util.Date para OffsetDateTime ou ZonedDateTime de java.time

Desde estes incorporam informações de fuso horário, é necessário extrair o fuso da data herdada:

// If the legacy date is a GregorianCalendar (which can hold time zone info)
if (myUtilCalendar instanceof GregorianCalendar) {
    GregorianCalendar gregCal = (GregorianCalendar) myUtilCalendar;
    ZonedDateTime zdt = gregCal.toZonedDateTime(); // ZonedDateTime with time zone

    java.util.Calendar myUtilCalendar = java.util.GregorianCalendar.from(zdt);
}

Mapeamentos de conversão adicionais

Considerações importantes

• A conversão de um tipo java.util.Date para um tipo java.time pode resultar em perda de precisão, pois a resolução de nanossegundos não é suportada pelas classes herdadas.
• Ao converter para OffsetDateTime ou ZonedDateTime, as informações de fuso horário devem ser preservadas para garantir interpretação correta.
• É altamente recomendado usar tipos java.time em novo código para maior precisão e consistência.