The UTC date/time of the telescope's internal clock

Namespace: ASCOM.DeviceInterface
Assembly: ASCOM.DeviceInterfaces (in ASCOM.DeviceInterfaces.dll) Version: 6.0.0.0 (6.1.1.2619)

Syntax

C#
DateTime UTCDate { get; set; }
Visual Basic
Property UTCDate As DateTime
	Get
	Set
Visual C++
property DateTime UTCDate {
	DateTime get ();
	void set (DateTime value);
}

Remarks

UTCDate Read must be implemented and must not throw a PropertyNotImplementedException.

UTCDate Write can throw a PropertyNotImplementedException.

The driver must calculate this from the system clock if the telescope has no accessible source of UTC time. In this case, the property must not be writeable (this would change the system clock!) and will instead raise an error. However, it is permitted to change the telescope's internal UTC clock if it is being used for this property. This allows clients to adjust the telescope's UTC clock as needed for accuracy. Reading the property will raise an error if the value has never been set or is otherwise unavailable.

Exceptions

ExceptionCondition
ASCOM..::..PropertyNotImplementedExceptionIf UTCDate Write is not implemented.
ASCOM..::..InvalidValueExceptionIf an invalid DateTime is set.
ASCOM..::..InvalidOperationExceptionWhen UTCDate is read and the mount cannot provide this property itslef and a value has not yet be established by writing to the property.

See Also