Coldbox Scheduled Tasks

CavanVannice · January 3, 2023, 6:52pm

The frequency “onFirstBusinessDayOfTheMonth( time )” has a description of “Run the task on the first Monday of every month”. The first business day of the month could be any day Mon-Fri. Can I get some clarification on whether it runs on the first Monday of the month OR the first business day, please?

Ancient_Programmer · January 3, 2023, 8:21pm

If you take a look the source code, it shows MONDAY.

github.com

ColdBox/coldbox-platform/blob/b3442463986c02bbc397f2a18f6e0c14941ecce3/system/async/tasks/ScheduledTask.cfc

/**
 * This object represents a scheduled task that will be sent in to a scheduled executor for scheduling.
 * It has a fluent and human dsl for setting it up and restricting is scheduling and frequency of scheduling.
 *
 * A task can be represented as either a closure or a cfc with a `run()` or custom runnable method.
 */
component accessors="true" {

	/**
	 * The delay or time to wait before we execute the task in the scheduler
	 */
	property name="delay" type="numeric";

	/**
	 * A fixed time period of execution of the tasks in this schedule. It does not wait for tasks to finish,
	 * tasks are fired exactly at that time period.
	 */
	property name="period" type="numeric";

	/**

This file has been truncated. show original

CavanVannice · January 4, 2023, 6:11pm

Thanks for the link. I see what you are saying. The function is misnamed. If I set a task to run onFirstBusinessDayOfTheMonth( time ) my expectation is that this February 2023 it would run Wednesday the First, with the way the function works it would run February the 6th. The docs explain it that way, but the function name itself is a misnomer.

Coldbox Scheduled Tasks

Latest Ortus News

GIVING BACK

HARVESTING IN SPANISH

WOODSEDGE