parameters: (value)
return_statement: return datetime_obj
docstring: Converted the passed in value to a datetime object with tzinfo.
  
      This function can be used to normalize all timestamp inputs.  This
      function accepts a number of different types of inputs, but
      will always return a datetime.datetime object with time zone
      information.
  
      The input param ``value`` can be one of several types:
  
          * A datetime object (both naive and aware)
          * An integer representing the epoch time (can also be a string
            of the integer, i.e '0', instead of 0).  The epoch time is
            considered to be UTC.
          * An iso8601 formatted timestamp.  This does not need to be
            a complete timestamp, it can contain just the date portion
            without the time component.
  
      The returned value will be a datetime object that will have tzinfo.
      If no timezone info was provided in the input value, then UTC is
      assumed, not local time.
docstring_summary: Converted the passed in value to a datetime object with tzinfo.
docstring_tokens: Converted the passed in value to a datetime object with tzinfo .
function: def parse_to_aware_datetime(value):
      """Converted the passed in value to a datetime object with tzinfo.
  
      This function can be used to normalize all timestamp inputs.  This
      function accepts a number of different types of inputs, but
      will always return a datetime.datetime object with time zone
      information.
  
      The input param ``value`` can be one of several types:
  
          * A datetime object (both naive and aware)
          * An integer representing the epoch time (can also be a string
            of the integer, i.e '0', instead of 0).  The epoch time is
            considered to be UTC.
          * An iso8601 formatted timestamp.  This does not need to be
            a complete timestamp, it can contain just the date portion
            without the time component.
  
      The returned value will be a datetime object that will have tzinfo.
      If no timezone info was provided in the input value, then UTC is
      assumed, not local time.
  
      """
      # This is a general purpose method that handles several cases of
      # converting the provided value to a string timestamp suitable to be
      # serialized to an http request. It can handle:
      # 1) A datetime.datetime object.
      if isinstance(value, datetime.datetime):
          datetime_obj = value
      else:
          # 2) A string object that's formatted as a timestamp.
          #    We document this as being an iso8601 timestamp, although
          #    parse_timestamp is a bit more flexible.
          datetime_obj = parse_timestamp(value)
      if datetime_obj.tzinfo is None:
          # I think a case would be made that if no time zone is provided,
          # we should use the local time.  However, to restore backwards
          # compat, the previous behavior was to assume UTC, which is
          # what we're going to do here.
          datetime_obj = datetime_obj.replace(tzinfo=tzutc())
      else:
          datetime_obj = datetime_obj.astimezone(tzutc())
      return datetime_obj
function_tokens: def parse_to_aware_datetime ( value ) : # This is a general purpose method that handles several cases of # converting the provided value to a string timestamp suitable to be # serialized to an http request. It can handle: # 1) A datetime.datetime object. if isinstance ( value , datetime . datetime ) : datetime_obj = value else : # 2) A string object that's formatted as a timestamp. #    We document this as being an iso8601 timestamp, although #    parse_timestamp is a bit more flexible. datetime_obj = parse_timestamp ( value ) if datetime_obj . tzinfo is None : # I think a case would be made that if no time zone is provided, # we should use the local time.  However, to restore backwards # compat, the previous behavior was to assume UTC, which is # what we're going to do here. datetime_obj = datetime_obj . replace ( tzinfo = tzutc ( ) ) else : datetime_obj = datetime_obj . astimezone ( tzutc ( ) ) return datetime_obj