1##############################################################################
2# Copyright 2009, Gerhard Weis
3# All rights reserved.
4#
5# Redistribution and use in source and binary forms, with or without
6# modification, are permitted provided that the following conditions are met:
7#
8# * Redistributions of source code must retain the above copyright notice,
9# this list of conditions and the following disclaimer.
10# * Redistributions in binary form must reproduce the above copyright notice,
11# this list of conditions and the following disclaimer in the documentation
12# and/or other materials provided with the distribution.
13# * Neither the name of the authors nor the names of its contributors
14# may be used to endorse or promote products derived from this software
15# without specific prior written permission.
16#
17# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
18# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
21# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
22# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
23# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
24# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
25# CONTRACT, STRICT LIABILITY, OR TORT
26##############################################################################
27'''
28This module defines a method to parse an ISO 8601:2004 date time string.
29
30For this job it uses the parse_date and parse_time methods defined in date
31and time module.
32'''
33from datetime import datetime
34
35from isodate.isostrf import strftime
36from isodate.isostrf import DATE_EXT_COMPLETE, TIME_EXT_COMPLETE, TZ_EXT
37from isodate.isodates import parse_date
38from isodate.isoerror import ISO8601Error
39from isodate.isotime import parse_time
40
41
42def parse_datetime(datetimestring):
43 '''
44 Parses ISO 8601 date-times into datetime.datetime objects.
45
46 This function uses parse_date and parse_time to do the job, so it allows
47 more combinations of date and time representations, than the actual
48 ISO 8601:2004 standard allows.
49 '''
50 try:
51 datestring, timestring = datetimestring.split('T')
52 except ValueError:
53 raise ISO8601Error("ISO 8601 time designator 'T' missing. Unable to"
54 " parse datetime string %r" % datetimestring)
55 tmpdate = parse_date(datestring)
56 tmptime = parse_time(timestring)
57 return datetime.combine(tmpdate, tmptime)
58
59
60def datetime_isoformat(tdt, format=DATE_EXT_COMPLETE + 'T' +
61 TIME_EXT_COMPLETE + TZ_EXT):
62 '''
63 Format datetime strings.
64
65 This method is just a wrapper around isodate.isostrf.strftime and uses
66 Extended-Complete as default format.
67 '''
68 return strftime(tdt, format)