OffsetDateTime

class OffsetDateTime(dateTime: DateTime, offset: UtcOffset) : TimePoint<OffsetDateTime>

A date and time of day with an offset from UTC.

OffsetDateTime is intended to be used primarily for use cases involving persistence or network transfer where the application of time zone rules may be undesirable. For most applications, ZonedDateTime is a better choice since it takes time zone rules into account when performing calendrical calculations.

Parameters

dateTime

the local date and time of day

offset

the offset from UTC

Throws

io.islandtime.DateTimeException

if the offset is invalid

Constructors

OffsetDateTime

common

fun OffsetDateTime(date: Date, time: Time, offset: UtcOffset)

Creates an OffsetDateTime.

OffsetDateTime

common

fun OffsetDateTime(year: Int, month: Month, dayOfMonth: Int, hour: Int, minute: Int, second: Int, nanosecond: Int, offset: UtcOffset)

Creates an OffsetDateTime.

OffsetDateTime

common

fun OffsetDateTime(year: Int, monthNumber: Int, dayOfMonth: Int, hour: Int, minute: Int, second: Int, nanosecond: Int, offset: UtcOffset)

Creates an OffsetDateTime.

OffsetDateTime

common

fun OffsetDateTime(year: Int, dayOfYear: Int, hour: Int, minute: Int, second: Int, nanosecond: Int, offset: UtcOffset)

Creates an OffsetDateTime.

OffsetDateTime

common

fun OffsetDateTime(dateTime: DateTime, offset: UtcOffset)

Creates an OffsetDateTime by combining a DateTime and UtcOffset.

Types

Companion

common

object Companion

Functions

adjustedTo

common

fun adjustedTo(newOffset: UtcOffset): OffsetDateTime

Changes the offset of this OffsetDateTime, adjusting the date and time components such that the instant represented by it remains the same.

compareTo

common

open operator fun compareTo(other: TimePoint<*>): Int

Compares this time point with another time point.

copy

common

fun copy(dateTime: DateTime = this.dateTime, offset: UtcOffset = this.offset): OffsetDateTime

Returns a copy of this date-time with the values of any individual components replaced by the new values specified.

fun copy(date: Date = this.date, time: Time = this.time, offset: UtcOffset = this.offset): OffsetDateTime

Returns a copy of this date-time with the values of any individual components replaced by the new values specified.

fun copy(year: Int = this.year, dayOfYear: Int = this.dayOfYear, hour: Int = this.hour, minute: Int = this.minute, second: Int = this.second, nanosecond: Int = this.nanosecond, offset: UtcOffset = this.offset): OffsetDateTime

Returns a copy of this date-time with the values of any individual components replaced by the new values specified.

fun copy(year: Int = this.year, month: Month = this.month, dayOfMonth: Int = this.dayOfMonth, hour: Int = this.hour, minute: Int = this.minute, second: Int = this.second, nanosecond: Int = this.nanosecond, offset: UtcOffset = this.offset): OffsetDateTime

Returns a copy of this date-time with the values of any individual components replaced by the new values specified.

equals

common

open operator override fun equals(other: Any?): Boolean

hashCode

common

open override fun hashCode(): Int

isSameInstantAs

common

open fun isSameInstantAs(other: TimePoint<*>): Boolean

Checks if this time point represents the same instant as other.

minus

common

operator fun minus(duration: Duration): OffsetDateTime

operator fun minus(days: IntDays): OffsetDateTime

open operator override fun minus(hours: IntHours): OffsetDateTime

open operator override fun minus(microseconds: IntMicroseconds): OffsetDateTime

open operator override fun minus(milliseconds: IntMilliseconds): OffsetDateTime

open operator override fun minus(minutes: IntMinutes): OffsetDateTime

operator fun minus(months: IntMonths): OffsetDateTime

open operator override fun minus(nanoseconds: IntNanoseconds): OffsetDateTime

open operator override fun minus(seconds: IntSeconds): OffsetDateTime

operator fun minus(weeks: IntWeeks): OffsetDateTime

operator fun minus(years: IntYears): OffsetDateTime

operator fun minus(days: LongDays): OffsetDateTime

open operator override fun minus(hours: LongHours): OffsetDateTime

open operator override fun minus(microseconds: LongMicroseconds): OffsetDateTime

open operator override fun minus(milliseconds: LongMilliseconds): OffsetDateTime

open operator override fun minus(minutes: LongMinutes): OffsetDateTime

operator fun minus(months: LongMonths): OffsetDateTime

open operator override fun minus(nanoseconds: LongNanoseconds): OffsetDateTime

open operator override fun minus(seconds: LongSeconds): OffsetDateTime

