<?php 





/**


 * Parent class for usage resources that expose a single date, eg 'Today', 'ThisMonth', etc


 * @author Kevin Burke <kevin@twilio.com>


 * @license  http://creativecommons.org/licenses/MIT/ MIT


 * @link     http://pear.php.net/package/Services_Twilio


 */


class Services_Twilio_TimeRangeResource extends Services_Twilio_UsageResource {





    /**


     * Return a UsageRecord corresponding to the given category.


     *


     * @param string $category The category of usage to retrieve. For a full 


     *      list of valid categories, please see the documentation at 


     *      http://www.twilio.com/docs/api/rest/usage-records#usage-all-categories


     * @return Services_Twilio_Rest_UsageRecord


     * @throws Services_Twilio_RestException


     */


    public function getCategory($category) {


        $page = $this->getPage(0, 1, array(


            'Category' => $category,


        ));


        $items = $page->getItems();


        if (!is_array($items) || count($items) === 0) {


            throw new Services_Twilio_RestException(


                400, "Usage record data is unformattable.");


        }


        return $items[0];


    }


}


