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.