operator fun minus(weeks: LongWeeks): OffsetDateTime

operator fun minus(years: LongYears): OffsetDateTime

operator fun minus(period: Period): OffsetDateTime

Returns this date-time with period subtracted from it.

plus

common

operator fun plus(duration: Duration): OffsetDateTime

operator fun plus(days: IntDays): OffsetDateTime

open operator override fun plus(hours: IntHours): OffsetDateTime

open operator override fun plus(microseconds: IntMicroseconds): OffsetDateTime

open operator override fun plus(milliseconds: IntMilliseconds): OffsetDateTime

open operator override fun plus(minutes: IntMinutes): OffsetDateTime

operator fun plus(months: IntMonths): OffsetDateTime

open operator override fun plus(nanoseconds: IntNanoseconds): OffsetDateTime

open operator override fun plus(seconds: IntSeconds): OffsetDateTime

operator fun plus(weeks: IntWeeks): OffsetDateTime

operator fun plus(years: IntYears): OffsetDateTime

operator fun plus(days: LongDays): OffsetDateTime

open operator override fun plus(hours: LongHours): OffsetDateTime

open operator override fun plus(microseconds: LongMicroseconds): OffsetDateTime

open operator override fun plus(milliseconds: LongMilliseconds): OffsetDateTime

open operator override fun plus(minutes: LongMinutes): OffsetDateTime

operator fun plus(months: LongMonths): OffsetDateTime

open operator override fun plus(nanoseconds: LongNanoseconds): OffsetDateTime

open operator override fun plus(seconds: LongSeconds): OffsetDateTime

operator fun plus(weeks: LongWeeks): OffsetDateTime

operator fun plus(years: LongYears): OffsetDateTime

operator fun plus(period: Period): OffsetDateTime

Returns this date-time with period added to it.

rangeTo

common

operator fun rangeTo(other: OffsetDateTime): OffsetDateTimeInterval

toString

common

open override fun toString(): String

Converts this date-time to a string in ISO-8601 extended format.

Properties

additionalNanosecondsSinceUnixEpoch

common

open override val additionalNanosecondsSinceUnixEpoch: IntNanoseconds

The number of additional nanoseconds on top of secondsSinceUnixEpoch.

date

common

val date: Date

The local date.

dateTime

common

val dateTime: DateTime

The local date and time of day.

dayOfMonth

common

val dayOfMonth: Int

The day of the month.

dayOfWeek

common

val dayOfWeek: DayOfWeek

The day of the week.

dayOfYear

common

val dayOfYear: Int

The day of the year.

hour

common

val hour: Int

The hour of the day.

millisecondOfUnixEpoch

common

open val millisecondOfUnixEpoch: Long

The millisecond of the Unix epoch.

millisecondsSinceUnixEpoch

common

open override val millisecondsSinceUnixEpoch: LongMilliseconds

The number of milliseconds since the Unix epoch of 1970-01-01T00:00Z.

minute

common

val minute: Int

The minute of the hour.

month

common

val month: Month

The month of the year.

monthNumber

common

val monthNumber: Int

The ISO month number, from 1-12.

nanosecond

common

open override val nanosecond: Int

The nanosecond of the second.

offset

common

val offset: UtcOffset

The offset from UTC.

second

common

val second: Int

The second of the minute.

secondOfUnixEpoch

common

open val secondOfUnixEpoch: Long

The second of the Unix epoch.

secondsSinceUnixEpoch

common

open override val secondsSinceUnixEpoch: LongSeconds

The number of seconds since the Unix epoch of 1970-01-01T00:00Z.

time

common

val time: Time

The local time of day.

year

common

val year: Int

The year.

Extensions

asZonedDateTime

common

fun OffsetDateTime.asZonedDateTime(): ZonedDateTime

Converts this OffsetDateTime to an equivalent ZonedDateTime using a fixed-offset time zone.

endOfMonth

common

val OffsetDateTime.endOfMonth: OffsetDateTime

The date-time at the last representable instant of the month that this date-time falls in.

endOfWeek

common

val OffsetDateTime.endOfWeek: OffsetDateTime

The date-time at the last representable instant of the ISO week that this date-time falls in.

fun OffsetDateTime.endOfWeek(settings: WeekSettings): OffsetDateTime

The date-time at the last representable instant of the week that this date-time falls in.

fun OffsetDateTime.endOfWeek(locale: Locale): OffsetDateTime

The date-time at the last representable instant of the week that this date-time falls in.

endOfYear

common

val OffsetDateTime.endOfYear: OffsetDateTime

The date-time at the last representable instant of the year that this date-time falls in.

isInLeapDay

common

val OffsetDateTime.isInLeapDay: Boolean

Checks if this date-time falls within February 29.

