Year

inline class Year(value: Int) : Comparable<Year>

A year as defined by ISO-8601.

Parameters

value

the year

Throws

io.islandtime.DateTimeException

if the year is invalid

Constructors

Year

common

fun Year(value: Long)

Creates a Year.

Year

common

fun Year(value: Int)

Creates a Year.

Types

Companion

common

object Companion

Functions

compareTo

common

open operator override fun compareTo(other: Year): Int

contains

common

operator fun contains(date: Date): Boolean

operator fun contains(yearMonth: YearMonth): Boolean

equals

common

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

hashCode

common

open override fun hashCode(): Int

minus

common

operator fun minus(years: IntYears): Year

operator fun minus(years: LongYears): Year

plus

common

operator fun plus(years: IntYears): Year

operator fun plus(years: LongYears): Year

toString

common

open override fun toString(): String

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

Properties

dateRange

common

val dateRange: DateRange

The date range of the year.

dayRange

common

val dayRange: IntRange

The day range of the year.

endDate

common

val endDate: Date

The last date of the year.

isLeap

common

val isLeap: Boolean

Checks if this is a leap year.

lastDay

common

val lastDay: Int

The last day of the year.

length

common

val length: IntDays

The length of the year in days.

startDate

common

val startDate: Date

The first date of the year.

value

common

val value: Int

The year value.

Extensions

common

infix fun Year.at(month: Month): YearMonth

Combines a year and month to create a YearMonth.

atMonth

common

fun Year.atMonth(number: Int): YearMonth

Combines a year and month number to create a YearMonth.

toJavaYear

jvm

fun Year.toJavaYear(): Year

Converts this year to an equivalent Java Year.

toNSDateComponents

darwin

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

Converts this year to an equivalent NSDateComponents object.