TelescopeUTCDate Property |
The UTC date/time of the telescope's internal clock
Namespace: ASCOM.DriverAccess
Assembly: ASCOM.DriverAccess (in ASCOM.DriverAccess.dll) Version: 3351c4f3fa64146a7efd5b51ed4591e32a0a5484
SyntaxExceptions| Exception | Condition |
|---|---|
| PropertyNotImplementedException | If UTCDate Write is not implemented. |
| InvalidValueException | If an invalid DateTime is set. |
| InvalidOperationException | When UTCDate is read and the mount cannot provide this property itself and a value has not yet be established by writing to the property. |
| NotConnectedException | If the device is not connected |
| DriverException | An error occurred that is not described by one of the more specific ASCOM exceptions. The device did not successfully complete the request. |
Remarks
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.
See Also