XmlDateTime#

class xsdata.models.datatype.XmlDateTime(year: int, month: int, day: int, hour: int, minute: int, second: int, microsecond: int = 0, offset: Optional[int] = None)[source]#

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 – Any signed integer, eg (0, -535, 2020)

  • month – Unsigned integer between 1-12

  • day – Unsigned integer between 1-31

  • hour – Unsigned integer between 0-24

  • minute – Unsigned integer between 0-59

  • second – Unsigned integer between 0-59

  • microsecond – Unsigned integer between 0-999999

  • offset – Signed integer representing timezone offset in minutes

year: int#

Alias for field number 0

month: int#

Alias for field number 1

day: int#

Alias for field number 2

hour: int#

Alias for field number 3

minute: int#

Alias for field number 4

second: int#

Alias for field number 5

microsecond: int#

Alias for field number 6

offset: Optional[int]#

Alias for field number 7

classmethod from_string(string)[source]#

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

Return type

XmlDateTime

classmethod from_datetime(obj)[source]#

Initialize from datetime.datetime instance.

Return type

XmlDateTime

classmethod now(tz=None)[source]#

Initialize from datetime.datetime.now()

Return type

XmlDateTime

classmethod utcnow()[source]#

Initialize from datetime.datetime.utcnow()

Return type

XmlDateTime

to_datetime()[source]#

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)[source]#

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

Return type

XmlDateTime

__str__()[source]#

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

__eq__(other)[source]#

Return self==value.

Return type

bool

__ne__(other)[source]#

Return self!=value.

Return type

bool

__lt__(other)[source]#

Return self<value.

Return type

bool

__le__(other)[source]#

Return self<=value.

Return type

bool

__gt__(other)[source]#

Return self>value.

Return type

bool

__ge__(other)[source]#

Return self>=value.

Return type

bool

__add__(value, /)#

Return self+value.

__contains__(key, /)#

Return key in self.

__getattribute__(name, /)#

Return getattr(self, name).

__getitem__(key, /)#

Return self[key].

__getnewargs__()#

Return self as a plain tuple. Used by copy and pickle.

__hash__()#

Return hash(self).

__iter__()#

Implement iter(self).

__len__()#

Return len(self).

__mul__(value, /)#

Return self*value.

__rmul__(value, /)#

Return value*self.

count(value, /)#

Return number of occurrences of value.

index(value, start=0, stop=9223372036854775807, /)#

Return first index of value.

Raises ValueError if the value is not present.