Go to the latest version of this document.

# ``twisted`.`protocols`.`amp`.`DateTime``

class documentation

`class DateTime(Argument): (source)`

Constructor: `DateTime(optional)`

View In Hierarchy

Encodes `datetime.datetime` instances.

Wire format: '%04i-%02i-%02iT%02i:%02i:%02i.%06i%s%02i:%02i'. Fields in order are: year, month, day, hour, minute, second, microsecond, timezone direction (+ or -), timezone hour, timezone minute. Encoded string is always exactly 32 characters long. This format is compatible with ISO 8601, but that does not mean all ISO 8601 dates can be accepted.

Also, note that the datetime module's notion of a "timezone" can be complex, but the wire format includes only a fixed offset, so the conversion is not lossless. A lossless transmission of a `datetime` instance is not feasible since the receiving end would require a Python interpreter.

Method | `fromString` | Parse a string containing a date and time in the wire format into a `datetime.datetime` instance.
Method | `toString` | Serialize a `datetime.datetime` instance to a string in the specified wire format.
Instance Variable | `_positions` | A sequence of slices giving the positions of various interesting parts of the wire format.

Inherited from `Argument`:

Method | `__init__` | Create an Argument.
Method | `fromBox` | Populate an 'out' dictionary with mapping names to Python values decoded from an 'in' AmpBox mapping strings to string values.
Method | `fromStringProto` | Convert a string to a Python value.
Method | `retrieve` | Retrieve the given key from the given dictionary, removing it if found.
Method | `toBox` | Populate an 'out' AmpBox with strings encoded from an 'in' dictionary mapping names to Python values.
Method | `toStringProto` | Convert a Python object to a string.
Instance Variable | `optional` | Undocumented

def fromString(self, s): (source)
overrides `twisted.protocols.amp.Argument.fromString`

Parse a string containing a date and time in the wire format into a `datetime.datetime` instance.

def toString(self, i): (source)
overrides `twisted.protocols.amp.Argument.toString`

Serialize a `datetime.datetime` instance to a string in the specified wire format.

_positions = (source)

A sequence of slices giving the positions of various interesting parts of the wire format.