Add specified number of hours, minutes, or seconds to this time. If the argument is not specified, 0 will be added. If the resulting value is bigger than 23:59:59, the value will be wrapped (e.g. to 00:00:00)

asMidnight

fun LocalDateTime.asMidnight(): LocalDateTime

Returns a new LocalDateTime set to the midnight.

asStartOfMonth

fun LocalDateTime.asStartOfMonth(): LocalDateTime

Returns a new LocalDateTime that is set to the first day of month and 00:00:00.000 of the month of this.

asStartOfWeek

fun LocalDateTime.asStartOfWeek(zone: TimeZone): LocalDateTime

Returns a new LocalDateTime that is set to DayOfWeek.MONDAY and 00:00:00.000 of the week of this.

asStartOfYear

fun LocalDateTime.asStartOfYear(): LocalDateTime

Returns a new LocalDateTime that is set to the first day of year and 00:00:00.000 of the year of this.

asString

fun LocalTime.asString(use12h: Boolean = false, addSecondsIfZero: Boolean = false): String

Same as toString but gives you a choice on whether to use 12H scheme. toString uses asString(false).

fun DayOfWeek.asString(): String

Gets the DayOfWeek.getDisplayName of this using system default locale

fun Instant.asString(formatter: DateTimeFormatter): String

Formats this using formatter

fun Month.asString(textStyle: TextStyle = TextStyle.FULL, locale: Locale = Locale.getDefault()): String

Returns a string representation of this using specified textStyle and locale

asTimeNumber

fun LocalTime.Companion.asTimeNumber(value: Int): String

Represents this numeric value as if it is a number on the clock Examples:

atDate

fun LocalTime.atDate(date: LocalDate): LocalDateTime

Create a new LocalDateTime using given date

atTime

fun LocalDate.atTime(time: LocalTime): LocalDateTime

Create a LocalDateTime with the specified time

distanceInSeconds

infix fun LocalTime.distanceInSeconds(to: LocalTime): Int

distanceTo

infix fun LocalTime.distanceTo(other: LocalTime): LocalTime

Calculate distance to the other between LocalTime.MIN and LocalTime.MAX

get

operator fun LocalTime.get(index: Int): Int

Get either the hour or minute or second value of this time. Values more than 2 will throw an IndexOutOfBoundsException

invoke

operator fun LocalTime.Companion.invoke(duration: Duration): LocalTime

Create a new LocalTime from duration. If the duration is larger than 24 hours, it will wrap around

isCurrentMonth

fun Calendar.isCurrentMonth(): Boolean

Returns tru if this calendar is set to current month, computed using local date and timezone of the original calendar.

isCurrentYear

fun Calendar.isCurrentYear(): Boolean

Returns tru if this calendar is set to current year, computed using local date and timezone of the original calendar

isValid

fun LocalTime.Companion.isValid(time: String): Boolean

Returns true if time is a valid time string

length

fun Month.length(year: Int): Int

Finds the length of a given month based on the year, in days.

minus

operator fun LocalTime.minus(other: LocalTime): LocalTime

Subtract other from LocalTime

minusDays

fun LocalDateTime.minusDays(days: Int, zone: TimeZone): LocalDateTime

Subtracts a specified number of days from this.

fun Instant.minusDays(days: Long): Instant

Returns a new Instant with given number of days subtracted

minusMonths

fun LocalDateTime.minusMonths(months: Int, zone: TimeZone): LocalDateTime

Subtracts a specified number of months from this. Returns a new LocalDateTime

now

fun LocalDate.Companion.now(zone: TimeZone): LocalDate

Get the current date using provided zone.

fun LocalDateTime.Companion.now(zone: TimeZone): LocalDateTime

Creates a new Instant and converts it to LocalDateTime

fun LocalTime.Companion.now(zone: TimeZone): LocalTime

Get the current time using provided zone.

ofInt

fun LocalTime.Companion.ofInt(hms: Int): LocalTime

Parse a new time object using the int representation of it.

ofMillis

fun LocalTime.Companion.ofMillis(millis: Int): LocalTime

Create a time from milliseconds since midnight. millis is NOT a timestamp

ofSeconds

fun LocalTime.Companion.ofSeconds(seconds: Int): LocalTime

Get current time value using specified seconds since midnight seconds is NOT a timestamp

onSameDay

fun LocalDateTime.onSameDay(other: LocalDateTime): Boolean

Returns tru if this is on the same day as other. Ignores time, but considers year and month.

onSameLocalDay

fun ZonedDateTime.onSameLocalDay(other: ZonedDateTime): Boolean

Whether this is on the same day as other, using ZoneId of this and other. It's important that if the ZonedDateTime.zones are different, the values can still be on the same day

onSameUTCDay

fun Instant.onSameUTCDay(other: Instant): Boolean

Returns true if this is on the same day as other, not considering time zones

parseAs12H

fun LocalTime.Companion.parseAs12H(s: String): LocalTime

example: 12:45:00, 4:30, 7:00 AM, 24 or 12h format, word separator is " ". On a value that is not a valid time, will throw.

parseOrNull

fun LocalTime.Companion.parseOrNull(s: String): LocalTime?

Parse s as time serialized using LocalTime.toString and return null if it fails.

plus

operator fun Instant.plus(time: LocalTime): Instant

