/** * 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); }