/**
* Obtains an instance of {@code OffsetDateTime} from a temporal object.
* <p>
* This obtains an offset date-time based on the specified temporal.
* A {@code TemporalAccessor} represents an arbitrary set of date and time information,
* which this factory converts to an instance of {@code OffsetDateTime}.
* <p>
* The conversion will first obtain a {@code ZoneOffset} from the temporal object.
* It will then try to obtain a {@code LocalDateTime}, falling back to an {@code Instant} if necessary.
* The result will be the combination of {@code ZoneOffset} with either
* with {@code LocalDateTime} or {@code Instant}.
* Implementations are permitted to perform optimizations such as accessing
* those fields that are equivalent to the relevant objects.
* <p>
* This method matches the signature of the functional interface {@link TemporalQuery}
* allowing it to be used as a query via method reference, {@code OffsetDateTime::from}.
*
* @param TemporalAccessor $temporal the temporal object to convert, not null
* @return OffsetDateTime the offset date-time, not null
* @throws DateTimeException if unable to convert to an {@code OffsetDateTime}
*/
public static function from(TemporalAccessor $temporal)
{
if ($temporal instanceof OffsetDateTime) {
return $temporal;
}
try {
$offset = ZoneOffset::from($temporal);
$date = $temporal->query(TemporalQueries::localDate());
$time = $temporal->query(TemporalQueries::localTime());
if ($date !== null && $time !== null) {
return OffsetDateTime::ofDateAndTime($date, $time, $offset);
} else {
$instant = Instant::from($temporal);
return OffsetDateTime::ofInstant($instant, $offset);
}
} catch (DateTimeException $ex) {
throw new DateTimeException("Unable to obtain OffsetDateTime from TemporalAccessor: " . $temporal . " of type " . get_class($temporal), $ex);
}
}
/**
* Combines this instant with an offset to create an {@code OffsetDateTime}.
* <p>
* This returns an {@code OffsetDateTime} formed from this instant at the
* specified offset from UTC/Greenwich. An exception will be thrown if the
* instant is too large to fit into an offset date-time.
* <p>
* This method is equivalent to
* {@link OffsetDateTime#ofInstant(Instant, ZoneId) OffsetDateTime.ofInstant(this, offset)}.
*
* @param ZoneOffset $offset the offset to combine with, not null
* @return OffsetDateTime the offset date-time formed from this instant and the specified offset, not null
* @throws DateTimeException if the result exceeds the supported range
*/
public function atOffset(ZoneOffset $offset)
{
return OffsetDateTime::ofInstant($this, $offset);
}
