Mail::Field::Date(3)

okay bestie, this is the manual page for Mail::Field::Date — yes, that's the manual name up top, and no, we are not doing the boring header-line copy-paste. 💅

🌸 NAME 🌸

Mail::Field::Date — a date header field ✨

🦋 INHERITANCE 🦋

Here's the family tree, no cap:

Mail::Field::Date
  is a Mail::Field

✨ SYNOPSIS ✨

Bestie, here's the whole vibe in two lines:

use HTTP::Date 'time2iso';
my $field = Mail::Field->new(Date => time2iso());

💅 DESCRIPTION 💅

Represents one "Date" header field. That's literally the whole personality. 🎀

It extends "DESCRIPTION" in Mail::Field — so go read that section too, iykyk.

🧚 METHODS 🧚

Extends "METHODS" in Mail::Field.

🎀 Constructors 🎀

Extends "Constructors" in Mail::Field.

• Mail::Field::Date->combine($fields) — inherited, see "Constructors" in Mail::Field.
• Mail::Field::Date->extract( $tag, $head [, $index ] ) — inherited, see "Constructors" in Mail::Field.
• Mail::Field::Date->new( $tag [, STRING | %options] ) — inherited, see "Constructors" in Mail::Field.

💀 "Fake" constructors 💀

Extends "Fake" constructors" in Mail::Field.

• $obj->create(%options) — inherited, see "Fake" constructors" in Mail::Field.
• $obj->parse() — inherited, see "Fake" constructors" in Mail::Field.

🔥 Accessors 🔥

Extends "Accessors" in Mail::Field.

• $obj->set(%options) — sets the field options. The defaults are:

-Option --Default
 Time     undef
 TimeStr  undef

The individual options are:

• Time — Time => SECONDS; default undef.
• TimeStr — TimeStr => STRING; a string acceptable to Date::Parse; default undef.

• $obj->stringify() — inherited, see "Accessors" in Mail::Field.
• $obj->tag() and Mail::Field::Date->tag() — both inherited, see "Accessors" in Mail::Field.

🌈 Smart accessors 🌈

Extends "Smart accessors" in Mail::Field.

• $obj->text( [STRING] ) — inherited, see "Smart accessors" in Mail::Field.
• $obj->time( [$time] ) — query (or change) the $time (as stored in the field) in seconds.

👑 DETAILS 👑

Extends "DETAILS" in Mail::Field.

🩺 DIAGNOSTICS 🩺

Here's the dramatic error moment:

Error: Undefined subroutine <method> called

Mail::Field objects use autoloading to compile new functionality. Apparently, the method called is not implemented for the specific class of the field object.

🫶 SEE ALSO 🫶

This module is part of the MailTools distribution, http://perl.overmeer.net/mailtools/.

💖 AUTHORS 💖

The MailTools bundle was developed by Graham Barr. Later, Mark Overmeer took over maintenance without commitment to further development.

Mail::Cap by Gisle Aas <aas@oslonett.no>. Mail::Field::AddrList by Peter Orbaek <poe@cit.dk>. Mail::Mailer and Mail::Send by Tim Bunce <Tim.Bunce@ig.co.uk>. For other contributors see ChangeLog.

📜 LICENSE 📜

Copyrights 1995-2000 Graham Barr <gbarr@pobox.com> and 2001-2024 Mark Overmeer <perl@overmeer.net>.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See http://www.perl.com/perl/misc/Artistic.html.

---

xoxo bestie, that's the whole page 💖 — from perl v5.42.0, dated 2024-12-12, and you just read Mail::Field::Date(3) 🫶✨