# phpman > perldoc > Mail::Field::Date

## NAME
    [Mail::Field::Date](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField%3A%3ADate/markdown) - a date header field

## INHERITANCE
     [Mail::Field::Date](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField%3A%3ADate/markdown)
       is a [Mail::Field](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField/markdown)

## SYNOPSIS
      use [HTTP::Date](https://www.chedong.com/phpMan.php/perldoc/HTTP%3A%3ADate/markdown) 'time2iso';
      my $field = [Mail::Field](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField/markdown)->new(Date => time2iso());

## DESCRIPTION
    Represents one "Date" header field.

    Extends "DESCRIPTION" in [Mail::Field](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField/markdown).

## METHODS
    Extends "METHODS" in [Mail::Field](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField/markdown).

### Constructors
    Extends "Constructors" in [Mail::Field](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField/markdown).

    [Mail::Field::Date](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField%3A%3ADate/markdown)->combine($fields)
        Inherited, see "Constructors" in [Mail::Field](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField/markdown)

    [Mail::Field::Date](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField%3A%3ADate/markdown)->extract( $tag, $head [, $index ] )
        Inherited, see "Constructors" in [Mail::Field](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField/markdown)

    [Mail::Field::Date](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField%3A%3ADate/markdown)->new( $tag [, STRING | %options] )
        Inherited, see "Constructors" in [Mail::Field](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField/markdown)

  "Fake" constructors
    Extends ""Fake" constructors" in [Mail::Field](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField/markdown).

    $obj->create(%options)
        Inherited, see ""Fake" constructors" in [Mail::Field](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField/markdown)

    $obj->parse()
        Inherited, see ""Fake" constructors" in [Mail::Field](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField/markdown)

### Accessors
    Extends "Accessors" in [Mail::Field](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField/markdown).

    $obj->set(%options)
         -Option --Default
          Time     undef
          TimeStr  undef

        Time => SECONDS
        TimeStr => STRING
          A string acceptable to [Date::Parse](https://www.chedong.com/phpMan.php/perldoc/Date%3A%3AParse/markdown).

    $obj->stringify()
        Inherited, see "Accessors" in [Mail::Field](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField/markdown)

    $obj->tag()
    [Mail::Field::Date](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField%3A%3ADate/markdown)->tag()
        Inherited, see "Accessors" in [Mail::Field](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField/markdown)

### Smart accessors
    Extends "Smart accessors" in [Mail::Field](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField/markdown).

    $obj->text( [STRING] )
        Inherited, see "Smart accessors" in [Mail::Field](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField/markdown)

    $obj->time( [$time] )
        Query (or change) the $time (as stored in the field) in seconds.

## DETAILS
    Extends "DETAILS" in [Mail::Field](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField/markdown).

## DIAGNOSTICS
    Error: Undefined subroutine <method> called
        [Mail::Field](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField/markdown) 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](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3ACap/markdown) by Gisle Aas <<aas@oslonett.no>>. [Mail::Field::AddrList](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AField%3A%3AAddrList/markdown) by Peter Orbaek <<poe@cit.dk>>.
    [Mail::Mailer](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3AMailer/markdown) and [Mail::Send](https://www.chedong.com/phpMan.php/perldoc/Mail%3A%3ASend/markdown) by Tim Bunce <<Tim.Bunce@ig.co.uk>>. For other contributors see
    ChangeLog.

## LICENSE
    Copyrights 1995-2000 Graham Barr <<gbarr@pobox.com>> and 2001-2017 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>