LocalTime

LocalTime Class

The LocalTime class represents a time of day without a date and time zone. It provides methods for creating, manipulating, and comparing time values.

var localtime = LocalTime.of(15, 30); // LTIME 15:30

Static Methods

now()

• Returns the current time.

• Example Usage:

  var currentTime = LocalTime.now();

parse(text: String)

• Parses the input text to create a LocalTime instance.

• Example Usage:

  var parsedTime = LocalTime.parse("15:30:45");

of(hour: Integer, minute: Integer, second: Integer)

• Creates a LocalTime instance with the specified hour, minute, and second values.

• Example Usage:

  var customTime = LocalTime.of(15, 30, 45);

of(hour: Integer, minute: Integer, second: Integer, nanoOfSecond: Integer)

• Creates a LocalTime instance with the specified hour, minute, second, and nanosecond values.

• Example Usage:

  var customTimeWithNano = LocalTime.of(15, 30, 45, 500000000);

---

Getter Methods

getHour()

• Gets the hour-of-day field.

• Returns the hour-of-day, from 0 to 23.

• Example Usage:

  var hour = customTime.getHour();

getMinute()

• Gets the minute-of-hour field.

• Returns the minute-of-hour, from 0 to 59.

• Example Usage:

  var minute = customTime.getMinute();

getSecond()

• Gets the second-of-minute field.

• Returns the second-of-minute, from 0 to 59.

• Example Usage:

  var second = customTime.getSecond();

getNano()

• Gets the nano-of-second field.

• Returns the nano-of-second, from 0 to 999,999,999.

• Example Usage:

  var nano = customTime.getNano();

---

Time Manipulation Methods

plusHours(hoursToAdd: Long)

• Adds the specified number of hours to the current time and returns a new LocalTime instance.

• Example Usage:

  var newTime = customTime.plusHours(2);

plusMinutes(minutesToAdd: Long)

• Adds the specified number of minutes to the current time and returns a new LocalTime instance.

• Example Usage:

  var newTime = customTime.plusMinutes(30);

plusSeconds(secondsToAdd: Long)

• Adds the specified number of seconds to the current time and returns a new LocalTime instance.

• Example Usage:

  var newTime = customTime.plusSeconds(15);

plusNanos(nanosToAdd: Long)

• Adds the specified number of nanoseconds to the current time and returns a new LocalTime instance.

• Example Usage:

  var newTime = customTime.plusNanos(500000000);

minusHours(hoursToSubtract: Long)

• Subtracts the specified number of hours from the current time and returns a new LocalTime instance.

• Example Usage:

  var newTime = customTime.minusHours(1);

minusMinutes(minutesToSubtract: Long)

• Subtracts the specified number of minutes from the current time and returns a new LocalTime instance.

• Example Usage:

  var newTime = customTime.minusMinutes(10);

minusSeconds(secondsToSubtract: Long)

• Subtracts the specified number of seconds from the current time and returns a new LocalTime instance.

• Example Usage:

  var newTime = customTime.minusSeconds(30);

minusNanos(nanosToSubtract: Long)

• Subtracts the specified number of nanoseconds from the current time and returns a new LocalTime instance.

• Example Usage:

  var newTime = customTime.minusNanos(100000000);

---

Comparison Methods

isBefore(otherInstant: LocalTime)

• Checks if the current time is before the specified LocalTime instance.

• Returns true if the current time is before otherInstant, false otherwise.

• Example Usage:

  var before = customTime.isBefore(parsedTime);

isAfter(otherInstant: LocalTime)

• Checks if the current time is after the specified LocalTime instance.

• Returns true if the current time is after otherInstant, false otherwise.

• Example Usage:

  var after = customTime.isAfter(parsedTime);

---

Conversion Method

toString()

• Converts the LocalTime to a string representation in the format "HH:mm:ss".

• Example Usage:

  var timeString = customTime.toString();