# Package org.apache.commons.lang3.time

Provides classes and methods to work with dates and durations. These classes are immutable (and therefore thread-safe) apart from `StopWatch`.

The time package contains some basic utilities for manipulating time (a delorean, police box and grandfather clock?). These include a `StopWatch` for simple performance measurements and an optimised `FastDateFormat` class.

New in Lang 2.1 is the `DurationFormatUtils` class, which provides various methods for formatting durations.

Since:
  2.0

Interface Summary
DateParser: DateParser is the "missing" interface for the parsing methods of `DateFormat`.
DatePrinter: DatePrinter is the "missing" interface for the format methods of `DateFormat`.

Class Summary
CalendarUtils: Helps use `Calendar`s.
DateFormatUtils: Date and time formatting utilities and constants.
DateUtils: A suite of utilities surrounding the use of the `Calendar` and `Date` object.
DurationFormatUtils: Duration formatting utilities and constants.
FastDateFormat: FastDateFormat is a fast and thread-safe version of `SimpleDateFormat`.
FastDateParser: FastDateParser is a fast and thread-safe version of `SimpleDateFormat`.
FastDatePrinter: FastDatePrinter is a fast and thread-safe version of `SimpleDateFormat`.
FastTimeZone: Faster methods to produce custom time zones.
StopWatch: `StopWatch` provides a convenient API for timings.
TimeZones: Helps to deal with `TimeZone`s.