1Date::Manip::Migration5Utsoe6r(3C)ontributed Perl DocumeDnattaet:i:oMnanip::Migration5to6(3)
2
3
4

NAME

6       Date::Manip::Migration5to6 - how to upgrade from 5.xx to 6.00
7

SYNOPSIS

9       When upgrading from Date::Manip 5.xx to 6.00, a few changes may be
10       necessary to your scripts.
11
12       The Date::Manip::Changes5to6 document lists in more detail the ways in
13       which Date::Manip changed, but very few of these actually entail
14       changes to your script.
15
16       It should be noted that once the changes are made to your script, it
17       will no longer run correctly in 5.xx.
18

NECESSARY AND SUGGESTED CHANGES

20       The following changes are necessary, or strongly suggested:
21
22       Reading config files with Date_Init
23           If you use Date_Init to read any config files (if you do business
24           mode calculations, you probably do), you should remove all of the
25           following config variables from your call to Date_Init:
26
27              GlobalCnf=FILE
28              PersonalCnf=FILE
29              PathSep=*
30              IgnoreGlobalCnf=*
31              PersonalCnfPath=*
32
33           and replace them with:
34
35              ConfigFile=FILE
36
37           where FILE is now the full path to a config file. Also, the
38           ConfigFile argument should be the first argument in Date_Init.
39
40       Date_ConvTZ
41           The Date_ConvTZ function has changed. It should now take 3
42           arguments:
43
44              $date = Date_ConvTZ($date,$from,$to);
45
46           If $from is not given, it defaults to the local time zone. If $to
47           is not given, it defaults to the local time zone.
48
49           The date is converted from the $from time zone into the $to time
50           zone. Both should be any time zone (or alias) supported by
51           Date::Manip.
52
53           The old $errlevel argument is no longer handled.
54
55       ConvTZ and TZ config variables
56           If you use either the ConvTZ or TZ config variables, you should
57           replace them with either SetDate or ForceDate. See the
58           Date::Manip::Config document for information.
59
60           The TZ variable will continue to work until Dec 2015 at which point
61           it will be removed.
62
63       Other deprecated config variables
64           The following config variables have been deprecated, but will
65           continue to function (though they will be removed at a future
66           date):
67
68              TZ           (removed Mar 2016)
69
70           The following variables have been removed. If you use any of them,
71           you may need to modify your scripts:
72
73              IntCharSet
74              GlobalCnf
75              PersonalCnf
76              PathSep
77              IgnoreGlobalCnf
78              PersonalCnfPath
79              ConvTZ
80              Internal
81              TodayIsMidnight
82              DeltaSigns
83              UpdateCurrTZ
84              ResetWorkdDay
85
86       today, yesterday, tomorrow
87           If you parse the strings "today", "yesterday", or "tomorrow" in
88           order to get the time now, or 24 hours in the past/future, this
89           will no longer work.  These strings now refer strictly to the date
90           (so "today" is the current day at midnight, "yesterday" is the
91           previous day at midnight, etc.).
92
93           To get the time now, 24 hours ago, or 24 hours in the future, you
94           would need to parse the strings "now", "-24:00:00", or "+24:00:00"
95           respectively.
96
97       Do not use Memoize
98           In 5.xx, it was documented that you could use the module Memoize to
99           speed up Date::Manip, especially when sorting dates.
100
101           This information is no longer accurate. Using Memoize in
102           conjunction with Date::Manip should have little impact on
103           performance, and may lead to incorrect results, especially if you
104           change config variables.
105
106           Please refer to "GENERAL CHANGES" in Date::Manip::Changes5to6 for
107           more information.
108
109       If you find other instances where it is necessary to modify your
110       script, please email me so that I can add that information to this
111       document.
112

BUGS AND QUESTIONS

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

SEE ALSO

118       Date::Manip        - main module documentation
119

LICENSE

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

AUTHOR

125       Sullivan Beck (sbeck@cpan.org)
126
127
128
129perl v5.34.1                      2022-06-06     Date::Manip::Migration5to6(3)