Provided by: libclass-date-perl_1.1.17-2_all bug

NAME

       Class::Date - Class for easy date and time manipulation

VERSION

       version 1.1.17

SYNOPSIS

         use Class::Date qw(:errors date localdate gmdate now -DateParse -EnvC);

         # creating absolute date object (local time)
         $date = Class::Date->new( [$year,$month,$day,$hour,$min,$sec]);
         $date = date [$year,$month,$day,$hour,$min,$sec];
           # ^- "date" is an exportable function, the same as Class::Date->new
         $date = date { year => $year, month => $month, day => $day,
           hour => $hour, min => $min, sec => $sec };
         $date = date "2001-11-12 07:13:12";
         $date = localdate "2001-12-11";
         $date = now;                      #  the same as date(time)
         $date = date($other_date_object); # cloning
         ...

         # creating absolute date object (GMT)
         $date = Class::Date->new( [$year,$month,$day,$hour,$min,$sec],'GMT');
         $date = gmdate "2001-11-12 17:13";
         ...

         # creating absolute date object in any other timezone
         $date = Class::Date->new( [$year,$month,$day,$hour,$min,$sec],'Iceland' );
         $date = date "2001-11-12 17:13", 'Iceland';
         $date2 = $date->new([$y2, $m2, $d2, $h2, $m2, $s2]);
           # ^- timezone is inherited from the $date object

         # creating relative date object
         # (normally you don't need to create this object explicitly)
         $reldate = Class::Date::Rel->new( "3Y 1M 3D 6h 2m 4s" );
         $reldate = Class::Date::Rel->new( "6Y" );
         $reldate = Class::Date::Rel->new( $secs );  # secs
         $reldate = Class::Date::Rel->new( [$year,$month,$day,$hour,$min,$sec] );
         $reldate = Class::Date::Rel->new( { year => $year, month => $month, day => $day,
           hour => $hour, min => $min, sec => $sec } );
         $reldate = Class::Date::Rel->new( "2001-11-12 07:13:12" );
         $reldate = Class::Date::Rel->new( "2001-12-11" );

         # getting values of an absolute date object
         $date;              # prints the date in default output format (see below)
         $date->year;        # year, e.g: 2001
         $date->_year;       # year - 1900, e.g. 101
         $date->yr;          # 2-digit year 0-99, e.g 1
         $date->mon;         # month 1..12
         $date->month;       # same as prev.
         $date->_mon;        # month 0..11
         $date->_month;      # same as prev.
         $date->day;         # day of month
         $date->mday;        # day of month
         $date->day_of_month;# same as prev.
         $date->hour;
         $date->min;
         $date->minute;      # same as prev.
         $date->sec;
         $date->second;      # same as prev.
         $date->wday;        # 1 = Sunday
         $date->_wday;       # 0 = Sunday
         $date->day_of_week; # same as prev.
         $date->yday;
         $date->day_of_year; # same as prev.
         $date->isdst;       # DST?
         $date->daylight_savings; # same as prev.
         $date->epoch;       # UNIX time_t
         $date->monname;     # name of month, eg: March
         $date->monthname;   # same as prev.
         $date->wdayname;    # Thursday
         $date->day_of_weekname # same as prev.
         $date->hms          # 01:23:45
         $date->ymd          # 2000/02/29
         $date->mdy          # 02/29/2000
         $date->dmy          # 29/02/2000
         $date->meridiam     # 01:23 AM
         $date->ampm         # AM/PM
         $date->string       # 2000-02-29 12:21:11 (format can be changed, look below)
         "$date"             # same as prev.
         $date->tzoffset     # timezone-offset
         $date->strftime($format) # POSIX strftime (without the huge POSIX.pm)
         $date->tz           # returns the base timezone as you specify, eg: CET
         $date->tzdst        # returns the real timezone with dst information, eg: CEST

         ($year,$month,$day,$hour,$min,$sec)=$date->array;
         ($year,$month,$day,$hour,$min,$sec)=@{ $date->aref };
         # !! $year: 1900-, $month: 1-12

         ($sec,$min,$hour,$day,$mon,$year,$wday,$yday,$isdst)=$date->struct;
         ($sec,$min,$hour,$day,$mon,$year,$wday,$yday,$isdst)=@{ $date->sref };
         # !! $year: 0-, $month: 0-11

         $hash=$date->href; # $href can be reused as a constructor
         print $hash->{year}."-".$hash->{month}. ... $hash->{sec} ... ;

         %hash=$date->hash;
         # !! $hash{year}: 1900-, $hash{month}: 1-12

         $date->month_begin  # First day of the month (date object)
         $date->month_end    # Last day of the month
         $date->days_in_month # 28..31

         # constructing new date based on an existing one:
         $new_date = $date->clone;
         $new_date = $date->clone( year => 1977, sec => 14 );
         # valid keys: year, _year, month, mon, _month, _mon, day, mday, day_of_month,
         #             hour, min, minute, sec, second, tz
         # constructing a new date, which is the same as the original, but in
         # another timezone:
         $new_date = $date->to_tz('Iceland');

         # changing date format
         {
           local $Class::Date::DATE_FORMAT="%Y%m%d%H%M%S";
           print $date       # result: 20011222000000
           $Class::Date::DATE_FORMAT=undef;
           print $date       # result: Thu Oct 13 04:54:34 1994
           $Class::Date::DATE_FORMAT="%Y/%m/%d"
           print $date       # result: 1994/10/13
         }

         # error handling
         $a = date($date_string);
         if ($a) { # valid date
           ...
         } else { # invalid date
           if ($a->error == E_INVALID) { ... }
           print $a->errstr;
         }

         # adjusting DST in calculations  (see the doc)
         $Class::Date::DST_ADJUST = 1; # this is the default
         $Class::Date::DST_ADJUST = 0;

         # "month-border adjust" flag
         $Class::Date::MONTH_BORDER_ADJUST = 0; # this is the default
         print date("2001-01-31")+'1M'; # will print 2001-03-03
         $Class::Date::MONTH_BORDER_ADJUST = 1;
         print date("2001-01-31")+'1M'; # will print 2001-02-28

         # date range check
         $Class::Date::RANGE_CHECK = 0; # this is the default
         print date("2001-02-31"); # will print 2001-03-03
         $Class::Date::RANGE_CHECK = 1;
         print date("2001-02-31"); # will print nothing

         # getting values of a relative date object
         $reldate;              # reldate in seconds (assumed 1 month = 2_629_744 secs)
         $reldate->year;
         $reldate->mon;
         $reldate->month;       # same as prev.
         $reldate->day;
         $reldate->hour;
         $reldate->min;
         $reldate->minute;      # same as prev.
         $reldate->sec;         # same as $reldate
         $reldate->second;      # same as prev.
         $reldate->sec_part;    # "second" part of the relative date
         $reldate->mon_part;    # "month"  part of the relative date

         # arithmetic with dates:
         print date([2001,12,11,4,5,6])->truncate;
                                      # will print "2001-12-11"
         $new_date = $date+$reldate;
         $date2    = $date+'3Y 2D';   # 3 Years and 2 days
         $date3    = $date+[1,2,3];   # $date plus 1 year, 2 months, 3 days
         $date4    = $date+'3-1-5'    # $date plus 3 years, 1 months, 5 days

         $new_date = $date-$reldate;
         $date2    = $date-'3Y';      # 3 Yearss
         $date3    = $date-[1,2,3];   # $date minus 1 year, 2 months, 3 days
         $date4    = $date-'3-1-5'    # $date minus 3 years, 1 month, 5 days

         $new_reldate = $date1-$date2;
         $reldate2 = Class::Date->new('2000-11-12')-'2000-11-10';
         $reldate3    = $date3-'1977-11-10';

         $days_between = (Class::Date->new('2001-11-12')-'2001-07-04')->day;

         # comparison between absolute dates
         print $date1 > $date2 ? "I am older" : "I am younger";

         # comparison between relative dates
         print $reldate1 > $reldate2 ? "I am faster" : "I am slower";

         # Adding / Subtracting months and years are sometimes tricky:
         print date("2001-01-29") + '1M' - '1M'; # gives "2001-02-01"
         print date("2000-02-29") + '1Y' - '1Y'; # gives "2000-03-01"

         # Named interface ($date2 does not necessary to be a Class::Date object)
         $date1->string;               # same as $date1 in scalar context
         $date1->subtract($date2);     # same as $date1 - $date2
         $date1->add($date2);          # same as $date1 + $date2
         $date1->compare($date2);      # same as $date1 <=> $date2

         $reldate1->sec;               # same as $reldate1 in numeric or scalar context
         $reldate1->compare($reldate2);# same as $reldate1 <=> $reldate2
         $reldate1->add($reldate2);    # same as $reldate1 + $reldate2
         $reldate1->neg                # used for subtraction

         # Disabling Class::Date warnings at load time
         BEGIN { $Class::Date::WARNINGS=0; }
         use Class::Date;

