manpagez: man pages & more
man Date::Manip(3)
Home | html | info | man
Date::Manip(3)        User Contributed Perl Documentation       Date::Manip(3)



NAME

       Date::Manip - Date manipulation routines


DESCRIPTION

       Date::Manip is a series of modules designed to make any common
       date/time operation easy to do.  Operations such as comparing two
       times, determining a date a given amount of time from another, or
       parsing international times are all easily done.  It deals with time as
       it is used in the Gregorian calendar (the one currently in use) with
       full support for time changes due to daylight saving time.

       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.

       dates
           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.

       delta
           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.

       recurrence
           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.


HOW TO USE DATE::MANIP

       There are three different ways to use Date::Manip .  There are three
       interfaces (version 5 functional interface, version 6 functional, and
       version 6 object-oriented).  A complete description of each is included
       in the Date::Manip::Interfaces document.  The recommended (and the only
       one with access to the full functionality of the module) is using the
       Object-Oriented interface.


SEE ALSO

       Because Date::Manip performs so many operations, the documentation is
       extensive.  It includes the following documents:

   Information about the different interfaces
       Read this for a detailed description of each of the interfaces,
       including information on how to choose and use the interface best
       suited to your situation.

       Date::Manip::Interfaces(3)
           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 limitations.

   A description of the functional interfaces:
       Date::Manip::DM5(3)
           The version 5 functional interface

       Date::Manip::DM6(3)
           The version 6 functional interface

   Objects and configuration
       An introduction to the Date::Manip classes used by the object-oriented
       interface and how to configure them:

       Date::Manip::Objects(3)
           An overview of the various Date::Manip modules, and how to use
           them.

       Date::Manip::Config(3)
           Information for configuring Date::Manip

   Date::Manip object-oriented modules
       These are the modules for using the object-oriented interface.

       Date::Manip::Obj(3)
           This is the base class.  All other classes listed here inherit the
           methods defined in this class.

       Date::Manip::Base(3)
           A module for doing low-level date operations.

       Date::Manip::TZ(3)
           A module for working with time zones.

       Date::Manip::Date(3)
           The module for working with dates.

       Date::Manip::Delta(3)
           The module for working with deltas (amount of time).

       Date::Manip::Recur(3)
           The module for working with recurrences (recurring dates).

   Timezone information
       Date::Manip::DM5abbrevs(3)
           Time zone abbreviations used in the version 5 interface.

       Date::Manip::Zones(3)
           Time zone data included in Date::Manip used in the version 6
           interfaces.

   Miscellaneous information:
       Date::Manip::Calc(3)
           Detailed information on how date calculations are done.

       Date::Manip::Holidays(3)
           Information on defining and using holidays and events.

       Date::Manip::ConfigFile(3)
           A sample config file.

       Date::Manip::Lang(3)
           Information about the languages supported by Date::Manip and how to
           add a new language.

       Date::Manip::Lang::english
       Date::Manip::Lang::catalan
       Date::Manip::Lang::danish
       Date::Manip::Lang::dutch
       Date::Manip::Lang::finnish
       Date::Manip::Lang::french
       Date::Manip::Lang::german
       Date::Manip::Lang::italian
       Date::Manip::Lang::norwegian
       Date::Manip::Lang::polish
       Date::Manip::Lang::portugue
       Date::Manip::Lang::romanian
       Date::Manip::Lang::russian
       Date::Manip::Lang::spanish
       Date::Manip::Lang::swedish
       Date::Manip::Lang::turkish
           A description of the parseable words in each language currently
           supported by Date::Manip.

   Information about the module and administrative things:
       Date::Manip::Migration5to6(3)
           Information on changes necessary to scripts when upgrading from
           5.xx to 6.xx.

       Date::Manip::Changes5(3)
           Change log for Date::Manip 5.xx

       Date::Manip::Changes5to6(3)
           Differences between version 5.xx and 6.00 (including information on
           upgrading); this contains more details than the Migration5to6
           document.

       Date::Manip::Changes6(3)
           Change log for Date::Manip 6.xx

       Date::Manip::Misc(3)
           Miscellaneous information about Date::Manip (who should use it;
           acknowledgments).

           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.

       Date::Manip::History(3)
           Musings on the history of Date::Manip written around it's 20th
           birthday.

       Date::Manip::Problems(3)
           Common problems and instructions for reporting bugs.

       Date::Manip::Examples(3)
           Examples of how to use Date::Manip.


LICENSE

       This script is free software; you can redistribute it and/or modify it
       under the same terms as Perl itself.


AUTHOR

       Sullivan Beck (sbeck@cpan.org)

perl v5.34.1                      2023-04-04                    Date::Manip(3)

date-manip 6.920.0 - Generated Mon Jun 12 11:39:56 CDT 2023
© manpagez.com 2000-2024
Individual documents may contain additional copyright information.