isInLeapYear

common

val OffsetDateTime.isInLeapYear: Boolean

Checks if this date-time falls within a leap year.

lengthOfMonth

common

val OffsetDateTime.lengthOfMonth: IntDays

The length of this date-time's month in days.

lengthOfWeekBasedYear

common

val OffsetDateTime.lengthOfWeekBasedYear: IntWeeks

The length of the ISO week-based year that this date-time falls in, either 52 or 53 weeks.

lengthOfYear

common

val OffsetDateTime.lengthOfYear: IntDays

The length of this date-time's year in days.

common

fun OffsetDateTime.next(dayOfWeek: DayOfWeek): OffsetDateTime

The next date-time after this one that falls on dayOfWeek.

nextOrSame

common

fun OffsetDateTime.nextOrSame(dayOfWeek: DayOfWeek): OffsetDateTime

The next date-time that falls on dayOfWeek, or this date-time if it falls on the same day.

common

fun OffsetDateTime.previous(dayOfWeek: DayOfWeek): OffsetDateTime

The last date-time before this one that falls on dayOfWeek.

previousOrSame

common

fun OffsetDateTime.previousOrSame(dayOfWeek: DayOfWeek): OffsetDateTime

The previous date-time that falls on dayOfWeek, or this date-time if it falls on the same day.

roundedDownTo

common

fun OffsetDateTime.roundedDownTo(unit: TimeUnit): OffsetDateTime

Returns this date-time, rounded down to match the precision of a given unit.

roundedDownToNearest

common

fun OffsetDateTime.roundedDownToNearest(increment: IntHours): OffsetDateTime

Returns this date-time, rounded down to the nearest hour that satisfies the increment.

fun OffsetDateTime.roundedDownToNearest(increment: IntMinutes): OffsetDateTime

Returns this date-time, rounded down to the nearest minute that satisfies the increment.

fun OffsetDateTime.roundedDownToNearest(increment: IntSeconds): OffsetDateTime

Returns this date-time, rounded down to the nearest second that satisfies the increment.

fun OffsetDateTime.roundedDownToNearest(increment: IntMilliseconds): OffsetDateTime

Returns this date-time, rounded down to the nearest millisecond that satisfies the increment.

fun OffsetDateTime.roundedDownToNearest(increment: IntMicroseconds): OffsetDateTime

Returns this date-time, rounded down to the nearest microsecond that satisfies the increment.

fun OffsetDateTime.roundedDownToNearest(increment: IntNanoseconds): OffsetDateTime

Returns this date-time, rounded down to the nearest nanosecond that satisfies the increment.

roundedTo

common

fun OffsetDateTime.roundedTo(unit: TimeUnit): OffsetDateTime

Returns this date-time, rounded to match the precision of a given unit.

roundedToNearest

common

fun OffsetDateTime.roundedToNearest(increment: IntHours): OffsetDateTime

Returns this date-time, rounded to the nearest hour that satisfies the increment.

fun OffsetDateTime.roundedToNearest(increment: IntMinutes): OffsetDateTime

Returns this date-time, rounded to the nearest minute that satisfies the increment.

fun OffsetDateTime.roundedToNearest(increment: IntSeconds): OffsetDateTime

Returns this date-time, rounded to the nearest second that satisfies the increment.

fun OffsetDateTime.roundedToNearest(increment: IntMilliseconds): OffsetDateTime

Returns this date-time, rounded to the nearest millisecond that satisfies the increment.

fun OffsetDateTime.roundedToNearest(increment: IntMicroseconds): OffsetDateTime

Returns this date-time, rounded to the nearest microsecond that satisfies the increment.

fun OffsetDateTime.roundedToNearest(increment: IntNanoseconds): OffsetDateTime

Returns this date-time, rounded to the nearest nanosecond that satisfies the increment.

roundedUpTo

common

fun OffsetDateTime.roundedUpTo(unit: TimeUnit): OffsetDateTime

Returns this date-time, rounded up to match the precision of a given unit.

roundedUpToNearest

common

fun OffsetDateTime.roundedUpToNearest(increment: IntHours): OffsetDateTime

Returns this date-time, rounded up to the nearest hour that satisfies the increment.

fun OffsetDateTime.roundedUpToNearest(increment: IntMinutes): OffsetDateTime

Returns this date-time, rounded up to the nearest minute that satisfies the increment.

fun OffsetDateTime.roundedUpToNearest(increment: IntSeconds): OffsetDateTime

Returns this date-time, rounded up to the nearest second that satisfies the increment.

fun OffsetDateTime.roundedUpToNearest(increment: IntMilliseconds): OffsetDateTime

Returns this date-time, rounded up to the nearest millisecond that satisfies the increment.