DESCRIPTION

       This module is intended to provide a general-purpose date and datetime type for perl. You have a
       Class::Date class for absolute date and datetime, and have a Class::Date::Rel class for relative dates.

       You can use "+", "-", "<" and ">" operators as with native perl data types.

       Note that this module is fairly ancient and dusty. You might want to take a look at DateTime and its
       related modules for a more standard, and maintained, Perl date manipulation solution.

USAGE

       If you want to use a date object, you need to do the following:

         - create a new object
         - do some operations (+, -, comparison)
         - get result back

   Creating a new date object
       You can create a date object by the "date", "localdate" or "gmdate" function, or by calling the
       Class::Date constructor.

       "date" and "Class::Date->new" are equivalent, both has two arguments: The date and the timezone.

         $date1= date [2000,11,12];
         $date2= Class::Date->new([2000,06,11,13,11,22],'GMT');
         $date2= $date1->new([2000,06,11,13,11,22]);

       If the timezone information is omitted, then it first check if "new" is called as an object method or a
       class method. If it is an object method, then it inherits the timezone from the base object, otherwise
       the default timezone is used ($Class::Date::DEFAULT_TIMEZONE), which is usually set to the local timezone
       (which is stored in $Class::Date::LOCAL_TIMEZONE). These two variables are set only once to the value,
       which is returned by the Class::Date::local_timezone() function. You can change these values whenever you
       want.

       "localdate $x" is equivalent to "date $x, $Class::Date::LOCAL_TIMEZONE", "gmdate $x" is equivalent to
       "date $x, $Class::Date::GMT_TIMEZONE".

       $Class::Date::GMT_TIMEZONE is set to 'GMT' by default.

         $date1= localdate [2000,11,12];
         $date2= gmdate [2000,4,2,3,33,33];

         $date = localdate(time);

       The format of the accepted input date can be:

       [$year,$month,$day,$hour,$min,$sec]
           An array reference with 6 elements. The missing elements have default values (year: 2000, month, day:
           1, hour, min, sec: 0)

       { year => $year, month => $month, day => $day, hour => $hour, min => $min, sec => $sec }
           A hash reference with the same 6 elements as above.

       "YYYYMMDDhhmmss"
           A mysql-style timestamp value, which consist of at least 14 digit.

       "973897262"
           A valid 32-bit integer: This is parsed as a unix time.

       "YYYY-MM-DD hh:mm:ss"
           A standard ISO(-like) date format. Additional ".fraction" part is ignored, ":ss" can be omitted.

       additional input formats
           You can specify "-DateParse" as  an import parameter, e.g:

             use Class::Date qw(date -DateParse);

           With  this,  the module will try to load Date::Parse module, and if it find it then all these formats
           can be used as an input. Please refer to the Date::Parse documentation.

   Operations
       addition
           You can add the following to a Class::Date object:

             - a valid Class::Date::Rel object
             - anything, that can be used for creating a new Class::Date::Rel object

           It means that you don't need to create  a  new  Class::Date::Rel  object  every  time  when  you  add
           something to the Class::Date object, it creates them automatically:

             $date= Class::Date->new('2001-12-11')+Class::Date::Rel->new('3Y');

           is the same as:

             $date= date('2001-12-11')+'3Y';

           You can provide a Class::Date::Rel object in the following form:

           array ref
               The same format as seen in Class::Date format, except the default values are different: all zero.

           hash ref
               The same format as seen in Class::Date format, except the default values are different: all zero.

           "973897262"
               A valid 32-bit integer is parsed as seconds.

           "YYYY-MM-DD hh:mm:ss"
               A  standard ISO date format, but this is parsed as relative date date and time, so month, day and
               year can be zero (and defaults to zero).

           "12Y 6M 6D 20h 12m 5s"
               This special string can be used if you don't want to use the ISO format. This string consists  of
               whitespace separated tags, each tag consists of a number and a unit. The units can be:

                 Y: year
                 M: month
                 D: day
                 h: hour
                 m: min
                 s: sec

               The number and unit must be written with no space between them.

       subtraction
           The  same  rules  are  true for subtraction, except you can subtract two Class::Date object from each
           other, and you will get a Class::Date::Rel object:

             $reldate=$date1-$date2;
             $reldate=date('2001-11-12 12:11:07')-date('2001-10-07 10:3:21');

           In this case, the "month" field of the $reldate object will be 0, and the other fields  will  contain
           the difference between two dates;

       comparison
           You  can  compare  two  Class::Date objects, or one Class::Date object and another data, which can be
           used for creating a new Class::Data object.

           It means that you don't need to bless both objects, one of them can be a simple  string,  array  ref,
           hash ref, etc (see how to create a date object).

             if ( date('2001-11-12') > date('2000-11-11') ) { ... }

           or

             if ( date('2001-11-12') > '2000-11-11' ) { ... }

       truncate
           You  can  chop  the  time  value from this object (set hour, min and sec to 0) with the "truncate" or
           "trunc" method. It does not modify the specified object, it returns with a new one.

       clone
           You can create new date object based on an existing one, by using the "clone" method. Note, this DOES
           NOT modify the base object.

             $new_date = $date->clone( year => 2001, hour => 14 );

           The valid keys are: year, _year, month, mon,  _month,  _mon,  day,  mday,  day_of_month,  hour,  min,
           minute, sec, second, tz.

           There is a "set" method, which does the same as the "clone", it exists only for compatibility.

       to_tz
           You  can use "to_tz" to create a new object, which means the same time as the base object, but in the
           different timezone.

           Note that $date->clone( tz => 'Iceland') and $date->to_tz('Iceland') is not the same! Cloning  a  new
           object  with  setting  timezone  will preserve the time information (hour, minute, second, etc.), but
           transfer the time into other  timezone,  while  to_tz  usually  change  these  values  based  on  the
           difference between the source and the destination timezone.

       Operations with Class::Date::Rel
           The  Class::Date::Rel  object consists of a month part and a day part. Most people only use the "day"
           part of it. If you use both part, then you can get these parts with  the  "sec_part"  and  "mon_part"
           method.  If you use "sec", "month", etc. methods or if you use this object in a mathematical context,
           then this object is converted to one number, which is interpreted as second.  The conversion is based
           on a 30.436 days month. Don't use it too often, because it is confusing...

           If you use Class::Date::Rel in an expression with other Class::Date or Class::Date::Rel objects, then
           it does what is expected:

             date('2001-11-12')+'1M' will be '2001-12-12'

           and

             date('1996-02-11')+'2M' will be '1996-04-11'

   Accessing data from a Class::Date and Class::Date::Rel object
       You can use the methods methods described at the top of the document if you want to access parts  of  the
       data which is stored in a Class::Date and Class::Date::Rel object.

   Error handling
       If  a  date object became invalid, then the object will be reblessed to Class::Date::Invalid. This object
       is false in boolean environment, so you can test the date validity like this:

         $a = date($input_date);
         if ($a) { # valid date
             ...
         } else { # invalid date
             if ($a->error == E_INVALID) { ... }
             print $a->errstr;
         }

       Note even the date is invalid, the expression "defined $a" always  returns  true,  so  the  following  is
       wrong:

         $a = date($input_date);
         if (defined $a) ... # WRONG!!!!

       You can test the error by getting the $date->error value. You might import the ":errors" tag:

         use Class::Date qw(:errors);

       Possible error values are:

       E_OK
           No errors.

       E_INVALID
           Invalid  date.  It  is  set when some of the parts of the date are invalid, and Time::Local functions
           cannot convert them to a valid date.

       E_RANGE
           This error is set, when parts of the  date  are  valid,  but  the  whole  date  is  not  valid,  e.g.
           2001-02-31.  When  the $Class::Date::RANGE_CHECK is not set, then these date values are automatically
           converted to  a  valid  date:  2001-03-03,  but  the  $date->error  value  are  set  to  E_RANGE.  If
           $Class::Date::RANGE_CHECK is set, then a date "2001-02-31" became invalid date.

       E_UNPARSABLE
           This error is set, when the constructor cannot be created from a scalar, e.g:

             $a = date("4kd sdlsdf lwekrmk");

       E_UNDEFINED
           This error is set, when you want to create a date object from an undefined value:

             $a = Class::Date->new(undef);

           Note, that localdate(undef) will create a valid object, because it calls $Class::Date(time).

       You can get the error in string form by calling the "errstr" method.

