NextRunTime Property (SQL-DMO)

The NextRunTime property returns a system-generated execution time for a SQL Server Agent job.

Applies To

Job Object

Syntax

object.NextRunTime

Part Description
object Expression that evaluates to an object in the Applies To list

Remarks

The value returned by the NextRunTime property is determined by evaluating all schedules assigned to the job. Zero is a valid return value.

When no schedule is active or no next execution date and time can be calculated, the NextRunDate property returns 0.


Note When SQL-DMO uses a scaled long integer to represent a time, the integer is built as a sum of the hour scaled by 10000, the minute scaled by 100, and the seconds. The time value uses a 24-hour clock. For example, the time 1:03:09 P.M. is represented by the long integer value 130309.


Data Type

Long

Modifiable

Read-only

Prototype (C/C++)

HRESULT GetNextRunTime(LPLONG pRetVal);

  


(c) 1988-98 Microsoft Corporation. All Rights Reserved.