Skip to main content

Schedule

Applies ToBlish HUD (Pathing)TacOBurrito
Trails, Markers

Description

Hides the marker outside of the specified schedule. Good for showing markers only during their associated scheduled meta event, day of the week, etc. All scheduling is based on UTC.

AttributeData TypeDefault ValueExampleDescription
schedulestring0 0 * * 2A cron expression which represents the start time of when the marker or trail should be shown.
schedule-durationfloat1440The duration after the start time that the marker or trail should remain visible.

Supported values

schedule

The schedule attribute uses cron expressions to indicate the start time.

                                      Allowed values    Allowed special characters   Comment

┌───────────── second 0-59
│ ┌───────────── minute 0-59 * , - /
│ │ ┌───────────── hour 0-23 * , - /
│ │ │ ┌───────────── day of month 1-31 * , - / L W ?
│ │ │ │ ┌───────────── month 1-12 or JAN-DEC * , - /
│ │ │ │ │ ┌───────────── day of week 0-6 or SUN-SAT * , - / # L ? Both 0 and 7 means SUN
│ │ │ │ │ │
* * * * * *

The library we use to parse cron expressions provides some detailed explainations in their README and there is plenty of documentation available online as the syntax is used for multiple systems. Minutes are the smallest unit of time currently enabled for cron expressions as shown above.

To get assistance writing and checking your cron expressions, you can use the Cron expression generator by Cronhub. Other generators with other features you may prefer are freely available online and can be found by searching for "cron expression generator".

schedule-duration

The schedule duration is the time in minutes after the start time that the marker or trail should be displayed. The data type is a float, so partial minutes can be represented accordingly. For example, 0.5 indicates a duration of 30 seconds.

How it works

Cron expressions are used to represent repeating start times that can be anywhere from simplistic to complex. We use the cron expression to calcuate the schedule that we'll show the markers and trails.

For example, "0 * * * *" indicates a start time of every hour at the top of the hour. We'll calculate the timestamp of the next time this occurs and then use the duration to decide what times the marker / trail will be visible.

  • 00:00
  • 01:00
  • 02:00
  • etc.

The duration is added to the start time to create an end time and if the current time is between the start and end then the marker or trail is allowed to show.

Example Schedules

ScheduleDurationMeaning
0 0 * * 31440All of Wednesday (the 3 indicates Wednesday and 1440 is the number of minutes in a day)
0 * * * *2Every hour for the first two minutes.
20 2/6 * * *15At 20 minutes past the hour, every 6 hours, starting at 02:00 AM (Ley-Line Anomaly in Iron Marches) for 15 minutes