DST_ADJUST

       $DST_ADJUST is an important configuration option.

       If it is set to true (default), then the module adjusts the date and time when the operation switches the
       border of DST. With this setting, you are ignoring the effect of DST.

       When  $DST_ADJUST is set to false, then no adjustment is done, the calculation will be based on the exact
       time difference.

       You will see the difference through an example:

         $Class::Date::DST_ADJUST=1;

         print date("2000-10-29", "CET") + "1D";
         # This will print 2000-10-30 00:00:00

         print date("2001-03-24 23:00:00", "CET") + "1D";
         # This will be 2001-03-25 23:00:00

         print date("2001-03-25", "CET") + "1D";
         # This will be 2001-03-26 00:00:00

         $Class::Date::DST_ADJUST=0;

         print date("2000-10-29", "CET") + "1D";
         # This will print 2000-10-29 23:00:00

         print date("2001-03-24 23:00:00", "CET") + "1D";
         # This will be 2001-03-26 00:00:00

MONTHS AND YEARS

       If you add or subtract "months" and "years" to a date, you may get wrong dates,  e.g  when  you  add  one
       month  to 2001-01-31, you expect to get 2001-02-31, but this date is invalid and converted to 2001-03-03.
       Thats' why

         date("2001-01-31") + '1M' - '1M' != "2001-01-31"

       This problem can occur only with months and years, because others can easily be converted to seconds.

