Skip to content

//core/io.islandtime.parser

Package-level declarations

common

Parsing of dates, times, durations, and intervals from textual representations.

Types

Name Summary
DateTimeParseException

common


class DateTimeParseException(message: String? = null, val parsedString: String? = null, val errorIndex: Int = 0, cause: Throwable? = null) : DateTimeException
DateTimeParser

common


abstract class DateTimeParser

A parser that converts text into a collection of date-time fields that are understood throughout Island Time.
DateTimeParserBuilder

common


interface DateTimeParserBuilder
DateTimeParserDsl

common


@DslMarker

annotation class DateTimeParserDsl
DateTimeParseResult

common


data class DateTimeParseResult(val fields: MutableMap<DateTimeField, Long> = hashMapOf(), var timeZoneId: String? = null)

The result of a parsing operation.
DateTimeParsers

common


object DateTimeParsers

A set of predefined parsers.
DateTimeParserSettings

common


data class DateTimeParserSettings(val numberStyle: NumberStyle = NumberStyle.DEFAULT, val locale: () -> Locale = { defaultLocale() }, val isCaseSensitive: Boolean = true)

Settings that control the parsing behavior.
DecimalNumberParserBuilder

common


interface DecimalNumberParserBuilder : NumberParserBuilder
GroupedDateTimeParser

common


class GroupedDateTimeParser
GroupedDateTimeParserBuilder

common


interface GroupedDateTimeParserBuilder
LiteralParserBuilder

common


interface LiteralParserBuilder
NumberParserBuilder

common


interface NumberParserBuilder
SignParserBuilder

common


interface SignParserBuilder
SignStyle

common


enum SignStyle : Enum<SignStyle>
StringParseAction

common


enum StringParseAction : Enum<StringParseAction>
StringParserBuilder

common


interface StringParserBuilder
WholeNumberParserBuilder

common


interface WholeNumberParserBuilder : NumberParserBuilder

Functions

Name Summary
amPm

common


fun DateTimeParserBuilder.amPm()

Parse the AM or PM of the day from its textual representation.
dateTimeParser

common


inline fun dateTimeParser(builder: DateTimeParserBuilder.() -> Unit): DateTimeParser

Define a custom DateTimeParser.
dayOfMonth

common


inline fun DateTimeParserBuilder.dayOfMonth(length: Int, crossinline builder: WholeNumberParserBuilder.() -> Unit = {})

Parse a day of the month value with a fixed number of digits.

common


inline fun DateTimeParserBuilder.dayOfMonth(length: IntRange = 1..19, crossinline builder: WholeNumberParserBuilder.() -> Unit = {})

Parse a day of the month value with a variable number of digits.
dayOfWeekNumber

common


inline fun DateTimeParserBuilder.dayOfWeekNumber(length: Int = 1, crossinline builder: WholeNumberParserBuilder.() -> Unit = {})

Parse a day of week number with a fixed number of digits.
dayOfYear

common


inline fun DateTimeParserBuilder.dayOfYear(length: Int, crossinline builder: WholeNumberParserBuilder.() -> Unit = {})

Parse a day of the year value with a fixed number of digits.

common


inline fun DateTimeParserBuilder.dayOfYear(length: IntRange = 1..19, crossinline builder: WholeNumberParserBuilder.() -> Unit = {})

Parse a day of the year value with a variable number of digits.
durationOfFractionalSeconds

common


inline fun DateTimeParserBuilder.durationOfFractionalSeconds(wholeLength: IntRange = 1..19, fractionLength: IntRange = 0..9, fractionScale: Int = 9, crossinline builder: DecimalNumberParserBuilder.() -> Unit = {})

Parse a duration of fractional seconds.
durationOfHours

common


inline fun DateTimeParserBuilder.durationOfHours(length: IntRange = 1..19, crossinline builder: WholeNumberParserBuilder.() -> Unit = {})

Parse a duration of whole hours.
durationOfMinutes

common


inline fun DateTimeParserBuilder.durationOfMinutes(length: IntRange = 1..19, crossinline builder: WholeNumberParserBuilder.() -> Unit = {})

Parse a duration of whole minutes.
durationOfSeconds

common


inline fun DateTimeParserBuilder.durationOfSeconds(length: IntRange = 1..19, crossinline builder: WholeNumberParserBuilder.() -> Unit = {})

Parse a duration of whole seconds.
era

common


fun DateTimeParserBuilder.era(style: TextStyle)

Parse an era from its textual representation in a specific style.

common


fun DateTimeParserBuilder.era(styles: Set<TextStyle>)

Parse an era from its textual representation in any of the specified styles.
fractionalSecondOfMinute

common


inline fun DateTimeParserBuilder.fractionalSecondOfMinute(wholeLength: Int, fractionLength: IntRange = 0..9, fractionScale: Int = 9, crossinline builder: DecimalNumberParserBuilder.() -> Unit = {})

Parse a fractional second of the minute with a fixed number of characters representing the whole second.

common


inline fun DateTimeParserBuilder.fractionalSecondOfMinute(wholeLength: IntRange = 1..2, fractionLength: IntRange = 0..9, fractionScale: Int = 9, crossinline builder: DecimalNumberParserBuilder.() -> Unit = {})

Parse a fractional second of the minute.
groupedDateTimeParser

common


inline fun groupedDateTimeParser(builder: GroupedDateTimeParserBuilder.() -> Unit): GroupedDateTimeParser

Creates a GroupedDateTimeParser.
hourOfDay

