src/pyams_utils/date.py
branchdoc-dc
changeset 252 05af55de9eab
parent 72 9049384a2bd4
child 272 e2a747608ef6
equal deleted inserted replaced
164:07d7bca9e2af 252:05af55de9eab
    26 from pyams_utils import _
    26 from pyams_utils import _
    27 
    27 
    28 
    28 
    29 def unidate(value):
    29 def unidate(value):
    30     """Get specified date converted to unicode ISO format
    30     """Get specified date converted to unicode ISO format
    31     
    31 
    32     Dates are always assumed to be stored in GMT timezone
    32     Dates are always assumed to be stored in GMT timezone
    33     
    33 
    34     :param date value: input date to convert to unicode
    34     :param datetime value: input date to convert to unicode
    35     :return: unicode; input date converted to unicode
    35     :return: unicode; input date converted to unicode
    36 
    36 
    37     >>> from datetime import datetime
    37     >>> from datetime import datetime
    38     >>> from pyams_utils.date import unidate
    38     >>> from pyams_utils.date import unidate
    39     >>> value = datetime(2016, 11, 15, 10, 13, 12)
    39     >>> value = datetime(2016, 11, 15, 10, 13, 12)
    46     return None
    46     return None
    47 
    47 
    48 
    48 
    49 def parse_date(value):
    49 def parse_date(value):
    50     """Get date specified in unicode ISO format to Python datetime object
    50     """Get date specified in unicode ISO format to Python datetime object
    51     
    51 
    52     Dates are always assumed to be stored in GMT timezone
    52     Dates are always assumed to be stored in GMT timezone
    53     
    53 
    54     :param str value: unicode date to be parsed
    54     :param str value: unicode date to be parsed
    55     :return: datetime; the specified value, converted to datetime
    55     :return: datetime; the specified value, converted to datetime
    56 
    56 
    57     >>> from pyams_utils.date import parse_date
    57     >>> from pyams_utils.date import parse_date
    58     >>> parse_date('2016-11-15T10:13:12+00:00')
    58     >>> parse_date('2016-11-15T10:13:12+00:00')
    63     return None
    63     return None
    64 
    64 
    65 
    65 
    66 def date_to_datetime(value):
    66 def date_to_datetime(value):
    67     """Get datetime value converted from a date or datetime object
    67     """Get datetime value converted from a date or datetime object
    68     
    68 
    69     :param date/datetime value: a date or datetime value to convert
    69     :param date/datetime value: a date or datetime value to convert
    70     :return: datetime; input value converted to datetime
    70     :return: datetime; input value converted to datetime
    71 
    71 
    72     >>> from datetime import date, datetime
    72     >>> from datetime import date, datetime
    73     >>> from pyams_utils.date import date_to_datetime
    73     >>> from pyams_utils.date import date_to_datetime