Time::localtime(3pm)

🌸 NAME 🌸

Okay bestie, meet Time::localtime(3pm) — from the Perl Programmers Reference Guide — it’s the by-name interface to Perl’s built-in localtime() function. That’s the whole vibe: you get the time fields by name instead of by mysterious list positions. 💅

✨ SYNOPSIS ✨

Like, literally the smallest taste:

use Time::localtime;
printf "Year is %d\n", localtime->year() + 1900;

$now = ctime();

use Time::localtime;
use File::stat;
$date_string = ctime(stat($file)->mtime);

💖 DESCRIPTION 💖

So here’s the tea: this module’s default exports override the core localtime() function, replacing it with a version that returns "Time::tm" objects. Those objects have methods that return the similarly named structure field name from the C’s tm structure from time.h — namely sec, min, hour, mday, mon, year, wday, yday, and isdst. Periodt. 👑

You may also import all the structure fields directly into your namespace as regular variables using the :FIELDS import tag. (Note that this still overrides your core functions.) Access these fields as variables named with a preceding "tm_" in front their method names. Thus, "$tm_obj->mday()" corresponds to $tm_mday if you import the fields. Slay. 🦋

The ctime() function provides a way of getting at the scalar sense of the original CORE::localtime() function.

To access this functionality without the core overrides, pass the "use" an empty import list, and then access function functions with their full qualified names. On the other hand, the built-ins are still available via the "CORE::" pseudo-package. 👑

🫶 NOTE 🫶

While this class is currently implemented using the Class::Struct module to build a struct-like class, you shouldn’t rely upon this. No cap — that’s an implementation detail, not a promise. 💀

🌈 AUTHOR 🌈

Tom Christiansen. Iconic. 🎀

---

Signed, sealed, delivered: this page is from perl v5.42.3, dated 2026-11-03, and it’s the Time::localtime(3pm) manual page. Bye bestie! 💖