Android WorkManager - how to delay task?

android schedule task
android periodic task
android workmanager observe
android-workmanager specific time
work manager android kotlin
android-workmanager location
android workmanager reboot

I am building a functionality that will allow merchants to set the schedule of their business. Such functionality would automatically change the variable open to true and false accordingly to the times the merchant set in each day of the week. Therefore, there would be a total of 14 possible different times.

I am trying to build a recurrent background task that would accomplish such a thing using WorkManager, the new Android Architecture Components library.

val scheduleStartWork = PeriodicWorkRequest.Builder(, 7, TimeUnit.DAYS)
                .setInputData(Data.Builder().putBoolean("isStart", true).build())
                .setScheduleRequestedAt(diff_time, TimeUnit.MILLISECONDS)

It's giving me the following APILibraryException error though:

Builder.setScheduleRequestedAt can only be called from within the same library group

My questions:

1) Is it setScheduleRequestedAt the right method to call if I want to delay the scheduling by diff_time?

2) If so, how can I solve this problem?

PS: diff_time is the difference, in milliseconds, to each of the corresponding hours of each day set by the user. Example: Monday-Friday = 08:00, Sat-Sun= 10:00.


Since WorkManager v2.1-alpha02 it is now possible add an initial delay to a PeriodicWorkRequest. Now your call became simply:

val scheduleStartWork = PeriodicWorkRequest.Builder(, 7, TimeUnit.DAYS)
                .setInputData(Data.Builder().putBoolean("isStart", true).build())
                .setInitialDelay(diff_time, TimeUnit.MILLISECONDS)

Note because the setInitialDelay has been introduced in the parent class, WorkRequest, this introduced a binary change moving from v2.0 to v2.1 for the OneTimeWorkRequest#setInitialDelay() method. This means that to use the new library you need to recompile the project when upgrading from v2.0.

Follows original answer

It's not possible to delay the first run of a periodic task with WorkManager.

Your best option is to use a OneTimeWorker with the delay that you want and from there you can enqueue your periodic worker with the period you want.

There's a feature request on WorkManager's issue tracker with an explanation for this workaround that you can use as a reference.

Note: because of how the minimum interval works, you cannot build a periodic work request that is executed at a recurring time, e.g. every day at 4:00 AM. You can specify a 24 hours repeat interval, but this can get the worker executed at 4:05AM the first day, 6:00AM the second, 6:10 AM the third day and so on. If you need to execute a worker at the same time every day, your best option is to use a OneTimeWorkRequest with an initial delay:

OneTimeWorkRequest save = new OneTimeWorkRequest
            .setInitialDelay(24, TimeUnit.HOURS)

When the worker has been completed, you can reschedule it with a Delay so that it is going to be fired at the correct time (the exact time that the worker is going to be executed depends on the constraints that you’re using when creating the work request).

Android WorkManager - how to delay task?, I am trying to build a recurrent background task that would accomplish such a thing using WorkManager, the new Android Architecture Components library. val​  I have explained schedule cron job in android .. Scheduling Recurring Task in Android .. WorkManager .. repetitive task in android PeriodicWorkRequest

You need to update the work manager library version to 2.1.0-alpha03. In the version WorkManager provides the functionality to add initial delay in task.

Then you need to use the method setInitialDelay(). Following is the implementation to use the same in a way to achieve specific time trigger work:

long initialDelayInSeconds = (futureSpecificTime - System.currentTimeInMills()) / 1000;

PeriodicWorkRequest workRequest =
                new PeriodicWorkRequest.Builder(WorkerClass.class, interval, TimeUnit.SECONDS)
                        .setInitialDelay(initialDelayInSeconds, TimeUnit.SECONDS)

Defining your Work Requests, This is something that users can wipe out using Android settings. Work Manager cancels tasks running for more than 10 minutes. more precise implementation, the app could request a one time work with an initial delay. WorkManager is an Android library that runs deferrable background work when the work’s constraints are satisfied. WorkManager is intended for tasks that require a guarantee that the system will

In the new version of Work manager (Version 2.1.0-alpha02 released on May 16, 2019) PeriodicWorkRequests now support initial delays. You can use the setInitialDelay method on PeriodicWorkRequest.Builder to set an initial delay.

PeriodicWorkRequest workRequest = new PeriodicWorkRequest.Builder(
    .setInitialDelay(1, TimeUnit.HOURS)

        .enqueueUniquePeriodicWork("send_reminder_periodic", ExistingPeriodicWorkPolicy.REPLACE, workRequest);

WorkManager Periodicity - Android Developers, In my previous post I covered details about the Android memory The execution may be delayed because WorkManager is subject to OS  WorkManager is a part of Android Jetpack and an Architecture Component for a background work. Android WorkManager choose an appropriate way to schedule task depending on API.

WorkManager, The first blog post in a new series on WorkManager: Android memory tasks by using ids, tags and unique names; Add constraint, delay and  With WorkManager, you can easily set up a task and hand it off to the system to run under the conditions you specify. To learn more if WorkManager is the right solution for your task, check out the background processing guide. In this guide you will learn how to: Add WorkManager to your Android project; Create a background task

Workout your tasks with WorkManager, WorkManager is for deferrable background task that needs a data your app consumes by delaying data-intensive tasks until the device is  APIs are also can set up a chain of tasks; when one task finishes, WorkManager queues up the next task in the chain. How to use work manager-

Workout your tasks with WorkManager, Flutter WorkManager is a wrapper around Android's WorkManager and iOS' This is especially useful to run periodic tasks, such as fetching remote data on a regular basis. This plugin was You can also specify the delay. In previous sections, we mentioned that WorkManager performs background work asynchronously on your behalf. The basic implementation addresses the demands of most apps. For more advanced use cases, such as correctly handling work being stopped, you should learn about threading and concurrency in WorkManager.

  • I can't find this method in the Javadoc…
  • Yeah :/ I didn't find either but this method exists when writing code. Is there any other method though that can delay the scheduling?
  • There probably isn't a way to schedule a repeated task with an initial delay. There's no such functionality in JobScheduler and WorkManager is a layer above it.
  • But there's such a functionality in AlarmManager and WorkManager is a layer above it as well, right?