Name
localtime
Synopsis
localtime val
Description
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.
Get Perl in a Nutshell now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.