NAME
    Date::ISO - Perl extension for converting dates between ISO and
    Gregorian formats.

SYNOPSIS
      use Date::ISO;
      $iso = Date::ISO->new( iso => $iso_date_string );
      $iso = Date::ISO->new( epoch => $epoch_time );
      $iso = Date::ISO->new( ical => $ical_string );
      $iso = Date::ISO->new( year => $year, month => $month,
                             day => $day );
      $iso = Date::ISO->new( year => $year, week => $week,
                             weekday => $weekday );

      $year = $iso->year;

      $iso_year = $iso->iso_year()
      $iso_week = $iso->iso_week();
      $week_day = $iso->iso_week_day();

      $month = $iso->month();
      $day = $iso->day();

    And, for backward compatibility:

      ($yearnumber, $weeknumber, $weekday) = iso($year, $month, $day);
      ($yearnumber, $weeknumber, $weekday) = localiso(time);
      ($year, $month, $day) = inverseiso($iso_year, $iso_week,
                                         $iso_week_day);

DESCRIPTION
    Convert dates between ISO and Gregorian formats.

  new
        my $iso = Date::ISO->new( iso => $iso_date_string );
        my $iso = Date::ISO->new( epoch = $epoch_time );

    Set the time to 2:30:25 on the date specified in $iso_date_string my
    $iso = Date::ISO->new( iso => $iso_date_string, hour => 2, min => 30,
    sec => 25 );

    And, since this is a Date::ICal subclass ...

        my $iso = Date::ISO->new( ical => $ical_string );
        $ical = $iso->ical;

    Accepted ISO date string formats are:

        1997-02-05 (Feb 5, 1997)
        19970205 (Same)
        199702 (February 1997)
        1997-W06 (6th week, 1997)
        1997W06 (Same)
        1997-W06-2 (6th week, 2nd day)
        1997W062 (Same as above)
        1997-035 (35th day of 1997)
        1997035 (Same as above)

    2-digit representations of the year are not supported at this time.