Package org.daiitech.naftah.utils.time

Class ChronoConversionUtils

java.lang.Object

org.daiitech.naftah.utils.time.ChronoConversionUtils

public final class ChronoConversionUtils
extends Object

Utility class for converting between ISO date/time objects and ChronoLocalDate / ChronoLocalDateTime in arbitrary chronologies.

Includes conversions to/from LocalDate, LocalDateTime, OffsetDateTime, OffsetTime, and ZonedDateTime.

Author:

Chakib Daii

Constructor Summary

Constructors

Modifier	Constructor	Description
private	ChronoConversionUtils()	Private constructor to prevent instantiation.

Method Summary

Modifier and Type	Method	Description
static ChronoLocalDate	toChronoDate(Temporal isoDate, Chronology chronology)	Converts an ISO Temporal to a ChronoLocalDate in the given chronology.
static ChronoLocalDateTime<?>	toChronoDateTime(LocalDateTime isoDateTime, Chronology chronology)	Converts an ISO LocalDateTime to a ChronoLocalDateTime in the specified chronology.
static ChronoLocalDateTime<?>	toChronoDateTime(OffsetDateTime isoDateTime, Chronology chronology)	Converts an OffsetDateTime to a ChronoLocalDateTime in the specified chronology.
static ChronoLocalDateTime<?>	toChronoDateTime(ZonedDateTime isoDateTime, Chronology chronology)	Converts a ZonedDateTime to a ChronoLocalDateTime in the specified chronology.
static Temporal	toChronoTemporal(Temporal temporal, Chronology chronology)	Converts any ISO Temporal back to a ChronoLocalDate or ChronoLocalDateTime in the * specified chronology.
static Temporal	toChronoTemporal(Temporal temporal, Chronology chronology, ZoneId zoneIdOrOffset)	Converts any ISO Temporal back to a ChronoLocalDate or ChronoLocalDateTime in the * specified chronology, applying a ZoneId or ZoneOffset if present.
static LocalDate	toIsoDate(ChronoLocalDate chronoDate)	Converts a ChronoLocalDate to ISO LocalDate.
static LocalDateTime	toIsoDateTime(ChronoLocalDateTime<?> chronoDateTime)	Converts a ChronoLocalDateTime to ISO LocalDateTime.
static OffsetDateTime	toIsoOffsetDateTime(ChronoLocalDateTime<?> chronoDateTime, ZoneOffset offset)	Converts a ChronoLocalDateTime to OffsetDateTime using the specified ZoneOffset.
static Temporal	toIsoTemporal(Temporal temporal)	Converts any Temporal to ISO form.
static Temporal	toIsoTemporal(Temporal temporal, ZoneId zoneIdOrOffset)	Converts any Temporal to ISO form and applies a ZoneId or ZoneOffset.
static ZonedDateTime	toIsoZonedDateTime(ChronoLocalDateTime<?> chronoDateTime, ZoneId zoneId)	Converts a ChronoLocalDateTime to ZonedDateTime in the specified ZoneId.

Methods inherited from class java.lang.Object

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

Constructor Details

ChronoConversionUtils

private ChronoConversionUtils()

Private constructor to prevent instantiation. Always throws a NaftahBugError when called.

Method Details

toIsoDate

public static LocalDate toIsoDate(ChronoLocalDate chronoDate)

Converts a ChronoLocalDate to ISO LocalDate.

If the input date is in a non-ISO chronology (e.g., Hijrah), the resulting LocalDate represents the same point in time but in the ISO calendar system.

Parameters:

chronoDate - the date in any chronology

Returns:

the corresponding ISO LocalDate

toChronoDate

public static ChronoLocalDate toChronoDate(Temporal isoDate,
 Chronology chronology)

Converts an ISO Temporal to a ChronoLocalDate in the given chronology.

Parameters:

isoDate - the ISO Temporal

chronology - the chronology to use

Returns:

a ChronoLocalDate in the specified chronology

