phpman > man > 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 RFC 2822 compliant datetime string. (In
    case you care, they're not RFC 822 dates, because they use a four digit year, which is not
    allowed in RFC 822.)

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 RFC 2822. 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 AT 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.