Clock is a small library for mocking time in Go.
Alternatives To Clock
Project NameStarsDownloadsRepos Using ThisPackages Using ThisMost Recent CommitTotal ReleasesLatest ReleaseOpen IssuesLicenseLanguage
Clock64613553114 days ago15November 15, 20213mitGo
Clock is a small library for mocking time in Go.
Delorean464794503 years ago11December 06, 20127mitRuby
DISCONTINUED - Delorean lets you travel in time with Ruby by mocking
Python Libfaketime59
2 years ago3gpl-2.0Python
A fast time mocking alternative to freezegun that wraps libfaketime.
Timeshift Js5528a year ago6June 01, 20223mitJavaScript
Library for mocking JavaScript's Date object
a month ago8January 19, 2022mitGo
A library for abstracting away from the literal Go time library, for testing and time control.
Timex3713 years ago3August 03, 2020otherGo
A test-friendly replacement for golang's time package
Time Travel33
3 years ago5September 04, 20188mitPython
python time libraries mocking
Time Machine13
5 years ago1November 26, 2017bsd-3-clauseHaskell
A Haskell library to mock the current time.
2 years agomitGo
A Go (golang) library for mocking standard time, optionally also with context.Context
5 years agomitGo
Clock is a small library for mocking time in Go.
Alternatives To Clock
Select To Compare

Alternative Project Comparisons

clock reference

Clock is a small library for mocking time in Go. It provides an interface around the standard library's time package so that the application can use the realtime clock while tests can use the mock clock.

This module is no longer maintained.


Realtime Clock

Your application can maintain a Clock variable that will allow realtime and mock clocks to be interchangeable. For example, if you had an Application type:

import ""

type Application struct {
	Clock clock.Clock

You could initialize it to use the realtime clock like this:

var app Application
app.Clock = clock.New()

Then all timers and time-related functionality should be performed from the Clock variable.

Mocking time

In your tests, you will want to use a Mock clock:

import (


func TestApplication_DoSomething(t *testing.T) {
	mock := clock.NewMock()
	app := Application{Clock: mock}

Now that you've initialized your application to use the mock clock, you can adjust the time programmatically. The mock clock always starts from the Unix epoch (midnight UTC on Jan 1, 1970).

Controlling time

The mock clock provides the same functions that the standard library's time package provides. For example, to find the current time, you use the Now() function:

mock := clock.NewMock()

// Find the current time.
mock.Now().UTC() // 1970-01-01 00:00:00 +0000 UTC

// Move the clock forward.
mock.Add(2 * time.Hour)

// Check the time again. It's 2 hours later!
mock.Now().UTC() // 1970-01-01 02:00:00 +0000 UTC

Timers and Tickers are also controlled by this same mock clock. They will only execute when the clock is moved forward:

mock := clock.NewMock()
count := 0

// Kick off a timer to increment every 1 mock second.
go func() {
    ticker := mock.Ticker(1 * time.Second)
    for {

// Move the clock forward 10 seconds.
mock.Add(10 * time.Second)

// This prints 10.
Popular Time Projects
Popular Mocking Projects
Popular Libraries Categories
Related Searches

Get A Weekly Email With Trending Projects For These Categories
No Spam. Unsubscribe easily at any time.
Real Time