Reference: localtime
Author: Ellen Siever, Stephen Spainhour & Nathan Patwardhan
Date: 1999-07-02T01:36:20Z

#

| Chapter 5 Function Reference |

## 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.

Reference: local |  | Reference: log