Module

java_time_utils

Module java_time_utils

OverviewInstallationQuick StartGetting the Current Date and Time Without ZoneFeatures

API

between
betweenPeriod
createObject
Duration_getZERO
fromInterval
getApril
getAugust
getBasicIsoDateFormatter
getCurrentDate
getCurrentDateTime
getCurrentTime
getDecember
getEpochDate
getFebruary
getFriday
getIsoDateFormatter
getIsoDateTimeFormatter
getIsoInstantFormatter
getIsoLocalDateFormatter
getIsoLocalDateTimeFormatter
getIsoLocalTimeFormatter
getIsoOffsetDateFormatter
getIsoOffsetDateTimeFormatter
getIsoOffsetTimeFormatter
getIsoOrdinalDateFormatter
getIsoTimeFormatter
getIsoWeekDateFormatter
getIsoZonedDateTimeFormatter
getJanuary
getJuly
getJune
getMarch
getMaxDate
getMaxDateTime
getMaxTime
getMay
getMidnigth
getMinDate
getMinDateTime
getMinTime
getMonday
getMonthOf
getMonthValueOf
getMonthValueOfEnum
getMonthValues
getNoon
getNovember
getOctober
getRfc1123DateTimeFormatter
getSaturday
getSeptember
getSunday
getThursday
getTuesday
getWednesday
getWeekValues
getZero
ofDate
ofDateTime
ofDay
ofDays
ofEnumValue
ofEpochDay
ofHours
ofLocalDateWithLocalTime
ofLocalizedPattern
ofMillis
ofMinutes
ofMonth
ofMonthFull
ofMonthFullWithNano
ofMonthFullWithsecond
ofNanoOfDay
ofNanos
ofPattern
ofPeriod
ofPeriodDays
ofPeriodMonths
ofPeriodWeeks
ofPeriodYears
ofSecondOfDay
ofSeconds
ofSecondsWithNanos
ofTime
ofTimeWithSecond
ofTimeWithSecondNano
ofWithNanos
ofWithSeconds
ofYearDay
parse
parseDuration
parseFormatter
parsePeriod
parseText
parseTextWithFormatter
parseWithFormatter
parseWithText
valueOf
valueOfDayName

AppendableCharSequence
ChronoLocalDateChronoLocalDateTimeChronologyClassClockDateTimeFormatterDayOfWeekDecimalStyleDurationEnumFormatFormatStyleInstantIntStreamIsoChronologyIsoEraListLocalDateLocalDateTimeLocaleLocalTimeMonthObjectOffsetDateTimeOffsetTimeOptionalParsePositionPeriodResolverStyleSetStreamTemporalTemporalAccessorTemporalAdjusterTemporalAmountTemporalFieldTemporalQueryTemporalUnitTextStyleValueRangeZonedDateTimeZoneIdZoneOffset

Declarations

INTERRUPTEDEXCEPTION

Definitions

InterruptedException

kruutteri1/java_time_utils

1.0.7

Overview

A Ballerina wrapper around java.time — LocalDate, LocalDateTime, and LocalTime, and other core helper and enum classes like Month and DayOfWeek for working with dates, times, and temporal components without time zones.

java.time is the gold standard for date and time handling on the JVM. java_time_utils brings that same power into Ballerina — precise date/time arithmetic, immutable values, and predictable behavior, without reaching for a full-blown time-zone library when you don't need one.

Installation

Copy
# Ballerina.toml
[[dependency]]
org = "kruutteri1"
name = "java_time_utils"
version = "1.0.7"  # check central.ballerina.io for the latest version
Copy
import kruutteri1/java_time_utils as jt;

Quick Start

Copy
import ballerina/io;
import kruutteri1/java_time_utils as jt;

public function main() returns error? {
    jt:LocalDate date = check jt:ofDate(2026, 7, 15);
    jt:LocalTime time = check jt:ofTimeWithSecond(14, 28, 19);
    jt:LocalDateTime dateTime = check jt:ofLocalDateWithLocalTime(date, time);

    io:println(date.toString());      // 2026-07-15
    io:println(time.toString());      // 14:28:19
    io:println(dateTime.toString());  // 2026-07-15T14:28:19
}

Getting the Current Date and Time Without Zone

Copy
import ballerina/io;
import kruutteri1/java_time_utils as jt;

public function main() {
    jt:LocalDate today = jt:getCurrentDate();
    jt:LocalTime now = jt:getCurrentTime();
    jt:LocalDateTime currentDateTime = jt:getCurrentDateTime();

    io:println("Today: ", today.toString());             // Today: 2026-07-22
    io:println("Now: ", now.toString());                 // Now: 14:57:30
    io:println("Current date-time: ", currentDateTime.toString()); // Current date-time: 2026-07-22T14:57:30
}

Features

  • 📅 LocalDate — dates without time or time zone
  • 🗓️ LocalDateTime — dates with time, no time zone
  • 🕒 LocalTime — time of day without date or time zone
  • ⏳ Duration — time-based amount of time (e.g., seconds, nanoseconds)
  • ⏳ Period — date-based amount of time (e.g., years, months, days)
  • 📅 Month — month-of-year enum representation (such as January, July)
  • 📅 DayOfWeek — day-of-week enum representation (such as Monday, Sunday)
  • 🕒 DateTimeFormatter — formatting and parsing for temporal objects
  • Robust error handling using check patterns to prevent runtime panics on invalid interop calls
  • Immutable API — every plus*, minus*, and with* method returns a new object
  • Familiar java.time semantics, ported to idiomatic Ballerina

Functions

between

function between(LocalDateTime|LocalTime|LocalDate startInclusive, LocalDateTime|LocalTime|LocalDate endExclusive) returns Duration

Obtains a Duration representing the duration between two temporal objects.

Parameters
Return Type
  • Duration - The duration between the start and end time objects.

betweenPeriod

function betweenPeriod(LocalDate startDateInclusive, LocalDate endDateExclusive) returns Period

Obtains a Period consisting of the number of years, months, and days between two dates.

Parameters
  • startDateInclusive LocalDate - The start date, inclusive.
  • endDateExclusive LocalDate - The end date, exclusive.
Return Type
  • Period - The period between the start and end dates.

createObject

function createObject() returns Object

Creates a new instance of java.lang.Object.

Return Type
  • Object - A new Object instance.

Duration_getZERO

function Duration_getZERO() returns Duration

Obtains a constant Duration instance representing a zero length.

Return Type

fromInterval

function fromInterval(Duration|Period interval) returns Duration

Obtains an instance of Duration from a temporal amount.

Parameters
  • interval Duration|Period - The temporal amount to convert (Duration or Period), not null.
Return Type
  • Duration - The equivalent Duration instance.

getApril

function getApril() returns Month

Retrieves the constant representing the month of April.

Return Type
  • Month - The April month constant.

getAugust

function getAugust() returns Month

Retrieves the constant representing the month of August.

Return Type
  • Month - The August month constant.

getBasicIsoDateFormatter

function getBasicIsoDateFormatter() returns DateTimeFormatter

Obtains the BASIC_ISO_DATE formatter that formats or parses a basic date without separators, such as "20260722".

Return Type

getCurrentDate

function getCurrentDate() returns LocalDate

Obtains the current date from the system clock in the default time-zone.

Return Type

getCurrentDateTime

function getCurrentDateTime() returns LocalDateTime

Obtains the current date-time from the system clock in the default time-zone.

Return Type

getCurrentTime

function getCurrentTime() returns LocalTime

Obtains the current time from the system clock in the default time-zone.

Return Type

getDecember

function getDecember() returns Month

Retrieves the constant representing the month of December.

Return Type
  • Month - The December month constant.

getEpochDate

function getEpochDate() returns LocalDate

Returns the epoch date (1970-01-01).

Return Type

getFebruary

function getFebruary() returns Month

Retrieves the constant representing the month of February.

Return Type
  • Month - The February month constant.

getFriday

function getFriday() returns DayOfWeek

Returns the constant for Friday.

Return Type

getIsoDateFormatter

function getIsoDateFormatter() returns DateTimeFormatter

Obtains the ISO_DATE formatter that formats or parses a date with or without an offset, such as "2026-07-22" or "2026-07-22+03:00".

Return Type

getIsoDateTimeFormatter

function getIsoDateTimeFormatter() returns DateTimeFormatter

Obtains the ISO_DATE_TIME formatter that formats or parses a date-time with a zone, such as "2026-07-22T14:28:19+03:00[Europe/Kyiv]".

Return Type

getIsoInstantFormatter

function getIsoInstantFormatter() returns DateTimeFormatter

Obtains the ISO_INSTANT formatter that formats or parses an instant in UTC, such as "2026-07-22T11:28:19Z".

Return Type

getIsoLocalDateFormatter

function getIsoLocalDateFormatter() returns DateTimeFormatter

Obtains the ISO_LOCAL_DATE formatter that formats or parses a date without an offset, such as "2026-07-22".

Return Type

getIsoLocalDateTimeFormatter

function getIsoLocalDateTimeFormatter() returns DateTimeFormatter

Obtains the ISO_LOCAL_DATE_TIME formatter that formats or parses a date-time without an offset, such as "2026-07-22T14:28:19".

Return Type

getIsoLocalTimeFormatter

function getIsoLocalTimeFormatter() returns DateTimeFormatter

Obtains the ISO_LOCAL_TIME formatter that formats or parses a time without an offset, such as "14:28:19".

Return Type

getIsoOffsetDateFormatter

function getIsoOffsetDateFormatter() returns DateTimeFormatter

Obtains the ISO_OFFSET_DATE formatter that formats or parses a date with an offset, such as "2026-07-22+03:00".

Return Type

getIsoOffsetDateTimeFormatter

function getIsoOffsetDateTimeFormatter() returns DateTimeFormatter

Obtains the ISO_OFFSET_DATE_TIME formatter that formats or parses a date-time with an offset, such as "2026-07-22T14:28:19+03:00".

Return Type

getIsoOffsetTimeFormatter

function getIsoOffsetTimeFormatter() returns DateTimeFormatter

Obtains the ISO_OFFSET_TIME formatter that formats or parses a time with an offset, such as "14:28:19+03:00".

Return Type

getIsoOrdinalDateFormatter

function getIsoOrdinalDateFormatter() returns DateTimeFormatter

Obtains the ISO_ORDINAL_DATE formatter that formats or parses the ordinal date, such as "2026-203".

Return Type

getIsoTimeFormatter

function getIsoTimeFormatter() returns DateTimeFormatter

Obtains the ISO_TIME formatter that formats or parses a time with or without an offset, such as "14:28:19" or "14:28:19+03:00".

Return Type

getIsoWeekDateFormatter

function getIsoWeekDateFormatter() returns DateTimeFormatter

Obtains the ISO_WEEK_DATE formatter that formats or parses the week-based date, such as "2026-W30-3".

Return Type

getIsoZonedDateTimeFormatter

function getIsoZonedDateTimeFormatter() returns DateTimeFormatter

Obtains the ISO_ZONED_DATE_TIME formatter that formats or parses a date-time with a zone ID, such as "2026-07-22T14:28:19+03:00[Europe/Kyiv]".

Return Type

getJanuary

function getJanuary() returns Month

Retrieves the constant representing the month of January.

Return Type
  • Month - The January month constant.

getJuly

function getJuly() returns Month

Retrieves the constant representing the month of July.

Return Type
  • Month - The July month constant.

getJune

function getJune() returns Month

Retrieves the constant representing the month of June.

Return Type
  • Month - The June month constant.

getMarch

function getMarch() returns Month

Retrieves the constant representing the month of March.

Return Type
  • Month - The March month constant.

getMaxDate

function getMaxDate() returns LocalDate

Returns the maximum supported LocalDate (year 999999999-12-31).

Return Type

getMaxDateTime

function getMaxDateTime() returns LocalDateTime

Retrieves the maximum supported LocalDateTime (+999999999-12-31T23:59:59.999999999).

Return Type

getMaxTime

function getMaxTime() returns LocalTime

Retrieves the value of the public field MAX.

Return Type
  • LocalTime - The LocalTime value of the field.

getMay

function getMay() returns Month

Retrieves the constant representing the month of May.

Return Type
  • Month - The May month constant.

getMidnigth

function getMidnigth() returns LocalTime

Retrieves the value of the public field MIDNIGHT.

Return Type
  • LocalTime - The LocalTime value of the field.

getMinDate

function getMinDate() returns LocalDate

Returns the minimum supported LocalDate (year -999999999-01-01).

Return Type

getMinDateTime

function getMinDateTime() returns LocalDateTime

Retrieves the minimum supported LocalDateTime (-999999999-01-01T00:00:00).

Return Type

getMinTime

function getMinTime() returns LocalTime

Retrieves the value of the public field MIN.

Return Type
  • LocalTime - The LocalTime value of the field.

getMonday

function getMonday() returns DayOfWeek

Returns the constant for Monday.

Return Type

getMonthOf

function getMonthOf(int month) returns Month|error

Obtains an instance of Month from an int value.

Parameters
  • month int - The month-of-year to represent, from 1 (January) to 12 (December).
Return Type
  • Month|error - Month|error — the month constant, or an error if month is outside the range 1-12.

getMonthValueOf

function getMonthValueOf(string name) returns Month|error

Returns the enum constant of this type with the specified name.

Parameters
  • name string - The name of the constant to return.
