kotlinx-datetime/kotlinx.datetime/plus

plus

operator fun DateTimePeriod.plus(other: DateTimePeriod): DateTimePeriod

Adds two DateTimePeriod instances.

Throws

if arithmetic overflow happens.

operator fun DatePeriod.plus(other: DatePeriod): DatePeriod

Adds two DatePeriod instances.

Throws

if arithmetic overflow happens.

fun Instant.plus(unit: DateTimeUnit.TimeBased): Instant

Returns an instant that is the result of adding one unit to this instant.

The returned instant is later than this instant.

The return value is clamped to the platform-specific boundaries for Instant if the result exceeds them.

fun Instant.plus(value: Int, unit: DateTimeUnit.TimeBased): Instant
expect fun Instant.plus(value: Long, unit: DateTimeUnit.TimeBased): Instant

Returns an instant that is the result of adding the value number of the specified unit to this instant.

If the value is positive, the returned instant is later than this instant. If the value is negative, the returned instant is earlier than this instant.

The return value is clamped to the platform-specific boundaries for Instant if the result exceeds them.

expect fun Instant.plus(period: DateTimePeriod, timeZone: TimeZone): Instant

Returns an instant that is the result of adding components of DateTimePeriod to this instant. The components are added in the order from the largest units to the smallest, i.e. from years to nanoseconds.

Throws

if this value or the results of intermediate computations are too large to fit in LocalDateTime.

expect fun Instant.plus(unit: DateTimeUnit, timeZone: TimeZone): Instant

Returns an instant that is the result of adding one unit to this instant in the specified timeZone.

The returned instant is later than this instant.

Throws

if this value or the result is too large to fit in LocalDateTime.

expect fun Instant.plus(value: Int, unit: DateTimeUnit, timeZone: TimeZone): Instant
expect fun Instant.plus(value: Long, unit: DateTimeUnit, timeZone: TimeZone): Instant

Returns an instant that is the result of adding the value number of the specified unit to this instant in the specified timeZone.

If the value is positive, the returned instant is later than this instant. If the value is negative, the returned instant is earlier than this instant.

Throws

if this value or the result is too large to fit in LocalDateTime.

expect operator fun LocalDate.plus(period: DatePeriod): LocalDate

Returns a date that is the result of adding components of DatePeriod to this date. The components are added in the order from the largest units to the smallest, i.e. from years to days.

See also

Throws

if this value or the results of intermediate computations are too large to fit in LocalDate.

expect fun LocalDate.plus(unit: DateTimeUnit.DateBased): LocalDate

Returns a LocalDate that is the result of adding one unit to this date.

The returned date is later than this date.

Throws

if the result exceeds the boundaries of LocalDate.

expect fun LocalDate.plus(value: Int, unit: DateTimeUnit.DateBased): LocalDate
expect fun LocalDate.plus(value: Long, unit: DateTimeUnit.DateBased): LocalDate

Returns a LocalDate that is the result of adding the value number of the specified unit to this date.

If the value is positive, the returned date is later than this date. If the value is negative, the returned date is earlier than this date.

Throws

if the result exceeds the boundaries of LocalDate.

actual fun Instant.plus(period: DateTimePeriod, timeZone: TimeZone): Instant
actual fun Instant.plus(unit: DateTimeUnit, timeZone: TimeZone): Instant
actual fun Instant.plus(value: Int, unit: DateTimeUnit, timeZone: TimeZone): Instant
actual fun Instant.plus(value: Long, unit: DateTimeUnit, timeZone: TimeZone): Instant
actual fun Instant.plus(value: Long, unit: DateTimeUnit.TimeBased): Instant
actual operator fun LocalDate.plus(period: DatePeriod): LocalDate
actual fun LocalDate.plus(unit: DateTimeUnit.DateBased): LocalDate
actual fun LocalDate.plus(value: Int, unit: DateTimeUnit.DateBased): LocalDate
actual fun LocalDate.plus(value: Long, unit: DateTimeUnit.DateBased): LocalDate
actual fun Instant.plus(period: DateTimePeriod, timeZone: TimeZone): Instant
actual fun Instant.plus(unit: DateTimeUnit, timeZone: TimeZone): Instant
actual fun Instant.plus(value: Int, unit: DateTimeUnit, timeZone: TimeZone): Instant
actual fun Instant.plus(value: Long, unit: DateTimeUnit, timeZone: TimeZone): Instant
actual fun Instant.plus(value: Long, unit: DateTimeUnit.TimeBased): Instant
actual operator fun LocalDate.plus(period: DatePeriod): LocalDate
actual fun LocalDate.plus(unit: DateTimeUnit.DateBased): LocalDate
actual fun LocalDate.plus(value: Int, unit: DateTimeUnit.DateBased): LocalDate
actual fun LocalDate.plus(value: Long, unit: DateTimeUnit.DateBased): LocalDate
actual fun Instant.plus(period: DateTimePeriod, timeZone: TimeZone): Instant
actual fun Instant.plus(unit: DateTimeUnit, timeZone: TimeZone): Instant
actual fun Instant.plus(value: Int, unit: DateTimeUnit, timeZone: TimeZone): Instant
actual fun Instant.plus(value: Long, unit: DateTimeUnit, timeZone: TimeZone): Instant
actual fun Instant.plus(value: Long, unit: DateTimeUnit.TimeBased): Instant
actual operator fun LocalDate.plus(period: DatePeriod): LocalDate
actual fun LocalDate.plus(unit: DateTimeUnit.DateBased): LocalDate
actual fun LocalDate.plus(value: Int, unit: DateTimeUnit.DateBased): LocalDate
actual fun LocalDate.plus(value: Long, unit: DateTimeUnit.DateBased): LocalDate