Many applications need to work across timezones for different purposes.
On one of our applications, we needed to support customers at locations across different timezones.
For one of the features on this application, we needed to create a report for data from the past day.
Since the customers were across different timezones,
we needed to run this scheduled task for report creation,
for each customer at a specific time in its timezone.
We needed to let it process data set for the report
A to time
B in that specific timezone.
One way to achieve this would be to create a single scheduled job. That would then fetch all customers, and trigger another delayed background job per customer.
This would be repetitive if we had to do this for customers with similar timezones.
We use clockwork to manage such background jobs. From its description:
Clockwork is a scheduler which can be used as a replacement of cron. It’s a lightweight running Ruby process which runs similar to web or worker processes. It allows you to schedule recurring jobs at a specific time or date similar to cronjob.
In clockwork one specifies the jobs we want to schedule in a file called
We specify the tasks to be scheduled using the
every method provided by clockwork
and specify the frequency and name of the job:
every takes blocks as arguments to execute per given frequency:
We can also specify the time and timezone using
This helps us to achieve our desired result of scheduling jobs at different timezone specific times.
Following is an example of sample
clock.rb that schedules a job of
that is scheduled to run every day at 12:00 AM mid-night in
Using these we can now schedule a job per customer’s timezones:
In the above example, we first collect all the timezones that we want to run the job in.
For each of the timezones, we schedule a job using the
every method provided by clockwork,
to run every day, at 08:00 am for that specific timezone.
We passed a block that triggers our report job that will process all customers having