Return Type
  • Month|error - Month|error — the month constant, or an error if no month with the given name exists (e.g. misspelled).

getMonthValueOfEnum

function getMonthValueOfEnum(Class enumClass, string name) returns Enum|error

Returns the enum constant of the specified enum type with the specified name.

Parameters
  • enumClass Class - The Class object of the enum type.
  • name string - The name of the constant to return.
Return Type
  • Enum|error - Enum|error — the enum constant, or an error if no constant with the given name exists.

getMonthValues

function getMonthValues() returns Month[]|error

Returns an array containing the constants of this enum class, in the order they're declared.

Return Type
  • Month[]|error - Month[]|error — an array of all twelve Month constants, or an error if conversion fails.

getNoon

function getNoon() returns LocalTime

Retrieves the value of the public field NOON.

Return Type
  • LocalTime - The LocalTime value của the field.

getNovember

function getNovember() returns Month

Retrieves the constant representing the month of November.

Return Type
  • Month - The November month constant.

getOctober

function getOctober() returns Month

Retrieves the constant representing the month of October.

Return Type
  • Month - The October month constant.

getRfc1123DateTimeFormatter

function getRfc1123DateTimeFormatter() returns DateTimeFormatter

Obtains the RFC_1123_DATE_TIME formatter that formats or parses a date-time according to RFC 1123, such as "Wed, 22 Jul 2026 14:28:19 +0300".

Return Type

getSaturday

function getSaturday() returns DayOfWeek

Returns the constant for Saturday.

Return Type

getSeptember

function getSeptember() returns Month

Retrieves the constant representing the month of September.

Return Type
  • Month - The September month constant.

getSunday

function getSunday() returns DayOfWeek

Returns the constant for Sunday.

Return Type

getThursday

function getThursday() returns DayOfWeek

Returns the constant for Thursday.

Return Type

getTuesday

function getTuesday() returns DayOfWeek

Returns the constant for Tuesday.

Return Type

getWednesday

function getWednesday() returns DayOfWeek

Returns the constant for Wednesday.

Return Type

getWeekValues

function getWeekValues() returns DayOfWeek[]|error

Returns all seven DayOfWeek constants, in declaration order (MONDAY first).

Return Type
  • DayOfWeek[]|error - DayOfWeek[]|error — an array of all seven DayOfWeek constants, or an error if the underlying Java array conversion fails.

getZero

function getZero() returns Period

Retrieves the constant for a period of zero.

Return Type

ofDate

function ofDate(int year, int month, int day) returns LocalDate|error

Obtains a LocalDate from a year, month, and day.

Parameters
  • year int - The year.
  • month int - The month-of-year (1-12).
  • day int - The day-of-month (1-31).
Return Type
  • LocalDate|error - LocalDate|error — the constructed date, or an error if the date is invalid.

ofDateTime

function ofDateTime(int year, int month, int dayOfMonth, int hour, int minute) returns LocalDateTime|error

Obtains an instance of LocalDateTime from year, month, day, hour, and minute.

Parameters
  • year int - The year to represent.
  • month int - The month-of-year to represent (1-12).
  • dayOfMonth int - The day-of-month to represent (1-31).
  • hour int - The hour-of-day to represent (0-23).
  • minute int - The minute-of-hour to represent (0-59).
Return Type
  • LocalDateTime|error - LocalDateTime|error — the constructed date-time, or an error if the date-time is invalid.

ofDay

function ofDay(int dayOfWeek) returns DayOfWeek|error

Creates a DayOfWeek from an ISO-8601 numeric value.

Parameters
  • dayOfWeek int - The day-of-week value, from 1 (MONDAY) to 7 (SUNDAY).
Return Type
  • DayOfWeek|error - DayOfWeek|error — the corresponding DayOfWeek, or an error if the value is out of range.

ofDays

function ofDays(int days) returns Duration

Obtains a Duration representing a number of standard 24-hour days.

Parameters
  • days int - The number of days, positive or negative.
Return Type
  • Duration - The created Duration instance.

ofEnumValue

function ofEnumValue(Class enumClass, string name) returns Enum|error

Returns the enum constant of the specified enum type with the specified name.

Parameters
  • enumClass Class - The Class object of the enum type.
  • name string - The name of the constant to return.
Return Type
  • Enum|error - Enum|error — the enum constant, or an error if no constant with the given name exists.

ofEpochDay

function ofEpochDay(int epochDay) returns LocalDate|error

Obtains a LocalDate from the epoch day count.

Parameters
  • epochDay int - The number of days from the epoch of 1970-01-01.
Return Type
  • LocalDate|error - LocalDate|error — the constructed date, or an error if the resulting date is outside the supported range.

ofHours

function ofHours(int hours) returns Duration

Obtains a Duration representing a number of hours.

Parameters
  • hours int - The number of hours, positive or negative.
Return Type
  • Duration - The created Duration instance.

ofLocalDateWithLocalTime

function ofLocalDateWithLocalTime(LocalDate date, LocalTime time) returns LocalDateTime

Obtains an instance of LocalDateTime from a LocalDate and LocalTime.

Parameters
Return Type

ofLocalizedPattern

function ofLocalizedPattern(string text) returns DateTimeFormatter|error

Creates a formatter using the specified pattern template, such as "dd.MM.yyyy".

Parameters
  • text string - The pattern template to use, such as "dd.MM.yyyy".
Return Type

ofMillis

function ofMillis(int millis) returns Duration

Obtains a Duration representing a number of milliseconds.

Parameters
  • millis int - The number of milliseconds, positive or negative.
Return Type
  • Duration - The created Duration instance.

ofMinutes

function ofMinutes(int minutes) returns Duration

Obtains a Duration representing a number of minutes.

Parameters
  • minutes int - The number of minutes, positive or negative.
Return Type
  • Duration - The created Duration instance.

ofMonth

function ofMonth(int year, Month month, int day) returns LocalDate|error

Obtains a LocalDate from a year, month, and day.

Parameters
  • year int - The year.
  • month Month - The month enum.
  • day int - The day-of-month (1-31).
Return Type
  • LocalDate|error - LocalDate|error — the constructed date, or an error if the date is invalid.

ofMonthFull

function ofMonthFull(int year, Month month, int dayOfMonth, int hour, int minute) returns LocalDateTime|error

Obtains an instance of LocalDateTime from year, Month enum, day, hour, and minute.

Parameters
  • year int - The year to represent.
  • month Month - The Month enum.
  • dayOfMonth int - The day-of-month to represent (1-31).
  • hour int - The hour-of-day to represent (0-23).
  • minute int - The minute-of-hour to represent (0-59).
Return Type
  • LocalDateTime|error - LocalDateTime|error — the constructed date-time, or an error if the date-time is invalid.

ofMonthFullWithNano

function ofMonthFullWithNano(int year, Month month, int dayOfMonth, int hour, int minute, int second, int nanoOfSecond) returns LocalDateTime|error

Obtains an instance of LocalDateTime from year, Month enum, day, hour, minute, second, and nanosecond.

Parameters
  • year int - The year to represent.
  • month Month - The Month enum.
  • dayOfMonth int - The day-of-month to represent (1-31).
  • hour int - The hour-of-day to represent (0-23).
  • minute int - The minute-of-hour to represent (0-59).
  • second int - The second-of-minute to represent (0-59).
  • nanoOfSecond int - The nano-of-second to represent (0-999,999,999).
Return Type
  • LocalDateTime|error - LocalDateTime|error — the constructed date-time, or an error if the date-time is invalid.

ofMonthFullWithsecond

function ofMonthFullWithsecond(int year, Month month, int dayOfMonth, int hour, int minute, int second) returns LocalDateTime|error

Obtains an instance of LocalDateTime from year, Month enum, day, hour, minute, and second.

Parameters
  • year int - The year to represent.
  • month Month - The Month enum.
  • dayOfMonth int - The day-of-month to represent (1-31).
  • hour int - The hour-of-day to represent (0-23).
  • minute int - The minute-of-hour to represent (0-59).
  • second int - The second-of-minute to represent (0-59).
Return Type
  • LocalDateTime|error - LocalDateTime|error — the constructed date-time, or an error if the date-time is invalid.

ofNanoOfDay

function ofNanoOfDay(int nanoOfDay) returns LocalTime|error

Obtains an instance of LocalTime from a nanos-of-day value.

Parameters
  • nanoOfDay int - The nanos of day.
Return Type
  • LocalTime|error - LocalTime|error — the constructed time, or an error if nanoOfDay is negative or exceeds 86,399,999,999,999.

ofNanos

function ofNanos(int nanos) returns Duration

Obtains a Duration representing a number of nanoseconds.

Parameters
  • nanos int - The number of nanoseconds, positive or negative.
Return Type
  • Duration - The created Duration instance.

ofPattern

function ofPattern(string pattern) returns DateTimeFormatter|error

Creates a formatter using the specified pattern, such as "yyyy-MM-dd HH:mm:ss", "yyyy.MM.dd 'at' HH:mm:ss".

Parameters
  • pattern string - The pattern to use, such as "yyyy-MM-dd HH:mm:ss".
Return Type

ofPeriod

function ofPeriod(int years, int months, int days) returns Period

Obtains a Period representing a number of years, months, and days.

Parameters
  • years int - The amount of years, may be negative.
  • months int - The amount of months, may be negative.
  • days int - The amount of days, may be negative.
Return Type
  • Period - The period of years, months and days.

ofPeriodDays

function ofPeriodDays(int days) returns Period

Obtains a Period representing a number of days.

Parameters
  • days int - The number of days, may be negative.
Return Type
  • Period - A period with the specified number of days.

ofPeriodMonths

function ofPeriodMonths(int months) returns Period

Obtains a Period representing a number of months.

Parameters
  • months int - The number of months, may be negative.
Return Type
  • Period - A period with the specified number of months.

ofPeriodWeeks

function ofPeriodWeeks(int weeks) returns Period

Obtains a Period representing a number of weeks.

Parameters
  • weeks int - The number of weeks, may be negative.
Return Type
  • Period - A period with the specified number of weeks.

ofPeriodYears

function ofPeriodYears(int years) returns Period

Obtains a Period representing a number of years.

Parameters
  • years int - The number of years, may be negative.
Return Type
  • Period - A period with the specified number of years.

ofSecondOfDay

function ofSecondOfDay(int secondOfDay) returns LocalTime|error

Obtains an instance of LocalTime from a second-of-day value.

Parameters
  • secondOfDay int - The second of day.
Return Type
  • LocalTime|error - LocalTime|error — the constructed time, or an error if secondOfDay is negative or exceeds 86,399.

ofSeconds

function ofSeconds(int seconds) returns Duration

Obtains a Duration representing a number of seconds.

Parameters
  • seconds int - The number of seconds, positive or negative.
Return Type
  • Duration - The created Duration instance.

ofSecondsWithNanos

function ofSecondsWithNanos(int seconds, int nanoAdjustment) returns Duration

Obtains a Duration representing a number of seconds and an adjustment in nanoseconds.

Parameters
  • seconds int - The number of seconds, positive or negative.
  • nanoAdjustment int - The nanosecond adjustment, from -999,999,999 to +999,999,999.
Return Type
  • Duration - The created Duration instance.

ofTime

function ofTime(int hour, int minute) returns LocalTime|error

Obtains an instance of LocalTime from an hour and minute.

Parameters
  • hour int - The hour-of-day to represent.
  • minute int - The minute-of-hour to represent.
Return Type
  • LocalTime|error - LocalTime|error — the constructed time, or an error if hour or minute is out of range.

ofTimeWithSecond

function ofTimeWithSecond(int hour, int minute, int second) returns LocalTime|error

Obtains an instance of LocalTime from an hour, minute and second.

Parameters
  • hour int - The hour-of-day to represent.
  • minute int - The minute-of-hour to represent.
  • second int - The second-of-minute to represent.
Return Type
  • LocalTime|error - LocalTime|error — the constructed time, or an error if any parameter is out of range.

ofTimeWithSecondNano

function ofTimeWithSecondNano(int hour, int minute, int second, int nanoOfSecond) returns LocalTime|error

Obtains an instance of LocalTime from an hour, minute, second and nanosecond.

Parameters
  • hour int - The hour-of-day.
  • minute int - The minute-of-hour.
  • second int - The second-of-minute.
  • nanoOfSecond int - The nano-of-second.
Return Type
  • LocalTime|error - LocalTime|error — the constructed time, or an error if any parameter is out of range.

ofWithNanos

function ofWithNanos(int year, int month, int dayOfMonth, int hour, int minute, int second, int nanoOfSecond) returns LocalDateTime|error

Obtains an instance of LocalDateTime from year, month, day, hour, minute, second, and nanosecond.

Parameters
  • year int - The year to represent.
  • month int - The month-of-year to represent (1-12).
  • dayOfMonth int - The day-of-month to represent (1-31).
  • hour int - The hour-of-day to represent (0-23).
  • minute int - The minute-of-hour to represent (0-59).
  • second int - The second-of-minute to represent (0-59).
  • nanoOfSecond int - The nano-of-second to represent (0-999,999,999).
Return Type
  • LocalDateTime|error - LocalDateTime|error — the constructed date-time, or an error if the date-time is invalid.

ofWithSeconds

function ofWithSeconds(int year, int month, int dayOfMonth, int hour, int minute, int second) returns LocalDateTime|error

Obtains an instance of LocalDateTime from year, month, day, hour, minute, and second.

