LocalTime Property
This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature.
The LocalTime property identifies the current date and time for the referenced target server.
Syntax
object
.LocalTime
Parts
- object
An expression that evaluates to an object in the Applies To list
Data Type
String
Modifiable
Read-only
Prototype (C/C++)
HRESULT GetLocalTime(SQLDMO_LPBSTR pRetVal);
Note
SQL Distributed Management Objects (SQL-DMO) strings are always returned as OLE BSTR objects. A C/C++ application obtains a reference to the string. The application must release the reference using SysFreeString.
Remarks
Microsoft SQL Server multiserver administration can be configured to administer servers installed throughout the world. The possibility for job scheduling conflicts or errors can arise.
For example, a job created on June 1, 1998 for single execution on that date by a master server in Seattle cannot execute on a server enlisted from Japan. The Japanese target server, having a local date of June 2, ignores the job because its defined execution date has passed.
Querying the LocalTime property and using the TimeZoneAdjustment property in scheduling can help avoid these potential errors.