NAME

       Twitter::API::Util - Utilities for working with the Twitter API

VERSION

       version 1.0006

SYNOPSIS

           use Twitter::API::Util ':all';

           # Given a timestamp in Twitter's text format:
           my $ts = $status->{created_at}; # "Wed Jun 06 20:07:10 +0000 2012"

           # Convert it UNIX epoch seconds (a Perl "time" value):
           my $time = timestamp_to_time($status->{created_at});

           # Or a Perl localtime:
           my $utc = timestamp_to_timepiece($status->{created_at});

           # Or a Perl gmtime:
           my $utc = timestamp_to_gmtime($status->{created_at});

           # Check to see if an exception is a Twitter::API::Error
           if ( is_twitter_api_error($@) ) {
               warn "Twitter API error: " . $@->twitter_error_text;
           }

DESCRIPTION

       Exports helpful utility functions.

METHODS

   timestamp_to_gmtime
       Returns "gmtime" from a Twitter timestamp string. See "gmtime-EXPR" in perlfunc for
       details.

   timestamp_to_localtime
       Returns "localtime" for a Twitter timestamp string. See "localtime-EXPR" in perlfunc for
       details.

   timestamp_to_time
       Returns a UNIX epoch time for a Twitter timestamp string. See "time" in perlfunc for
       details.

   is_twitter_api_error
       Returns true if the scalar passed to it is a Twitter::API::Error. Otherwise, it returns
       false.

AUTHOR

       Marc Mims <marc@questright.com>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2015-2021 by Marc Mims.

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