MONTH_BORDER_ADJUST

       $MONTH_BORDER_ADJUST variable is used to switch on or off the month-adjust feature.  This  is  used  only
       when someone adds months or years to a date and then the resulted date became invalid. An example: adding
       one month to "2001-01-31" will result "2001-02-31", and this is an invalid date.

       When  $MONTH_BORDER_ADJUST is false, this result simply normalized, and becomes "2001-03-03". This is the
       default behaviour.

       When $MONTH_BORDER_ADJUST is true, this result becomes "2001-02-28". So when the date overflows, then  it
       returns the last day insted.

       Both settings keep the time information.

TIMEZONE SUPPORT

       Since  1.0.11,  Class::Date  handle  timezones  natively  on most platforms (see the BUGS AND LIMITATIONS
       section for more info).

       When  the  module  is  loaded,  then  it  determines   the   local   base   timezone   by   calling   the
       Class::Date::local_timezone()   function,  and  stores  these  values  into  two  variables,  these  are:
       $Class::Date::LOCAL_TIMEZONE and $Class::Date::DEFAULT_TIMEZONE. The first value is used, when  you  call
       the  "localdate"  function,  the  second  value  is used, when you call the "date" function and you don't
       specify the timezone. There is a $Class::Date::GMT_TIMEZONE function also, which is used by the  "gmdate"
       function, this is set to 'GMT'.

       You  can query the timezone of a date object by calling the $date->tz method. Note this value returns the
       timezone as you specify, so if you create the object with an unknown timezone, you will get this back. If
       you want to query the effective timezone, you can call the $date->tzdst method.  This method returns only
       valid timezones, but it is not necessarily the timezone which can be used to create  a  new  object.  For
       example  $date->tzdst can return 'CEST', which is not a valid base timezone, because it contains daylight
       savings  information  also.  On  Linux  systems,  you  can  see  the  possible  base  timezones  in   the
       /usr/share/zoneinfo directory.

       In  Class::Date  1.1.6,  a  new  environment  variable  is  introduced: $Class::Date::NOTZ_TIMEZONE. This
       variable stores the local timezone, which is used, when the TZ environment variable is  not  set.  It  is
       introduced,  because  there  are some systems, which cannot handle the queried timezone well. For example
       the local timezone is CST, it is returned  by  the  tzname()  perl  function,  but  when  I  set  the  TZ
       environment  variable  to CST, it works like it would be GMT.  The workaround is NOTZ_TIMEZONE: if a date
       object has a timezone, which is the same as NOTZ_TIMEZONE, then the TZ variable will  be  removed  before
       each  calculation. In normal case, it would be the same as setting TZ to $NOTZ_TIMEZONE, but some systems
       don't like it, so I decided to introduce this variable. The $Class::Date::NOTZ_TIMEZONE variable  is  set
       in  the  initialization  of  the module by removing the TZ variable from the environment and querying the
       tzname variable.

