From Code to Community: Sponsoring The Perl and Raku Conference 2025 Learn more

 / 
Date-ISO-1.31
River stage zero No dependents
/ Date::ISO

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.