Carbon 2.6.0 Released: A Lightweight Golang Time Handling Library

carbon3/25/25About 1 min

Carbon is a lightweight, semantic, and developer-friendly Golang time handling library. It supports time travel, time difference calculations, time extremes, time judgments, zodiac signs, constellations, the lunar calendar, Julian Day / Modified Julian Day, and the Persian (Iranian) calendar.

Carbon has been donated to the dromara[1] open-source organization, included in awesome-go[2], and has received the gitee[3] 2024 Most Valuable Project (GVP[4]) award and the gitcode[5] 2024 G-Star[6] award. If you find it useful, please give it a star!

github.com/dromara/carbon[7]

gitee.com/dromara/carbon[8]

gitcode.com/dromara/carbon[9]

Changelog

Minimum golang version requirement upgraded to 1.18
carbon, julian, lunar, and persian changed from value passing to pointer passing
Added ZoneName method to retrieve the timezone name
Added HasError method to check for errors
Added IsNil method to check if the value is nil
Added Copy method for deep copying a carbon instance
Added example files xxx_example.go
Added constant.go file; constants migrated from carbon.go to this file
Default global timezone changed from Local to UTC
Renamed Offset method to ZoneOffset
Renamed IsSetTestNow method to IsTestNow
Renamed UnSetTestNow method to CleanTestNow
Removed Location method, replaced by Timezone method
Modified the logic of IsValid and IsInvalid methods; zero time is no longer considered invalid
Setting the global default timezone now simultaneously updates time.Local
Refactored database.go; removed carbon.DateTime, carbon.DateTimeMilli, carbon.DateTimeMicro, carbon.DateTimeNano, carbon.Date, carbon.DateMilli, carbon.DateMicro, carbon.DateNano, carbon.Time, carbon.TimeMilli, carbon.TimeMicro, carbon.TimeNano, carbon.Timestamp, carbon.TimestampMilli, carbon.TimestampMicro, and carbon.TimestampNano field types. Replaced with generic fields to enable custom output formatting during MarshalJSON/UnmarshalJSON

References

[1]
dromara: https://dromara.org/

[2]
awesome-go: https://github.com/avelino/awesome-go#date-and-time

[3]
gitee: https://gitee.com

[4]
GVP: https://gitee.com/gcp

[5]
gitcode: https://gitcode.com

[6]
G-Star: https://gitcode.com/g-star

[7]
github.com/dromara/carbon: https://github.com/dromara/carbon

[8]
gitee.com/dromara/carbon: https://gitee.com/dromara/carbon

[9]
gitcode.com/dromara/carbon: https://gitcode.com/dromara/carbon