Programming language: Go
License: Apache License 2.0
Tags: Date & Time    
Latest version: v0.1.6

carbon alternatives and similar packages

Based on the "Date & Time" category.
Alternatively, view carbon alternatives based on common mentions on social networks and blogs.

Do you think we are missing an alternative of carbon or a related project?

Add another 'Date & Time' Package



Build Status Go Report Card codecov GoDoc License

A simple extension for Time based on PHP's Carbon library.


  • Time is embedded into Carbon (provides access to all of Time's functionality)
  • Supports addition and subtraction of dates
  • Provides methods to compare dates
  • Supports date formatting in common formats
  • Easily calculate difference between dates
  • Ease testing with dates by using carbon.Freeze() and carbon.Now()

To do:

  • Implement all localization features as in Carbon
  • Improve the code style to be more idiomatic Go

Getting started

Install Carbon:

go get github.com/uniplaces/carbon

Add to your imports to start using Carbon

import "github.com/uniplaces/carbon"


A simple example to get you started:

package main

import (


func main() {
    fmt.Printf("Right now is %s\n", carbon.Now().DateTimeString())

    today, _ := carbon.NowInLocation("America/Vancouver")
    fmt.Printf("Right now in Vancouver is %s\n", today)

    fmt.Printf("Tomorrow is %s\n", carbon.Now().AddDay())
    fmt.Printf("Last week is %s\n", carbon.Now().SubWeek())

    nextOlympics, _ := carbon.CreateFromDate(2016, time.August, 5, "Europe/London")
    nextOlympics = nextOlympics.AddYears(4)
    fmt.Printf("Next olympics are in %d\n", nextOlympics.Year())

    if carbon.Now().IsWeekend() {
        fmt.Printf("Party time!")

You can also check the examples/ folder for more examples.


Please feel free to make suggestions, create issues, fork the repository and send pull requests!


Copyright 2016 UNIPLACES

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at


Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

*Note that all licence references and agreements mentioned in the carbon README section above are relevant to that project's source code only.