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 is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.