+
−# -*- coding: latin-1 -*-
+
−
+
−""" Date/Time string parsing module.
+
−
+
−    Note about the Y2K problems:
+
−
+
−       The parser can only handle years with at least 2 digits. 2
+
−       digit year values get expanded by adding the century using
+
−       DateTime.add_century(), while 3 digit year get converted
+
−       literally. To have 2 digit years also be interpreted literally,
+
−       add leading zeros, e.g. year 99 must be written as 099 or 0099.
+
−
+
−    Copyright (c) 1998-2000, Marc-Andre Lemburg; mailto:mal@lemburg.com
+
−    Copyright (c) 2000-2007, eGenix.com Software GmbH; mailto:info@egenix.com
+
−    See the documentation for further information on copyrights,
+
−    or contact the author. All Rights Reserved.
+
−
+
−"""
+
−import types,re,string
+
−import DateTime,ISO,ARPA,Timezone
+
−
+
−# Enable to produce debugging output
+
−_debug = 0
+
−
+
−# REs for matching date and time parts in a string; These REs
+
−# parse a superset of ARPA, ISO, American and European style dates.
+
−# Timezones are supported via the Timezone submodule.
+
−
+
−_year = '(?P<year>-?\d+\d(?!:))'
+
−_fullyear = '(?P<year>-?\d+\d\d(?!:))'
+
−_year_epoch = '(?:' + _year + '(?P<epoch> *[ABCDE\.]+)?)'
+
−_fullyear_epoch = '(?:' + _fullyear + '(?P<epoch> *[ABCDE\.]+)?)'
+
−_relyear = '(?:\((?P<relyear>[-+]?\d+)\))'
+
−
+
−_month = '(?P<month>\d?\d(?!:))'
+
−_fullmonth = '(?P<month>\d\d(?!:))'
+
−_litmonth = ('(?P<litmonth>'
+
−             'jan|feb|mar|apr|may|jun|jul|aug|sep|oct|nov|dec|'
+
−             'm�r|mae|mrz|mai|okt|dez|'
+
−             'fev|avr|juin|juil|aou|ao�|d�c|'
+
−             'ene|abr|ago|dic|'
+
−             'out'
+
−             ')[a-z,\.;]*')
+
−litmonthtable = {
+
−    # English
+
−    'jan':1, 'feb':2, 'mar':3, 'apr':4, 'may':5, 'jun':6,
+
−    'jul':7, 'aug':8, 'sep':9, 'oct':10, 'nov':11, 'dec':12,
+
−    # German
+
−    'm�r':3, 'mae':3, 'mrz':3, 'mai':5, 'okt':10, 'dez':12,
+
−    # French
+
−    'fev':2, 'avr':4, 'juin':6, 'juil':7, 'aou':8, 'ao�':8,
+
−    'd�c':12,
+
−    # Spanish
+
−    'ene':1, 'abr':4, 'ago':8, 'dic':12,
+
−    # Portuguese
+
−    'out':10,
+
−    }
+
−_relmonth = '(?:\((?P<relmonth>[-+]?\d+)\))'
+
−
+
−_day = '(?P<day>\d?\d(?!:))'
+
−_usday = '(?P<day>\d?\d(?!:))(?:st|nd|rd|th|[,\.;])?'
+
−_fullday = '(?P<day>\d\d(?!:))'
+
−_litday = ('(?P<litday>'
+
−           'mon|tue|wed|thu|fri|sat|sun|'
+
−           'die|mit|don|fre|sam|son|'
+
−           'lun|mar|mer|jeu|ven|sam|dim|'
+
−           'mie|jue|vie|sab|dom|'
+
−           'pri|seg|ter|cua|qui'
+
−           ')[a-z]*')
+
−litdaytable = {
+
−    # English
+
−    'mon':0, 'tue':1, 'wed':2, 'thu':3, 'fri':4, 'sat':5, 'sun':6,
+
−    # German
+
−    'die':1, 'mit':2, 'don':3, 'fre':4, 'sam':5, 'son':6,
+
−    # French
+
−    'lun':0, 'mar':1, 'mer':2, 'jeu':3, 'ven':4, 'sam':5, 'dim':6,
+
−    # Spanish
+
−    'mie':2, 'jue':3, 'vie':4, 'sab':5, 'dom':6,
+
−    # Portuguese
+
−    'pri':0, 'seg':1, 'ter':2, 'cua':3, 'qui':4,
+
−    }
+
−_relday = '(?:\((?P<relday>[-+]?\d+)\))'
+
−
+
−_hour = '(?P<hour>[012]?\d)'
+
−_minute = '(?P<minute>[0-6]\d)'
+
−_second = '(?P<second>[0-6]\d(?:[.,]\d+)?)'
+
−
+
−_days = '(?P<days>\d*\d(?:[.,]\d+)?)'
+
−_hours = '(?P<hours>\d*\d(?:[.,]\d+)?)'
+
−_minutes = '(?P<minutes>\d*\d(?:[.,]\d+)?)'
+
−_seconds = '(?P<seconds>\d*\d(?:[.,]\d+)?)'
+
−
+
−_reldays = '(?:\((?P<reldays>[-+]?\d+(?:[.,]\d+)?)\))'
+
−_relhours = '(?:\((?P<relhours>[-+]?\d+(?:[.,]\d+)?)\))'
+
−_relminutes = '(?:\((?P<relminutes>[-+]?\d+(?:[.,]\d+)?)\))'
+
−_relseconds = '(?:\((?P<relseconds>[-+]?\d+(?:[.,]\d+)?)\))'
+
−
+
−_sign = '(?:(?P<sign>[-+]) *)'
+
−_week = 'W(?P<week>\d?\d)'
+
−_zone = Timezone.zone
+
−_ampm = '(?P<ampm>[ap][m.]+)'
+
−
+
−_time = (_hour + ':' + _minute + '(?::' + _second + '|[^:]|$) *'
+
−         + _ampm + '? *' + _zone + '?')
+
−_isotime = _hour + ':?' + _minute + ':?' + _second + '? *' + _zone + '?'
+
−
+
−_weekdate = _year + '-?(?:' + _week + '-?' + _day + '?)?'
+
−_eurodate = _day + '\.' + _month + '\.' + _year_epoch + '?'
+
−_usdate = _month + '/' + _day + '(?:/' + _year_epoch + '|[^/]|$)'
+
−_altusdate = _month + '-' + _day + '-' + _fullyear_epoch
+
−_isodate = _year + '-' + _month + '-?' + _day + '?(?!:)'
+
−_altisodate = _year + _fullmonth + _fullday + '(?!:)'
+
−_usisodate = _fullyear + '/' + _fullmonth + '/' + _fullday
+
−_litdate = ('(?:'+ _litday + ',? )? *' + 
+
−            _usday + ' *' + 
+
−            '[- ] *(?:' + _litmonth + '|'+ _month +') *[- ] *' +
+
−            _year_epoch + '?')
+
−_altlitdate = ('(?:'+ _litday + ',? )? *' + 
+
−               _litmonth + '[ ,.a-z]+' +
+
−               _usday + 
+
−               '(?:[ a-z]+' + _year_epoch + ')?')
+
−_eurlitdate = ('(?:'+ _litday + ',?[ a-z]+)? *' + 
+
−               '(?:'+ _usday + '[ a-z]+)? *' +
+
−               _litmonth + 
+
−               '(?:[ ,.a-z]+' + _year_epoch + ')?')
+
−
+
−_relany = '[*%?a-zA-Z]+'
+
−
+
−_relisodate = ('(?:(?:' + _relany + '|' + _year + '|' + _relyear + ')-' +
+
−               '(?:' + _relany + '|' + _month + '|' + _relmonth + ')-' +
+
−               '(?:' + _relany + '|' + _day + '|' + _relday + '))')
+
−
+
−_asctime = ('(?:'+ _litday + ',? )? *' + 
+
−                _usday + ' *' + 
+
−                '[- ] *(?:' + _litmonth + '|'+ _month +') *[- ]' +
+
−                '(?:[0-9: ]+)' + 
+
−                _year_epoch + '?')
+
−
+
−_relisotime = ('(?:(?:' + _relany + '|' + _hour + '|' + _relhours + '):' +
+
−               '(?:' + _relany + '|' + _minute + '|' + _relminutes + ')' +
+
−               '(?::(?:' + _relany + '|' + _second + '|' + _relseconds + '))?)')
+
−
+
−_isodelta1 = (_sign + '?' +
+
−              _days + ':' + _hours + ':' + _minutes + ':' + _seconds)
+
−_isodelta2 = (_sign + '?' + 
+
−              _hours + ':' + _minutes + ':' + _seconds)
+
−_isodelta3 = (_sign + '?' + 
+
−              _hours + ':' + _minutes)
+
−_litdelta = (_sign + '?' +
+
−             '(?:' + _days + ' *d[a-z]*[,; ]*)?' + 
+
−             '(?:' + _hours + ' *h[a-z]*[,; ]*)?' + 
+
−             '(?:' + _minutes + ' *m[a-z]*[,; ]*)?' +
+
−             '(?:' + _seconds + ' *s[a-z]*[,; ]*)?')
+
−_litdelta2 = (_sign + '?' +
+
−             '(?:' + _days + ' *d[a-z]*[,; ]*)?' + 
+
−              _hours + ':' + _minutes + '(?::' + _seconds + ')?')
+
−
+
−_timeRE = re.compile(_time, re.I)
+
−_isotimeRE = re.compile(_isotime, re.I)
+
−_isodateRE = re.compile(_isodate, re.I)
+
−_altisodateRE = re.compile(_altisodate, re.I)
+
−_usisodateRE = re.compile(_usisodate, re.I)
+
−_eurodateRE = re.compile(_eurodate, re.I)
+
−_usdateRE = re.compile(_usdate, re.I)
+
−_altusdateRE = re.compile(_altusdate, re.I)
+
−_litdateRE = re.compile(_litdate, re.I)
+
−_altlitdateRE = re.compile(_altlitdate, re.I)
+
−_eurlitdateRE = re.compile(_eurlitdate, re.I)
+
−_relisodateRE = re.compile(_relisodate, re.I)
+
−_asctimeRE = re.compile(_asctime, re.I)
+
−_isodelta1RE = re.compile(_isodelta1)
+
−_isodelta2RE = re.compile(_isodelta2)
+
−_isodelta3RE = re.compile(_isodelta3)
+
−_litdeltaRE = re.compile(_litdelta)
+
−_litdelta2RE = re.compile(_litdelta2)
+
−_relisotimeRE = re.compile(_relisotime, re.I)
+
−
+
−# Available date parsers
+
−_date_formats = ('euro',
+
−                 'usiso', 'us', 'altus',
+
−                 'iso', 'altiso', 
+
−                 'lit', 'altlit', 'eurlit',
+
−                 'unknown')
+
−
+
−# Available time parsers
+
−_time_formats = ('standard',
+
−                 'iso',
+
−                 'unknown')
+
−
+
−def _parse_date(text, formats=_date_formats, defaultdate=None,
+
−
+
−                int=int,float=float,lower=string.lower,
+
−                add_century=DateTime.add_century,
+
−                now=DateTime.now,us_formats=('us', 'altus'),
+
−                iso_formats=('iso', 'altiso', 'usiso')):
+
−
+
−    """ Parses the date part given in text and returns a tuple
+
−        (text,day,month,year,style) with the following
+
−        meanings:
+
−
+
−        * text gives the original text without the date part
+
−
+
−        * day,month,year give the parsed date
+
−
+
−        * style gives information about which parser was successful:
+
−          'euro' - the European date parser
+
−          'us' - the US date parser
+
−          'altus' - the alternative US date parser (with '-' instead of '/')
+
−          'iso' - the ISO date parser
+
−          'altiso' - the alternative ISO date parser (without '-')
+
−          'usiso' - US style ISO date parser (yyyy/mm/dd)
+
−          'lit' - the US literal date parser
+
−          'altlit' - the alternative US literal date parser
+
−          'eurlit' - the Eurpean literal date parser
+
−          'unknown' - no date part was found, defaultdate was used
+
−
+
−        formats may be set to a tuple of style strings specifying
+
−        which of the above parsers to use and in which order to try
+
−        them. Default is to try all of them in the above order.
+
−
+
−        defaultdate provides the defaults to use in case no date part
+
−        is found. Most other parsers default to the current year
+
−        January 1 if some of these date parts are missing.
+
−
+
−        If 'unknown' is not given in formats and the date cannot be
+
−        parsed, a ValueError is raised.
+
−
+
−    """
+
−    match = None
+
−    style = ''
+
−    
+
−    # Apply parsers in the order given in formats
+
−    for format in formats:
+
−
+
−        if format == 'euro':
+
−            # European style date
+
−            match = _eurodateRE.search(text)
+
−            if match is not None:
+
−                day,month,year,epoch = match.groups()
+
−                if year:
+
−                    if len(year) == 2:
+
−                        # Y2K problem:
+
−                        year = add_century(int(year))
+
−                    else:
+
−                        year = int(year)
+
−                else:
+
−                    if defaultdate is None:
+
−                        defaultdate = now()
+
−                    year = defaultdate.year
+
−                if epoch and 'B' in epoch:
+
−                    year = -year + 1
+
−                month = int(month)
+
−                day = int(day)
+
−                # Could have mistaken euro format for us style date
+
−                # which uses month, day order
+
−                if month > 12 or month == 0:
+
−                    match = None
+
−                    continue
+
−                break
+
−
+
−        elif format in iso_formats:
+
−            # ISO style date
+
−            if format == 'iso':
+
−                match = _isodateRE.search(text)
+
−            elif format == 'altiso':
+
−                match = _altisodateRE.search(text)
+
−                # Avoid mistaking ISO time parts ('Thhmmss') for dates
+
−                if match is not None:
+
−                    left, right = match.span()
+
−                    if left > 0 and \
+
−                       text[left - 1:left] == 'T':
+
−                        match = None
+
−                        continue
+
−            else:
+
−                match = _usisodateRE.search(text)
+
−            if match is not None:
+
−                year,month,day = match.groups()
+
−                if len(year) == 2:
+
−                    # Y2K problem:
+
−                    year = add_century(int(year))
+
−                else:
+
−                    year = int(year)
+
−                # Default to January 1st
+
−                if not month:
+
−                    month = 1
+
−                else:
+
−                    month = int(month)
+
−                if not day:
+
−                    day = 1
+
−                else:
+
−                    day = int(day)
+
−                break
+
−
+
−        elif format in us_formats:
+
−            # US style date
+
−            if format == 'us':
+
−                match = _usdateRE.search(text)
+
−            else:
+
−                match = _altusdateRE.search(text)
+
−            if match is not None:
+
−                month,day,year,epoch = match.groups()
+
−                if year:
+
−                    if len(year) == 2:
+
−                        # Y2K problem:
+
−                        year = add_century(int(year))
+
−                    else:
+
−                        year = int(year)
+
−                else:
+
−                    if defaultdate is None:
+
−                        defaultdate = now()
+
−                    year = defaultdate.year
+
−                if epoch and 'B' in epoch:
+
−                    year = -year + 1
+
−                # Default to 1 if no day is given
+
−                if day:
+
−                    day = int(day)
+
−                else:
+
−                    day = 1
+
−                month = int(month)
+
−                # Could have mistaken us format for euro style date
+
−                # which uses day, month order
+
−                if month > 12 or month == 0:
+
−                    match = None
+
−                    continue
+
−                break
+
−
+
−        elif format == 'lit':
+
−            # US style literal date
+
−            match = _litdateRE.search(text)
+
−            if match is not None:
+
−                litday,day,litmonth,month,year,epoch = match.groups()
+
−                break
+
−
+
−        elif format == 'altlit':
+
−            # Alternative US style literal date
+
−            match = _altlitdateRE.search(text)
+
−            if match is not None: 
+
−                litday,litmonth,day,year,epoch = match.groups()
+
−                month = '<missing>'
+
−                break
+
−
+
−        elif format == 'eurlit':
+
−            # European style literal date
+
−            match = _eurlitdateRE.search(text)
+
−            if match is not None: 
+
−                litday,day,litmonth,year,epoch = match.groups()
+
−                month = '<missing>'
+
−                break
+
−
+
−        elif format == 'unknown':
+
−            # No date part: use defaultdate
+
−            if defaultdate is None:
+
−                defaultdate = now()
+
−            year = defaultdate.year
+
−            month = defaultdate.month
+
−            day = defaultdate.day
+
−            style = format
+
−            break
+
−
+
−    # Check success
+
−    if match is not None:
+
−        # Remove date from text
+
−        left, right = match.span()
+
−        if 0 and _debug:
+
−            print 'parsed date:',repr(text[left:right]),\
+
−                  'giving:',year,month,day
+
−        text = text[:left] + text[right:]
+
−        style = format
+
−        
+
−    elif not style:
+
−        # Not recognized: raise an error
+
−        raise ValueError, 'unknown date format: "%s"' % text
+
−
+
−    # Literal date post-processing
+
−    if style in ('lit', 'altlit', 'eurlit'):
+
−        if 0 and _debug: print match.groups()
+
−        # Default to current year, January 1st
+
−        if not year:
+
−            if defaultdate is None:
+
−                defaultdate = now()
+
−            year = defaultdate.year
+
−        else:
+
−            if len(year) == 2:
+
−                # Y2K problem:
+
−                year = add_century(int(year))
+
−            else:
+
−                year = int(year)
+
−        if epoch and 'B' in epoch:
+
−            year = -year + 1
+
−        if litmonth:
+
−            litmonth = lower(litmonth)
+
−            try:
+
−                month = litmonthtable[litmonth]
+
−            except KeyError:
+
−                raise ValueError,\
+
−                      'wrong month name: "%s"' % litmonth
+
−        elif month:
+
−            month = int(month)
+
−        else:
+
−            month = 1
+
−        if day:
+
−            day = int(day)
+
−        else:
+
−            day = 1
+
−
+
−    #print '_parse_date:',text,day,month,year,style
+
−    return text,day,month,year,style
+
−
+
−def _parse_time(text, formats=_time_formats,
+
−
+
−                int=int,float=float,replace=string.replace):
+
−
+
−    """ Parses a time part given in text and returns a tuple
+
−        (text,hour,minute,second,offset,style) with the following
+
−        meanings:
+
−
+
−        * text gives the original text without the time part
+
−        * hour,minute,second give the parsed time
+
−        * offset gives the time zone UTC offset
+
−        * style gives information about which parser was successful:
+
−          'standard' - the standard parser
+
−          'iso' - the ISO time format parser
+
−          'unknown' - no time part was found
+
−
+
−        formats may be set to a tuple specifying the parsers to use:
+
−          'standard' - standard time format with ':' delimiter
+
−          'iso' - ISO time format (superset of 'standard')
+
−          'unknown' - default to 0:00:00, 0 zone offset
+
−
+
−        If 'unknown' is not given in formats and the time cannot be
+
−        parsed, a ValueError is raised.
+
−
+
−    """
+
−    match = None
+
−    style = ''
+
−
+
−    # Apply parsers in the order given in formats
+
−    for format in formats:
+
−
+
−        # Standard format
+
−        if format == 'standard':
+
−            match = _timeRE.search(text)
+
−            if match is not None:
+
−                hour,minute,second,ampm,zone = match.groups()
+
−                style = 'standard'
+
−                break
+
−
+
−        # ISO format
+
−        if format == 'iso':
+
−            match =  _isotimeRE.search(text)
+
−            if match is not None:
+
−                hour,minute,second,zone = match.groups()
+
−                ampm = None
+
−                style = 'iso'
+
−                break
+
−
+
−        # Default handling
+
−        elif format == 'unknown':
+
−            hour,minute,second,offset = 0,0,0.0,0
+
−            style = 'unknown'
+
−            break
+
−
+
−    if not style:
+
−        # If no default handling should be applied, raise an error
+
−        raise ValueError, 'unknown time format: "%s"' % text
+
−
+
−    # Post-processing
+
−    if match is not None:
+
−        if zone:
+
−            # Convert to UTC offset
+
−            offset = Timezone.utc_offset(zone)
+
−        else:
+
−            offset = 0
+
−        hour = int(hour)
+
−        if ampm:
+
−            if ampm[0] in ('p', 'P'):
+
−                # 12pm = midday
+
−                if hour < 12:
+
−                    hour = hour + 12
+
−            else:
+
−                # 12am = midnight 
+
−                if hour >= 12:
+
−                    hour = hour - 12
+
−        if minute:
+
−            minute = int(minute)
+
−        else:
+
−            minute = 0
+
−        if not second:
+
−            second = 0.0
+
−        else:
+
−            if ',' in second:
+
−                second = replace(second, ',', '.')
+
−            second = float(second)
+
−
+
−        # Remove time from text
+
−        left,right = match.span()
+
−        if 0 and _debug: 
+
−            print 'parsed time:',repr(text[left:right]),\
+
−                  'giving:',hour,minute,second,offset
+
−        text = text[:left] + text[right:]
+
−
+
−    #print '_parse_time:',text,hour,minute,second,offset,style
+
−    return text,hour,minute,second,offset,style
+
−
+
−###
+
−
+
−def DateTimeFromString(text, formats=_date_formats, defaultdate=None,
+
−                       time_formats=_time_formats,
+
−
+
−                       DateTime=DateTime):
+
−
+
−    """ DateTimeFromString(text, [formats, defaultdate])
+
−    
+
−        Returns a DateTime instance reflecting the date and time given
+
−        in text. In case a timezone is given, the returned instance
+
−        will point to the corresponding UTC time value. Otherwise, the
+
−        value is set as given in the string.
+
−
+
−        formats may be set to a tuple of strings specifying which of
+
−        the following parsers to use and in which order to try
+
−        them. Default is to try all of them in the order given below:
+
−
+
−          'euro' - the European date parser
+
−          'us' - the US date parser
+
−          'altus' - the alternative US date parser (with '-' instead of '/')
+
−          'iso' - the ISO date parser
+
−          'altiso' - the alternative ISO date parser (without '-')
+
−          'usiso' - US style ISO date parser (yyyy/mm/dd)
+
−          'lit' - the US literal date parser
+
−          'altlit' - the alternative US literal date parser
+
−          'eurlit' - the Eurpean literal date parser
+
−          'unknown' - if no date part is found, use defaultdate
+
−
+
−        defaultdate provides the defaults to use in case no date part
+
−        is found. Most of the parsers default to the current year
+
−        January 1 if some of these date parts are missing.
+
−
+
−        If 'unknown' is not given in formats and the date cannot
+
−        be parsed, a ValueError is raised.
+
−
+
−        time_formats may be set to a tuple of strings specifying which
+
−        of the following parsers to use and in which order to try
+
−        them. Default is to try all of them in the order given below:
+
−
+
−          'standard' - standard time format HH:MM:SS (with ':' delimiter)
+
−          'iso' - ISO time format (superset of 'standard')
+
−          'unknown' - default to 00:00:00 in case the time format
+
−                      cannot be parsed
+
−
+
−        Defaults to 00:00:00.00 for time parts that are not included
+
−        in the textual representation.
+
−
+
−        If 'unknown' is not given in time_formats and the time cannot
+
−        be parsed, a ValueError is raised.
+
−
+
−    """
+
−    origtext = text
+
−    formats = tuple(formats)
+
−
+
−    if formats is _date_formats or \
+
−       'iso' in formats or \
+
−       'altiso' in formats:
+
−
+
−        # First try standard order (parse time, then date)
+
−        if formats[0] not in ('iso', 'altiso'):
+
−            text,hour,minute,second,offset,timestyle = _parse_time(
+
−                origtext,
+
−                time_formats)
+
−            text,day,month,year,datestyle = _parse_date(
+
−                text,
+
−                formats + ('unknown',),
+
−                defaultdate)
+
−            if 0 and _debug:
+
−                print 'tried time/date on %s, date=%s, time=%s' % (origtext,
+
−                                                                   datestyle,
+
−                                                                   timestyle)
+
−        else:
+
−            timestyle = 'iso'
+
−            
+
−        # If this fails, try the ISO order (date, then time)
+
−        if timestyle in ('iso', 'unknown'):
+
−            text,day,month,year,datestyle = _parse_date(
+
−                origtext,
+
−                formats,
+
−                defaultdate)
+
−            text,hour,minute,second,offset,timestyle = _parse_time(
+
−                text,
+
−                time_formats)
+
−            if 0 and _debug:
+
−                print 'tried ISO on %s, date=%s, time=%s' % (origtext,
+
−                                                             datestyle,
+
−                                                             timestyle)
+
−    else:
+
−        # Standard order: time part, then date part
+
−        text,hour,minute,second,offset,timestyle = _parse_time(
+
−            origtext,
+
−            time_formats)
+
−        text,day,month,year,datestyle = _parse_date(
+
−            text,
+
−            formats,
+
−            defaultdate)
+
−
+
−    if (datestyle == 'unknown' and 'unknown' not in formats) or \
+
−       (timestyle == 'unknown' and 'unknown' not in time_formats):
+
−        raise ValueError,\
+
−              'Failed to parse "%s": found "%s" date, "%s" time' % \
+
−              (origtext, datestyle, timestyle)
+
−    
+
−    try:
+
−        return DateTime.DateTime(year,month,day,hour,minute,second) - offset
+
−    except DateTime.RangeError, why:
+
−        raise DateTime.RangeError,\
+
−              'Failed to parse "%s": %s' % (origtext, why)
+
−
+
−def DateFromString(text, formats=_date_formats, defaultdate=None,
+
−
+
−                   DateTime=DateTime):
+
−
+
−    """ DateFromString(text, [formats, defaultdate])
+
−    
+
−        Returns a DateTime instance reflecting the date given in
+
−        text. A possibly included time part is ignored.
+
−
+
−        formats and defaultdate work just like for
+
−        DateTimeFromString().
+
−
+
−    """
+
−    _text,day,month,year,datestyle = _parse_date(text, formats, defaultdate)
+
−
+
−    if datestyle == 'unknown' and \
+
−       'unknown' not in formats:
+
−        raise ValueError,\
+
−              'Failed to parse "%s": found "%s" date' % \
+
−              (origtext, datestyle)
+
−
+
−    try:
+
−        return DateTime.DateTime(year,month,day)
+
−    except DateTime.RangeError, why:
+
−        raise DateTime.RangeError,\
+
−              'Failed to parse "%s": %s' % (text, why)
+
−
+
−def validateDateTimeString(text, formats=_date_formats):
+
−
+
−    """ validateDateTimeString(text, [formats, defaultdate])
+
−
+
−        Validates the given text and returns 1/0 depending on whether
+
−        text includes parseable date and time values or not.
+
−
+
−        formats works just like for DateTimeFromString() and defines
+
−        the order of date/time parsers to apply. It defaults to the
+
−        same list of parsers as for DateTimeFromString().
+
−
+
−        XXX Undocumented !
+
−    
+
−    """
+
−    formats = list(formats)
+
−    if 'unknown' in formats:
+
−        formats.remove('unknown')
+
−    try:
+
−        DateTimeFromString(text, formats)
+
−    except (DateTime.RangeError, ValueError), why:
+
−        return 0
+
−    return 1
+
−
+
−def validateDateString(text, formats=_date_formats):
+
−
+
−    """ validateDateString(text, [formats, defaultdate])
+
−
+
−        Validates the given text and returns 1/0 depending on whether
+
−        text includes a parseable date value or not.
+
−
+
−        formats works just like for DateTimeFromString() and defines
+
−        the order of date/time parsers to apply. It defaults to the
+
−        same list of parsers as for DateTimeFromString().
+
−    
+
−        XXX Undocumented !
+
−    
+
−    """
+
−    formats = list(formats)
+
−    if 'unknown' in formats:
+
−        formats.remove('unknown')
+
−    try:
+
−        DateFromString(text, formats)
+
−    except (DateTime.RangeError, ValueError), why:
+
−        return 0
+
−    return 1
+
−
+
−def TimeFromString(text, formats=_time_formats,
+
−
+
−                   DateTime=DateTime):
+
−
+
−    """ TimeFromString(text, [formats])
+
−    
+
−        Returns a DateTimeDelta instance reflecting the time given in
+
−        text. A possibly included date part is ignored.
+
−
+
−        formats may be set to a tuple of strings specifying which of
+
−        the following parsers to use and in which order to try
+
−        them. Default is to try all of them in the order given below:
+
−
+
−          'standard' - standard time format with ':' delimiter
+
−          'iso' - ISO time format (superset of 'standard')
+
−          'unknown' - default to 00:00:00 in case the time format
+
−                      cannot be parsed
+
−
+
−        Defaults to 00:00:00.00 for parts that are not included in the
+
−        textual representation.
+
−        
+
−    """
+
−    _text,hour,minute,second,offset,timestyle = _parse_time(
+
−        text,
+
−        formats)
+
−
+
−    if timestyle == 'unknown' and \
+
−       'unknown' not in formats:
+
−        raise ValueError,\
+
−              'Failed to parse "%s": found "%s" time' % \
+
−              (text, timestyle)
+
−
+
−    try:
+
−        dtd = DateTime.DateTimeDelta(0.0, hour, minute, second)
+
−    except DateTime.RangeError, why:
+
−        raise DateTime.RangeError,\
+
−              'Failed to parse "%s": %s' % (text, why)
+
−    else:
+
−        # XXX What to do with offset ?
+
−        return dtd
+
−
+
−#
+
−# XXX Still missing: validateTimeString(), validateDateTimeDeltaString()
+
−#                    and validateTimeDeltaString()
+
−#
+
−
+
−def DateTimeDeltaFromString(text,
+
−
+
−                            float=float,DateTime=DateTime):
+
−
+
−    """ DateTimeDeltaFromString(text)
+
−    
+
−        Returns a DateTimeDelta instance reflecting the delta given in
+
−        text. Defaults to 0:00:00:00.00 for parts that are not
+
−        included in the textual representation or cannot be parsed.
+
−
+
−    """
+
−    match = _isodelta1RE.search(text)
+
−    if match is not None:
+
−        sign, days, hours, minutes, seconds = match.groups()
+
−    else:
+
−        match = _litdelta2RE.search(text)
+
−        if match is not None:
+
−            sign, days, hours, minutes, seconds = match.groups()
+
−        else:
+
−            match = _isodelta2RE.search(text)
+
−            if match is not None:
+
−                sign, hours, minutes, seconds = match.groups()
+
−                days = None
+
−            else:
+
−                match = _isodelta3RE.search(text)
+
−                if match is not None:
+
−                    sign, hours, minutes = match.groups()
+
−                    days = None
+
−                    seconds = None
+
−                else:
+
−                    match = _litdeltaRE.search(text)
+
−                    if match is not None:
+
−                        sign, days, hours, minutes, seconds = match.groups()
+
−
+
−                    else:
+
−                        # Not matched:
+
−                        return DateTime.DateTimeDelta(0.0)
+
−
+
−    # Conversions
+
−    if days:
+
−        days = float(days)
+
−    else:
+
−        days = 0.0
+
−    if hours:
+
−        hours = float(hours)
+
−    else:
+
−        hours = 0.0
+
−    if minutes:
+
−        minutes = float(minutes)
+
−    else:
+
−        minutes = 0.0
+
−    if seconds:
+
−        seconds = float(seconds)
+
−    else:
+
−        seconds = 0.0
+
−    if sign != '-':
+
−        sign = 1
+
−    else:
+
−        sign = -1
+
−
+
−    try:
+
−        dtd = DateTime.DateTimeDelta(days,hours,minutes,seconds)
+
−    except DateTime.RangeError, why:
+
−        raise DateTime.RangeError,\
+
−              'Failed to parse "%s": %s' % (text, why)
+
−    else:
+
−        if sign < 0:
+
−            return -dtd
+
−        else:
+
−            return dtd
+
−
+
−# Aliases
+
−TimeDeltaFromString = DateTimeDeltaFromString
+
−
+
−###
+
−
+
−def _parse_reldate(text,
+
−
+
−                   int=int,float=float):
+
−
+
−    match = _relisodateRE.search(text)
+
−    if match is not None:
+
−        groups = match.groups()
+
−        if 0 and _debug: print groups
+
−        year,years,month,months,day,days = groups
+
−        if year:
+
−            year = int(year)
+
−        if years:
+
−            years = float(years)
+
−        else:
+
−            years = 0
+
−        if month:
+
−            month = int(month)
+
−        if months:
+
−            months = float(months)
+
−        else:
+
−            months = 0
+
−        if day:
+
−            day = int(day)
+
−        if days:
+
−            days = float(days)
+
−        else:
+
−            days = 0
+
−        return year,years,month,months,day,days
+
−    else:
+
−        return None,0,None,0,None,0
+
−
+
−def _parse_reltime(text,
+
−
+
−                   int=int,float=float):
+
−
+
−    match = _relisotimeRE.search(text)
+
−    if match is not None:
+
−        groups = match.groups()
+
−        if 0 and _debug: print groups
+
−        hour,hours,minute,minutes,second,seconds = groups
+
−        if hour:
+
−            hour = int(hour)
+
−        if hours:
+
−            hours = float(hours)
+
−        else:
+
−            hours = 0
+
−        if minute:
+
−            minute = int(minute)
+
−        if minutes:
+
−            minutes = float(minutes)
+
−        else:
+
−            minutes = 0
+
−        if second:
+
−            second = int(second)
+
−        if seconds:
+
−            seconds = float(seconds)
+
−        else:
+
−            seconds = 0
+
−        return hour,hours,minute,minutes,second,seconds
+
−    else:
+
−        return None,0,None,0,None,0
+
−
+
−def RelativeDateTimeFromString(text,
+
−
+
−                               RelativeDateTime=DateTime.RelativeDateTime):
+
−
+
−    """ RelativeDateTimeFromString(text)
+
−    
+
−        Returns a RelativeDateTime instance reflecting the relative
+
−        date and time given in text.
+
−
+
−        Defaults to wildcards for parts or values which are not
+
−        included in the textual representation or cannot be parsed.
+
−
+
−        The format used in text must adhere to the following syntax:
+
−
+
−                        [YYYY-MM-DD] [HH:MM[:SS]]
+
−
+
−        with the usual meanings. Values which should not be altered
+
−        may be replaced with '*', '%', '?' or any combination of
+
−        letters, e.g. 'YYYY'. Relative settings must be enclosed in
+
−        parenthesis if given and should include a sign, e.g. '(+0001)'
+
−        for the year part. All other settings are interpreted as
+
−        absolute values.
+
−
+
−        Date and time parts are both optional as a whole. Seconds in
+
−        the time part are optional too. Everything else (including the
+
−        hyphens and colons) is mandatory.
+
−
+
−    """
+
−    year,years,month,months,day,days = _parse_reldate(text)
+
−    hour,hours,minute,minutes,second,seconds = _parse_reltime(text)
+
−    return RelativeDateTime(year=year,years=years,
+
−                            month=month,months=months,
+
−                            day=day,days=days,
+
−                            hour=hour,hours=hours,
+
−                            minute=minute,minutes=minutes,
+
−                            second=second,seconds=seconds)
+
−
+
−def RelativeDateFromString(text,
+
−
+
−                           RelativeDateTime=DateTime.RelativeDateTime):
+
−
+
−    """ RelativeDateFromString(text)
+
−    
+
−        Same as RelativeDateTimeFromString(text) except that only the
+
−        date part of text is taken into account.
+
−
+
−    """
+
−    year,years,month,months,day,days = _parse_reldate(text)
+
−    return RelativeDateTime(year=year,years=years,
+
−                            month=month,months=months,
+
−                            day=day,days=days)
+
−
+
−def RelativeTimeFromString(text,
+
−
+
−                           RelativeDateTime=DateTime.RelativeDateTime):
+
−
+
−    """ RelativeTimeFromString(text)
+
−    
+
−        Same as RelativeDateTimeFromString(text) except that only the
+
−        time part of text is taken into account.
+
−
+
−    """
+
−    hour,hours,minute,minutes,second,seconds = _parse_reltime(text)
+
−    return RelativeDateTime(hour=hour,hours=hours,
+
−                            minute=minute,minutes=minutes,
+
−                            second=second,seconds=seconds)
+
−
+
−### Tests
+
−
+
−def _test():
+
−
+
−    import sys
+
−
+
−    t = DateTime.now()
+
−
+
−    print 'Testing DateTime Parser...'
+
−
+
−    l = [
+
−
+
−        # Literal formats
+
−        ('Sun Nov  6 08:49:37 1994', '1994-11-06 08:49:37.00'),
+
−        ('sun nov  6 08:49:37 1994', '1994-11-06 08:49:37.00'),
+
−        ('sUN NOV  6 08:49:37 1994', '1994-11-06 08:49:37.00'),
+
−        ('Sunday, 06-Nov-94 08:49:37 GMT', '1994-11-06 08:49:37.00'),
+
−        ('Sun, 06 Nov 1994 08:49:37 GMT', '1994-11-06 08:49:37.00'),
+
−        ('06-Nov-94 08:49:37', '1994-11-06 08:49:37.00'),
+
−        ('06-Nov-94', '1994-11-06 00:00:00.00'),
+
−        ('06-NOV-94', '1994-11-06 00:00:00.00'),
+
−        ('November 19 08:49:37', '%s-11-19 08:49:37.00' % t.year),
+
−        ('Nov. 9', '%s-11-09 00:00:00.00' % t.year),
+
−        ('Sonntag, der 6. November 1994, 08:49:37 GMT', '1994-11-06 08:49:37.00'),
+
−        ('6. November 2001, 08:49:37', '2001-11-06 08:49:37.00'),
+
−        ('sep 6', '%s-09-06 00:00:00.00' % t.year),
+
−        ('sep 6 2000', '2000-09-06 00:00:00.00'),
+
−        ('September 29', '%s-09-29 00:00:00.00' % t.year),
+
−        ('Sep. 29', '%s-09-29 00:00:00.00' % t.year),
+
−        ('6 sep', '%s-09-06 00:00:00.00' % t.year),
+
−        ('29 September', '%s-09-29 00:00:00.00' % t.year),
+
−        ('29 Sep.', '%s-09-29 00:00:00.00' % t.year),
+
−        ('sep 6 2001', '2001-09-06 00:00:00.00'),
+
−        ('Sep 6, 2001', '2001-09-06 00:00:00.00'),
+
−        ('September 6, 2001', '2001-09-06 00:00:00.00'),
+
−        ('sep 6 01', '2001-09-06 00:00:00.00'),
+
−        ('Sep 6, 01', '2001-09-06 00:00:00.00'),
+
−        ('September 6, 01', '2001-09-06 00:00:00.00'),
+
−        ('30 Apr 2006 20:19:00', '2006-04-30 20:19:00.00'),
+
−        
+
−        # ISO formats
+
−        ('1994-11-06 08:49:37', '1994-11-06 08:49:37.00'),
+
−        ('010203', '2001-02-03 00:00:00.00'),
+
−        ('2001-02-03 00:00:00.00', '2001-02-03 00:00:00.00'),
+
−        ('2001-02 00:00:00.00', '2001-02-01 00:00:00.00'),
+
−        ('2001-02-03', '2001-02-03 00:00:00.00'),
+
−        ('2001-02', '2001-02-01 00:00:00.00'),
+
−        ('20000824/2300', '2000-08-24 23:00:00.00'),
+
−        ('20000824/0102', '2000-08-24 01:02:00.00'),
+
−        ('20000824', '2000-08-24 00:00:00.00'),
+
−        ('20000824/020301', '2000-08-24 02:03:01.00'),
+
−        ('20000824 020301', '2000-08-24 02:03:01.00'),
+
−        ('-20000824 020301', '-2000-08-24 02:03:01.00'),
+
−        ('20000824T020301', '2000-08-24 02:03:01.00'),
+
−        ('20000824 020301', '2000-08-24 02:03:01.00'),
+
−        ('2000-08-24 02:03:01.00', '2000-08-24 02:03:01.00'),
+
−        ('T020311', '%s 02:03:11.00' % t.date),
+
−        ('2003-12-9', '2003-12-09 00:00:00.00'),
+
−        ('03-12-9', '2003-12-09 00:00:00.00'),
+
−        ('003-12-9', '0003-12-09 00:00:00.00'),
+
−        ('0003-12-9', '0003-12-09 00:00:00.00'),
+
−        ('2003-1-9', '2003-01-09 00:00:00.00'),
+
−        ('03-1-9', '2003-01-09 00:00:00.00'),
+
−        ('003-1-9', '0003-01-09 00:00:00.00'),
+
−        ('0003-1-9', '0003-01-09 00:00:00.00'),
+
−
+
−        # US formats
+
−        ('06/11/94 08:49:37', '1994-06-11 08:49:37.00'),
+
−        ('11/06/94 08:49:37', '1994-11-06 08:49:37.00'),
+
−        ('9/23/2001', '2001-09-23 00:00:00.00'),
+
−        ('9-23-2001', '2001-09-23 00:00:00.00'),
+
−        ('9/6', '%s-09-06 00:00:00.00' % t.year),
+
−        ('09/6', '%s-09-06 00:00:00.00' % t.year),
+
−        ('9/06', '%s-09-06 00:00:00.00' % t.year),
+
−        ('09/06', '%s-09-06 00:00:00.00' % t.year),
+
−        ('9/6/2001', '2001-09-06 00:00:00.00'),
+
−        ('09/6/2001', '2001-09-06 00:00:00.00'),
+
−        ('9/06/2001', '2001-09-06 00:00:00.00'),
+
−        ('09/06/2001', '2001-09-06 00:00:00.00'),
+
−        ('9-6-2001', '2001-09-06 00:00:00.00'),
+
−        ('09-6-2001', '2001-09-06 00:00:00.00'),
+
−        ('9-06-2001', '2001-09-06 00:00:00.00'),
+
−        ('09-06-2001', '2001-09-06 00:00:00.00'),
+
−        ('2002/05/28 13:10:56.1147 GMT+2', '2002-05-28 13:10:56.11'),
+
−        ('1970/01/01', '1970-01-01 00:00:00.00'),
+
−        ('20021025 12:00 PM', '2002-10-25 12:00:00.00'),
+
−        ('20021025 12:30 PM', '2002-10-25 12:30:00.00'),
+
−        ('20021025 12:00 AM', '2002-10-25 00:00:00.00'),
+
−        ('20021025 12:30 AM', '2002-10-25 00:30:00.00'),
+
−        ('20021025 1:00 PM', '2002-10-25 13:00:00.00'),
+
−        ('20021025 2:00 AM', '2002-10-25 02:00:00.00'),
+
−        ('Thursday, February 06, 2003 12:40 PM', '2003-02-06 12:40:00.00'),
+
−        ('Mon, 18 Sep 2006 23:03:00', '2006-09-18 23:03:00.00'),
+
−
+
−        # European formats
+
−        ('6.11.2001, 08:49:37', '2001-11-06 08:49:37.00'),
+
−        ('06.11.2001, 08:49:37', '2001-11-06 08:49:37.00'),
+
−        ('06.11. 08:49:37', '%s-11-06 08:49:37.00' % t.year),
+
−        #('21/12/2002', '2002-12-21 00:00:00.00'),
+
−        #('21/08/2002', '2002-08-21 00:00:00.00'),
+
−        #('21-08-2002', '2002-08-21 00:00:00.00'),
+
−        #('13/01/03', '2003-01-13 00:00:00.00'),
+
−        #('13/1/03', '2003-01-13 00:00:00.00'),
+
−        #('13/1/3', '2003-01-13 00:00:00.00'),
+
−        #('13/01/3', '2003-01-13 00:00:00.00'),
+
−
+
−        # Time only formats
+
−        ('01:03', '%s 01:03:00.00' % t.date),
+
−        ('01:03:11', '%s 01:03:11.00' % t.date),
+
−        ('01:03:11.50', '%s 01:03:11.50' % t.date),
+
−        ('01:03:11.50 AM', '%s 01:03:11.50' % t.date),
+
−        ('01:03:11.50 PM', '%s 13:03:11.50' % t.date),
+
−        ('01:03:11.50 a.m.', '%s 01:03:11.50' % t.date),
+
−        ('01:03:11.50 p.m.', '%s 13:03:11.50' % t.date),
+
−
+
−        # Invalid formats
+
−        ('6..2001, 08:49:37', '%s 08:49:37.00' % t.date),
+
−        ('9//2001', 'ignore'),
+
−        ('06--94 08:49:37', 'ignore'),
+
−        ('20000824020301', 'ignore'),
+
−        ('20-03 00:00:00.00', 'ignore'),
+
−        ('9/2001', 'ignore'),
+
−        ('9-6', 'ignore'),
+
−        ('09-6', 'ignore'),
+
−        ('9-06', 'ignore'),
+
−        ('09-06', 'ignore'),
+
−        ('20000824/23', 'ignore'),
+
−        ('November 1994 08:49:37', 'ignore'),
+
−        ('Nov. 94', 'ignore'),
+
−        ('Mon, 18 Sep 2006 23:03:00 +1234567890', 'ignore'),
+
−
+
−        ]
+
−
+
−    # Add Unicode versions
+
−    try:
+
−        unicode
+
−    except NameError:
+
−        pass
+
−    else:
+
−        k = []
+
−        for text, result in l:
+
−            k.append((unicode(text), result))
+
−        l.extend(k)
+
−
+
−    for text, reference in l:
+
−        try:
+
−            value = DateTimeFromString(text)
+
−        except:
+
−            if reference is None:
+
−                continue
+
−            else:
+
−                value = str(sys.exc_info()[1])
+
−        valid_datetime = validateDateTimeString(text)
+
−        valid_date = validateDateString(text)
+
−        if str(value) != reference and \
+
−           not reference == 'ignore':
+
−            print 'Failed to parse "%s"' % text
+
−            print '  expected: %s' % (reference or '<exception>')
+
−            print '  parsed:   %s' % value
+
−        elif _debug:
+
−            print 'Parsed "%s" successfully' % text
+
−        if _debug:
+
−            if not valid_datetime:
+
−                print '  "%s" failed date/time validation' % text
+
−            if not valid_date:
+
−                print '  "%s" failed date validation' % text
+
−
+
−    et = DateTime.now()
+
−    print 'done. (after %f seconds)' % ((et-t).seconds)
+
−
+
−    ###
+
−
+
−    print 'Testing DateTimeDelta Parser...'
+
−
+
−    t = DateTime.now()
+
−    l = [
+
−
+
−        # Literal formats
+
−        ('Sun Nov  6 08:49:37 1994', '08:49:37.00'),
+
−        ('1 day, 8 hours, 49 minutes, 37 seconds', '1:08:49:37.00'),
+
−        ('10 days, 8 hours, 49 minutes, 37 seconds', '10:08:49:37.00'),
+
−        ('8 hours, 49 minutes, 37 seconds', '08:49:37.00'),
+
−        ('49 minutes, 37 seconds', '00:49:37.00'),
+
−        ('37 seconds', '00:00:37.00'),
+
−        ('37.5 seconds', '00:00:37.50'),
+
−        ('8 hours later', '08:00:00.00'),
+
−        ('2 days', '2:00:00:00.00'),
+
−        ('2 days 23h', '2:23:00:00.00'),
+
−        ('2 days 23:57', '2:23:57:00.00'),
+
−        ('2 days 23:57:13', '2:23:57:13.00'),
+
−        ('', '00:00:00.00'),
+
−        
+
−        # ISO formats
+
−        ('1994-11-06 08:49:37', '08:49:37.00'),
+
−        ('10:08:49:37', '10:08:49:37.00'),
+
−        ('08:49:37', '08:49:37.00'),
+
−        ('08:49', '08:49:00.00'),
+
−        ('-10:08:49:37', '-10:08:49:37.00'),
+
−        ('-08:49:37', '-08:49:37.00'),
+
−        ('-08:49', '-08:49:00.00'),
+
−        ('- 10:08:49:37', '-10:08:49:37.00'),
+
−        ('- 08:49:37', '-08:49:37.00'),
+
−        ('- 08:49', '-08:49:00.00'),
+
−        ('10:08:49:37.5', '10:08:49:37.50'),
+
−        ('08:49:37.5', '08:49:37.50'),
+
−        ('10:8:49:37', '10:08:49:37.00'),
+
−        ('8:9:37', '08:09:37.00'),
+
−        ('8:9', '08:09:00.00'),
+
−        ('8', '00:00:00.00'),
+
−
+
−        # Invalid formats
+
−        #('', None),
+
−        #('8', None),
+
−
+
−        ]
+
−
+
−    for text, reference in l:
+
−        try:
+
−            value = DateTimeDeltaFromString(text)
+
−        except:
+
−            if reference is None:
+
−                continue
+
−            else:
+
−                value = str(sys.exc_info()[1])
+
−        if str(value) != reference and \
+
−           not reference == 'ignore':
+
−            print 'Failed to parse "%s"' % text
+
−            print '  expected: %s' % (reference or '<exception>')
+
−            print '  parsed:   %s' % value
+
−        elif _debug:
+
−            print 'Parsed "%s" successfully' % text
+
−
+
−    et = DateTime.now()
+
−    print 'done. (after %f seconds)' % ((et-t).seconds)
+
−
+
−    ###
+
−
+
−    print 'Testing Time Parser...'
+
−
+
−    t = DateTime.now()
+
−    l = [
+
−
+
−        # Standard formats
+
−        ('08:49:37 AM', '08:49:37.00'),
+
−        ('08:49:37 PM', '20:49:37.00'),
+
−        ('12:00:00 AM', '00:00:00.00'),
+
−        ('12:00:00 PM', '12:00:00.00'),
+
−        ('8:09:37', '08:09:37.00'),
+
−        ('8:09', '08:09:00.00'),
+
−        
+
−        # ISO formats
+
−        ('08:49:37', '08:49:37.00'),
+
−        ('08:49', '08:49:00.00'),
+
−        ('08:49:37.5', '08:49:37.50'),
+
−        ('08:49:37,5', '08:49:37.50'),
+
−        ('08:09', '08:09:00.00'),
+
−
+
−        # Invalid formats
+
−        ('', None),
+
−        ('8:9:37', 'XXX Should give an exception'),
+
−        ('08:9:37', 'XXX Should give an exception'),
+
−        ('8:9', None),
+
−        ('8', None),
+
−
+
−        ]
+
−
+
−    for text, reference in l:
+
−        try:
+
−            value = TimeFromString(text, formats=('standard', 'iso'))
+
−        except:
+
−            if reference is None:
+
−                continue
+
−            else:
+
−                value = str(sys.exc_info()[1])
+
−        if str(value) != reference and \
+
−           not reference == 'ignore':
+
−            print 'Failed to parse "%s"' % text
+
−            print '  expected: %s' % (reference or '<exception>')
+
−            print '  parsed:   %s' % value
+
−        elif _debug:
+
−            print 'Parsed "%s" successfully' % text
+
−
+
−    et = DateTime.now()
+
−    print 'done. (after %f seconds)' % ((et-t).seconds)
+
−
+
−if __name__ == '__main__':
+
−    _test()