Parameters
  • year int - The year to represent.
  • month int - The month-of-year to represent (1-12).
  • dayOfMonth int - The day-of-month to represent (1-31).
  • hour int - The hour-of-day to represent (0-23).
  • minute int - The minute-of-hour to represent (0-59).
  • second int - The second-of-minute to represent (0-59).
Return Type
  • LocalDateTime|error - LocalDateTime|error — the constructed date-time, or an error if the date-time is invalid.

ofYearDay

function ofYearDay(int year, int dayOfYear) returns LocalDate|error

Obtains a LocalDate from a year and day-of-year.

Parameters
  • year int - The year to represent.
  • dayOfYear int - The day-of-year to represent (1-366).
Return Type
  • LocalDate|error - LocalDate|error — the constructed date, or an error if dayOfYear exceeds the length of the year.

parse

function parse(string text) returns LocalDate|error

Parses a string to a LocalDate using the ISO-8601 formatter.

Parameters
  • text string - The text to parse, such as "2026-07-15".
Return Type
  • LocalDate|error - LocalDate|error — the constructed date, or an error if the date is invalid.

parseDuration

function parseDuration(string text) returns Duration

Obtains a Duration from a text string such as PT20.345S (ISO-8601 format).

Parameters
  • text string - The text string to parse, not null.
Return Type
  • Duration - The parsed Duration instance.

parseFormatter

function parseFormatter(string text, DateTimeFormatter formatter) returns LocalDateTime|error

Parses a text string to a LocalDateTime using a specific formatter.

Parameters
  • text string - The text to parse.
Return Type
  • LocalDateTime|error - LocalDateTime|error — the constructed date-time, or an error if the date-time is invalid.

parsePeriod

function parsePeriod(string text) returns Period|error

Obtains a Period from a text string such as PnYnMnD.

Parameters
  • text string - The text to parse, not null.
Return Type
  • Period|error - Period|error — the parsed period, or an error if the text is invalid.

parseText

function parseText(string text) returns LocalTime|error

Obtains an instance of LocalTime from a text string, such as "14:28:19".

Parameters
  • text string - The text to parse.
Return Type
  • LocalTime|error - LocalTime|error — the constructed local time, or an error if the time is invalid.

parseTextWithFormatter

function parseTextWithFormatter(string text, DateTimeFormatter formatter) returns LocalTime|error

Obtains an instance of LocalTime from a text string using a specific formatter.

Parameters
  • text string - The text to parse.
Return Type
  • LocalTime|error - LocalTime|error — the constructed local time, or an error if the time is invalid.

parseWithFormatter

function parseWithFormatter(string text, DateTimeFormatter formatter) returns LocalDate|error

Parses a string to a LocalDate using a specific formatter.

Parameters
  • text string - The text to parse.
Return Type
  • LocalDate|error - LocalDate|error — the constructed date, or an error if the date is invalid.

parseWithText

function parseWithText(string text) returns LocalDateTime|error

Parses a text string to a LocalDateTime using the default ISO_LOCAL_DATE_TIME formatter, such as "2026-07-22T14:28:19".

Parameters
  • text string - The text to parse.
Return Type
  • LocalDateTime|error - LocalDateTime|error — the constructed date-time, or an error if the date-time is invalid.

valueOf

function valueOf(Class enumClass, string name) returns Enum|error

Returns the enum constant of the specified enum type with the specified name. This is the generic Enum.valueOf(Class, String) form.

Parameters
  • enumClass Class - The Class object of the enum type.
  • name string - The name of the constant to return.
Return Type
  • Enum|error - Enum|error — the enum constant, or an error if no constant with the given name exists.

valueOfDayName

function valueOfDayName(string name) returns DayOfWeek|error

Returns the DayOfWeek constant with the specified name (e.g. "MONDAY"). Panics if no constant with that name exists.

Parameters
  • name string - The name of the constant to return.
Return Type
  • DayOfWeek|error - DayOfWeek|error — the corresponding DayOfWeek, or an error if no constant with that name exists.

Classes

java_time_utils: Appendable

Ballerina class mapping for the Java java.lang.Appendable interface.

Constructor

The init function of the Ballerina class mapping the java.lang.Appendable Java interface.

init (handle obj)
  • obj handle - The handle value containing the Java reference of the object.

toString

function toString() returns string

The function to retrieve the string representation of the Ballerina class mapping the java.lang.Appendable Java interface.

Return Type
  • string - The string form of the Java object instance.
Fields
  • jObj handle
  • jObj handle - The handle field that stores the reference to the java.lang.Appendable object.

java_time_utils: CharSequence

Ballerina class mapping for the Java java.lang.CharSequence interface.

Fields
  • jObj handle
  • jObj handle - The handle field that stores the reference to the java.lang.CharSequence object.

java_time_utils: ChronoLocalDate

Ballerina class mapping for the Java java.time.chrono.ChronoLocalDate interface.

Constructor

The init function of the Ballerina class mapping the java.time.chrono.ChronoLocalDate Java interface.

init (handle obj)
  • obj handle - The handle value containing the Java reference of the object.

toString

function toString() returns string

The function to retrieve the string representation of the Ballerina class mapping the java.time.chrono.ChronoLocalDate Java interface.

Return Type
  • string - The string form of the Java object instance.
Fields
  • jObj handle
  • jObj handle - The handle field that stores the reference to the java.time.chrono.ChronoLocalDate object.

java_time_utils: ChronoLocalDateTime

Ballerina class mapping for the Java java.time.chrono.ChronoLocalDateTime interface.

Constructor

The init function of the Ballerina class mapping the java.time.chrono.ChronoLocalDateTime Java interface.

init (handle obj)
  • obj handle - The handle value containing the Java reference of the object.

toString

function toString() returns string

The function to retrieve the string representation of the Ballerina class mapping the java.time.chrono.ChronoLocalDateTime Java interface.

Return Type
  • string - The string form of the Java object instance.
Fields
  • jObj handle
  • jObj handle - The handle field that stores the reference to the java.time.chrono.ChronoLocalDateTime object.

java_time_utils: Chronology

Ballerina class mapping for the Java java.time.chrono.Chronology interface.

Constructor

The init function of the Ballerina class mapping the java.time.chrono.Chronology Java interface.

init (handle obj)
  • obj handle - The handle value containing the Java reference of the object.

toString

function toString() returns string

The function to retrieve the string representation of the Ballerina class mapping the java.time.chrono.Chronology Java interface.

Return Type
  • string - The string form of the Java object instance.
Fields
  • jObj handle
  • jObj handle - The handle field that stores the reference to the java.time.chrono.Chronology object.

java_time_utils: Class

Ballerina class mapping for the Java java.lang.Class class.

Constructor

The init function of the Ballerina class mapping the java.lang.Class Java class.

init (handle obj)
  • obj handle - The handle value containing the Java reference of the object.

toString

function toString() returns string

The function to retrieve the string representation of the Ballerina class mapping the java.lang.Class Java class.

Return Type
  • string - The string form of the Java object instance.
Fields
  • jObj handle
  • jObj handle - The handle field that stores the reference to the java.lang.Class object.

java_time_utils: Clock

Ballerina class mapping for the Java java.time.Clock class.

Constructor

The init function of the Ballerina class mapping the java.time.Clock Java class.

init (handle obj)
  • obj handle - The handle value containing the Java reference of the object.

toString

function toString() returns string

The function to retrieve the string representation of the Ballerina class mapping the java.time.Clock Java class.

Return Type
  • string - The string form of the Java object instance.
Fields
  • jObj handle
  • jObj handle - The handle field that stores the reference to the java.time.Clock object.

java_time_utils: DateTimeFormatter

Ballerina class mapping for the Java java.time.format.DateTimeFormatter class.

Constructor

The init function of the Ballerina class mapping the java.time.format.DateTimeFormatter Java class.

init (handle obj)
  • obj handle - The handle value containing the Java reference of the object.

toString

function toString() returns string

The function to retrieve the string representation of the Ballerina class mapping the java.time.format.DateTimeFormatter Java class.

Return Type
  • string - The string form of the Java object instance.

isEquals

function isEquals(Object arg0) returns boolean

The function that maps to the equals method of java.time.format.DateTimeFormatter.

Parameters
  • arg0 Object - The Object value required to map with the Java method parameter.
Return Type
  • boolean - The boolean value returning from the Java mapping.

getClass

function getClass() returns Class

The function that maps to the getClass method of java.time.format.DateTimeFormatter.

Return Type
  • Class - The Class value returning from the Java mapping.

hashCode

function hashCode() returns int

The function that maps to the hashCode method of java.time.format.DateTimeFormatter.

Return Type
  • int - The int value returning from the Java mapping.

notify

function notify()

The function that maps to the notify method of java.time.format.DateTimeFormatter.

notifyAll

function notifyAll()

The function that maps to the notifyAll method of java.time.format.DateTimeFormatter.

doWait

function doWait() returns InterruptedException?

The function that maps to the wait method of java.time.format.DateTimeFormatter.

Return Type

waitWithTimeout

function waitWithTimeout(int arg0) returns InterruptedException?

The function that maps to the wait method of java.time.format.DateTimeFormatter.

Parameters
  • arg0 int - The int value required to map with the Java method parameter.
Return Type

waitWithTimeoutAndNanos

function waitWithTimeoutAndNanos(int arg0, int arg1) returns InterruptedException?

The function that maps to the wait method of java.time.format.DateTimeFormatter.

Parameters
  • arg0 int - The int value required to map with the Java method parameter.
  • arg1 int - The int value required to map with the Java method parameter.
Return Type
Fields
  • jObj handle
  • jObj handle
  • jObj handle - The handle field that stores the reference to the java.time.format.DateTimeFormatter object.

java_time_utils: DayOfWeek

Ballerina class mapping for the Java java.time.DayOfWeek class.

DayOfWeek is an enum representing the seven days of the week (MONDAY through SUNDAY). It is returned by LocalDate.getDayOfWeek() and LocalDateTime.getDayOfWeek().

Constructor

Initializes the DayOfWeek wrapper.

init (handle obj)
  • obj handle - The handle value containing the Java reference.

describeConstable

function describeConstable() returns Optional

