Mojo::Date(3)

💖 Mojo::Date(3) — NAME 💖

okay bestie, this is the Mojo::Date(3) manual page from the User Contributed Perl Documentation — the HTTP date one. Periodt.

Mojo::Date — HTTP date. 💅

---

✨ SYNOPSIS ✨

Quick vibe check — here's how you parse and build, no cap:

use Mojo::Date;

# Parse
my $date = Mojo::Date->new('Sun, 06 Nov 1994 08:49:37 GMT');
say $date->epoch;

# Build
my $date = Mojo::Date->new(time + 60);
say "$date";

---

🦋 DESCRIPTION 🦋

Mojo::Date implements HTTP date and time functions, based on RFC 7230 (<https://tools.ietf.org/html/rfc7230>), RFC 7231 (<https://tools.ietf.org/html/rfc7231>) and RFC 3339 (<https://tools.ietf.org/html/rfc3339>). It's giving date-and-time main character energy, fr fr. 🦋

---

🌸 ATTRIBUTES 🌸

Mojo::Date implements the following attributes. Let's go, bestie:

🕰️ epoch

my $epoch = $date->epoch;
$date     = $date->epoch(784111777);

Epoch seconds, defaults to the current time. Lowkey essential. ✨

---

💅 METHODS 💅

Mojo::Date inherits all methods from Mojo::Base and implements the following new ones. Slay.

🎀 new

my $date = Mojo::Date->new;
my $date = Mojo::Date->new('Sun Nov  6 08:49:37 1994');

Construct a new Mojo::Date object and “parse” date if necessary. New object, who dis? 🎀

🔥 parse

$date = $date->parse('Sun Nov  6 08:49:37 1994');

Parse date. Here's the whole snack buffet of formats it handles, iykyk:

# Epoch
say Mojo::Date->new('784111777')->epoch;
say Mojo::Date->new('784111777.21')->epoch;

# RFC 822/1123
say Mojo::Date->new('Sun, 06 Nov 1994 08:49:37 GMT')->epoch;

# RFC 850/1036
say Mojo::Date->new('Sunday, 06-Nov-94 08:49:37 GMT')->epoch;

# Ansi C asctime()
say Mojo::Date->new('Sun Nov  6 08:49:37 1994')->epoch;

# RFC 3339
say Mojo::Date->new('1994-11-06T08:49:37Z')->epoch;
say Mojo::Date->new('1994-11-06T08:49:37')->epoch;
say Mojo::Date->new('1994-11-06T08:49:37.21Z')->epoch;
say Mojo::Date->new('1994-11-06T08:49:37+01:00')->epoch;
say Mojo::Date->new('1994-11-06T08:49:37-01:00')->epoch;

💜 to_datetime

my $str = $date->to_datetime;

Render RFC 3339 (<https://tools.ietf.org/html/rfc3339>) date and time. Iconic output, honestly:

# "1994-11-06T08:49:37Z"
Mojo::Date->new(784111777)->to_datetime;

# "1994-11-06T08:49:37.21Z"
Mojo::Date->new(784111777.21)->to_datetime;

🌈 to_string

my $str = $date->to_string;

Render date suitable for HTTP messages. This is the one that's ready for the group chat:

# "Sun, 06 Nov 1994 08:49:37 GMT"
Mojo::Date->new(784111777)->to_string;

---

👑 OPERATORS 👑

Mojo::Date overloads the following operators. Operator magic, bestie:

⭐ bool

my $bool = !!$date;

Always true. No cap. 💯

🎀 stringify

my $str = "$date";

Alias for to_string. Obsessed. 💖

---

🫶 SEE ALSO 🫶

Mojolicious, Mojolicious::Guides, <https://mojolicious.org>.

---

That's the whole page, bestie! This was Mojo::Date(3) from perl v5.42.0, dated 2026-07-15. Catch you in the group chat — mwah 💋✨