Client and backend. This class is shared: the same code is compiled into your app and into your server, so everything on this page works in both.

public final class OffsetDateTime

  1. Object
  2. OffsetDateTime

ImplementsComparable<OffsetDateTime>, Temporal, TemporalAccessor

A date and time with a fixed offset from UTC, such as 2007-12-03T10:15:30+01:00.

Fields

public static final OffsetDateTime MINThe earliest date and time, at the largest offset.
public static final OffsetDateTime MAXThe latest date and time, at the smallest offset.

Methods

public static OffsetDateTime now()
public static OffsetDateTime now(ZoneId zone)
public static OffsetDateTime now(Clock clock)
public static OffsetDateTime of(LocalDate date, LocalTime time, ZoneOffset offset)
public static OffsetDateTime of(LocalDateTime dateTime, ZoneOffset offset)
public static OffsetDateTime of(int year, int month, int dayOfMonth, int hour, int minute, int second, int nanoOfSecond, ZoneOffset offset)
public static OffsetDateTime ofInstant(Instant instant, ZoneId zone)
public static OffsetDateTime from(TemporalAccessor temporal)The date, time and offset of temporal.
public static OffsetDateTime parse(CharSequence text)
public static OffsetDateTime parse(CharSequence text, DateTimeFormatter formatter)
public LocalDateTime toLocalDateTime()
public LocalDate toLocalDate()
public LocalTime toLocalTime()
public ZoneOffset getOffset()
public Instant toInstant()
public long toEpochSecond()
public ZonedDateTime toZonedDateTime()This date and time, as a moment in offset’s own zone.
public ZonedDateTime atZoneSameInstant(ZoneId zone)The same moment in zone.
public OffsetDateTime withOffsetSameInstant(ZoneOffset offset)The same moment at another offset.
public OffsetDateTime withOffsetSameLocal(ZoneOffset offset)The same wall clock time at another offset.
public int getYear()
public int getMonthValue()
public Month getMonth()
public int getDayOfMonth()
public int getDayOfYear()
public DayOfWeek getDayOfWeek()
public int getHour()
public int getMinute()
public int getSecond()
public int getNano()
public OffsetDateTime withYear(int year)
public OffsetDateTime withMonth(int month)
public OffsetDateTime withDayOfMonth(int dayOfMonth)
public OffsetDateTime withDayOfYear(int dayOfYear)
public OffsetDateTime withHour(int hour)
public OffsetDateTime withMinute(int minute)
public OffsetDateTime withSecond(int second)
public OffsetDateTime withNano(int nanoOfSecond)
public OffsetDateTime truncatedTo(TemporalUnit unit)
public boolean isSupported(TemporalUnit unit)Whether this value can add or subtract unit.
public OffsetDateTime plus(long amountToAdd, TemporalUnit unit)This value moved forward by amountToAdd of unit.
public OffsetDateTime minus(long amountToSubtract, TemporalUnit unit)This value moved back by amountToSubtract of unit.
public OffsetDateTime plus(TemporalAmount amount)This value moved forward by amount.
public OffsetDateTime minus(TemporalAmount amount)This value moved back by amount.
public OffsetDateTime plusYears(long years)
public OffsetDateTime plusMonths(long months)
public OffsetDateTime plusWeeks(long weeks)
public OffsetDateTime plusDays(long days)
public OffsetDateTime plusHours(long hours)
public OffsetDateTime plusMinutes(long minutes)
public OffsetDateTime plusSeconds(long seconds)
public OffsetDateTime plusNanos(long nanos)
public OffsetDateTime minusYears(long years)
public OffsetDateTime minusMonths(long months)
public OffsetDateTime minusWeeks(long weeks)
public OffsetDateTime minusDays(long days)
public OffsetDateTime minusHours(long hours)
public OffsetDateTime minusMinutes(long minutes)
public OffsetDateTime minusSeconds(long seconds)
public OffsetDateTime minusNanos(long nanos)
public long until(Temporal endExclusive, TemporalUnit unit)The whole units of unit from this value to endExclusive.
public String format(DateTimeFormatter formatter)
public boolean isAfter(OffsetDateTime other)
public boolean isBefore(OffsetDateTime other)
public boolean isEqual(OffsetDateTime other)
public int compareTo(OffsetDateTime other)Orders by moment, and moments that are equal by wall clock time.
public boolean equals(Object obj)Indicates whether some other object is “equal to” this one.
public int hashCode()Returns a hash code value for the object.
public String toString()Returns a string representation of the object.