fun OffsetDateTime.roundedUpToNearest(increment: IntMicroseconds): OffsetDateTime

Returns this date-time, rounded up to the nearest microsecond that satisfies the increment.

fun OffsetDateTime.roundedUpToNearest(increment: IntNanoseconds): OffsetDateTime

Returns this date-time, rounded up to the nearest nanosecond that satisfies the increment.

startOfMonth

common

val OffsetDateTime.startOfMonth: OffsetDateTime

The date-time at the first instant of the month that this date-time falls in.

startOfWeek

common

val OffsetDateTime.startOfWeek: OffsetDateTime

The date-time at the first instant of the ISO week that this date-time falls in.

fun OffsetDateTime.startOfWeek(settings: WeekSettings): OffsetDateTime

The date-time at the first instant of the week that this date-time falls in.

fun OffsetDateTime.startOfWeek(locale: Locale): OffsetDateTime

The date-time at the first instant of the week that this date-time falls in.

startOfYear

common

val OffsetDateTime.startOfYear: OffsetDateTime

The date-time at the first instant of the year that this date-time falls in.

toInstant

common

fun OffsetDateTime.toInstant(): Instant

Converts this date-time to an Instant representing the same time point.

toJavaOffsetDateTime

jvm

fun OffsetDateTime.toJavaOffsetDateTime(): OffsetDateTime

Converts this date-time to an equivalent Java OffsetDateTime.

toNSDateComponents

darwin

fun OffsetDateTime.toNSDateComponents(includeCalendar: Boolean = false): <ERROR CLASS>

Converts this date-time to an equivalent NSDateComponents object.

toOffsetTime

common

fun OffsetDateTime.toOffsetTime(): OffsetTime

Returns the combined time and UTC offset.

toYear

common

fun OffsetDateTime.toYear(): Year

Returns this date-time with the precision reduced to the year.

toYearMonth

common

fun OffsetDateTime.toYearMonth(): YearMonth

Returns this date-time with the precision reduced to the month.

toZonedDateTime

common

fun OffsetDateTime.toZonedDateTime(zone: TimeZone, strategy: OffsetConversionStrategy): ZonedDateTime

Converts this OffsetDateTime to a ZonedDateTime using the specified strategy to adjust it to a valid date, time, and offset in zone.

truncatedTo

common

fun OffsetDateTime.truncatedTo(unit: TimeUnit): OffsetDateTime

Returns this date-time, rounded down to match the precision of a given unit.

until

common

infix fun OffsetDateTime.until(to: OffsetDateTime): OffsetDateTimeInterval

Creates an OffsetDateTimeInterval from this date-time up to, but not including to.

week

common

val OffsetDateTime.week: OffsetDateTimeInterval

The interval defining the ISO week that this date-time falls within.

fun OffsetDateTime.week(settings: WeekSettings): OffsetDateTimeInterval

The interval defining the week that this date-time falls within.

fun OffsetDateTime.week(locale: Locale): OffsetDateTimeInterval

The interval defining the week that this date-time falls within.

weekBasedYear

common

val OffsetDateTime.weekBasedYear: Int

The week-based year used in the ISO week date system.

fun OffsetDateTime.weekBasedYear(settings: WeekSettings): Int

The week-based year, calculated using the week definition in settings.

fun OffsetDateTime.weekBasedYear(locale: Locale): Int

The week-based year, calculated using the week definition associated with the provided locale.

weekOfMonth

common

val OffsetDateTime.weekOfMonth: Int

The week of the month, from 0-6, calculated using the ISO week definition.

fun OffsetDateTime.weekOfMonth(settings: WeekSettings): Int

The week of the month, from 0-6, calculated using the week definition in settings.

fun OffsetDateTime.weekOfMonth(locale: Locale): Int

The week of the month, from 0-6, calculated using the default week definition associated with the provided locale.

weekOfWeekBasedYear

common

val OffsetDateTime.weekOfWeekBasedYear: Int

The week number used in the ISO week date system.

fun OffsetDateTime.weekOfWeekBasedYear(settings: WeekSettings): Int

The week number of the week-based year, calculated using the week definition in settings.

fun OffsetDateTime.weekOfWeekBasedYear(locale: Locale): Int

The week number of the week-based year, calculated using the week definition associated with the provided locale.

weekOfYear

common

val OffsetDateTime.weekOfYear: Int

The week of the year, calculated using the ISO week definition.

fun OffsetDateTime.weekOfYear(settings: WeekSettings): Int

The week of the year, calculated using the week definition in settings.

fun OffsetDateTime.weekOfYear(locale: Locale): Int

The week of the year, calculated using the week definition associated with the provided locale.