common


inline fun DateTimeParserBuilder.hourOfDay(length: Int, crossinline builder: WholeNumberParserBuilder.() -> Unit = {})

Parse an hour of the day with a fixed number of digits.

common


inline fun DateTimeParserBuilder.hourOfDay(length: IntRange = 1..2, crossinline builder: WholeNumberParserBuilder.() -> Unit = {})

Parse an hour of the day with a variable number of digits.
localizedDayOfWeek

common


fun DateTimeParserBuilder.localizedDayOfWeek(style: TextStyle)

Parse a day of the week from its textual representation in a specific style.

common


fun DateTimeParserBuilder.localizedDayOfWeek(styles: Set<TextStyle>)

Parse a day of the week from its textual representation in any of the specified styles.
localizedMonth

common


fun DateTimeParserBuilder.localizedMonth(style: TextStyle)

Parse a month from its textual representation in a specific style.

common


fun DateTimeParserBuilder.localizedMonth(styles: Set<TextStyle>)

Parse a month from its textual representation in any of the specified styles.
minuteOfHour

common


inline fun DateTimeParserBuilder.minuteOfHour(length: Int, crossinline builder: WholeNumberParserBuilder.() -> Unit = {})

Parse a minute of the hour with a fixed number of digits.

common


inline fun DateTimeParserBuilder.minuteOfHour(length: IntRange = 1..2, crossinline builder: WholeNumberParserBuilder.() -> Unit = {})

Parse a minute of the hour with a variable number of digits.
monthNumber

common


inline fun DateTimeParserBuilder.monthNumber(length: Int, crossinline builder: WholeNumberParserBuilder.() -> Unit = {})

Parse a month of year number with a fixed number of digits.

common


inline fun DateTimeParserBuilder.monthNumber(length: IntRange = 1..19, crossinline builder: WholeNumberParserBuilder.() -> Unit = {})

Parse a month of year value with a variable number of digits.
periodOfDays

common


inline fun DateTimeParserBuilder.periodOfDays(length: IntRange = 1..10, crossinline builder: WholeNumberParserBuilder.() -> Unit = {})

Parse a period of whole days.
periodOfMonths

common


inline fun DateTimeParserBuilder.periodOfMonths(length: IntRange = 1..10, crossinline builder: WholeNumberParserBuilder.() -> Unit = {})

Parse a period of whole months.
periodOfWeeks

common


inline fun DateTimeParserBuilder.periodOfWeeks(length: IntRange = 1..10, crossinline builder: WholeNumberParserBuilder.() -> Unit = {})

Parse a period of whole weeks.
periodOfYears

common


inline fun DateTimeParserBuilder.periodOfYears(length: IntRange = 1..10, crossinline builder: WholeNumberParserBuilder.() -> Unit = {})

Parse a period of whole years.
periodSign

common


fun DateTimeParserBuilder.periodSign()

Parses a number's sign and populates DateTimeField.PERIOD_SIGN with -1L, if negative or 1L, if positive.
secondOfMinute

common


inline fun DateTimeParserBuilder.secondOfMinute(length: Int, crossinline builder: WholeNumberParserBuilder.() -> Unit = {})

Parse a second of the minute with a fixed number of digits.

common


inline fun DateTimeParserBuilder.secondOfMinute(length: IntRange = 1..2, crossinline builder: WholeNumberParserBuilder.() -> Unit = {})

Parse a second of the minute with a variable number of digits.
timeZoneId

common


fun DateTimeParserBuilder.timeZoneId()

Parse a time zone region ID.
unboundedDesignator

common


fun DateTimeParserBuilder.unboundedDesignator()

Parses the string ".." and populates DateTimeField.IS_UNBOUNDED with 1L.
utcDesignator

common


fun DateTimeParserBuilder.utcDesignator()

Parses the character 'Z' and populates DateTimeField.UTC_OFFSET_TOTAL_SECONDS with 0L.
utcOffsetHours

common


inline fun DateTimeParserBuilder.utcOffsetHours(length: Int, crossinline builder: WholeNumberParserBuilder.() -> Unit = {})
utcOffsetMinutes

common


inline fun DateTimeParserBuilder.utcOffsetMinutes(length: Int, crossinline builder: WholeNumberParserBuilder.() -> Unit = {})
utcOffsetSeconds

common


inline fun DateTimeParserBuilder.utcOffsetSeconds(length: Int, crossinline builder: WholeNumberParserBuilder.() -> Unit = {})
utcOffsetSign

common


fun DateTimeParserBuilder.utcOffsetSign()

Parses a number's sign and populates DateTimeField.UTC_OFFSET_SIGN with -1L, if negative or 1L, if positive.
year

common


inline fun DateTimeParserBuilder.year(length: Int, crossinline builder: WholeNumberParserBuilder.() -> Unit = {})

Parse a year with a fixed number of digits.

common


inline fun DateTimeParserBuilder.year(length: IntRange = 1..19, crossinline builder: WholeNumberParserBuilder.() -> Unit = {})

Parse a year with a variable number of digits.
yearOfEra

common


inline fun DateTimeParserBuilder.yearOfEra(length: Int, crossinline builder: WholeNumberParserBuilder.() -> Unit = {})

Parse a year of era with a fixed number of digits.

common


inline fun DateTimeParserBuilder.yearOfEra(length: IntRange = 1..19, crossinline builder: WholeNumberParserBuilder.() -> Unit = {})

Parse a year of era with a variable number of digits.