• Documentation
    • Search documentation
    karat

    +

    K

    API Reference ↗
    Use case developmentAutomateConditionTime condition

    Time condition

    To trigger your automation effects at a specific time or on a schedule, you can use a time condition. Select it by choosing the time condition card.

    Add time condition

    By default, a daily frequency will be selected.

    Configure time condition via user interface

    Configuration

    There are two ways to configure the time condition: in the user interface or as a cron expression.

    User interface

    This is the default option and will be sufficient for most use cases. The interface provides options to set up hourly, daily, weekly, and monthly schedules.

    Cron expression

    If the default time condition configuration options are not flexible enough for your use case, you can define a custom cron expression.

    Requirements for cron expressions:

    • Exactly five fields (space separated): minutes, hours, day of month, month, day of week
      • Note that seconds and years fields are not supported
    • A minimum frequency of once per hour
    • The minutes field must be a number between 0 and 59, with no special characters
    • Supported special characters are *, -, /, ,, L, and #
      • Note that W is not supported

    A natural language preview of your schedule will appear after entering the expression.

    Configure time condition via cron expression

    For reference, a list of example cron expressions is shown below:

    Cron stringMeaning
    0 * * * *Every hour on the hour
    0 0 1 1 *At midnight on the first day of every year
    15 8,20 * * *At 08:15 AM and 08:15 PM
    15 8,14 * * 1-5At 08:15 AM and 02:15 PM, Monday through Friday
    0 9 L * *At 09:00 AM, on the last day of each month
    0 9 1 3,7,10,12 *At 09:00 AM, on the first day of the month, in March, July, October, and December
    0 9 * * 1#1At 09:00 AM, on the first Monday of the month
    0 9 * * 5LAt 09:00 AM, on the last Friday of the month

    Multiple cron schedules

    You can add multiple cron expressions to a single time condition to define more complex scheduling patterns. When using advanced cron mode, select the option to add additional cron expressions.

    Requirements for multiple cron schedules:

    • Each cron expression must be non-overlapping with the others
    • All expressions must individually meet the cron expression requirements listed above

    For example, use 0 9 1,15 * * to execute at 9:00 AM on the first and fifteenth of every month. Add 0 10 * * 5 to execute at 10:00 AM every Friday. Using different times prevents the schedules from overlapping when the first or fifteenth falls on a Friday.