Net::Domain::ExpireDate - obtain expiration date of domain names


Net-Domain-ExpireDate documentation  | view source Contained in the Net-Domain-ExpireDate distribution.

Index


NAME

Top

Net::Domain::ExpireDate -- obtain expiration date of domain names

SYNOPSIS

Top

 use Net::Domain::ExpireDate;

 $expiration_obj = expire_date( 'microsoft.com' );
 $expiration_str  = expire_date( 'microsoft.com', '%Y-%m-%d' );
 $expiration_obj = expdate_int( $whois_text, 'com' );
 $expiration_str  = expdate_fmt( $whois_text, 'ru', '%Y-%m-%d' );

 ($creation_obj, $expiration_obj) = domain_dates( 'microsoft.com' );
 ($creation_str, $expiration_str) = domain_dates( 'microsoft.com', '%Y-%m-%d' );
 ($creation_obj, $expiration_obj) = domdates_int( $whois_text, 'com' );

ABSTRACT

Top

Net::Domain::ExpireDate gets WHOIS information of given domain using Net::Whois::Raw and tries to obtain expiration date of domain. Unfortunately there are too many different whois servers which provides whois info in very different formats. Net::Domain::ExpireDate knows more than 40 different formats of expiration date representation provided by different servers (almost all gTLD registrars and some ccTLD registrars are covered). Now obtaining of domain creation date is also supported.

"$date" in synopsis is an object of type Time::Piece.

FUNCTIONS

Top

expire_date( DOMAIN [,FORMAT] )

Returns expiration date of DOMAIN. Without FORMAT argument returns Time::Piece object. With FORMAT argument returns date formatted using FORMAT template. See strftime man page for FORMAT specification.

expdate_int( WHOISTEXT [,TLD] )

Extracts expiration date of domain in TLD from WHOISTEXT. If no TLD is given 'com' is the default. There is no distinction between 'com' or 'net' TLDs in this function. Also 'org', 'biz', 'info', 'us', 'uk', 'ru' and 'su' TLDs are suppored. Returns Time::Piece object.

With FORMAT argument returns date formatted using FORMAT template (see strftime man page for FORMAT specification)

expdate_fmt( WHOISTEXT [,TLD [,FORMAT]] )

Similar to expdate_int except that output value is formatted date. If no FORMAT specified, '%Y-%m-%d' is assumed. See strftime man page for FORMAT specification.

domain_dates( DOMAIN [,FORMAT] )

Returns list of two values -- creation and expiration date of DOMAIN. Without FORMAT argument returns Time::Piece objects. With FORMAT argument dates are formatted using FORMAT template. See strftime man page for FORMAT specification.

domdates_int( WHOISTEXT [,TLD [,FLAGS]] )

Returns list of three values -- creation, expiration and free date of domain extracted from WHOISTEXT. If no TLD is given 'com' is the default. There is no distinction between 'com' or 'net' TLDs in this function. Also 'org', 'biz', 'info', 'us', 'ru' and 'su' TLDs are suppored. Returns Time::Piece object.

domdates_fmt( WHOISTEXT [,TLD [,FORMAT [,FLAGS]]] )

The same as domdates_int, except it returns formatted results instead of Time::Piece objects.

AUTHOR

Top

Walery Studennikov, <despair@cpan.org>

SEE ALSO

Top

Net::Whois::Raw, Time::Piece.


Net-Domain-ExpireDate documentation  | view source Contained in the Net-Domain-ExpireDate distribution.