|Date::Manip(3)||User Contributed Perl Documentation||Date::Manip(3)|
From the very beginning, the main focus of Date::Manip has been to be able to do ANY desired date/time operation easily. Many other modules exist which may do a subset of these operations quicker or more efficiently, but no other module can do all of the operations available in Date::Manip.
Date::Manip has functionality to work with several fundamental types of data.
- The word date is used extensively here and is somewhat misleading. In Date::Manip, a date consists of three pieces of information: a calendar date (year, month, day), a time of day (hour, minute, second), and time zone information. Calendar dates and times are fully handled. Time zones are handled as well, but depending on how you use Date::Manip, there may be some limitations as discussed below.
- A delta is an amount of time (i.e. the amount of time between two
different dates). Think of it as the duration of an event or the amount of
time between two dates.
A delta refers only to an amount of time. It includes no information about a starting or ending date/time. Most people will think of a delta as an amount of time, but the term 'time' is already used so much in this module that I didn't want to use it here in order to avoid confusion.
- A recurring event is something which occurs on a regular recurring basis.
- holidays and events
- Holidays and events are basically named dates or recurrences.
Among other things, Date::Manip allow you to:
- Enter a date in practically any format you choose.
- Compare two dates, entered in widely different formats to determine which is earlier.
- Extract any information you want from a date using a format string similar to the Unix date command.
- Determine the amount of time between two dates, or add an amount of time (a delta) to a date to get a second date.
- Work with dates using international formats (foreign month names, 12/10/95 referring to October rather than December, etc.).
- Convert dates from one timezone to another.
- To find a list of dates where a recurring event happens.
Each of these tasks is trivial (one or two lines at most) with this package.
- A complete description of the functional interfaces available. NOTE: it is recommended that you use the OO interface wherever possible as the functional interfaces have some imitations.
- The version 5 functional interface
- The version 6 functional interface
- An overview of the various Date::Manip modules, and how to use them.
- Information for configuring Date::Manip
- This is the base class. All other classes listed here inherit the methods defined in this class.
- A module for doing low-level date operations.
- A module for working with time zones.
- The module for working with dates.
- The module for working with deltas (amount of time).
- The module for working with recurrences (recurring dates).
- Time zone abbreviations used in the version 5 interface.
- Time zone data included in Date::Manip used in the version 6 interfaces.
- Detailed information on how date calculations are done.
- Information on defining and using holidays and events.
- A sample config file.
- Information about the languages supported by Date::Manip and how to add a new language.
- A description of the parseable words in each language currently supported by Date::Manip.
- Information on changes necessary to scripts when upgrading from 5.xx to 6.xx.
- Change log for Date::Manip 5.xx
- Differences between version 5.xx and 6.00 (including information on upgrading); this contains more details than the Migration5to6 document.
- Change log for Date::Manip 6.xx
- Miscellaneous information about Date::Manip (who should use it;
Since many other date/time modules exist, some of which may do the specific operation(s) you need faster, be sure to read "SHOULD I USE DATE::MANIP" in Date::Manip::Misc before deciding which of the Date and Time modules from CPAN is for you. However, if you want one module to do it all, Date::Manip is the one to use.
- Musings on the history of Date::Manip written around it's 20th birthday.
- Common problems and instructions for reporting bugs.
- Examples of how to use Date::Manip.