perldoc > Date::Manip::Migration5to6(3pm)

man perldoc info pydoc3 ri search

📛 NAME

Date::Manip::Migration5to6 — how to upgrade from 5.xx to 6.00

🚀 Quick Reference

Use Case	Command	Description
📂 Config file setup	ConfigFile=FILE	Single argument replaces GlobalCnf, PersonalCnf, PathSep, IgnoreGlobalCnf, PersonalCnfPath
🌍 Time zone conversion	Date_ConvTZ($date,$from,$to)	3-argument form; old $errlevel removed; both args default to local time zone
⏰ Get current time	ParseDate("now")	"today" now means midnight (date only); use "now" for current time, "-24:00:00" / "+24:00:00" for offsets
⚙️ TZ/ConvTZ config	SetDate or ForceDate	Replace deprecated ConvTZ and TZ config variables
⚡ Performance	Remove use Memoize;	Memoize no longer effective with Date::Manip 6; may cause incorrect results

📋 SYNOPSIS

When upgrading from Date::Manip 5.xx to 6.00, a few changes may be necessary to your scripts.

The Date::Manip::Changes5to6 document lists in more detail the ways in which Date::Manip changed, but very few of these actually entail changes to your script.

⚠️ It should be noted that once the changes are made to your script, it will no longer run correctly in 5.xx.

⚠️ NECESSARY AND SUGGESTED CHANGES

The following changes are necessary, or strongly suggested:

📖 Reading config files with Date_Init

If you use Date_Init to read any config files (if you do business mode calculations, you probably do), you should remove all of the following config variables from your call to Date_Init:

GlobalCnf=FILE
PersonalCnf=FILE
PathSep=*
IgnoreGlobalCnf=*
PersonalCnfPath=*

and replace them with:

ConfigFile=FILE

where FILE is now the full path to a config file. Also, the ConfigFile argument should be the first argument in Date_Init.

🔄 Date_ConvTZ

The Date_ConvTZ function has changed. It should now take 3 arguments:

$date = Date_ConvTZ($date,$from,$to);

If $from is not given, it defaults to the local time zone. If $to is not given, it defaults to the local time zone.

The date is converted from the $from time zone into the $to time zone. Both should be any time zone (or alias) supported by Date::Manip.

⚠️ The old $errlevel argument is no longer handled.

⚙️ ConvTZ and TZ config variables

If you use either the ConvTZ or TZ config variables, you should replace them with either SetDate or ForceDate. See the Date::Manip::Config document for information.

⚠️ The TZ variable will continue to work until Dec 2015 at which point it will be removed.

🗑️ Other deprecated config variables

The following config variables have been deprecated, but will continue to function (though they will be removed at a future date):

• ⚠️ TZ — removed Mar 2016

The following variables have been removed ❌. If you use any of them, you may need to modify your scripts:

• IntCharSet
• GlobalCnf
• PersonalCnf
• PathSep
• IgnoreGlobalCnf
• PersonalCnfPath
• ConvTZ
• Internal
• TodayIsMidnight
• DeltaSigns
• UpdateCurrTZ
• ResetWorkdDay

📅 today, yesterday, tomorrow

If you parse the strings today, yesterday, or tomorrow in order to get the time now, or 24 hours in the past/future, this will no longer work. These strings now refer strictly to the date (so today is the current day at midnight, yesterday is the previous day at midnight, etc.).

✅ To get the time now, 24 hours ago, or 24 hours in the future, you would need to parse the strings now, -24:00:00, or +24:00:00 respectively.

🚫 Do not use Memoize

In 5.xx, it was documented that you could use the module Memoize to speed up Date::Manip, especially when sorting dates.

⚠️ This information is no longer accurate. Using Memoize in conjunction with Date::Manip should have little impact on performance, and may lead to incorrect results, especially if you change config variables.

Please refer to "GENERAL CHANGES" in Date::Manip::Changes5to6 for more information.

📧 If you find other instances where it is necessary to modify your script, please email me so that I can add that information to this document.

🐛 BUGS AND QUESTIONS

Please refer to the Date::Manip::Problems documentation for information on submitting bug reports or questions to the author.

🔗 SEE ALSO

Date::Manip — main module documentation

📜 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 AT cpan.org)

📛 NAME 🚀 Quick Reference 📋 SYNOPSIS ⚠️ NECESSARY AND SUGGESTED CHANGES 🐛 BUGS AND QUESTIONS 🔗 SEE ALSO 📜 LICENSE 👤 AUTHOR