Task Properties and Functions

Overview

You can use these properties with the following Task types:

task.start

Description

The start time for a Scheduled Task, Triggered Task, and Ultra Pipeline Task. You enter this expression in the Expression field of a Snap. If you manually initiate the Task in Designer, then the task.start result is the starting time of the Pipeline, and the task.end result is an arbitrary date far in the future: (for example, 2999-12-31:11:59).

Syntax
task.start
Example

Expression: task.start

Result: Returns the start time and date for the Task: 2019-11-09T11:00:00


task.end

Description

The end time and date for a Scheduled Task. You enter this expression in the Expression field of a Snap, and the result is displayed on the Extra Details tab of the Pipeline Execution Statistics window.

Syntax
task.end
Example

Expression: task.end

Result: Returns the end time and date for the Task: 2019-11-09T12:00:00


Task Properties with Scheduled Tasks

For Scheduled Tasks, the task.start property should indicate when the Scheduled Task previously started. If the Scheduled Task has never been executed before, then the task.start is equivalent to the date and time when it currently starts. See Date Functions and Properties for details about date types.

If a Task runs every minute and starts today at noon, then expect the following values.

Scheduled Task Executiontask.starttask.end
2021-04-16 12:00:002021-04-16 12:00:002021-04-16 12:00:00
2021-04-16 12:01:002021-04-16 12:00:002021-04-16 12:01:00
2021-04-16 12:02:002021-04-16 12:01:002021-04-16 12:02:00

Task Properties with Ultra Pipeline and Triggered Tasks Examples

For Triggered Tasks and Tasks created from Ultra Pipelines, this expression generates a result, but the end date is always some future date, since with both of these Task types the end date is undefinable. The start time is the same as that of the pipe.startTime function.