David's Blog

Using GoCron in Golang A Practical Guide to Task Scheduling

By David Li on 2023-05-30T19:37:46.343Z

Using GoCron

GoCron is a simple, efficient, and flexible job scheduling library for the Go programming language (also known as Golang). It enables developers to schedule tasks, automate repetitive jobs, and manage background processes in a user-friendly and efficient manner. In this article, we will explore how to use GoCron to schedule and manage tasks in a Golang application.

Getting Started

To start using GoCron, you need to have Golang installed on your system. If you haven’t installed it yet, follow the official installation guide here.

Once Golang is installed, you can install GoCron using the go get command:

go get -u github.com/jasonlvhit/gocron

This command will install the latest version of GoCron in your $GOPATH.

Using GoCron in Your Application

Let’s begin by creating a simple Go application that uses GoCron. First, create a new directory for your project and navigate to it:

mkdir gocron-example && cd gocron-example

Next, create a new file named `main. and open it in your favorite text editor.

Importing GoCron

In your `main. file, start by importing the necessary packages, including GoCron:

package main

import (

Defining Tasks

Now, let’s define some tasks to be executed by GoCron. For this example, we will create two simple tasks:

  1. A task that prints “Hello, World!” every second.
  2. A task that prints the current time every 10 seconds.

Define these tasks as functions in your `main. file:

func printHello() {
	fmt.Println("Hello, World!")

func printCurrentTime() {
	currentTime := time.Now().Format("15:04:05")
	fmt.Printf("Current time: %s\n", currentTime)

Scheduling Tasks

Next, let’s schedule the tasks using GoCron. In your main. file, add the following code inside the main` function:

func main() {
	// Schedule the tasks

	// Start the scheduler

The gocron.Every(interval).Unit().Do(task) syntax is used to schedule a task with a specific interval and time unit. In our example, we scheduled printHello to run every second and printCurrentTime to run every 10 seconds.

The last line, <-gocron.Start(), starts the scheduler and keeps it running indefinitely.

Running the Application

Save the main. file and run the application using the go run` command:

go run main.go

You should see the “Hello, World!” message printed every second and the current time printed every 10 seconds.

Advanced Usage

GoCron also supports more advanced scheduling options, such as:

  • Running tasks at specific times using the At function.
  • Limiting the number of times a task is executed using the Limit function.
  • Removing scheduled tasks using the Remove function.

Refer to the official GoCron documentation for more information on these features and their usage.


GoCron is a powerful and easy-to-use task scheduling library for Golang applications. It can help you automate repetitive tasks, manage background processes, and improve the overall efficiency of your application. This article provided a brief introduction to GoCron and demonstrated how to use it to schedule and manage tasks in a Golang application.

© Copyright 2024 by FriendlyUsers Tech Blog. Built with ♥ by FriendlyUser. Last updated on 2024-06-14.