LocalTime class final

The time of the day without a timezone, as seen on a wall clock, such as. 12:30.

A LocalTime is immutable. It cannot represent a specific point in time without an additional offset or timezone. Time is stored to microsecond precision See range for the valid range of LocalTimes.

Working with LocalTimes

To create a LocalTime:

final now = LocalTime.now();
final moonLanding = LocalTime(18, 4);

You can add and subtract different types of time intervals, including:

• Duration - add and subtract
• Period - + and -
• Individual units of time - plus and minus

LocalTime behaves the same for all 3 types of time intervals. All calculations wrap around midnight.

final later = now.add(const Duration(hours: 1);
final evenLater = now + const Period(hour: 2);
final latest = now.plus(hours: 3);

LocalTimes can be compared using the comparison operators such as <.

print(now < later); // true
print(latest >= evenLater); // true

You can also truncate, round, ceil and floor LocalTime.

print(moonLanding.truncate(to: TimeUnit.hours); // 18:00
print(moonLanding.round(TimeUnit.minutes, 5);   // 18:05
print(moonLanding.ceil(TimeUnit.minutes, 5);    // 18:05
print(moonLanding.floor(TimeUnit.minutes, 5);   // 18:00

Testing

LocalTime.now can be stubbed by setting System.currentDateTime:

void main() {
  test('mock LocalDateTime.now()', () {
    System.currentDateTime = () => DateTime.utc(2023, 7, 9, 23, 30);
    expect(LocalTime.now(), LocalTime(23, 30));
  });
}

Other resources

See OffsetTime to represent times with offsets.