Inherited methods

Field details

MIN

public static final OffsetDateTime MIN
The earliest date and time, at the largest offset.

MAX

public static final OffsetDateTime MAX
The latest date and time, at the smallest offset.

Method details

now

public static OffsetDateTime now()

now

public static OffsetDateTime now(ZoneId zone)

now

public static OffsetDateTime now(Clock clock)

of

public static OffsetDateTime of(LocalDate date, LocalTime time, ZoneOffset offset)

of

public static OffsetDateTime of(LocalDateTime dateTime, ZoneOffset offset)

of

public static OffsetDateTime of(int year, int month, int dayOfMonth, int hour, int minute, int second, int nanoOfSecond, ZoneOffset offset)

ofInstant

public static OffsetDateTime ofInstant(Instant instant, ZoneId zone)

from

public static OffsetDateTime from(TemporalAccessor temporal)
The date, time and offset of temporal.

parse

public static OffsetDateTime parse(CharSequence text)

parse

public static OffsetDateTime parse(CharSequence text, DateTimeFormatter formatter)

toLocalDateTime

public LocalDateTime toLocalDateTime()

toLocalDate

public LocalDate toLocalDate()

toLocalTime

public LocalTime toLocalTime()

getOffset

public ZoneOffset getOffset()

toInstant

public Instant toInstant()

toEpochSecond

public long toEpochSecond()

toZonedDateTime

public ZonedDateTime toZonedDateTime()
This date and time, as a moment in offset’s own zone.

atZoneSameInstant

public ZonedDateTime atZoneSameInstant(ZoneId zone)
The same moment in zone.

withOffsetSameInstant

public OffsetDateTime withOffsetSameInstant(ZoneOffset offset)
The same moment at another offset.

withOffsetSameLocal

public OffsetDateTime withOffsetSameLocal(ZoneOffset offset)
The same wall clock time at another offset.

getYear

public int getYear()

getMonthValue

public int getMonthValue()

getMonth

public Month getMonth()

getDayOfMonth

public int getDayOfMonth()

getDayOfYear

public int getDayOfYear()

getDayOfWeek

public DayOfWeek getDayOfWeek()

getHour

public int getHour()

getMinute

public int getMinute()

getSecond

public int getSecond()

getNano

public int getNano()

withYear

public OffsetDateTime withYear(int year)

withMonth

public OffsetDateTime withMonth(int month)

withDayOfMonth

public OffsetDateTime withDayOfMonth(int dayOfMonth)

withDayOfYear

public OffsetDateTime withDayOfYear(int dayOfYear)

withHour

public OffsetDateTime withHour(int hour)

withMinute

public OffsetDateTime withMinute(int minute)

withSecond

public OffsetDateTime withSecond(int second)

withNano

public OffsetDateTime withNano(int nanoOfSecond)

truncatedTo

public OffsetDateTime truncatedTo(TemporalUnit unit)

isSupported

public boolean isSupported(TemporalUnit unit)
Whether this value can add or subtract unit.

plus

public OffsetDateTime plus(long amountToAdd, TemporalUnit unit)
This value moved forward by amountToAdd of unit.

minus

public OffsetDateTime minus(long amountToSubtract, TemporalUnit unit)
This value moved back by amountToSubtract of unit.

plus

public OffsetDateTime plus(TemporalAmount amount)
This value moved forward by amount.

