XmlDateTime

class xsdata.models.datatype.XmlDateTime(year, month, day, hour, minute, second, microsecond=0, offset=None)

Concrete xs:dateTime builtin type.

Represents iso 8601 date time format [-]CCYY-MM-DDThh:mm:ss[Z|(+|-)hh:mm] with rich comparisons and hashing.

Parameters

• year (int) – Any signed integer, eg (0, -535, 2020)

• month (int) – Unsigned integer between 1-12

• day (int) – Unsigned integer between 1-31

• hour (int) – Unsigned integer between 0-24

• minute (int) – Unsigned integer between 0-59

• second (int) – Unsigned integer between 0-59

• microsecond (int) – Unsigned integer between 0-999999

• offset (Optional[int]) – Signed integer representing timezone offset in minutes

classmethod from_string(string)

Initialize from string with format %Y-%m-%dT%H:%M:%S%z

Parameters

string (str) –

Return type

XmlDateTime

classmethod from_datetime(obj)

Initialize from datetime.datetime instance.

Parameters

obj (datetime) –

Return type

XmlDateTime

classmethod now(tz=None)

Initialize from datetime.datetime.now()

Parameters

tz (Optional[timezone]) –

Return type

XmlDateTime

classmethod utcnow()

Initialize from datetime.datetime.utcnow()

Return type

XmlDateTime

to_datetime()

Return a datetime.datetime instance.

Return type

datetime

replace(year=None, month=None, day=None, hour=None, minute=None, second=None, microsecond=None, offset=True)

Return a new instance replacing the specified fields with new values.

Parameters

• year (Optional[int]) –

• month (Optional[int]) –

• day (Optional[int]) –

• hour (Optional[int]) –

• minute (Optional[int]) –

• second (Optional[int]) –

• microsecond (Optional[int]) –

• offset (Optional[int]) –

Return type

XmlDateTime

__str__()

Return the datetime formatted according to ISO 8601 for xml.

Examples:

• 2001-10-26T21:32:52

• 2001-10-26T21:32:52+02:00

• 2001-10-26T19:32:52Z

• 2001-10-26T19:32:52.126789

• 2001-10-26T21:32:52.126

• -2001-10-26T21:32:52.126Z

Return type

str