Email::Date::Format (3)

Leading comments

Automatically generated by Pod::Man 2.28 (Pod::Simple 3.28)

Standard preamble:
========================================================================

(The comments found at the beginning of the groff file "man3/Email::Date::Format.3pm".)

NAME

Email::Date::Format - produce RFC 2822 date strings

VERSION

version 1.005

SYNOPSIS

  use Email::Date::Format qw(email_date);
  
  my $header = email_date($date->epoch);
  
  Email::Simple->create(
    header => [
      Date => $header,
    ],
    body => '...',
  );

DESCRIPTION

This module provides a simple means for generating an compliant datetime string. (In case you care, they're not dates, because they use a four digit year, which is not allowed in )

FUNCTIONS

email_date

  my $date = email_date; # now
  my $date = email_date( time - 60*60 ); # one hour ago

"email_date" accepts an epoch value, such as the one returned by "time". It returns a string representing the date and time of the input, as specified in

If no input value is provided, the current value of "time" is used.

"email_date" is exported only if requested.

email_gmdate

  my $date = email_gmdate;

"email_gmdate" is identical to "email_date", but it will return a string indicating the time in Greenwich Mean Time, rather than local time.

"email_gmdate" is exported only if requested.

AUTHORS

*

Casey West

*

Ricardo

SIGNES

<rjbs@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2004 by Casey West.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.