minus

public OffsetDateTime minus(TemporalAmount amount)
This value moved back by amount.

plusYears

public OffsetDateTime plusYears(long years)

plusMonths

public OffsetDateTime plusMonths(long months)

plusWeeks

public OffsetDateTime plusWeeks(long weeks)

plusDays

public OffsetDateTime plusDays(long days)

plusHours

public OffsetDateTime plusHours(long hours)

plusMinutes

public OffsetDateTime plusMinutes(long minutes)

plusSeconds

public OffsetDateTime plusSeconds(long seconds)

plusNanos

public OffsetDateTime plusNanos(long nanos)

minusYears

public OffsetDateTime minusYears(long years)

minusMonths

public OffsetDateTime minusMonths(long months)

minusWeeks

public OffsetDateTime minusWeeks(long weeks)

minusDays

public OffsetDateTime minusDays(long days)

minusHours

public OffsetDateTime minusHours(long hours)

minusMinutes

public OffsetDateTime minusMinutes(long minutes)

minusSeconds

public OffsetDateTime minusSeconds(long seconds)

minusNanos

public OffsetDateTime minusNanos(long nanos)

until

public long until(Temporal endExclusive, TemporalUnit unit)
The whole units of unit from this value to endExclusive.

format

public String format(DateTimeFormatter formatter)

isAfter

public boolean isAfter(OffsetDateTime other)

isBefore

public boolean isBefore(OffsetDateTime other)

isEqual

public boolean isEqual(OffsetDateTime other)

compareTo

public int compareTo(OffsetDateTime other)
Orders by moment, and moments that are equal by wall clock time.

Parameters

other OffsetDateTime
the object to compare to this instance.

Returns

a negative integer if this instance is less than another; a positive integer if this instance is greater than another; 0 if this instance has the same order as another.

Throws

ClassCastException
if another cannot be converted into something comparable to this instance.

equals

public boolean equals(Object obj)
Indicates whether some other object is “equal to” this one. The equals method implements an equivalence relation: It is reflexive: for any reference value x, x.equals(x) should return true. It is symmetric: for any reference values x and y, x.equals(y) should return true if and only if y.equals(x) returns true. It is transitive: for any reference values x, y, and z, if x.equals(y) returns true and y.equals(z) returns true, then x.equals(z) should return true. It is consistent: for any reference values x and y, multiple invocations of x.equals(y) consistently return true or consistently return false, provided no information used in equals comparisons on the object is modified. For any non-null reference value x, x.equals(null) should return false. The equals method for class Object implements the most discriminating possible equivalence relation on objects; that is, for any reference values x and y, this method returns true if and only if x and y refer to the same object (x==y has the value true).

hashCode

public int hashCode()
Returns a hash code value for the object. This method is supported for the benefit of hashtables such as those provided by java.util.Hashtable. The general contract of hashCode is: Whenever it is invoked on the same object more than once during an execution of a Java application, the hashCode method must consistently return the same integer, provided no information used in equals comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application. If two objects are equal according to the equals(Object) method, then calling the hashCode method on each of the two objects must produce the same integer result. It is not required that if two objects are unequal according to the equals(java.lang.Object) method, then calling the hashCode method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hashtables. As much as is reasonably practical, the hashCode method defined by class Object does return distinct integers for distinct objects. (This is typically implemented by converting the internal address of the object into an integer, but this implementation technique is not required by the JavaTM programming language.)

toString

public String toString()
Returns a string representation of the object. In general, the toString method returns a string that “textually represents” this object. The result should be a concise but informative representation that is easy for a person to read. It is recommended that all subclasses override this method. The toString method for class Object returns a string consisting of the name of the class of which the object is an instance, the at-sign character `@’, and the unsigned hexadecimal representation of the hash code of the object. In other words, this method returns a string equal to the value of: getClass().getName() + ‘@’ + Integer.toHexString(hashCode())