INTERNALS

       This module uses operator overloading very heavily. I've found it quite stable, but I am afraid of  it  a
       bit.

       A Class::Date object is an array reference.

       A  Class::Date::Rel  object is an array reference, which contains month and second information. I need to
       store it as an array ref, because array and month values cannot be converted into seconds, because of our
       super calendar.

       You can add code references to the @Class::Date::NEW_FROM_SCALAR and  @Class::Date::Rel::NEW_FROM_SCALAR.
       These arrays are iterated through when a scalar-format date must be parsed. These arrays only have one or
       two  values  at  initialization.  The  parameters which the code references got are the same as the "new"
       method of each class. In this way, you can personalize the date parses as you want.

       As of 0.90, the Class::Date has been rewritten. A lot of code and design decision has been borrowed  from
       Matt  Sergeant's  Time::Object,  and  there will be some incompatibility with the previous public version
       (0.5). I tried to keep compatibility methods in Class::Date. If you have problems regarding this,  please
       drop me an email with the description of the problem, and I will set the compatibility back.

       Invalid dates are Class::Date::Invalid objects. Every method call on this object and every operation with
       this object returns undef or 0.

DEVELOPMENT FOCUS

       This module tries to be as full-featured as can be. It currently lacks business-day calculation, which is
       planned to be implemented in the 1.0.x series.

       I  try  to  keep  this  module  not  to depend on other modules and I want this module usable without a C
       compiler.

       Currently the module uses the POSIX localtime function very extensively.  This makes the date calculation
       a bit slow, but provides a rich interface, which is not provided by any other module.  When  I  tried  to
       redesign  the internals to not depend on localtime, I failed, because there are no other way to determine
       the daylight savings information.

