====Trim====

Trims any start and end times outside the range of the **frame**.

===Parameters===

No Parameters

===Description===

This function filters each item in the list, trimming the **StartTime** and **EndTime** columns in the table to fit within the frame time.

This function is often used after loading times from events or an API.

===Example===

If the frame contains the following table...

^StartTime^EndTime^Name^
|02:00 AM|04:00 AM|Early Morning|
|04:00AM|06:00 AM|Morning|

...and the frame itself contained...

^Property^Value^
|StartTime|03:00 AM|
|EndTime|05:00 AM|

Then the following JSON

<code javascript>
{
   "type": "trim"
}
</code>

Would limit the 'Start' and 'End' values in the //table// to match those of the //frame//.

^StartTime^EndTime^Name^
|03:00 AM|04:00 AM|Early Morning|
|04:00AM|05:00 AM|Morning|