{"id":"sforce_api_objects_crontrigger","title":"CronTrigger","content":"<a name=\"sforce_api_objects_objectname\"><!-- --></a><h1 class=\"helpHead1\">CronTrigger</h1><div class=\"body\">\n<div class=\"shortdesc\"><span class=\"ph\" id=\"summary\"><a name=\"summary\"><!-- --></a><span class=\"ph\" id=\"CronTriggerDefn\"><a name=\"CronTriggerDefn\"><!-- --></a>Contains schedule information for a scheduled\n    job. CronTrigger is similar to a cron job on UNIX systems.</span> This object is available in API\n   version 17.0 and later.</span></div>\n\n  <div class=\"section\">\n<h2 class=\"helpHead2\">Supported Calls</h2>\n\n   \n   <p class=\"p\"><samp class=\"codeph nolang\">describeSObjects()</samp>, <samp class=\"codeph nolang\">query()</samp>, <samp class=\"codeph nolang\">retrieve()</samp></p>\n\n  </div>\n\n  <div class=\"section\">\n<h2 class=\"helpHead2\">Fields</h2>\n\n   \n   \n<div class=\"data colSort\"><table class=\"featureTable sort_table\" summary=\"\">\n     \n     \n     <thead class=\"thead sorted\" align=\"left\">\n      <tr>\n       <th class=\"featureTableHeader  \" id=\"d535804e75\">Field</th>\n\n       <th class=\"featureTableHeader  \" id=\"d535804e78\">Details</th>\n\n      </tr>\n\n     </thead>\n\n     <tbody class=\"tbody\">\n      <tr>\n       <td class=\"entry\" headers=\"d535804e75\" data-title=\"Field\"><span class=\"keyword parmname\">CronExpression</span></td>\n\n       <td class=\"entry\" headers=\"d535804e78\" data-title=\"Details\">\n        <dl class=\"dl detailList\">\n         \n          <dt class=\"dt dlterm\">Type</dt>\n\n          <dd class=\"dd\">string</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Properties</dt>\n\n          <dd class=\"dd\">Filter, Group, Nillable, Sort</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Description</dt>\n\n          <dd class=\"dd\">The cron expression used to initiate the schedule. </dd>\n\n          <dd class=\"dd\">Syntax:<div class=\"codeSection apex_code\"><pre class=\"codeblock brush:apex\"><var class=\"keyword varname\">Seconds</var> <var class=\"keyword varname\">Minutes</var> <var class=\"keyword varname\">Hours</var> <var class=\"keyword varname\">Day_of_month</var> <var class=\"keyword varname\">Month</var> <var class=\"keyword varname\">Day_of_week</var> <var class=\"keyword varname\">Optional_year</var></pre></div>\n</dd>\n\n          <dd class=\"dd\">See <a class=\"xref\" href=\"https://developer.salesforce.com/docs/atlas.en-us.260.0.apexcode.meta/apexref/apex_methods_system_system.htm\" target=\"_blank\" title=\"HTML (New Window)\"><samp class=\"codeph apex_code\">schedule(jobName,\n             cronExpression, schedulableClass)</samp></a> in the <cite class=\"cite\">Apex Reference\n            Guide</cite>.</dd>\n\n         \n        </dl>\n\n       </td>\n\n      </tr>\n\n      <tr>\n       <td class=\"entry\" headers=\"d535804e75\" data-title=\"Field\"><span class=\"keyword parmname\">CronJobDetailId</span></td>\n\n       <td class=\"entry\" headers=\"d535804e78\" data-title=\"Details\">\n        <dl class=\"dl detailList\">\n         \n          <dt class=\"dt dlterm\">Type</dt>\n\n          <dd class=\"dd\">reference</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Properties</dt>\n\n          <dd class=\"dd\">Filter, Group, Nillable, Sort</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Description</dt>\n\n          <dd class=\"dd\">The ID of the CronJobDetail record containing more details about this scheduled\n           job.</dd>\n\n          <dd class=\"dd\">This is a relationship field.</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Relationship Name</dt>\n\n          <dd class=\"dd\">CronJobDetail</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Relationship Type</dt>\n\n          <dd class=\"dd\">Lookup</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Refers To</dt>\n\n          <dd class=\"dd\">CronJobDetail</dd>\n\n         \n        </dl>\n\n       </td>\n\n      </tr>\n\n      <tr>\n       <td class=\"entry\" headers=\"d535804e75\" data-title=\"Field\"><span class=\"keyword parmname\">EndTime</span></td>\n\n       <td class=\"entry\" headers=\"d535804e78\" data-title=\"Details\">\n        <dl class=\"dl detailList\">\n         \n          <dt class=\"dt dlterm\">Type</dt>\n\n          <dd class=\"dd\">dateTime</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Properties</dt>\n\n          <dd class=\"dd\">Filter, Nillable, Sort</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Description</dt>\n\n          <dd class=\"dd\">The date and time when the job either finished or will finish.</dd>\n\n         \n        </dl>\n\n       </td>\n\n      </tr>\n\n      <tr>\n       <td class=\"entry\" headers=\"d535804e75\" data-title=\"Field\"><span class=\"keyword parmname\">NextFireTime</span></td>\n\n       <td class=\"entry\" headers=\"d535804e78\" data-title=\"Details\">\n        <dl class=\"dl detailList\">\n         \n          <dt class=\"dt dlterm\">Type</dt>\n\n          <dd class=\"dd\">dateTime</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Properties</dt>\n\n          <dd class=\"dd\">Filter, Nillable, Sort</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Description</dt>\n\n          <dd class=\"dd\">The next date and time the job is scheduled to run. <samp class=\"codeph nolang\">null</samp> if the job is not scheduled to run again. </dd>\n\n         \n        </dl>\n\n       </td>\n\n      </tr>\n\n      <tr>\n       <td class=\"entry\" headers=\"d535804e75\" data-title=\"Field\"><span class=\"keyword parmname\">OwnerId</span></td>\n\n       <td class=\"entry\" headers=\"d535804e78\" data-title=\"Details\">\n        <dl class=\"dl detailList\">\n         \n          <dt class=\"dt dlterm\">Type</dt>\n\n          <dd class=\"dd\">reference</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Properties</dt>\n\n          <dd class=\"dd\">Filter, Group, Nillable, Sort</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Description</dt>\n\n          <dd class=\"dd\">Owner of the job.</dd>\n\n         \n        </dl>\n\n       </td>\n\n      </tr>\n\n      <tr>\n       <td class=\"entry\" headers=\"d535804e75\" data-title=\"Field\"><span class=\"keyword parmname\">PreviousFireTime</span></td>\n\n       <td class=\"entry\" headers=\"d535804e78\" data-title=\"Details\">\n        <dl class=\"dl detailList\">\n         \n          <dt class=\"dt dlterm\">Type</dt>\n\n          <dd class=\"dd\">dateTime</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Properties</dt>\n\n          <dd class=\"dd\">Filter, Nillable, Sort</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Description</dt>\n\n          <dd class=\"dd\">The most recent date and time the job ran. <samp class=\"codeph java\">null</samp> if\n           the job has not run before current local time. </dd>\n\n         \n        </dl>\n\n       </td>\n\n      </tr>\n\n      \n      <tr>\n       <td class=\"entry\" headers=\"d535804e75\" data-title=\"Field\"><span class=\"keyword parmname\">StartTime</span></td>\n\n       <td class=\"entry\" headers=\"d535804e78\" data-title=\"Details\">\n        <dl class=\"dl detailList\">\n         \n          <dt class=\"dt dlterm\">Type</dt>\n\n          <dd class=\"dd\">dateTime</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Properties</dt>\n\n          <dd class=\"dd\">Filter, Nillable, Sort</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Description</dt>\n\n          <dd class=\"dd\">The date and time when the most recent iteration of the scheduled job started. </dd>\n\n         \n        </dl>\n\n       </td>\n\n      </tr>\n\n      <tr>\n       <td class=\"entry\" headers=\"d535804e75\" data-title=\"Field\"><span class=\"keyword parmname\">State</span></td>\n\n       <td class=\"entry\" headers=\"d535804e78\" data-title=\"Details\">\n        <dl class=\"dl detailList\">\n         \n          <dt class=\"dt dlterm\">Type</dt>\n\n          <dd class=\"dd\">string</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Properties</dt>\n\n          <dd class=\"dd\">Filter, Group, Nillable, Sort</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Description</dt>\n\n          <dd class=\"dd\">The current state of the job. The job state is managed by the system. Possible values are:<ul class=\"ul bulletList\">\n            <li class=\"li\">\n<samp class=\"codeph nolang\">WAITING</samp>—The job is waiting for\n             execution.</li>\n\n            <li class=\"li\">\n<samp class=\"codeph nolang\">ACQUIRED</samp>—The job has been picked up by\n             the system and is about to execute.</li>\n\n            <li class=\"li\">\n<samp class=\"codeph nolang\">EXECUTING</samp>—The job is executing.</li>\n\n            <li class=\"li\">\n<samp class=\"codeph nolang\">COMPLETE</samp>—The trigger has fired and is\n             not scheduled to fire again.</li>\n\n            <li class=\"li\">\n<samp class=\"codeph nolang\">ERROR</samp>—The trigger definition has an\n             error.</li>\n\n            <li class=\"li\">\n<samp class=\"codeph nolang\">DELETED</samp>—The job has been deleted.</li>\n\n            <li class=\"li\">\n<samp class=\"codeph nolang\">PAUSED</samp>—A job can have this state during\n             patch and major releases. After the release has finished, the job state is\n             automatically set to <samp class=\"codeph nolang\">WAITING</samp> or another\n             state.</li>\n\n            <li class=\"li\">\n<samp class=\"codeph nolang\">BLOCKED</samp>—Execution of a second instance\n             of the job is attempted while one instance is running. This state lasts until the first\n             job instance is completed. </li>\n\n            <li class=\"li\">\n<samp class=\"codeph nolang\">PAUSED_BLOCKED</samp>—A job has this state due\n             to a release occurring. When the release has finished and no other instance of the job\n             is running, the job’s status is set to another state.</li>\n\n           </ul>\n</dd>\n\n         \n        </dl>\n\n       </td>\n\n      </tr>\n\n      <tr>\n       <td class=\"entry\" headers=\"d535804e75\" data-title=\"Field\"><span class=\"keyword parmname\">TimesTriggered</span></td>\n\n       <td class=\"entry\" headers=\"d535804e78\" data-title=\"Details\">\n        <dl class=\"dl detailList\">\n         \n          <dt class=\"dt dlterm\">Type</dt>\n\n          <dd class=\"dd\">int</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Properties</dt>\n\n          <dd class=\"dd\">Filter, Group, Nillable, Sort</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Description</dt>\n\n          <dd class=\"dd\">The number of times this job has been triggered.</dd>\n\n         \n        </dl>\n\n       </td>\n\n      </tr>\n\n      <tr>\n       <td class=\"entry\" headers=\"d535804e75\" data-title=\"Field\"><span class=\"keyword parmname\">TimeZoneSidKey</span></td>\n\n       <td class=\"entry\" headers=\"d535804e78\" data-title=\"Details\">\n        <dl class=\"dl detailList\">\n         \n          <dt class=\"dt dlterm\">Type</dt>\n\n          <dd class=\"dd\">picklist</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Properties</dt>\n\n          <dd class=\"dd\">Filter, Group, Nillable, Restricted picklist, Sort</dd>\n\n         \n         \n          <dt class=\"dt dlterm\">Description</dt>\n\n          <dd class=\"dd\">Returns the timezone ID. For example, <samp class=\"codeph nolang\">America/Los_Angeles</samp>.</dd>\n\n         \n        </dl>\n\n       </td>\n\n      </tr>\n\n     </tbody>\n\n    </table></div>\n\n  </div>\n\n  <div class=\"section\">\n<h2 class=\"helpHead2\">Usage</h2>\n\n   \n   <p class=\"p\">Use this object to query scheduled jobs in your organization. </p>\n\n  </div>\n\n </div><div id=\"sfdc:seealso\" class=\"related-links\"></div>"}