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.