Bixby Developer Center

Guides
References

time

requiredvalue optional

A required field that represents the point in time where you want to "anchor" the activity. Typically, this is the start time. However, in cases of activities that have multiple critical points in time (like ride sharing or a multi-leg flight) or is dependent on other factors, you can choose to set this value differently on every activity refresh or use conditional blocks to evaluate and pass an appropriate time value. It does not have to be the time at which the activity becomes relevant. In the case of flights, this could be the check-in time or the departure time. For ride booking, time could be the estimated time of arrival. The "activity time" expression is re-evaluated during an activity refresh.

The value of this field is used to sort or rank the activity update among a set of updates.

You can use the Date/Time EL Functions to further evaluate and conditionally set the time passed for the activity.

Note

The time that you pass must be of type or subtype BaseDate or BaseDateTime. Your time value cannot be empty and your capsule can only pass a single time value.

Examples

activity-support {
match {
Receipt (this)
}
time (statusRefreshTime)

View on GitHub

...
time {
if (isFuture(this.startDate)) { // uses a Date EL function to check if the startDate is upcoming
expression(this.startDate)
} else {
expression(this.endDate)
}
}
...
structure (Event) {
features {transient}
activity (event) {
time (startTime)
...
}
}

Child Keys

expression
required
This is a beta feature and doesn't yet have documentation