Returns an optional descriptor of this enum constant for use with nominal descriptors (Java's Constable mechanism).

Method included from *Enum

toString

function toString() returns string

Returns the string representation of this day-of-week (e.g. "MONDAY").

Return Type
  • string - The string form of the day-of-week.

compareTo

function compareTo(Enum other) returns int

Compares this day-of-week to another enum constant by ordinal position.

Parameters
  • other Enum - The enum constant to compare against.
Return Type
  • int - Negative, zero, or positive if this constant is declared before, at the same position as, or after other.

isEquals

function isEquals(Object other) returns boolean

Checks whether this day-of-week is equal to another object. Returns false rather than panicking if other is not a DayOfWeek.

Parameters
  • other Object - The object to compare against.
Return Type
  • boolean - True if equal, false otherwise.

getClass

function getClass() returns Class

Returns the runtime class of this object.

Return Type
  • Class - The Class object representing the runtime class.

getDeclaringClass

function getDeclaringClass() returns Class

Returns the Class object corresponding to this enum constant's enum type.

Return Type
  • Class - The Class of the enum type.

getValue

function getValue() returns int

Returns the ISO-8601 numeric value of this day-of-week.

Return Type
  • int - The day-of-week value, from 1 (MONDAY) to 7 (SUNDAY).

hashCode

function hashCode() returns int

Returns the hash code for this day-of-week.

Return Type
  • int - The hash code.

minusDays

function minusDays(int days) returns DayOfWeek

Returns the day-of-week that results from subtracting the specified number of days from this one, cycling through the week.

Parameters
  • days int - The number of days to subtract; may be negative.
Return Type

name

function name() returns string

Returns the name of this enum constant exactly as declared (e.g. "MONDAY").

Return Type
  • string - The declared name of this constant.

notify

function notify()

Wakes up a single thread that is waiting on this object's monitor.

WARNING: This is a low-level Java synchronization method. Avoid using it in business logic.

notifyAll

function notifyAll()

Wakes up all threads that are waiting on this object's monitor.

WARNING: This is a low-level Java synchronization method. Avoid using it in business logic.

ordinal

function ordinal() returns int

Returns the position of this constant in its enum declaration, where the first constant has an ordinal of zero (MONDAY = 0, ..., SUNDAY = 6).

Return Type
  • int - The ordinal of this constant.

plusDays

function plusDays(int days) returns DayOfWeek

Returns the day-of-week that results from adding the specified number of days to this one, cycling through the week.

Parameters
  • days int - The number of days to add; may be negative.
Return Type

doWait

function doWait() returns InterruptedException?

Causes the current thread to wait until notified.

WARNING: Low-level Java synchronization method. Use with caution.

Return Type

waitWithTimeout

function waitWithTimeout(int timeoutMillis) returns InterruptedException?

Causes the current thread to wait until notified or the specified time elapses.

WARNING: Low-level Java synchronization method. Use with caution.

Parameters
  • timeoutMillis int - The maximum time to wait, in milliseconds.
Return Type

waitWithTimeoutAndNanos

function waitWithTimeoutAndNanos(int timeoutMillis, int nanos) returns InterruptedException?

Causes the current thread to wait until notified, with the specified timeout.

WARNING: Low-level Java synchronization method. Use with caution.

Parameters
  • timeoutMillis int - The maximum time to wait, in milliseconds.
  • nanos int - Additional nanoseconds to wait.
Return Type
Fields
  • jObj handle
  • Fields Included from *Enum
  • jObj handle
  • jObj handle - The handle to the underlying Java object.

java_time_utils: DecimalStyle

Ballerina class mapping for the Java java.time.format.DecimalStyle class.

Constructor

The init function of the Ballerina class mapping the java.time.format.DecimalStyle Java class.

init (handle obj)
  • obj handle - The handle value containing the Java reference of the object.

toString

function toString() returns string

The function to retrieve the string representation of the Ballerina class mapping the java.time.format.DecimalStyle Java class.

Return Type
  • string - The string form of the Java object instance.
Fields
  • jObj handle
  • jObj handle - The handle field that stores the reference to the java.time.format.DecimalStyle object.

java_time_utils: Duration

Ballerina class mapping for the Java java.time.Duration class.

Constructor

Initializes the Ballerina wrapper with a Java reference.

init (handle obj)
  • obj handle - The handle value containing the Java reference.

toString

function toString() returns string

Returns the string representation of the duration.

Return Type
  • string - The string form of the duration instance.

abs

function abs() returns Duration

Returns a copy of this duration with a positive length.

Return Type
  • Duration - A duration with a positive length.

compareTo

function compareTo(Duration other) returns int

Compares this duration to another duration.

Parameters
  • other Duration - The other duration to compare with.
Return Type
  • int - Negative, zero, or positive as this duration is less than, equal to, or greater than the other.

dividedByDuration

function dividedByDuration(Duration other) returns int

Divides this duration by another duration.

Parameters
  • other Duration - The other duration to divide by.
Return Type
  • int - The ratio of the durations as an integer.

dividedBy

function dividedBy(int divisor) returns Duration

Divides this duration by the specified value.

Parameters
  • divisor int - The value to divide by.
Return Type
  • Duration - A duration-representing the result of the division.

isEquals

function isEquals(Object other) returns boolean

Checks if this duration is equal to another object.

Parameters
  • other Object - The object to check equality with.
Return Type
  • boolean - True if this duration is equal to the other object, false otherwise.

getClass

function getClass() returns Class

Gets the runtime class of this duration.

Return Type
  • Class - The Class object representing the runtime class.

getNano

function getNano() returns int

Gets the number of nanoseconds in the second-based part of this duration.

Return Type
  • int - The number of nanoseconds, from 0 to 999,999,999.

getSeconds

function getSeconds() returns int

Gets the number of seconds in this duration.

Return Type
  • int - The whole seconds part of the duration.

hashCode

function hashCode() returns int

Returns a hash code for this duration.

Return Type
  • int - A suitable hash code value.

isNegative

function isNegative() returns boolean

Checks if this duration is negative, excluding zero.

Return Type
  • boolean - True if this duration has a total length less than zero, false otherwise.

isPositive

function isPositive() returns boolean

Checks if this duration is positive, excluding zero.

Return Type
  • boolean - True if this duration has a total length greater than zero, false otherwise.

isZero

function isZero() returns boolean

Checks if this duration is zero length.

Return Type
  • boolean - True if this duration has a total length of zero, false otherwise.

minus

function minus(Duration other) returns Duration

Returns a copy of this duration with the specified duration subtracted.

Parameters
  • other Duration - The duration to subtract, not null.
Return Type
  • Duration - A duration based on this duration with the specified duration subtracted.

minusDays

function minusDays(int days) returns Duration

Returns a copy of this duration with the specified number of days subtracted.

Parameters
  • days int - The days to subtract, positive or negative.
Return Type
  • Duration - A duration based on this duration with the specified days subtracted.

minusHours

function minusHours(int hours) returns Duration

Returns a copy of this duration with the specified number of hours subtracted.

Parameters
  • hours int - The hours to subtract, positive or negative.
Return Type
  • Duration - A duration based on this duration with the specified hours subtracted.

minusMillis

function minusMillis(int millis) returns Duration

Returns a copy of this duration with the specified number of milliseconds subtracted.

Parameters
  • millis int - The milliseconds to subtract, positive or negative.
Return Type
  • Duration - A duration based on this duration with the specified milliseconds subtracted.

minusMinutes

function minusMinutes(int minutes) returns Duration

Returns a copy of this duration with the specified number of minutes subtracted.

Parameters
  • minutes int - The minutes to subtract, positive or negative.
Return Type
  • Duration - A duration based on this duration with the specified minutes subtracted.

minusNanos

function minusNanos(int nanos) returns Duration

Returns a copy of this duration with the specified number of nanoseconds subtracted.

Parameters
  • nanos int - The nanoseconds to subtract, positive or negative.
Return Type
  • Duration - A duration based on this duration with the specified nanoseconds subtracted.

minusSeconds

function minusSeconds(int seconds) returns Duration

Returns a copy of this duration with the specified number of seconds subtracted.

Parameters
  • seconds int - The seconds to subtract, positive or negative.
Return Type
  • Duration - A duration based on this duration with the specified seconds subtracted.

multipliedBy

function multipliedBy(int multiplier) returns Duration

Returns a copy of this duration multiplied by the specified scalar.

Parameters
  • multiplier int - The value to multiply by, positive or negative.
Return Type
  • Duration - A duration based on this duration multiplied by the scalar.

negated

function negated() returns Duration

Returns a copy of this duration with the length negated.

Return Type
  • Duration - A duration based on this duration with the amount negated.

notify

function notify()

Wakes up a single thread that is waiting on this object's monitor.

notifyAll

function notifyAll()

Wakes up all threads that are waiting on this object's monitor.

plus

function plus(Duration other) returns Duration

Returns a copy of this duration with the specified duration added.

Parameters
  • other Duration - The duration to add, not null.
Return Type
  • Duration - A duration based on this duration with the specified duration added.

plusDays

function plusDays(int days) returns Duration

Returns a copy of this duration with the specified number of days added.

Parameters
  • days int - The days to add, positive or negative.
Return Type
  • Duration - A duration based on this duration with the specified days added.

plusHours

function plusHours(int hours) returns Duration

Returns a copy of this duration with the specified number of hours added.

Parameters
  • hours int - The hours to add, positive or negative.
Return Type
  • Duration - A duration based on this duration with the specified hours added.

plusMillis

function plusMillis(int millis) returns Duration

Returns a copy of this duration with the specified number of milliseconds added.

Parameters
  • millis int - The milliseconds to add, positive or negative.
Return Type
  • Duration - A duration based on this duration with the specified milliseconds added.

plusMinutes

function plusMinutes(int minutes) returns Duration

Returns a copy of this duration with the specified number of minutes added.

Parameters
  • minutes int - The minutes to add, positive or negative.
Return Type
  • Duration - A duration based on this duration with the specified minutes added.

plusNanos

function plusNanos(int nanos) returns Duration

Returns a copy of this duration with the specified number of nanoseconds added.

Parameters
  • nanos int - The nanoseconds to add, positive or negative.
Return Type
  • Duration - A duration based on this duration with the specified nanoseconds added.

plusSeconds

function plusSeconds(int seconds) returns Duration

Returns a copy of this duration with the specified number of seconds added.

Parameters
  • seconds int - The seconds to add, positive or negative.
Return Type
  • Duration - A duration based on this duration with the specified seconds added.

toDays

function toDays() returns int

Gets the number of days in this duration.

Return Type
  • int - The total number of days in the duration.

toDaysPart

function toDaysPart() returns int

Extracts the number of days in this duration.

Return Type
  • int - The number of days part, after dividing out the hours, minutes and seconds.

toHours

function toHours() returns int

Gets the number of hours in this duration.

Return Type
  • int - The total number of hours in the duration.

toHoursPart

function toHoursPart() returns int

Extracts the number of hours part in this duration.

Return Type
  • int - The number of hours part, in the range 0 to 23.

toMillis

function toMillis() returns int

Gets the number of milliseconds in this duration.

Return Type
  • int - The total number of milliseconds in the duration.

toMillisPart

function toMillisPart() returns int

Extracts the number of milliseconds part in this duration.

Return Type
  • int - The number of milliseconds part, in the range 0 to 999.

toMinutes

function toMinutes() returns int

Gets the number of minutes in this duration.

Return Type
  • int - The total number of minutes in the duration.

toMinutesPart

function toMinutesPart() returns int

Extracts the number of minutes part in this duration.

Return Type
  • int - The number of minutes part, in the range 0 to 59.

toNanos

function toNanos() returns int

Gets the total number of nanoseconds in this duration.

Return Type
  • int - The total number of nanoseconds in the duration.

toNanosPart

function toNanosPart() returns int

Extracts the number of nanoseconds part in this duration.

Return Type
  • int - The number of nanoseconds part, in the range 0 to 999,999,999.

toSeconds

function toSeconds() returns int

Gets the number of seconds in this duration.

Return Type
  • int - The total number of seconds in the duration.

toSecondsPart

function toSecondsPart() returns int

Extracts the number of seconds part in this duration.

Return Type
  • int - The number of seconds part, in the range 0 to 59.

doWait

function doWait() returns InterruptedException?

Causes the current thread to wait until another thread invokes the notify() or notifyAll() methods for this object.

Return Type
  • InterruptedException? - An InterruptedException if the thread was interrupted while waiting, or nil otherwise.

waitWithTimeout

function waitWithTimeout(int millis) returns InterruptedException?

Causes the current thread to wait until another thread invokes notify() or notifyAll() for this object, or a certain amount of real time has elapsed.

Parameters
  • millis int - The maximum time to wait in milliseconds.
Return Type
  • InterruptedException? - An InterruptedException if the thread was interrupted while waiting, or nil otherwise.

waitWithTimeoutAndNanos

function waitWithTimeoutAndNanos(int millis, int nanos) returns InterruptedException?

Causes the current thread to wait until another thread invokes notify() or notifyAll() for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed.

Parameters
  • millis int - The maximum time to wait in milliseconds.
  • nanos int - Additional nanoseconds, in the range 0-999,999.
Return Type
  • InterruptedException? - An InterruptedException if the thread was interrupted while waiting, or nil otherwise.

withNanos

function withNanos(int nanos) returns Duration

Returns a copy of this duration with the specified number of nanoseconds.

Parameters
  • nanos int - The number of nanoseconds to represent, from 0 to 999,999,999.
Return Type
  • Duration - A duration based on this duration with the requested nanoseconds.

withSeconds

function withSeconds(int seconds) returns Duration

Returns a copy of this duration with the specified number of seconds.

Parameters
  • seconds int - The number of seconds, positive or negative.
Return Type
  • Duration - A duration based on this duration with the requested seconds.
Fields
  • jObj handle
  • jObj handle
  • jObj handle - The underlying Java object reference.

java_time_utils: Enum

Ballerina class mapping for the Java java.lang.Enum class.

Enum is the common base type for all Java enum classes. In this library, DayOfWeek and Month both extend it, giving access to shared enum behavior (ordinal, name, compareTo, etc.) without duplicating it in each concrete enum wrapper.

Constructor

Initializes the Enum wrapper.

init (handle obj)
  • obj handle - The handle value containing the Java reference.

toString

function toString() returns string

Returns the string representation of this enum constant (its declared name).

Return Type
  • string - The string form of the constant.

compareTo

function compareTo(Enum other) returns int

Compares this enum constant to another by declaration (ordinal) order. Only meaningful when both constants belong to the same enum type.

Parameters
  • other Enum - The enum constant to compare against.
Return Type
  • int - Negative, zero, or positive if this constant is declared before, at the same position as, or after other.

isEquals

function isEquals(Object other) returns boolean

Checks whether this enum constant is equal to another object. Enum constants are only ever equal to themselves (reference equality), so this returns false for any object that isn't this exact constant.

Parameters
  • other Object - The object to compare against.
Return Type
  • boolean - True if equal, false otherwise.

getClass

function getClass() returns Class

Returns the runtime class of this object.

Return Type
  • Class - The Class object representing the runtime class.

getDeclaringClass

function getDeclaringClass() returns Class

Returns the Class object corresponding to this enum constant's actual enum type (useful when the constant belongs to an enum with constant-specific method bodies).

Return Type
  • Class - The Class of the enum type.

hashCode

function hashCode() returns int

Returns the hash code for this enum constant.

Return Type
  • int - The hash code.

name

function name() returns string

Returns the name of this enum constant exactly as declared in its enum type (e.g. "MONDAY", "JANUARY").

Return Type
  • string - The declared name of this constant.

notify

function notify()

Wakes up a single thread that is waiting on this object's monitor.

WARNING: This is a low-level Java synchronization method. Avoid using it in business logic.

notifyAll

function notifyAll()

Wakes up all threads that are waiting on this object's monitor.

WARNING: This is a low-level Java synchronization method. Avoid using it in business logic.

ordinal

function ordinal() returns int

Returns the position of this constant in its enum declaration, where the first constant has an ordinal of zero.

Return Type
  • int - The ordinal of this constant.

doWait

function doWait() returns InterruptedException?

Causes the current thread to wait until notified.

WARNING: Low-level Java synchronization method. Use with caution.

Return Type

waitWithTimeout

function waitWithTimeout(int timeoutMillis) returns InterruptedException?

Causes the current thread to wait until notified or the specified time elapses.

WARNING: Low-level Java synchronization method. Use with caution.

Parameters
  • timeoutMillis int - The maximum time to wait, in milliseconds.
Return Type

waitWithTimeoutAndNanos

function waitWithTimeoutAndNanos(int timeoutMillis, int nanos) returns InterruptedException?

Causes the current thread to wait until notified, with the specified timeout.

WARNING: Low-level Java synchronization method. Use with caution.

Parameters
  • timeoutMillis int - The maximum time to wait, in milliseconds.
  • nanos int - Additional nanoseconds to wait.
Return Type
Fields
  • jObj handle
  • jObj handle
  • jObj handle - The handle to the underlying Java object.

java_time_utils: Format

Ballerina class mapping for the Java java.text.Format class.

Constructor

The init function of the Ballerina class mapping the java.text.Format Java class.

init (handle obj)
  • obj handle - The handle value containing the Java reference of the object.

toString

function toString() returns string

The function to retrieve the string representation of the Ballerina class mapping the java.text.Format Java class.

Return Type
  • string - The string form of the Java object instance.
Fields
  • jObj handle
  • jObj handle - The handle field that stores the reference to the java.text.Format object.

java_time_utils: FormatStyle

Ballerina class mapping for the Java java.time.format.FormatStyle class.

Constructor

The init function of the Ballerina class mapping the java.time.format.FormatStyle Java class.

init (handle obj)
  • obj handle - The handle value containing the Java reference of the object.

toString

function toString() returns string

The function to retrieve the string representation of the Ballerina class mapping the java.time.format.FormatStyle Java class.

Return Type
  • string - The string form of the Java object instance.
Fields
  • jObj handle
  • jObj handle - The handle field that stores the reference to the java.time.format.FormatStyle object.

java_time_utils: Instant

Ballerina class mapping for the Java java.time.Instant class.

Constructor

The init function of the Ballerina class mapping the java.time.Instant Java class.

init (handle obj)
  • obj handle - The handle value containing the Java reference of the object.

toString

function toString() returns string

The function to retrieve the string representation of the Ballerina class mapping the java.time.Instant Java class.

Return Type
  • string - The string form of the Java object instance.
Fields
  • jObj handle
  • jObj handle - The handle field that stores the reference to the java.time.Instant object.

java_time_utils: IntStream

Ballerina class mapping for the Java java.util.stream.IntStream interface.

Constructor

The init function of the Ballerina class mapping the java.util.stream.IntStream Java interface.

init (handle obj)
  • obj handle - The handle value containing the Java reference of the object.

toString

function toString() returns string

The function to retrieve the string representation of the Ballerina class mapping the java.util.stream.IntStream Java interface.

Return Type
  • string - The string form of the Java object instance.
Fields
  • jObj handle
  • jObj handle - The handle field that stores the reference to the java.util.stream.IntStream object.

java_time_utils: IsoChronology

Ballerina class mapping for the Java java.time.chrono.IsoChronology class.

Constructor

The init function of the Ballerina class mapping the java.time.chrono.IsoChronology Java class.

init (handle obj)
  • obj handle - The handle value containing the Java reference of the object.

toString

function toString() returns string

The function to retrieve the string representation of the Ballerina class mapping the java.time.chrono.IsoChronology Java class.

Return Type
  • string - The string form of the Java object instance.
Fields
  • jObj handle
  • jObj handle - The handle field that stores the reference to the java.time.chrono.IsoChronology object.

java_time_utils: IsoEra

Ballerina class mapping for the Java java.time.chrono.IsoEra class.

Constructor

The init function of the Ballerina class mapping the java.time.chrono.IsoEra Java class.

init (handle obj)
  • obj handle - The handle value containing the Java reference of the object.

toString

function toString() returns string

The function to retrieve the string representation of the Ballerina class mapping the java.time.chrono.IsoEra Java class.

Return Type
  • string - The string form of the Java object instance.
Fields
  • jObj handle
  • jObj handle - The handle field that stores the reference to the java.time.chrono.IsoEra object.

java_time_utils: List

Ballerina class mapping for the Java java.util.List interface.

Constructor

The init function of the Ballerina class mapping the java.util.List Java interface.

init (handle obj)
  • obj handle - The handle value containing the Java reference of the object.

toString

function toString() returns string

The function to retrieve the string representation of the Ballerina class mapping the java.util.List Java interface.

Return Type
  • string - The string form of the Java object instance.
Fields
  • jObj handle
  • jObj handle - The handle field that stores the reference to the java.util.List object.

java_time_utils: LocalDate

Represents a date without a time-zone in the ISO-8601 calendar system, such as 2026-07-15.

Constructor

Initializes the LocalDate wrapper.

init (handle obj)
  • obj handle - The handle value containing the Java reference.

toString

function toString() returns string

Returns the string representation of this date in ISO-8601 format.

Return Type
  • string - The string form (e.g., "2026-07-15").

atStartOfDay

function atStartOfDay() returns LocalDateTime

Returns a LocalDateTime formed from this date at the start of the day (00:00).

Return Type

atTime

function atTime(int hour, int minute) returns LocalDateTime

Combines this date with the specified time to create a LocalDateTime.

Parameters
  • hour int - The hour (0-23).
  • minute int - The minute (0-59).
Return Type

atTimeDetailed

function atTimeDetailed(int hour, int minute, int second) returns LocalDateTime

Combines this date with the specified time (hours, minutes, seconds) to create a LocalDateTime.

Parameters
  • hour int - The hour (0-23).
  • minute int - The minute (0-59).
  • second int - The second (0-59).
Return Type

atTimeFull

function atTimeFull(int hour, int minute, int second, int nano) returns LocalDateTime

Combines this date with the specified time (hours, minutes, seconds, nanos) to create a LocalDateTime.

Parameters
  • hour int - The hour.
  • minute int - The minute.
  • second int - The second.
  • nano int - The nanosecond.
Return Type

atLocalTime

function atLocalTime(LocalTime time) returns LocalDateTime

Combines this date with the specified LocalTime to create a LocalDateTime.

Parameters
  • time LocalTime - The LocalTime to combine with this date.
Return Type

isEquals

function isEquals(Object other) returns boolean

Checks if this date is equal to another object.

Parameters
  • other Object - The object to check equality with.
Return Type
  • boolean - True if equal, false otherwise.

getClass

function getClass() returns Class

Returns the class of this object.

Return Type
  • Class - The Java class instance.

getDayOfMonth

function getDayOfMonth() returns int

Returns the day-of-month.

Return Type
  • int - The day-of-month, from 1 to 31.

getDayOfWeek

function getDayOfWeek() returns DayOfWeek

Returns the day-of-week.

Return Type

getDayOfYear

function getDayOfYear() returns int

Returns the day-of-year.

Return Type
  • int - The day-of-year, from 1 to 365 or 366.

getEra

function getEra() returns IsoEra

Returns the era.

Return Type

getMonth

function getMonth() returns Month

Returns the month-of-year.

Return Type

getMonthValue

function getMonthValue() returns int

Returns the month-of-year value (1-12).

Return Type
  • int - The month-of-year.

getYear

function getYear() returns int

Returns the year.

Return Type
  • int - The year.

hashCode

function hashCode() returns int

Returns the hash code for this date.

Return Type
  • int - The hash code.

isAfter

function isAfter(LocalDate|LocalDateTime other) returns boolean

Checks if this date is after the specified date. If a LocalDateTime is given, only its date part (year, month, day) is compared — the time component is ignored.

Parameters
Return Type
  • boolean - True if this date is after the specified date.

isBefore

function isBefore(LocalDate|LocalDateTime other) returns boolean

Checks if this date is before the specified date. If a LocalDateTime is given, only its date part (year, month, day) is compared — the time component is ignored.

Parameters
Return Type
  • boolean - True if this date is before the specified date.

isLeapYear

function isLeapYear() returns boolean

Checks if the year is a leap year.

Return Type
  • boolean - True if the year is a leap year.

lengthOfMonth

function lengthOfMonth() returns int

Returns the length of the month represented by this date.

Return Type
  • int - The length of the month.

lengthOfYear

function lengthOfYear() returns int

Returns the length of the year represented by this date.

Return Type
  • int - The length of the year.

minusPeriod

function minusPeriod(Period interval) returns LocalDate

Returns a copy of this date with the specified period subtracted.

Parameters
  • interval Period - The amount to subtract.
Return Type
  • LocalDate - A date with the period subtracted.

minusDays

function minusDays(int days) returns LocalDate

Returns a copy of this date with the specified number of days subtracted.

Parameters
  • days int - The days to subtract.
Return Type
  • LocalDate - A date with the days subtracted.

minusMonths

function minusMonths(int months) returns LocalDate

Returns a copy of this date with the specified number of months subtracted.

Parameters
  • months int - The months to subtract.
Return Type
  • LocalDate - A date with the months subtracted.

minusWeeks

function minusWeeks(int weeks) returns LocalDate

Returns a copy of this date with the specified number of weeks subtracted.

Parameters
  • weeks int - The number of weeks to subtract.
Return Type
  • LocalDate - A new LocalDate with the weeks subtracted.

minusYears

function minusYears(int years) returns LocalDate

Returns a copy of this date with the specified number of years subtracted.

Parameters
  • years int - The number of years to subtract.
Return Type
  • LocalDate - A new LocalDate with the years subtracted.

notify

function notify()

Wakes up a single thread that is waiting on this object's monitor. WARNING: This is a low-level Java synchronization method. Avoid using it in business logic.

notifyAll

function notifyAll()

Wakes up all threads that are waiting on this object's monitor. WARNING: This is a low-level Java synchronization method. Avoid using it in business logic.

plusPeriod

function plusPeriod(Period interval) returns LocalDate

Returns a copy of this date with the specified period added.

Parameters
  • interval Period - The amount to add.
Return Type
  • LocalDate - A new LocalDate with the specified period added.

plusDays

function plusDays(int days) returns LocalDate

Returns a copy of this date with the specified number of days added.

Parameters
  • days int - The number of days to add, may be negative.
Return Type
  • LocalDate - A new LocalDate with the days added.

plusMonths

function plusMonths(int months) returns LocalDate

Returns a copy of this date with the specified number of months added.

Parameters
  • months int - The number of months to add, may be negative.
Return Type
  • LocalDate - A new LocalDate with the months added.

plusWeeks

function plusWeeks(int weeks) returns LocalDate

Returns a copy of this date with the specified number of weeks added.

Parameters
  • weeks int - The number of weeks to add, may be negative.
Return Type
  • LocalDate - A new LocalDate with the weeks added.

plusYears

function plusYears(int years) returns LocalDate

Returns a copy of this date with the specified number of years added.

Parameters
  • years int - The number of years to add, may be negative.
Return Type
  • LocalDate - A new LocalDate with the years added.

toEpochDay

function toEpochDay() returns int

Returns the epoch day count.

Return Type
  • int - The epoch day count.

doWait

function doWait() returns InterruptedException?

Causes the current thread to wait until notified. WARNING: Low-level Java synchronization method. Use with caution.

Return Type

waitWithTimeout

function waitWithTimeout(int timeoutMillis) returns InterruptedException?

Causes the current thread to wait until notified or the specified time elapses. WARNING: Low-level Java synchronization method. Use with caution.

Parameters
  • timeoutMillis int - The maximum time to wait in milliseconds.
Return Type

waitWithTimeoutAndNanos

function waitWithTimeoutAndNanos(int timeoutMillis, int nanos) returns InterruptedException?

Causes the current thread to wait until notified, with the specified timeout. WARNING: Low-level Java synchronization method. Use with caution.

Parameters
  • timeoutMillis int - The maximum time to wait in milliseconds.
  • nanos int - Additional nanoseconds to wait.
Return Type

withDayOfMonth

function withDayOfMonth(int dayOfMonth) returns LocalDate

Returns a copy of this date with the day-of-month altered.

Parameters
  • dayOfMonth int - The day-of-month to set (1-31).
Return Type
  • LocalDate - A new LocalDate with the day-of-month set.

withDayOfYear

function withDayOfYear(int dayOfYear) returns LocalDate

Returns a copy of this date with the day-of-year altered.

Parameters
  • dayOfYear int - The day-of-year to set (1-365/366).
Return Type
  • LocalDate - A new LocalDate with the day-of-year set.

withMonth

function withMonth(int month) returns LocalDate

Returns a copy of this date with the month-of-year altered.

Parameters
  • month int - The month-of-year to set (1-12).
Return Type
  • LocalDate - A new LocalDate with the month set.

withYear

function withYear(int year) returns LocalDate

Returns a copy of this date with the year altered.

Parameters
  • year int - The year to set.
Return Type
  • LocalDate - A new LocalDate with the year set.
Fields
  • jObj handle
  • jObj handle
  • jObj handle - The handle to the underlying Java object.

java_time_utils: LocalDateTime

Represents a date-time without a time-zone in the ISO-8601 calendar system, such as 2026-07-15T14:28:19.

Constructor

Initializes the LocalDateTime wrapper.

init (handle obj)
  • obj handle - The handle value containing the Java reference.

toString

function toString() returns string

Returns the string representation of this date-time in ISO-8601 format.

Return Type
  • string - The string form (e.g., "2026-07-15T14:28:19").

isEquals

function isEquals(Object other) returns boolean

Checks if this date-time is equal to another object.

Parameters
  • other Object - The object to check equality with.
Return Type
  • boolean - True if equal, false otherwise.

getChronology

function getChronology() returns Chronology

Returns the chronology of this date-time.

Return Type

getClass

function getClass() returns Class

Returns the class of this object.

Return Type
  • Class - The Java class instance.

getDayOfMonth

function getDayOfMonth() returns int

Returns the day-of-month.

Return Type
  • int - The day-of-month, from 1 to 31.

getDayOfWeek

function getDayOfWeek() returns DayOfWeek

Returns the day-of-week.

Return Type

getDayOfYear

function getDayOfYear() returns int

Returns the day-of-year.

Return Type
  • int - The day-of-year, from 1 to 365 or 366.

getHour

function getHour() returns int

Returns the hour-of-day.

Return Type
  • int - The hour-of-day, from 0 to 23.

getMinute

function getMinute() returns int

Returns the minute-of-hour.

Return Type
  • int - The minute-of-hour, from 0 to 59.

getMonth

function getMonth() returns Month

Returns the month-of-year.

Return Type

getMonthValue

function getMonthValue() returns int

Returns the month-of-year value (1-12).

Return Type
  • int - The month-of-year.

getNano

function getNano() returns int

Returns the nano-of-second.

Return Type
  • int - The nano-of-second, from 0 to 999,999,999.

getSecond

function getSecond() returns int

Returns the second-of-minute.

Return Type
  • int - The second-of-minute, from 0 to 59.

getYear

function getYear() returns int

Returns the year.

Return Type
  • int - The year.

hashCode

function hashCode() returns int

Returns the hash code for this date-time.

Return Type
  • int - The hash code.

isAfter

function isAfter(LocalDateTime|LocalDate other) returns boolean

Checks if this date-time is after the specified date-time or date. If a LocalDate is given, only the date part of this date-time is compared — the time component is ignored.

Parameters
Return Type
  • boolean - True if this date-time is after the specified date-time or date.

isBefore

function isBefore(LocalDateTime|LocalDate other) returns boolean

Checks if this date-time is before the specified date-time or date. If a LocalDate is given, only the date part of this date-time is compared — the time component is ignored.

Parameters
Return Type
  • boolean - True if this date-time is before the specified date-time or date.

minusInterval

function minusInterval(Period|Duration interval) returns LocalDateTime

Returns a copy of this date-time with the specified period subtracted.

Parameters
Return Type

minusDays

function minusDays(int days) returns LocalDateTime

Returns a copy of this date-time with the specified number of days subtracted.

Parameters
  • days int - The days to subtract.
Return Type

minusHours

function minusHours(int hours) returns LocalDateTime

Returns a copy of this date-time with the specified number of hours subtracted.

Parameters
  • hours int - The hours to subtract.
Return Type

minusMinutes

function minusMinutes(int minutes) returns LocalDateTime

Returns a copy of this date-time with the specified number of minutes subtracted.

Parameters
  • minutes int - The minutes to subtract.
Return Type
  • LocalDateTime - A new LocalDateTime with the minutes subtracted.

minusMonths

function minusMonths(int months) returns LocalDateTime

Returns a copy of this date-time with the specified number of months subtracted.

Parameters
  • months int - The months to subtract.
Return Type

minusNanos

function minusNanos(int nanos) returns LocalDateTime

Returns a copy of this date-time with the specified number of nanoseconds subtracted.

Parameters
  • nanos int - The nanoseconds to subtract.
Return Type
  • LocalDateTime - A new LocalDateTime with the nanoseconds subtracted.

minusSeconds

function minusSeconds(int seconds) returns LocalDateTime

Returns a copy of this date-time with the specified number of seconds subtracted.

Parameters
  • seconds int - The seconds to subtract.
Return Type
  • LocalDateTime - A new LocalDateTime with the seconds subtracted.

minusWeeks

function minusWeeks(int weeks) returns LocalDateTime

Returns a copy of this date-time with the specified number of weeks subtracted.

Parameters
  • weeks int - The weeks to subtract.
Return Type

minusYears

function minusYears(int years) returns LocalDateTime

Returns a copy of this date-time with the specified number of years subtracted.

Parameters
  • years int - The years to subtract.
Return Type

notify

function notify()

Wakes up a single thread that is waiting on this object's monitor. WARNING: Low-level Java synchronization method. Avoid using in business logic.

notifyAll

function notifyAll()

Wakes up all threads that are waiting on this object's monitor. WARNING: Low-level Java synchronization method. Avoid using in business logic.

plusInterval

function plusInterval(Period|Duration interval) returns LocalDateTime

Returns a copy of this date-time with the specified period added.

Parameters
Return Type

plusDays

function plusDays(int days) returns LocalDateTime

Returns a copy of this date-time with the specified number of days added.

Parameters
  • days int - The number of days to add.
Return Type

plusHours

function plusHours(int hours) returns LocalDateTime

Returns a copy of this date-time with the specified number of hours added.

Parameters
  • hours int - The number of hours to add.
Return Type

plusMinutes

function plusMinutes(int minutes) returns LocalDateTime

Returns a copy of this date-time with the specified number of minutes added.

Parameters
  • minutes int - The number of minutes to add.
Return Type

plusMonths

function plusMonths(int months) returns LocalDateTime

Returns a copy of this date-time with the specified number of months added.

Parameters
  • months int - The number of months to add.
Return Type

plusNanos

function plusNanos(int nanos) returns LocalDateTime

Returns a copy of this date-time with the specified number of nanoseconds added.

Parameters
  • nanos int - The number of nanoseconds to add.
Return Type

plusSeconds

function plusSeconds(int seconds) returns LocalDateTime

Returns a copy of this date-time with the specified number of seconds added.

Parameters
  • seconds int - The number of seconds to add.
Return Type

plusWeeks

function plusWeeks(int weeks) returns LocalDateTime

Returns a copy of this date-time with the specified number of weeks added.

Parameters
  • weeks int - The number of weeks to add.
Return Type

plusYears

function plusYears(int years) returns LocalDateTime

Returns a copy of this date-time with the specified number of years added.

Parameters
  • years int - The number of years to add.
Return Type

toLocalDate

function toLocalDate() returns LocalDate

Gets the LocalDate part of this date-time.

Return Type
  • LocalDate - The date part of this date-time.

toLocalTime

function toLocalTime() returns LocalTime

Gets the LocalTime part of this date-time.

Return Type
  • LocalTime - The time part of this date-time.

doWait

function doWait() returns InterruptedException?

Causes the current thread to wait until notified. WARNING: Low-level Java synchronization method. Use with caution.

Return Type

waitWithTimeout

function waitWithTimeout(int timeoutMillis) returns InterruptedException?

Causes the current thread to wait until notified or the specified time elapses. WARNING: Low-level Java synchronization method. Use with caution.

Parameters
  • timeoutMillis int - The maximum time to wait in milliseconds.
Return Type

waitWithTimeoutAndNanos

function waitWithTimeoutAndNanos(int timeoutMillis, int nanos) returns InterruptedException?

Causes the current thread to wait until notified, with the specified timeout. WARNING: Low-level Java synchronization method. Use with caution.

Parameters
  • timeoutMillis int - The maximum time to wait in milliseconds.
  • nanos int - Additional nanoseconds to wait.
Return Type

withDayOfMonth

function withDayOfMonth(int dayOfMonth) returns LocalDateTime

Returns a copy of this date-time with the day-of-month altered.

Parameters
  • dayOfMonth int - The day-of-month to set (1-31).
Return Type

withDayOfYear

function withDayOfYear(int dayOfYear) returns LocalDateTime

Returns a copy of this date-time with the day-of-year altered.

Parameters
  • dayOfYear int - The day-of-year to set (1-365/366).
Return Type

withHour

function withHour(int hour) returns LocalDateTime

Returns a copy of this date-time with the hour-of-day altered.

Parameters
  • hour int - The hour-of-day to set (0-23).
Return Type

withMinute

function withMinute(int minute) returns LocalDateTime

Returns a copy of this date-time with the minute-of-hour altered.

Parameters
  • minute int - The minute-of-hour to set (0-59).
Return Type

withMonth

function withMonth(int month) returns LocalDateTime

Returns a copy of this date-time with the month-of-year altered.

Parameters
  • month int - The month-of-year to set (1-12).
Return Type

withNano

function withNano(int nano) returns LocalDateTime

Returns a copy of this date-time with the nano-of-second altered.

Parameters
  • nano int - The nano-of-second to set (0-999,999,999).
Return Type
  • LocalDateTime - A new LocalDateTime with the nano-of-second set.

withSecond

function withSecond(int second) returns LocalDateTime

Returns a copy of this date-time with the second-of-minute altered.

Parameters
  • second int - The second-of-minute to set (0-59).
Return Type
  • LocalDateTime - A new LocalDateTime with the second-of-minute set.

withYear

function withYear(int year) returns LocalDateTime

Returns a copy of this date-time with the year altered.

Parameters
  • year int - The year to set.
Return Type
Fields
  • jObj handle
  • jObj handle
  • jObj handle - The handle field that stores the reference to the Java object.

java_time_utils: Locale

Ballerina class mapping for the Java java.util.Locale class.

Constructor

The init function of the Ballerina class mapping the java.util.Locale Java class.

init (handle obj)
  • obj handle - The handle value containing the Java reference of the object.

toString

function toString() returns string

The function to retrieve the string representation of the Ballerina class mapping the java.util.Locale Java class.

Return Type
  • string - The string form of the Java object instance.
Fields
  • jObj handle
  • jObj handle - The handle field that stores the reference to the java.util.Locale object.

java_time_utils: LocalTime

A time without a time-zone in the ISO-8601 calendar system, such as 10:15:30. This is a value-based class; use of identity-sensitive operations on instances of LocalTime may have unpredictable results and should be avoided.

Constructor

Initializes the class with a handle to a Java object.

init (handle obj)
  • obj handle - The handle reference to the Java object.

toString

function toString() returns string

Returns the ISO-8601 string representation of this time.

Return Type
  • string - The time as a string, e.g., 10:15:30.

atDate

function atDate(LocalDate date) returns LocalDateTime

Combines this time with a date to create a LocalDateTime.

Parameters
Return Type
  • LocalDateTime - The local date-time formed from this time and the specified date.

compareTo

function compareTo(LocalTime other) returns int

Compares this time to another time.

Parameters
  • other LocalTime - The other time to compare to.
Return Type
  • int - A negative integer, zero, or a positive integer as this time is less than, equal to, or greater than the specified time.

isEquals

function isEquals(Object other) returns boolean

Checks if this time is equal to another object.

Parameters
  • other Object - The object to check for equality.
Return Type
  • boolean - True if this time is equal to the specified object.

getClass

function getClass() returns Class

Returns the runtime class of this object.

Return Type
  • Class - The Class object representing the runtime class.

getHour

function getHour() returns int

Gets the hour-of-day field.

Return Type
  • int - The hour-of-day, from 0 to 23.

getMinute

function getMinute() returns int

Gets the minute-of-hour field.

Return Type
  • int - The minute-of-hour, from 0 to 59.

getNano

function getNano() returns int

Gets the nano-of-second field.

Return Type
  • int - The nano-of-second, from 0 to 999,999,999.

getSecond

function getSecond() returns int

Gets the second-of-minute field.

Return Type
  • int - The second-of-minute, from 0 to 59.

hashCode

function hashCode() returns int

Returns the hash code for this time.

Return Type
  • int - A suitable hash code.

isAfter

function isAfter(LocalTime other) returns boolean

Checks if this time is after the specified time.

Parameters
  • other LocalTime - The other time to compare to.
Return Type
  • boolean - True if this time is after the specified time.

isBefore

function isBefore(LocalTime other) returns boolean

Checks if this time is before the specified time.

Parameters
  • other LocalTime - The other time to compare to.
Return Type
  • boolean - True if this time is before the specified time.

minusDuration

function minusDuration(Duration amount) returns LocalTime

Returns a copy of this time with the specified period subtracted.

Parameters
  • amount Duration - The amount to subtract.
Return Type
  • LocalTime - A LocalTime based on this one with the specified amount subtracted.

minusHours

function minusHours(int hours) returns LocalTime

Returns a copy of this time with the specified number of hours subtracted.

Parameters
  • hours int - The hours to subtract.
Return Type
  • LocalTime - A LocalTime based on this one with the hours subtracted.

minusMinutes

function minusMinutes(int minutes) returns LocalTime

Returns a copy of this time with the specified number of minutes subtracted.

Parameters
  • minutes int - The minutes to subtract.
Return Type
  • LocalTime - A LocalTime based on this one with the minutes subtracted.

minusNanos

function minusNanos(int nanos) returns LocalTime

Returns a copy of this time with the specified number of nanoseconds subtracted.

Parameters
  • nanos int - The nanoseconds to subtract.
Return Type
  • LocalTime - A LocalTime based on this one with the nanoseconds subtracted.

minusSeconds

function minusSeconds(int seconds) returns LocalTime

Returns a copy of this time with the specified number of seconds subtracted.

Parameters
  • seconds int - The seconds to subtract.
Return Type
  • LocalTime - A LocalTime based on this one with the seconds subtracted.

notify

function notify()

Wakes up a single thread that is waiting on this object's monitor.

notifyAll

function notifyAll()

Wakes up all threads that are waiting on this object's monitor.

plusHours

function plusHours(int hours) returns LocalTime

Returns a copy of this time with the specified number of hours added.

Parameters
  • hours int - The hours to add.
Return Type
  • LocalTime - A LocalTime based on this one with the hours added.

plusMinutes

function plusMinutes(int minutes) returns LocalTime

Returns a copy of this time with the specified number of minutes added.

Parameters
  • minutes int - The minutes to add.
Return Type
  • LocalTime - A LocalTime based on this one with the minutes added.

plusNanos

function plusNanos(int nanos) returns LocalTime

Returns a copy of this time with the specified number of nanoseconds added.

Parameters
  • nanos int - The nanoseconds to add.
Return Type
  • LocalTime - A LocalTime based on this one with the nanoseconds added.

plusSeconds

function plusSeconds(int seconds) returns LocalTime

Returns a copy of this time with the specified number of seconds added.

Parameters
  • seconds int - The seconds to add.
Return Type
  • LocalTime - A LocalTime based on this one with the seconds added.

toNanoOfDay

function toNanoOfDay() returns int

Extracts the time as nanoseconds of day.

Return Type
  • int - The nanoseconds of day.

toSecondOfDay

function toSecondOfDay() returns int

Extracts the time as seconds of day.

Return Type
  • int - The seconds of day.

doWait

function doWait() returns InterruptedException?

Waits to be notified by another thread.

Return Type

waitWithTimeout

function waitWithTimeout(int timeoutMillis) returns InterruptedException?

Waits to be notified by another thread for a specified amount of time.

Parameters
  • timeoutMillis int - The maximum time to wait in milliseconds.
Return Type

waitWithTimeoutAndNanos

function waitWithTimeoutAndNanos(int timeoutMillis, int nanos) returns InterruptedException?

Waits to be notified by another thread for a specified amount of time.

Parameters
  • timeoutMillis int - The maximum time to wait in milliseconds.
  • nanos int - The additional nanoseconds to wait.
Return Type

withHour

function withHour(int hour) returns LocalTime

Returns a copy of this time with the hour-of-day altered.

Parameters
  • hour int - The hour-of-day to set in the result.
Return Type
  • LocalTime - A LocalTime based on this one with the requested hour.

withMinute

function withMinute(int minute) returns LocalTime

Returns a copy of this time with the minute-of-hour altered.

Parameters
  • minute int - The minute-of-hour to set in the result.
Return Type
  • LocalTime - A LocalTime based on this one with the requested minute.

withNano

function withNano(int nano) returns LocalTime

Returns a copy of this time with the nano-of-second altered.

Parameters
  • nano int - The nano-of-second to set in the result.
Return Type
  • LocalTime - A LocalTime based on this one with the requested nano-of-second.

withSecond

function withSecond(int second) returns LocalTime

Returns a copy of this time with the second-of-minute altered.

Parameters
  • second int - The second-of-minute to set in the result.
Return Type
  • LocalTime - A LocalTime based on this one with the requested second.
Fields
  • jObj handle
  • jObj handle
  • jObj handle - The handle to the underlying Java object.

java_time_utils: Month

Ballerina class mapping for the Java java.time.Month class.

Represents a month in the year, such as 'July'.

Constructor

The init function of the Ballerina class mapping the java.time.Month Java class.

init (handle obj)
  • obj handle - The handle value containing the Java reference of the object.

describeConstable

function describeConstable() returns Optional

Returns an optional descriptor of this enum constant for use with nominal descriptors (Java's Constable mechanism).

Method included from *Enum

toString

function toString() returns string

Returns the string representation of the Java Month object instance.

Return Type
  • string - The string form of the Java object instance.

compareTo

function compareTo(Enum other) returns int

Compares this month to another enum value.

Parameters
  • other Enum - The other enum value to compare against.
Return Type
  • int - The negative integer, zero, or positive integer as this object is less than, equal to, or greater than the specified object.

isEquals

function isEquals(Object other) returns boolean

Checks if this month is equal to another object.

Parameters
  • other Object - The object to check equality with.
Return Type
  • boolean - True if the objects are equal, false otherwise.

firstDayOfYear

function firstDayOfYear(boolean leapYear) returns int

Gets the day-of-year corresponding to the first day of this month.

Parameters
  • leapYear boolean - True if the year is a leap year, false otherwise.
Return Type
  • int - The day-of-year for the first day of this month (1 to 335).

firstMonthOfQuarter

function firstMonthOfQuarter() returns Month

Gets the first month of the quarter.

Return Type
  • Month - The first month of the corresponding quarter.

getClass

function getClass() returns Class

Returns the Class object that represents this month's runtime class.

Return Type
  • Class - The Class object.

getDeclaringClass

function getDeclaringClass() returns Class

Returns the declaring class of this enum's type.

Return Type
  • Class - The Class object representing the enum type.

getValue

function getValue() returns int

Returns the numeric value of the month.

Return Type
  • int - The integer value representing the month (1 for January, 12 for December).

hashCode

function hashCode() returns int

Returns a hash code for this month.

Return Type
  • int - A suitable hash code.

length

function length(boolean leapYear) returns int

Gets the length of the month in days, taking leap years into account.

Parameters
  • leapYear boolean - True if the year is a leap year, false otherwise.
Return Type
  • int - The length of this month in days.

maxLength

function maxLength() returns int

Gets the maximum length of this month in days.

Return Type
  • int - The maximum length of this month in days (29 to 31).

minLength

function minLength() returns int

Gets the minimum length of this month in days.

Return Type
  • int - The minimum length of this month in days (28 to 31).

minus

function minus(int months) returns Month

Returns the month-of-year that is the specified number of months before this one.

Parameters
  • months int - The months to subtract, positive or negative.
Return Type
  • Month - The resulting month.

name

function name() returns string

Returns the name of this enum constant, exactly as declared in its enum declaration.

Return Type
  • string - The name of this month.

notify

function notify()

Wakes up a single thread that is waiting on this object's monitor.

notifyAll

function notifyAll()

Wakes up all threads that are waiting on this object's monitor.

ordinal

function ordinal() returns int

Returns the ordinal of this enumeration constant (its position in its enum declaration, where the initial constant is assigned an ordinal of zero).

Return Type
  • int - The ordinal of this month.

plus

function plus(int months) returns Month

Returns the month-of-year that is the specified number of months after this one.

Parameters
  • months int - The months to add, positive or negative.
Return Type
  • Month - The resulting month.

doWait

function doWait() returns InterruptedException?

Causes the current thread to wait until another thread wakes it up.

Return Type
  • InterruptedException? - An InterruptedException if the current thread was interrupted while waiting, or nil otherwise.

waitWithTimeout

function waitWithTimeout(int timeoutMillis) returns InterruptedException?

Causes the current thread to wait until another thread wakes it up, or until a specified timeout elapses.

Parameters
  • timeoutMillis int - The maximum time to wait in milliseconds.
Return Type
  • InterruptedException? - An InterruptedException if the current thread was interrupted while waiting, or nil otherwise.

waitWithTimeoutAndNanos

function waitWithTimeoutAndNanos(int timeoutMillis, int nanos) returns InterruptedException?

Causes the current thread to wait until another thread wakes it up, or until a specified timeout and nanoseconds elapse.

Parameters
  • timeoutMillis int - The maximum time to wait in milliseconds.
  • nanos int - Additional nanoseconds to wait.
Return Type
  • InterruptedException? - An InterruptedException if the current thread was interrupted while waiting, or nil otherwise.
Fields
  • jObj handle
  • Fields Included from *Enum
  • jObj handle
  • jObj handle - The handle field that stores the reference to the java.time.Month object.

java_time_utils: Object

Ballerina wrapper for the Java java.lang.Object class.

Object is the root type used across this library so that different time-related classes (LocalDate, LocalDateTime, LocalTime) can share a common contract for equality, hashing, and low-level Java thread synchronization.@java:Binding {'class: "java.lang.Object"}

Constructor

Initializes the Object wrapper.

init (handle obj)
  • obj handle - The handle value containing the Java reference.

toString

function toString() returns string

Returns the string representation of this object.

Return Type
  • string - The string form of the Java object instance.

isEquals

function isEquals(Object other) returns boolean

Checks if this object is equal to another object.

Note: this delegates directly to Java's equals method on Object, which compares by reference identity unless the underlying Java class overrides it. Subclasses in this library (e.g. LocalDate, LocalDateTime, LocalTime) provide their own value-based equality instead of relying on this default behavior.

Parameters
  • other Object - The object to compare against.
Return Type
  • boolean - True if the two objects are equal, false otherwise.

getClass

function getClass() returns Class

Returns the runtime class of this object.

Return Type
  • Class - The Class instance representing this object's runtime type.

hashCode

function hashCode() returns int

Returns the hash code value for this object.

Return Type
  • int - The hash code.

notify

function notify()

Wakes up a single thread that is waiting on this object's monitor.

WARNING: This is a low-level Java synchronization method. Avoid using it in business logic.

notifyAll

function notifyAll()

Wakes up all threads that are waiting on this object's monitor.

WARNING: This is a low-level Java synchronization method. Avoid using it in business logic.

doWait

function doWait() returns InterruptedException?

Causes the current thread to wait until notified.

WARNING: Low-level Java synchronization method. Use with caution.

Return Type

waitWithTimeout

function waitWithTimeout(int timeoutMillis) returns InterruptedException?

Causes the current thread to wait until notified or the specified time elapses.

WARNING: Low-level Java synchronization method. Use with caution.

Parameters
  • timeoutMillis int - The maximum time to wait, in milliseconds.
Return Type

waitWithTimeoutAndNanos

function waitWithTimeoutAndNanos(int timeoutMillis, int nanos) returns InterruptedException?

Causes the current thread to wait until notified, with the specified timeout.

WARNING: Low-level Java synchronization method. Use with caution.

Parameters
  • timeoutMillis int - The maximum time to wait, in milliseconds.
  • nanos int - Additional nanoseconds to wait (0–999,999).
Return Type
Fields
  • jObj handle
  • jObj handle - The handle to the underlying Java object.

java_time_utils: OffsetDateTime

Ballerina class mapping for the Java java.time.OffsetDateTime class.

Constructor

The init function of the Ballerina class mapping the java.time.OffsetDateTime Java class.

init (handle obj)
  • obj handle - The handle value containing the Java reference of the object.

toString

function toString() returns string

The function to retrieve the string representation of the Ballerina class mapping the java.time.OffsetDateTime Java class.

Return Type
  • string - The string form of the Java object instance.
Fields
  • jObj handle
  • jObj handle - The handle field that stores the reference to the java.time.OffsetDateTime object.

java_time_utils: OffsetTime

Ballerina class mapping for the Java java.time.OffsetTime class.

Constructor

The init function of the Ballerina class mapping the java.time.OffsetTime Java class.

init (handle obj)
  • obj handle - The handle value containing the Java reference of the object.

toString

function toString() returns string

The function to retrieve the string representation of the Ballerina class mapping the java.time.OffsetTime Java class.

Return Type
  • string - The string form of the Java object instance.
Fields
  • jObj handle
  • jObj handle - The handle field that stores the reference to the java.time.OffsetTime object.

java_time_utils: Optional

Ballerina class mapping for the Java java.util.Optional class.

Constructor

The init function of the Ballerina class mapping the java.util.Optional Java class.

init (handle obj)
  • obj handle - The handle value containing the Java reference of the object.

toString

function toString() returns string

The function to retrieve the string representation of the Ballerina class mapping the java.util.Optional Java class.

Return Type
  • string - The string form of the Java object instance.
Fields
  • jObj handle
  • jObj handle - The handle field that stores the reference to the java.util.Optional object.

java_time_utils: ParsePosition

Ballerina class mapping for the Java java.text.ParsePosition class.

Constructor

The init function of the Ballerina class mapping the java.text.ParsePosition Java class.

init (handle obj)
  • obj handle - The handle value containing the Java reference of the object.

toString

function toString() returns string

The function to retrieve the string representation of the Ballerina class mapping the java.text.ParsePosition Java class.

Return Type
  • string - The string form of the Java object instance.
Fields
  • jObj handle
  • jObj handle - The handle field that stores the reference to the java.text.ParsePosition object.

java_time_utils: Period

Ballerina class mapping for the Java java.time.Period class, representing a date-based amount of time.

Constructor

Initializes a Ballerina Period wrapper around an existing Java Period handle.

init (handle obj)
  • obj handle - The handle value containing the Java reference of the object.

toString

function toString() returns string

Returns the string representation of the Java Period instance.

Return Type
  • string - The string form of the period (e.g., "P1Y2M3D").

isEquals

function isEquals(Object other) returns boolean

Checks whether this period is equal to another object.

Parameters
  • other Object - The object to compare with this period.
Return Type
  • boolean - True if the objects are equal, false otherwise.

getClass

function getClass() returns Class

Returns the runtime class of this object.

Return Type
  • Class - The Class object representing the runtime class.

getDays

function getDays() returns int

Gets the amount of days in this period.

Return Type
  • int - The amount of days component.

getMonths

function getMonths() returns int

Gets the amount of months in this period.

Return Type
  • int - The amount of months component.

getYears

function getYears() returns int

Gets the amount of years in this period.

Return Type
  • int - The amount of years component.

hashCode

function hashCode() returns int

Returns a hash code for this period.

Return Type
  • int - The hash code value.

isNegative

function isNegative() returns boolean

Checks if this period is negative.

Return Type
  • boolean - True if any of the three amounts are less than zero.

isZero

function isZero() returns boolean

Checks if this period is zero-length.

Return Type
  • boolean - True if all three amounts are zero.

minusDays

function minusDays(int days) returns Period

Returns a copy of this period with the specified number of days subtracted.

Parameters
  • days int - The amount of days to subtract, may be negative.
Return Type
  • Period - A Period based on this period with the specified days subtracted.

minusMonths

function minusMonths(int months) returns Period

Returns a copy of this period with the specified number of months subtracted.

Parameters
  • months int - The amount of months to subtract, may be negative.
Return Type
  • Period - A Period based on this period with the specified months subtracted.

minusYears

function minusYears(int years) returns Period

Returns a copy of this period with the specified number of years subtracted.

Parameters
  • years int - The amount of years to subtract, may be negative.
Return Type
  • Period - A Period based on this period with the specified years subtracted.

multipliedBy

function multipliedBy(int scalar) returns Period

Returns a copy of this period multiplied by the specified scalar value.

Parameters
  • scalar int - The value to multiply by, may be negative.
Return Type
  • Period - A Period based on this period multiplied by the scalar.

negated

function negated() returns Period

Returns a copy of this period with the length negated.

Return Type
  • Period - A Period based on this period with the amounts negated.

normalized

function normalized() returns Period

Returns a copy of this period with the years and months normalized.

Return Type
  • Period - A Period based on this period with the amounts normalized.

notify

function notify()

Wakes up a single thread that is waiting on this object's monitor.

notifyAll

function notifyAll()

Wakes up all threads that are waiting on this object's monitor.

plusDays

function plusDays(int days) returns Period

Returns a copy of this period with the specified number of days added.

Parameters
  • days int - The amount of days to add, may be negative.
Return Type
  • Period - A Period based on this period with the specified days added.

plusMonths

function plusMonths(int months) returns Period

Returns a copy of this period with the specified number of months added.

Parameters
  • months int - The amount of months to add, may be negative.
Return Type
  • Period - A Period based on this period with the specified months added.

plusYears

function plusYears(int years) returns Period

Returns a copy of this period with the specified number of years added.

Parameters
  • years int - The amount of years to add, may be negative.
Return Type
  • Period - A Period based on this period with the specified years added.

toTotalMonths

function toTotalMonths() returns int

Gets the total number of months in this period.

Return Type
  • int - The total number of months, calculated as years times 12 plus months.

doWait

function doWait() returns InterruptedException?

Causes the current thread to wait until another thread invokes the notify or notifyAll method.

Return Type
  • InterruptedException? - An InterruptedException if the thread was interrupted while waiting, or nil otherwise.

waitWithTimeout

function waitWithTimeout(int timeoutMillis) returns InterruptedException?

Causes the current thread to wait until another thread invokes notify or notifyAll, or a specified timeout expires.

Parameters
  • timeoutMillis int - The maximum time to wait in milliseconds.
Return Type
  • InterruptedException? - An InterruptedException if the thread was interrupted while waiting, or nil otherwise.

waitWithTimeoutAndNanos

function waitWithTimeoutAndNanos(int timeoutMillis, int nanos) returns InterruptedException?

Causes the current thread to wait until another thread invokes notify or notifyAll, or a specified timeout expires with nanosecond precision.

Parameters
  • timeoutMillis int - The maximum time to wait in milliseconds.
  • nanos int - Additional nanoseconds to wait.
Return Type
  • InterruptedException? - An InterruptedException if the thread was interrupted while waiting, or nil otherwise.

withDays

function withDays(int days) returns Period

Returns a copy of this period with the specified amount of days.

Parameters
  • days int - The days to represent in the new period.
Return Type
  • Period - A Period based on this period with the requested days.

withMonths

function withMonths(int months) returns Period

Returns a copy of this period with the specified amount of months.

Parameters
  • months int - The months to represent in the new period.
Return Type
  • Period - A Period based on this period with the requested months.

withYears

function withYears(int years) returns Period

Returns a copy of this period with the specified amount of years.

Parameters
  • years int - The years to represent in the new period.
Return Type
  • Period - A Period based on this period with the requested years.
Fields
  • jObj handle
  • jObj handle
  • jObj handle - The underlying Java reference for the java.time.Period instance.

java_time_utils: ResolverStyle

Ballerina class mapping for the Java java.time.format.ResolverStyle class.

Constructor

The init function of the Ballerina class mapping the java.time.format.ResolverStyle Java class.

init (handle obj)
  • obj handle - The handle value containing the Java reference of the object.

toString

function toString() returns string

The function to retrieve the string representation of the Ballerina class mapping the java.time.format.ResolverStyle Java class.

Return Type
  • string - The string form of the Java object instance.
Fields
  • jObj handle
  • jObj handle - The handle field that stores the reference to the java.time.format.ResolverStyle object.

java_time_utils: Set

Ballerina class mapping for the Java java.util.Set interface.

Constructor

The init function of the Ballerina class mapping the java.util.Set Java interface.

init (handle obj)
  • obj handle - The handle value containing the Java reference of the object.

toString

function toString() returns string

The function to retrieve the string representation of the Ballerina class mapping the java.util.Set Java interface.

Return Type
  • string - The string form of the Java object instance.
Fields
  • jObj handle
  • jObj handle - The handle field that stores the reference to the java.util.Set object.

java_time_utils: Stream

Ballerina class mapping for the Java java.util.stream.Stream interface.

Constructor

The init function of the Ballerina class mapping the java.util.stream.Stream Java interface.

init (handle obj)
  • obj handle - The handle value containing the Java reference of the object.

toString

function toString() returns string

The function to retrieve the string representation of the Ballerina class mapping the java.util.stream.Stream Java interface.

Return Type
  • string - The string form of the Java object instance.
Fields
  • jObj handle
  • jObj handle - The handle field that stores the reference to the java.util.stream.Stream object.

java_time_utils: Temporal

Ballerina class mapping for the Java java.time.temporal.Temporal interface.

Constructor

The init function of the Ballerina class mapping the java.time.temporal.Temporal Java interface.

init (handle obj)
  • obj handle - The handle value containing the Java reference of the object.

toString

function toString() returns string

The function to retrieve the string representation of the Ballerina class mapping the java.time.temporal.Temporal Java interface.

Return Type
  • string - The string form of the Java object instance.
Fields
  • jObj handle
  • jObj handle - The handle field that stores the reference to the java.time.temporal.Temporal object.

java_time_utils: TemporalAccessor

Ballerina class mapping for the Java java.time.temporal.TemporalAccessor interface.

Constructor

The init function of the Ballerina class mapping the java.time.temporal.TemporalAccessor Java interface.

init (handle obj)
  • obj handle - The handle value containing the Java reference of the object.

toString

function toString() returns string

The function to retrieve the string representation of the Ballerina class mapping the java.time.temporal.TemporalAccessor Java interface.

Return Type
  • string - The string form of the Java object instance.
Fields
  • jObj handle
  • jObj handle - The handle field that stores the reference to the java.time.temporal.TemporalAccessor object.

java_time_utils: TemporalAdjuster

Ballerina class mapping for the Java java.time.temporal.TemporalAdjuster interface.

Constructor

The init function of the Ballerina class mapping the java.time.temporal.TemporalAdjuster Java interface.

init (handle obj)
  • obj handle - The handle value containing the Java reference of the object.

toString

function toString() returns string

The function to retrieve the string representation of the Ballerina class mapping the java.time.temporal.TemporalAdjuster Java interface.

Return Type
  • string - The string form of the Java object instance.
Fields
  • jObj handle
  • jObj handle - The handle field that stores the reference to the java.time.temporal.TemporalAdjuster object.

java_time_utils: TemporalAmount

Ballerina class mapping for the Java java.time.temporal.TemporalAmount interface.

Constructor

The init function of the Ballerina class mapping the java.time.temporal.TemporalAmount Java interface.

init (handle obj)
  • obj handle - The handle value containing the Java reference of the object.

toString

function toString() returns string

The function to retrieve the string representation of the Ballerina class mapping the java.time.temporal.TemporalAmount Java interface.

Return Type
  • string - The string form of the Java object instance.
Fields
  • jObj handle
  • jObj handle - The handle field that stores the reference to the java.time.temporal.TemporalAmount object.

java_time_utils: TemporalField

Ballerina class mapping for the Java java.time.temporal.TemporalField interface.

Constructor

The init function of the Ballerina class mapping the java.time.temporal.TemporalField Java interface.

init (handle obj)
  • obj handle - The handle value containing the Java reference of the object.

toString

function toString() returns string

The function to retrieve the string representation of the Ballerina class mapping the java.time.temporal.TemporalField Java interface.

Return Type
  • string - The string form of the Java object instance.
Fields
  • jObj handle
  • jObj handle - The handle field that stores the reference to the java.time.temporal.TemporalField object.

java_time_utils: TemporalQuery

Ballerina class mapping for the Java java.time.temporal.TemporalQuery interface.

Constructor

The init function of the Ballerina class mapping the java.time.temporal.TemporalQuery Java interface.

init (handle obj)
  • obj handle - The handle value containing the Java reference of the object.

toString

function toString() returns string

The function to retrieve the string representation of the Ballerina class mapping the java.time.temporal.TemporalQuery Java interface.

Return Type
  • string - The string form of the Java object instance.
Fields
  • jObj handle
  • jObj handle - The handle field that stores the reference to the java.time.temporal.TemporalQuery object.

java_time_utils: TemporalUnit

Ballerina class mapping for the Java java.time.temporal.TemporalUnit interface.

Constructor

The init function of the Ballerina class mapping the java.time.temporal.TemporalUnit Java interface.

init (handle obj)
  • obj handle - The handle value containing the Java reference of the object.

toString

function toString() returns string

The function to retrieve the string representation of the Ballerina class mapping the java.time.temporal.TemporalUnit Java interface.

Return Type
  • string - The string form of the Java object instance.
Fields
  • jObj handle
  • jObj handle - The handle field that stores the reference to the java.time.temporal.TemporalUnit object.

java_time_utils: TextStyle

Ballerina class mapping for the Java java.time.format.TextStyle class.

Constructor

The init function of the Ballerina class mapping the java.time.format.TextStyle Java class.

init (handle obj)
  • obj handle - The handle value containing the Java reference of the object.

toString

function toString() returns string

The function to retrieve the string representation of the Ballerina class mapping the java.time.format.TextStyle Java class.

Return Type
  • string - The string form of the Java object instance.
Fields
  • jObj handle
  • jObj handle - The handle field that stores the reference to the java.time.format.TextStyle object.

java_time_utils: ValueRange

Ballerina class mapping for the Java java.time.temporal.ValueRange class.

Constructor

The init function of the Ballerina class mapping the java.time.temporal.ValueRange Java class.

init (handle obj)
  • obj handle - The handle value containing the Java reference of the object.

toString

function toString() returns string

The function to retrieve the string representation of the Ballerina class mapping the java.time.temporal.ValueRange Java class.

Return Type
  • string - The string form of the Java object instance.
Fields
  • jObj handle
  • jObj handle - The handle field that stores the reference to the java.time.temporal.ValueRange object.

java_time_utils: ZonedDateTime

Ballerina class mapping for the Java java.time.ZonedDateTime class.

Constructor

The init function of the Ballerina class mapping the java.time.ZonedDateTime Java class.

init (handle obj)
  • obj handle - The handle value containing the Java reference of the object.

toString

function toString() returns string

The function to retrieve the string representation of the Ballerina class mapping the java.time.ZonedDateTime Java class.

Return Type
  • string - The string form of the Java object instance.
Fields
  • jObj handle
  • jObj handle - The handle field that stores the reference to the java.time.ZonedDateTime object.

java_time_utils: ZoneId

Ballerina class mapping for the Java java.time.ZoneId class.

Constructor

The init function of the Ballerina class mapping the java.time.ZoneId Java class.

init (handle obj)
  • obj handle - The handle value containing the Java reference of the object.

toString

function toString() returns string

The function to retrieve the string representation of the Ballerina class mapping the java.time.ZoneId Java class.

Return Type
  • string - The string form of the Java object instance.
Fields
  • jObj handle
  • jObj handle - The handle field that stores the reference to the java.time.ZoneId object.

java_time_utils: ZoneOffset

Ballerina class mapping for the Java java.time.ZoneOffset class.

Constructor

The init function of the Ballerina class mapping the java.time.ZoneOffset Java class.

init (handle obj)
  • obj handle - The handle value containing the Java reference of the object.

toString

function toString() returns string

The function to retrieve the string representation of the Ballerina class mapping the java.time.ZoneOffset Java class.

Return Type
  • string - The string form of the Java object instance.
Fields
  • jObj handle
  • jObj handle - The handle field that stores the reference to the java.time.ZoneOffset object.

Constants

java_time_utils: INTERRUPTEDEXCEPTION

string "InterruptedException"

Errors

java_time_utils: InterruptedException

Distinct
record { message string, anydata... }

Import

import kruutteri1/java_time_utils;Copy

Other versions

1.0.7

1.0.61.0.51.0.41.0.3
See more...

Metadata

Released date: 3 days ago

Version: 1.0.7

License: Apache-2.0

Compatibility

Platform: java21

Ballerina version: 2201.13.4

GraalVM compatible: Yes

Pull count

Total: 5

Current verison: 0

Weekly downloads

Source repository

Keywords

java-time

date

time

localdate

localdatetime

localtime

Contributors

Dependencies

ballerina/jballerina.java.arrays/1.6.1

Terms of service

Privacy policy

Cookie policy

Delete policy

© 2026 WSO2 LLC