core-utils/com.pambrose.common.util/DateUtils

DateUtils

Date/time parsing, formatting, and arithmetic helpers shared across all Kotlin targets.

Formatters render US-style MM/DD dates; the *Now helpers default to the system time zone rather than assuming a region. Declared as an object so its extensions are brought in by member import (e.g. import com.pambrose.common.util.DateUtils.toMMDDYY).

Properties

age

val Instant?.age: Duration

The elapsed Duration from this instant until now, or Duration.ZERO if the receiver is null.

Functions

abbrevDayOfWeek

fun LocalDate.abbrevDayOfWeek(): String

fun LocalDateTime.abbrevDayOfWeek(): String

Returns the abbreviated day-of-week name (e.g., "Mon", "Tue").

age

fun LocalDateTime?.age(timeZone: TimeZone): Duration

The elapsed Duration from this date-time until now, interpreting the receiver in timeZone, or Duration.ZERO if the receiver is null.

instantNow

fun instantNow(): Instant

Returns the current moment from the system clock as an Instant.

localDateNow

fun localDateNow(timeZone: TimeZone = TimeZone.currentSystemDefault()): LocalDate

The current date in timeZone (the system default zone unless specified).

localDateTimeNow

fun localDateTimeNow(timeZone: TimeZone = TimeZone.currentSystemDefault()): LocalDateTime

The current date-time in timeZone (the system default zone unless specified).

parseToLocalDate

fun String.parseToLocalDate(): LocalDate

Parses this ISO-8601 date string (e.g. "2024-03-15") into a LocalDate.

parseToLocalDateTime

fun String.parseToLocalDateTime(): LocalDateTime

Parses this ISO-8601 date-time string (e.g. "2024-03-15T08:30:45") into a LocalDateTime.

parseToLocalTime

fun String.parseToLocalTime(): LocalTime

Parses this ISO-8601 time string (e.g. "13:45:30") into a LocalTime.

toAdjustedString

fun Duration.toAdjustedString(unit: DurationUnit = SECONDS): String

Truncates this Duration down to whole units and returns its Duration.toString form.

toCreated

fun LocalDateTime.toCreated(): String

Wraps toMMDDYYYYHHMM in a "(Created …)" label, e.g. "(Created 04/10/2026 14:30)".

toDashedYYYYMMDD

fun LocalDate.toDashedYYYYMMDD(): String

Formats this LocalDate as ISO-style YYYY-MM-DD, e.g. "2026-04-10".

toFullDateString

fun LocalDateTime.toFullDateString(): String

Formats this LocalDateTime as a full date string, e.g., "Mon 04/10/26 14:30:00".

fun LocalDateTime.toFullDateString(timeZone: TimeZone): String

Formats this LocalDateTime as a full date string suffixed with the UTC offset for timeZone, e.g., "Mon 04/10/26 14:30:00 -04:00" (a zero offset renders as "Z").

toISO8601

fun LocalDateTime.toISO8601(): String

Formats this LocalDateTime as an ISO-8601 string with a trailing Z, dropping any fractional-seconds component (e.g. 2024-03-15T08:30:45.123 becomes "2024-03-15T08:30:45Z").