NAME

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

VERSION

version 0.0113

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-2016 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.