SPEED ISSUES

       There are two kind of adjustment in this module, DST_ADJUST and MONTH_BORDER_ADJUST. Both of  them  makes
       the  "+"  and  "-"  operations  slower.  If  you  don't  need  them,  switch  them  off to achieve faster
       calculations.

       In general, if you really need fast date and datetime calculation, don't use this module. As you  see  in
       the  previous  section,  the  focus  of  development is not the speed in 1.0.  For fast date and datetime
       calculations, use Date::Calc module instead.

THREAD SAFETY and MOD_PERL

       This module is NOT thread-safe, since it uses C library functions, which are not thread-safe. Using  this
       module  in  a  multi-threaded  environment can cause timezones to be messed up. I did not put any warning
       about it, you have to make sure that you understand this!

       Under some circumstances in a mod_perl environment, you require the Env::C module to set the TZ  variable
       properly  before  calling  the time functions. I added the -EnvC import option to automatically load this
       module if it is not loaded  already.  Please  read  the  mod_perl  documentation  about  the  environment
       variables and mod_perl to get the idea why it is required sometimes:

         http://perl.apache.org/docs/2.0/user/troubleshooting/troubleshooting.html#C_Libraries_Don_t_See_C__ENV__Entries_Set_by_Perl_Code

       You are sure have this problem if the $Class::Date::NOTZ_TIMEZONE variable is set to 'UTC', althought you
       are  sure that your timezone is not that. Try -EnvC in this case, but make sure that you are not using it
       in a multi-threaded environment!

