localtime

localtime val

• Converts the value returned by time to a nine-element list with the time corrected for the local time zone. It's typically used as follows:
  
  

  ($sec,$min,$hour,$mday,$mon,$year,$wday,$yday,$isdst) = localtime(time);
  

  
  
  All list elements are numeric. The element $mon (month) has the range 0..11, and $wday (weekday) has the range 0..6. The year has had 1,900 subtracted from it. (You can remember which ones are 0-based because those are the ones you're always using as subscripts into 0-based arrays containing month and day names.) If val is omitted, it does localtime(time). For example, to get the name of the current day of the week:
  
  

  $thisday = (Sun,Mon,Tue,Wed,Thu,Fri,Sat)[(localtime)[6]];
  

  
  
  The Perl library module Time::Local contains a subroutine, timelocal(), that can convert in the opposite direction.

  In scalar context, localtime returns a ctime(3)-like string based on the localtime value.