{
    "mode": "perldoc",
    "parameter": "Date::Manip",
    "section": "",
    "url": "https://www.chedong.com/phpMan.php/perldoc/Date%3A%3AManip/json",
    "generated": "2026-06-09T17:10:50Z",
    "sections": {
        "NAME": {
            "content": "Date::Manip - Date manipulation routines\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "Date::Manip is a series of modules designed to make any common date/time operation easy to do.\nOperations such as comparing two times, determining a date a given amount of time from another,\nor parsing international times are all easily done. It deals with time as it is used in the\nGregorian calendar (the one currently in use) with full support for time changes due to daylight\nsaving time.\n\nFrom the very beginning, the main focus of Date::Manip has been to be able to do ANY desired\ndate/time operation easily. Many other modules exist which may do a subset of these operations\nquicker or more efficiently, but no other module can do all of the operations available in\nDate::Manip.\n\nDate::Manip has functionality to work with several fundamental types of data.\n\ndates\nThe word date is used extensively here and is somewhat misleading. In Date::Manip, a date\nconsists of three pieces of information: a calendar date (year, month, day), a time of day\n(hour, minute, second), and time zone information. Calendar dates and times are fully\nhandled. Time zones are handled as well, but depending on how you use Date::Manip, there may\nbe some limitations as discussed below.\n\ndelta\nA delta is an amount of time (i.e. the amount of time between two different dates). Think of\nit as the duration of an event or the amount of time between two dates.\n\nA delta refers only to an amount of time. It includes no information about a starting or\nending date/time. Most people will think of a delta as an amount of time, but the term\n'time' is already used so much in this module that I didn't want to use it here in order to\navoid confusion.\n\nrecurrence\nA recurring event is something which occurs on a regular recurring basis.\n\nholidays and events\nHolidays and events are basically named dates or recurrences.\n\nAmong other things, Date::Manip allow you to:\n\n*   Enter a date in practically any format you choose.\n\n*   Compare two dates, entered in widely different formats to determine which is earlier.\n\n*   Extract any information you want from a date using a format string similar to the Unix date\ncommand.\n\n*   Determine the amount of time between two dates, or add an amount of time (a delta) to a date\nto get a second date.\n\n*   Work with dates using international formats (foreign month names, 12/10/95 referring to\nOctober rather than December, etc.).\n\n*   Convert dates from one timezone to another.\n\n*   To find a list of dates where a recurring event happens.\n\nEach of these tasks is trivial (one or two lines at most) with this package.\n\nHOW TO USE DATE::MANIP\nThere are three different ways to use Date::Manip . There are three interfaces (version 5\nfunctional interface, version 6 functional, and version 6 object-oriented). A complete\ndescription of each is included in the Date::Manip::Interfaces document. The recommended (and\nthe only one with access to the full functionality of the module) is using the Object-Oriented\ninterface.\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "Because Date::Manip performs so many operations, the documentation is extensive. It includes the\nfollowing documents:\n",
            "subsections": [
                {
                    "name": "Information about the different interfaces",
                    "content": "Read this for a detailed description of each of the interfaces, including information on how to\nchoose and use the interface best suited to your situation.\n\nDate::Manip::Interfaces\nA complete description of the functional interfaces available. NOTE: it is recommended that\nyou use the OO interface wherever possible as the functional interfaces have some\nimitations.\n\nA description of the functional interfaces:\nDate::Manip::DM5\nThe version 5 functional interface\n\nDate::Manip::DM6\nThe version 6 functional interface\n"
                },
                {
                    "name": "Objects and configuration",
                    "content": "An introduction to the Date::Manip classes used by the object-oriented interface and how to\nconfigure them:\n\nDate::Manip::Objects\nAn overview of the various Date::Manip modules, and how to use them.\n\nDate::Manip::Config\nInformation for configuring Date::Manip\n"
                },
                {
                    "name": "Date::Manip object-oriented modules",
                    "content": "These are the modules for using the object-oriented interface.\n\nDate::Manip::Obj\nThis is the base class. All other classes listed here inherit the methods defined in this\nclass.\n\nDate::Manip::Base\nA module for doing low-level date operations.\n\nDate::Manip::TZ\nA module for working with time zones.\n\nDate::Manip::Date\nThe module for working with dates.\n\nDate::Manip::Delta\nThe module for working with deltas (amount of time).\n\nDate::Manip::Recur\nThe module for working with recurrences (recurring dates).\n"
                },
                {
                    "name": "Timezone information",
                    "content": "Date::Manip::DM5abbrevs\nTime zone abbreviations used in the version 5 interface.\n\nDate::Manip::Zones\nTime zone data included in Date::Manip used in the version 6 interfaces.\n"
                },
                {
                    "name": "Miscellaneous information:",
                    "content": "Date::Manip::Calc\nDetailed information on how date calculations are done.\n\nDate::Manip::Holidays\nInformation on defining and using holidays and events.\n\nDate::Manip::ConfigFile\nA sample config file.\n\nDate::Manip::Lang\nInformation about the languages supported by Date::Manip and how to add a new language.\n\nDate::Manip::Lang::english\nDate::Manip::Lang::catalan\nDate::Manip::Lang::danish\nDate::Manip::Lang::dutch\nDate::Manip::Lang::finnish\nDate::Manip::Lang::french\nDate::Manip::Lang::german\nDate::Manip::Lang::italian\nDate::Manip::Lang::norwegian\nDate::Manip::Lang::polish\nDate::Manip::Lang::portugue\nDate::Manip::Lang::romanian\nDate::Manip::Lang::russian\nDate::Manip::Lang::spanish\nDate::Manip::Lang::swedish\nDate::Manip::Lang::turkish\nA description of the parseable words in each language currently supported by Date::Manip.\n"
                },
                {
                    "name": "Information about the module and administrative things:",
                    "content": "Date::Manip::Migration5to6\nInformation on changes necessary to scripts when upgrading from 5.xx to 6.xx.\n\nDate::Manip::Changes5\nChange log for Date::Manip 5.xx\n\nDate::Manip::Changes5to6\nDifferences between version 5.xx and 6.00 (including information on upgrading); this\ncontains more details than the Migration5to6 document.\n\nDate::Manip::Changes6\nChange log for Date::Manip 6.xx\n\nDate::Manip::Misc\nMiscellaneous information about Date::Manip (who should use it; acknowledgments).\n\nSince many other date/time modules exist, some of which may do the specific operation(s) you\nneed faster, be sure to read \"SHOULD I USE DATE::MANIP\" in Date::Manip::Misc before deciding\nwhich of the Date and Time modules from CPAN is for you. However, if you want one module to\ndo it all, Date::Manip is the one to use.\n\nDate::Manip::History\nMusings on the history of Date::Manip written around it's 20th birthday.\n\nDate::Manip::Problems\nCommon problems and instructions for reporting bugs.\n\nDate::Manip::Examples\nExamples of how to use Date::Manip.\n"
                }
            ]
        },
        "LICENSE": {
            "content": "This script is free software; you can redistribute it and/or modify it under the same terms as\nPerl itself.\n",
            "subsections": []
        },
        "AUTHOR": {
            "content": "Sullivan Beck (sbeck@cpan.org)\n",
            "subsections": []
        }
    },
    "summary": "Date::Manip - Date manipulation routines",
    "flags": [],
    "examples": [],
    "see_also": [
        {
            "name": "operation",
            "section": "s",
            "url": "https://www.chedong.com/phpMan.php/man/operation/s/json"
        }
    ]
}