OTHER BUGS AND LIMITATIONS

       •   Not all date/time values can be expressed in all timezones. For example:

             print date("2010-10-03 02:00:00", "Australia/Sydney")
             # it will print 2010-10-03 03:00:00

           No matter how hard you try you, you are not going to be able to express the time in  the  example  in
           that  timezone.  If  you  don't  need  the  timezone  information  and you want to make sure that the
           calculations are always correct, please use GMT as  a  timezone  (the  'gmdate'  function  can  be  a
           shortcut  for  it).  In  this  case,  you  might also consider turning off DST_ADJUST to speed up the
           calculation.

       •   I cannot manage to get the timezone code working properly on ActivePerl 5.8.0 on win XP  and  earlier
           versions possibly have this problem also. If you have a system like this, then you will have only two
           timezones, the local and the GMT. Every timezone, which is not equal to $Class::Date::GMT_TIMEZONE is
           assumed  to  be  local.  This  seems to be caused by the win32 implementation of timezone routines. I
           don't really know how to make this thing working, so I gave up this issue. If anyone know  a  working
           solution, then I will integrate it into Class::Date, but until then, the timezone support will not be
           available for these platforms.

       •   Perl 5.8.0 and earlier versions has a bug in the strftime code on some operating systems (for example
           Linux),  which  is  timezone  related.  I  recommend  using  the  strftime,  which  is  provided with
           Class::Date, so don't try to use the module without the compiled part. The module will not work  with
           a  buggy  strftime  - the test is hardcoded into the beginning of the code. If you anyway want to use
           the module, remove the hardcoded "die" from the module, but do it for your own risk.

       •   This module uses the POSIX functions for date and time calculations, so it is not working  for  dates
           beyond 2038 and before 1902.

           I don't know what systems support dates in 1902-1970 range, it may not work on your system. I know it
           works on the Linux glibc system with perl 5.6.1 and 5.7.2. I know it does not work with perl 5.005_03
           (it  may  be  the  bug of the Time::Local module). Please report if you know any system where it does
           _not_ work with perl 5.6.1 or later.

           I hope that someone will fix this with new time_t in libc. If you really need  dates  over  2038  and
           before 1902, you need to completely rewrite this module or use Date::Calc or other date modules.

       •   This  module  uses  Time::Local, and when it croaks, Class::Date returns "Invalid date or time" error
           message. Time::Local is different in the 5.005 and 5.6.x (and even 5.7.x) version  of  perl,  so  the
           following code will return different results:

             $a = date("2006-11-11")->clone(year => -1);

           In  perl 5.6.1, it returns an invalid date with error message "Invali date or time", in perl 5.005 it
           returns an invalid date with range check error. Both are false if you use  them  in  boolean  context
           though,  only  the  error  message is different, but don't rely on the error message in this case. It
           however works in the same way if you change other fields than "year" to an invalid field.

SUPPORT

       Class::Date is free software. IT COMES WITHOUT WARRANTY OF ANY KIND.

       If you have questions, you can send questions directly to me:

         dlux@dlux.hu

WIN32 notes

       You can get a binary win32 version of Class::Date from Chris Winters' .ppd repository with the  following
       commands:

       For people using PPM2:

         c:\> ppm
         PPM> set repository oi http://openinteract.sourceforge.net/ppmpackages/
         PPM> set save
         PPM> install Class-Date

       For people using PPM3:

         c:\> ppm
         PPM> repository http://openinteract.sourceforge.net/ppmpackages/
         PPM> install Class-Date

       The first steps in PPM only needs to be done at the first time. Next time you just run the 'install'.

COPYRIGHT

       Copyright (c) 2001 Szabó, Balázs (dLux)

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

       Portions Copyright (c) Matt Sergeant

CREDITS

         - Matt Sergeant <matt@sergeant.org>
           (Lots of code are borrowed from the Time::Object module)
         - Tatsuhiko Miyagawa <miyagawa@cpan.org> (bugfixes)
         - Stas Bekman <stas@stason.org> (suggestions, bugfix)
         - Chris Winters <chris@cwinters.com> (win32 .ppd version)
         - Benoit Beausejour <bbeausej@pobox.com>
           (Parts of the timezone code is borrowed from his Date::Handler module)

SEE ALSO

       perl(1).  Date::Calc(3pm).  Time::Object(3pm).  Date::Handler(3pm).

AUTHORS

       •   dLux (Szabó, Balázs) <dlux@dlux.hu>

       •   Gabor Szabo <szabgab@gmail.com>

       •   Yanick Champoux <yanick@cpan.org>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2018, 2014, 2010, 2003 by Balázs Szabó.

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

perl v5.36.0                                       2022-12-04                                   Class::Date(3pm)