toIsoDateTime

public static LocalDateTime toIsoDateTime(ChronoLocalDateTime<?> chronoDateTime)

Converts a ChronoLocalDateTime to ISO LocalDateTime.

Parameters:

chronoDateTime - the date-time in any chronology

Returns:

the corresponding ISO LocalDateTime

toChronoDateTime

public static ChronoLocalDateTime<?> toChronoDateTime(LocalDateTime isoDateTime,
 Chronology chronology)

Converts an ISO LocalDateTime to a ChronoLocalDateTime in the specified chronology.

Parameters:

isoDateTime - the ISO LocalDateTime

chronology - the chronology to use

Returns:

a ChronoLocalDateTime in the specified chronology

toIsoOffsetDateTime

public static OffsetDateTime toIsoOffsetDateTime(ChronoLocalDateTime<?> chronoDateTime,
 ZoneOffset offset)

Converts a ChronoLocalDateTime to OffsetDateTime using the specified ZoneOffset.

Parameters:

chronoDateTime - the date-time in any chronology

offset - the ZoneOffset to apply

Returns:

an OffsetDateTime representing the same instant in the given offset

toChronoDateTime

public static ChronoLocalDateTime<?> toChronoDateTime(OffsetDateTime isoDateTime,
 Chronology chronology)

Converts an OffsetDateTime to a ChronoLocalDateTime in the specified chronology.

Parameters:

isoDateTime - the OffsetDateTime

chronology - the chronology to use

Returns:

a ChronoLocalDateTime in the specified chronology

toIsoZonedDateTime

public static ZonedDateTime toIsoZonedDateTime(ChronoLocalDateTime<?> chronoDateTime,
 ZoneId zoneId)

Converts a ChronoLocalDateTime to ZonedDateTime in the specified ZoneId.

Parameters:

chronoDateTime - the date-time in any chronology

zoneId - the time zone to apply

Returns:

a ZonedDateTime representing the same instant in the given zone

toChronoDateTime

public static ChronoLocalDateTime<?> toChronoDateTime(ZonedDateTime isoDateTime,
 Chronology chronology)

Converts a ZonedDateTime to a ChronoLocalDateTime in the specified chronology.

Parameters:

isoDateTime - the ZonedDateTime

chronology - the chronology to use

Returns:

a ChronoLocalDateTime in the specified chronology

toIsoTemporal

public static Temporal toIsoTemporal(Temporal temporal)

Converts any Temporal to ISO form.

- ChronoLocalDate → LocalDate
- ChronoLocalDateTime → LocalDateTime
- Other types are returned unchanged.

Parameters:

temporal - the temporal object to convert

Returns:

an ISO Temporal equivalent, or the original temporal if conversion is not needed

toIsoTemporal

public static Temporal toIsoTemporal(Temporal temporal,
 ZoneId zoneIdOrOffset)

Converts any Temporal to ISO form and applies a ZoneId or ZoneOffset.

Parameters:

temporal - the temporal object to convert

zoneIdOrOffset - the zone or offset to apply

Returns:

an ISO Temporal with the zone or offset applied

toChronoTemporal

public static Temporal toChronoTemporal(Temporal temporal,
 Chronology chronology)

Converts any ISO Temporal back to a ChronoLocalDate or ChronoLocalDateTime in the * specified chronology.

Parameters:

temporal - the ISO temporal

chronology - the target chronology

Returns:

the temporal in the specified chronology

toChronoTemporal

public static Temporal toChronoTemporal(Temporal temporal,
 Chronology chronology,
 ZoneId zoneIdOrOffset)

Converts any ISO Temporal back to a ChronoLocalDate or ChronoLocalDateTime in the * specified chronology, applying a ZoneId or ZoneOffset if present.

Parameters:

temporal - the ISO temporal

chronology - the target chronology

zoneIdOrOffset - the zone or offset to apply

Returns:

the temporal in the specified chronology with zone/offset applied