Adds a specified time to this. Returns a new Instant

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

Create a new time with the result of adding LocalTime to other

fun LocalDateTime.plus(value: Int, unit: DateTimeUnit, zone: TimeZone): LocalDateTime

Adds a given value to the this, converting it to Instant for the addition.

plusDays

fun LocalDate.plusDays(days: Int): LocalDate

Returns a new LocalDate with specified days added

fun LocalDateTime.plusDays(days: Int, zone: TimeZone): LocalDateTime

Adds a specified number of days to this.

fun Instant.plusDays(days: Long): Instant

Returns a new Instant with given number of days added

plusMonths

fun LocalDateTime.plusMonths(months: Int, zone: TimeZone): LocalDateTime

Adds a specified number of months to this. Returns a new LocalDateTime

resetToEndOfDay

fun Calendar.resetToEndOfDay()

Resets this to the last millisecond of the day.

resetToEndOfMonth

fun Calendar.resetToEndOfMonth()

Resets this to the last day of the month and the last millisecond of the day

resetToStartOfDay

fun Calendar.resetToStartOfDay()

Resets this calendar to the start of the day. Modifies the original object.

resetToStartOfMonth

fun Calendar.resetToStartOfMonth()

Resets this to the start of the month and midnight.

setToMaximum

fun Calendar.setToMaximum(field: Int)

Sets field to its maximum value

setToMidnight

fun Calendar.setToMidnight()

Resets a given Calendar to the start of the day. Modifies the original object.

setToMinimum

fun Calendar.setToMinimum(field: Int)

Sets field to its minimum value

sortedByLocale

fun Iterable<DayOfWeek>.sortedByLocale(locale: Locale = Locale.getDefault()): List<DayOfWeek>

Sorts DayOfWeeks according to the locale. I.e. will affect the first value (Monday / Sunday etc.)

takeIfNotZero

fun LocalTime?.takeIfNotZero(): LocalTime?

If this is LocalTime.MIN return null, this otherwise

toCalendar

fun Date.toCalendar(timeZone: TimeZone = TimeZone.getDefault(), locale: Locale = Locale.getDefault()): Calendar

Creates a new Calendar using this as the date.

fun Long.toCalendar(timeZone: TimeZone = TimeZone.getDefault(), locale: Locale = Locale.getDefault()): Calendar

Creates a new Calendar using this as the time in milliseconds.

toInt

fun LocalTime.toInt(): Int

Returns an integer that represents this time, like a string, but without the ":"

toLocalTimeOrNull

fun String?.toLocalTimeOrNull(): LocalTime?

Try to parse this as LocalTime or return null if it fails

totalDuration

fun Iterable<LocalTime?>.totalDuration(): Duration

Compute total asDuration of all items in the collection

@JvmName(name = "totalDurationSequence")

fun Sequence<LocalTime?>.totalDuration(): LocalTime

Compute total asDuration of all items in the sequence

toZDT

fun Instant.toZDT(zoneId: ZoneId): ZonedDateTime

Creates a new ZonedDateTime using this Instant and a given zoneId

truncateMinutes

fun LocalTime.truncateMinutes(): LocalTime

Returns the same time with all of nanos, seconds and minutes set to 0

truncateNanos

fun LocalTime.truncateNanos(): LocalTime

Returns the same time with LocalTime.nanosecond set to 0.

truncateSeconds

fun LocalTime.truncateSeconds(): LocalTime

Returns the same time with both nanos and seconds set to 0.

with

fun LocalTime.Companion.with(hours: Int = 0, minutes: Int = 0, seconds: Int = 0): LocalTime

Create a new time using specified hours, minutes, or seconds If you specify a value bigger than the initial, the remainder will spill into the next value. If you specify a value bigger than LocalTime.MAX, it will wrap around. Examples:

withDayOfMonth

fun LocalDate.withDayOfMonth(day: Int): LocalDate

Returns a new LocalDate with the day of month set to the specified day

fun LocalDateTime.withDayOfMonth(day: Int): LocalDateTime

Returns a new LocalDateTime with the given day of month and everything else of this.

withMonth

fun LocalDateTime.withMonth(month: Month): LocalDateTime

Returns a new LocalDateTime with the given month and everything else of this.

withNextDayOfWeek

fun LocalDateTime.withNextDayOfWeek(dayOfWeek: DayOfWeek, zone: TimeZone): LocalDateTime

Returns a new LocalDateTime that has the date adjusted to the date with the given next dayOfWeek. If the date is already on the given dayOfWeek, returns a date a week later.

withPreviousOrSameDayOfWeek

fun LocalDateTime.withPreviousOrSameDayOfWeek(dayOfWeek: DayOfWeek, zone: TimeZone): LocalDateTime

Returns a new LocalDateTime that has either the same (if this has the same day of week as dayOfWeek) or the previous dayOfWeek.

withTime

fun LocalDateTime.withTime(time: LocalTime, nanos: Int = nanosecond): LocalDateTime

Create a new LocalDateTime with the given time and nanos Preserves nanos of previous time

fun ZonedDateTime.withTime(time: LocalTime): ZonedDateTime

fun ZonedDateTime.~~withTime~~(time: LocalTime): ZonedDateTime

Sets this's time to time. Returns a new ZonedDateTime