登录
当前位置： 首页 > 软件库 > 程序开发 > 常用工具包 >

go-carbon

日期时间处理库
授权协议 MIT
开发语言 Google Go
所属分类 程序开发、 常用工具包
软件类型 开源软件
地区 国产
投 递 者 华振
操作系统 跨平台
开源组织 无
适用人群 未知
软件官网
软件文档
官方下载
 软件概览

carbon 是一个轻量级、语义化、对开发者友好的Golang时间处理库，支持链式调用和gorm、xorm等主流orm。

安装使用

// 使用 github 库
go get -u github.com/golang-module/carbon

import (
    "github.com/golang-module/carbon"
)

// 使用 gitee 库
go get -u gitee.com/golang-module/carbon

import (
    "gitee.com/golang-module/carbon"
)

用法示例

默认时区为 Local，即服务器所在时区，假设当前时间为 2020-08-05 13:14:15

  • 昨天、今天、明天 
// 今天此刻
fmt.Sprintf("%s", carbon.Now()) // 2020-08-05 13:14:15
carbon.Now().ToString() // 2020-08-05 13:14:15 +0800 CST
carbon.Now().ToDateTimeString() // 2020-08-05 13:14:15
// 今天日期
carbon.Now().ToDateString() // 2020-08-05
// 今天时间
carbon.Now().ToTimeString() // 13:14:15
// 指定时区的今天此刻
carbon.Now(Carbon.NewYork).ToDateTimeString() // 2020-08-05 14:14:15
// 今天秒级时间戳
carbon.Now().Timestamp() // 1596604455
// 今天毫秒级时间戳
carbon.Now().TimestampMilli() // 1596604455000
// 今天微秒级时间戳
carbon.Now().TimestampMicro() // 1596604455000000
// 今天纳秒级时间戳
carbon.Now().TimestampNano() // 1596604455000000000

// 昨天此刻
fmt.Sprintf("%s", carbon.Yesterday()) // 2020-08-04 13:14:15
carbon.Yesterday().ToString() // 2020-08-04 13:14:15 +0800 CST
carbon.Yesterday().ToDateTimeString() // 2020-08-04 13:14:15
// 昨天日期
carbon.Yesterday().ToDateString() // 2020-08-04
// 昨天时间
carbon.Yesterday().ToTimeString() // 13:14:15
// 指定日期的昨天此刻
carbon.Parse("2021-01-28 13:14:15").Yesterday().ToDateTimeString() // 2021-01-27 13:14:15
// 指定时区的昨天此刻
carbon.Yesterday(Carbon.NewYork).ToDateTimeString() // 2020-08-04 14:14:15
// 昨天秒级时间戳
carbon.Yesterday().Timestamp() // 1596518055
// 昨天毫秒级时间戳
carbon.Yesterday().TimestampMilli() // 1596518055000
// 昨天微秒级时间戳
carbon.Yesterday().TimestampMicro() // 1596518055000000
// 昨天纳秒级时间戳
carbon.Yesterday().TimestampNano() // 1596518055000000000

// 明天此刻
fmt.Sprintf("%s", carbon.Tomorrow()) // 2020-08-06 13:14:15
carbon.Tomorrow().ToString() // 2020-08-06 13:14:15 +0800 CST
carbon.Tomorrow().ToDateTimeString() // 2020-08-06 13:14:15
// 明天日期
carbon.Tomorrow().ToDateString() // 2020-08-06
// 明天时间
carbon.Tomorrow().ToTimeString() // 13:14:15
// 指定日期的明天此刻
carbon.Parse("2021-01-28 13:14:15").Tomorrow().ToDateTimeString() // 2021-01-29 13:14:15
// 指定时区的明天此刻
carbon.Tomorrow(Carbon.NewYork).ToDateTimeString() // 2020-08-06 14:14:15
// 明天秒级时间戳
carbon.Tomorrow().Timestamp() // 1596690855
// 明天毫秒级时间戳
carbon.Tomorrow().TimestampMilli() // 1596690855000
// 明天微秒级时间戳
carbon.Tomorrow().TimestampMicro() // 1596690855000000
// 明天纳秒级时间戳
carbon.Tomorrow().TimestampNano() // 1596690855000000000
  • 创建 carbon 实例
// 从秒级时间戳创建 Carbon 实例
carbon.CreateFromTimestamp(-1).ToString() // 1970-01-01 07:59:59 +0800 CST
carbon.CreateFromTimestamp(0).ToString() // 1970-01-01 08:00:00 +0800 CST
carbon.CreateFromTimestamp(1).ToString() // 1970-01-01 08:00:01 +0800 CST
carbon.CreateFromTimestamp(1649735755).ToString() // 2022-04-12 11:55:55 +0800 CST
// 从毫秒级时间戳创建 Carbon 实例
carbon.CreateFromTimestampMilli(1649735755981).ToString() // 2022-04-12 11:55:55.981 +0800 CST
// 从微秒级时间戳创建 Carbon 实例
carbon.CreateFromTimestampMicro(1649735755981566).ToString() // 2022-04-12 11:55:55.981566 +0800 CST
// 从纳秒级时间戳创建 Carbon 实例
carbon.CreateFromTimestampNano(1649735755981566000).ToString() // 2022-04-12 11:55:55.981566 +0800 CST

// 从年月日时分秒创建 Carbon 实例
carbon.CreateFromDateTime(2020, 8, 5, 13, 14, 15).ToString() // 2020-08-05 13:14:15 +0800 CST
// 从年月日时分秒创建 Carbon 实例，包含毫秒
carbon.CreateFromDateTimeMilli(2020, 8, 5, 13, 14, 15, 999).ToString() // 2020-08-05 13:14:15.999 +0800 CST
// 从年月日时分秒创建 Carbon 实例，包含微秒
carbon.CreateFromDateTimeMicro(2020, 8, 5, 13, 14, 15, 999999).ToString() // 2020-08-05 13:14:15.999999 +0800 CST
// 从年月日时分秒创建 Carbon 实例，包含纳秒
carbon.CreateFromDateTimeNano(2020, 8, 5, 13, 14, 15, 999999999).ToString() // 2020-08-05 13:14:15.999999999 +0800 CST

// 从年月日创建 Carbon 实例(时分秒默认为当前时分秒)
carbon.CreateFromDate(2020, 8, 5).ToString() // // 2020-08-05 13:14:15 +0800 CST
// 从年月日创建 Carbon 实例(时分秒默认为当前时分秒)，包含毫秒
carbon.CreateFromDateMilli(2020, 8, 5, 999).ToString() // 2020-08-05 13:14:15.999 +0800 CST
// 从年月日创建 Carbon 实例(时分秒默认为当前时分秒)，包含微秒
carbon.CreateFromDateMicro(2020, 8, 5, 999999).ToString() // 2020-08-05 13:14:15.999999 +0800 CST
// 从年月日创建 Carbon 实例(时分秒默认为当前时分秒)，包含纳秒
carbon.CreateFromDateNano(2020, 8, 5, 999999999).ToString() // 2020-08-05 13:14:15.999999999 +0800 CST

// 从时分秒创建 Carbon 实例(年月日默认为当前年月日)
carbon.CreateFromTime(13, 14, 15).ToString() // 2020-08-05 13:14:15 +0800 CST
// 从时分秒创建 Carbon 实例(年月日默认为当前年月日)，包含毫秒
carbon.CreateFromTimeMilli(13, 14, 15, 999).ToString() // 2020-08-05 13:14:15.999 +0800 CST
// 从时分秒创建 Carbon 实例(年月日默认为当前年月日)，包含微秒
carbon.CreateFromTimeMicro(13, 14, 15, 999999).ToString() // 2020-08-05 13:14:15.999999 +0800 CST
// 从时分秒创建 Carbon 实例(年月日默认为当前年月日)，包含纳秒
carbon.CreateFromTimeNano(13, 14, 15, 999999999).ToString() // 2020-08-05 13:14:15.999999999 +0800 CST
  • 将标准格式时间字符串解析成 carbon 实例
carbon.Parse("").ToDateTimeString() // 空字符串
carbon.Parse("0").ToDateTimeString() // 空字符串
carbon.Parse("0000-00-00 00:00:00").ToDateTimeString() // 空字符串
carbon.Parse("0000-00-00").ToDateTimeString() // 空字符串
carbon.Parse("00:00:00").ToDateTimeString() // 空字符串

carbon.Parse("2020-08-05").ToString() // 2020-08-05 00:00:00 +0800 CST
carbon.Parse("2020-08-05 13:14:15").ToString() // 2020-08-05 13:14:15 +0800 CST
carbon.Parse("2020-08-05 13:14:15.999").ToString() // 2020-08-05 13:14:15.999 +0800 CST
carbon.Parse("2020-08-05 13:14:15.999999").ToString() // 2020-08-05 13:14:15.999999 +0800 CST
carbon.Parse("2020-08-05 13:14:15.999999999").ToString() // 2020-08-05 13:14:15.999999999 +0800 CST

carbon.Parse("2020-08-05T13:14:15+08:00").ToString() // 2020-08-05 13:14:15 +0800 CST
carbon.Parse("2020-08-05T13:14:15.999+08:00").ToString() // 2020-08-05 13:14:15.999 +0800 CST
carbon.Parse("2020-08-05T13:14:15.999999+08:00").ToString() // 2020-08-05 13:14:15.999999 +0800 CST
carbon.Parse("2020-08-05T13:14:15.999999999+08:00").ToString() // 2020-08-05 13:14:15.999999999 +0800 CST

carbon.Parse("20200805").ToString() // 2020-08-05 00:00:00 +0800 CST
carbon.Parse("20200805131415").ToString() // 2020-08-05 13:14:15 +0800 CST
carbon.Parse("20200805131415.999").ToString() // 2020-08-05 13:14:15.999 +0800 CST
carbon.Parse("20200805131415.999999").ToString() // 2020-08-05 13:14:15.999999 +0800 CST
carbon.Parse("20200805131415.999999999").ToString() // 2020-08-05 13:14:15.999999999 +0800 CST
  • 通过格式模板将字符串解析成 carbon 实例
carbon.ParseByFormat("2020|08|05 13|14|15", "Y|m|d H|i|s").ToDateTimeString() // 2020-08-05 13:14:15
carbon.ParseByFormat("It is 2020-08-05 13:14:15", "\\I\\t \\i\\s Y-m-d H:i:s").ToDateTimeString() // 2020-08-05 13:14:15
carbon.ParseByFormat("今天是 2020年08月05日13时14分15秒", "今天是 Y年m月d日H时i分s秒").ToDateTimeString() // 2020-08-05 13:14:15
carbon.ParseByFormat("2020-08-05 13:14:15", "Y-m-d H:i:s", carbon.Tokyo).ToDateTimeString() // 2020-08-05 14:14:15
  • 通过布局模板将字符串解析成 carbon 实例
carbon.ParseByLayout("2020|08|05 13|14|15", "2006|01|02 15|04|05").ToDateTimeString() // 2020-08-05 13:14:15
carbon.ParseByLayout("It is 2020-08-05 13:14:15", "It is 2006-01-02 15:04:05").ToDateTimeString() // 2020-08-05 13:14:15
carbon.ParseByLayout("今天是 2020年08月05日13时14分15秒", "今天是 2006年01月02日15时04分05秒").ToDateTimeString() // 2020-08-05 13:14:15
carbon.ParseByLayout("2020-08-05 13:14:15", "2006-01-02 15:04:05", carbon.Tokyo).ToDateTimeString() // 2020-08-05 14:14:15
  • carbon和time.Time互转 
// 将 time.Time 转换成 Carbon
carbon.Time2Carbon(time.Now())
// 将 Carbon 转换成 time.Time
carbon.Now().Carbon2Time()

        更多用法请查看下方软件文档

         使用案例
        • Go 每日一库之 go-carbon，优雅的golang日期时间处理库

          Carbon carbon 是一个轻量级、语义化、对开发者友好的 Golang 时间处理库，支持链式调用和 gorm、xorm、zorm 等主流 orm。 github:github.com/golang-module/carbon gitee:gitee.com/go-package/carbon 安装使用 // 使用 github 库 go get -u github.com/golang-m

        • go-carbon v2.1.6 发布， 轻量级、语义化、对开发者友好的Golang时间处理库

          carbon 是一个轻量级、语义化、对开发者友好的 golang 时间处理库，支持链式调用。 目前已被 awesome-go 收录，如果您觉得不错，请给个 star 吧 github.com/golang-module/carbon gitee.com/golang-module/carbon 安装使用 Golang 版本大于等于1.16 // 使用 github 库 go get -u gith

        • go-carbon 2.2.3版本发布， 轻量级、语义化、对开发者友好的Golang时间处理库

          carbon 是一个轻量级、语义化、对开发者友好的 golang 时间处理库，支持链式调用。 目前已被 awesome-go 收录，如果您觉得不错，请给个 star 吧 github.com/golang-module/carbon gitee.com/golang-module/carbon 安装使用 Golang 版本大于等于1.16 // 使用 github 库 go get -u gith

        • go-carbon 2.1.5 五一特别版， 轻量级、语义化、对开发者友好的Golang时间处理库

          carbon 是一个轻量级、语义化、对开发者友好的golang时间处理库，支持链式调用。 目前已被 awesome-go 收录，如果您觉得不错，请给个star吧 github.com/golang-module/carbon gitee.com/golang-module/carbon 安装使用 Golang 版本小于1.16 // 使用 github 库 go get -u github.com

        • 2021-07-23go-carbon 1.4.4 版本发布，部分方法新增时区可选参数和新增功能

          carbon 是一个轻量级、语义化、对开发者友好的golang时间处理库，支持链式调用、农历和gorm、xorm等主流orm 如果您觉得不错，请给个star吧 github:github.com/golang-module/carbon gitee:gitee.com/go-package/carbon 更新日志 修复CreateFromDate()和CreateFromTime()方法缺少时区的

        • go-carbon 1.5.2版本发布， 修复已知 bug 和新增功能及葡萄牙语翻译文件

          carbon 是一个轻量级、语义化、对开发者友好的golang时间处理库，支持链式调用。 目前已被 awesome-go 收录，如果您觉得不错，请给个star吧 github.com/golang-module/carbon gitee.com/go-package/carbon 更新日志 修复某些情况下parseByFormat()方法解析无效的bug 修复某些情况下Format()方法解析无效

        • go-carbon 1.4.6版本发布，修复已知bug和新增翻译文件

          carbon 是一个轻量级、语义化、对开发者友好的golang时间处理库，支持链式调用。 目前已被awesome-go收录，如果您觉得不错，请给个star吧 github:github.com/golang-module/carbon gitee:gitee.com/go-package/carbon 更新日志 修复WeekOfMonth()计算错误的bug 修复韩语和日语的翻译错误 所有源码增加

        • go-carbon 1.4.3 版本发布，新增对json.UnmarshalJSON()的支持

          carbon 是一个轻量级、语义化、对开发者友好的Golang时间处理库，支持链式调用、农历和gorm、xorm等主流orm 如果您觉得不错，请给个star吧 github:github.com/golang-module/carbon gitee:gitee.com/go-package/carbon 更新日志 优化IsZero()方法的判断逻辑 修复Microsecond()方法获取毫秒数错误

        • go-carbon v2.1.8 发布， 轻量级、语义化、对开发者友好的Golang时间处理库

          carbon 是一个轻量级、语义化、对开发者友好的 golang 时间处理库，支持链式调用。 目前已被 awesome-go 收录，如果您觉得不错，请给个 star 吧 github.com/golang-module/carbon gitee.com/golang-module/carbon 安装使用 Golang 版本大于等于1.16 // 使用 github 库 go get -u gith

        • go-carbon 1.5.0版本发布，修复已知 bug 和新增德语翻译文件

          carbon 是一个轻量级、语义化、对开发者友好的golang时间处理库，支持链式调用。 目前已被 awesome-go 收录，如果您觉得不错，请给个star吧 github:github.com/golang-module/carbon gitee:gitee.com/go-package/carbon 更新日志 优化多语言支持，无需再将lang目录复制到项目目录下 移除SetDir()方法，语

        • go-carbon 1.3.1 版本发布，新增 DiffForHumans() 方法和多语言支持

          carbon 是一个轻量级、语义化、对开发者友好的 Golang 时间处理库，支持链式调用、农历和 gorm、xorm 等主流 orm 如果您觉得不错，请给个 star 吧 github:github.com/golang-module/carbon gitee:gitee.com/go-package/carbon 对人类友好的可读格式时间差 // 默认英文 carbon.Now().DiffF

        • go-carbon 1.3.2 版本发布，新增自定义 i18n 系列方法和日文翻译文件

          carbon 是一个轻量级、语义化、对开发者友好的Golang时间处理库，支持链式调用、农历和gorm、xorm等主流orm 如果您觉得不错，请给个star吧 github:https://github.com/golang-module/carbon gitee:https://gitee.com/go-package/carbon 更新日志 * 按照功能拆分文件，优化代码组织结构 * 新增Se

        • go-carbon 1.5.1 版本发布， 修复已知 bug 和新增土耳其翻译文件

          carbon 是一个轻量级、语义化、对开发者友好的golang时间处理库，支持链式调用。 目前已被 awesome-go 收录，如果您觉得不错，请给个star吧 github.com/golang-module/carbon gitee.com/go-package/carbon 更新日志 修复EndOfCentury()逻辑错误 修复将模型字段设为 carbon.TodateTimeString

        • go-carbon 1.4.5版本发布，修复已知bug和优化功能

          carbon 是一个轻量级、语义化、对开发者友好的golang时间处理库，支持链式调用、农历和gorm、xorm等主流orm 如果您觉得不错，请给个star吧 github:github.com/golang-module/carbon gitee:gitee.com/go-package/carbon 更新日志 修复IsFebruary()备注信息错误的bug 修复WeekOfMonth()计算

        • Golang：carbon一个轻量级、语义化、对开发者友好的 golang 时间处理库

          一个轻量级、语义化、对开发者友好的 golang 时间处理库，支持链式调用 文档 https://github.com/golang-module/carbon https://pkg.go.dev/github.com/golang-module/carbon/v2 中文文档 安装 go get -u github.com/golang-module/carbon/v2 示例 package

         相关资料
        • 批处理日期时间

          主要内容：日期,时间,日期格式化：年-月-日DOS脚本中的日期和时间具有以下两个用于检索系统日期和时间的基本命令。 日期 该命令获取系统日期。 语法 示例 当前日期将显示在命令提示符下。 例如， 时间 该命令设置或显示时间。 语法 示例 当前时间将显示在命令提示符下。 例如， 以下是一些可用于以不同格式获取日期和时间的实现。 日期格式化：年-月-日 示例 以上命令产生以下输出 -

        • Java时间日期的处理

          主要内容：Date 类,Calendar 类在 Java 中获取当前时间，可以使用 java.util.Date 类和 java.util.Calendar 类完成。其中， Date 类主要封装了系统的日期和时间的信息，Calendar 类则会根据系统的日历来解释 Date 对象。下面详细介绍这两个类的具体使用。 Date 类 Date 类表示系统特定的时间戳，可以精确到毫秒。Date 对象表示时间的默认顺序是星期、月、日、小时、分、秒、年

        • 18. 处理日期和时间

          使用DateTime 类。 在 PHP 糟糕的老时光里，我们必须使用 date()， gmdate()， date_timezone_set()， strtotime()等等令人迷惑的 组合来处理日期和时间。悲哀的是现在你仍旧会找到很多在线教程在讲述这些不易使用的老式函数。 幸运的是，我们正在讨论的 PHP 版本包含友好得多的 DateTime 类。 该类封装了老式日期函数所有功能，甚至更多，在一

        • JAVA时间日期处理类实例

          本文向大家介绍JAVA时间日期处理类实例，包括了JAVA时间日期处理类实例的使用技巧和注意事项，需要的朋友参考一下 本文实例讲述了JAVA时间日期处理类，主要用来遍历两个日期之间的每一天。分享给大家供大家参考。具体如下： 希望本文所述对大家的java程序设计有所帮助。

        • 在Java中处理MySQL日期时间和时间戳

          问题内容： 在Java应用程序中，使用日期时间和时间戳的混合在MySQL数据库中添加和输入日期信息方面有什么好的折衷办法？ 问题答案： 在Java方面，日期通常由（设计欠佳，但不包括在内）表示。它基本上是由支持大纪元时间中的味道long，也称为时间戳。它包含有关日期和时间部分的信息。在Java中，精度以毫秒为单位。 在SQL方面，有几个标准的日期和时间类型，DATE，TIME和TIMESTAMP（

        • Python 处理日期时间的Arrow库使用

          本文向大家介绍Python 处理日期时间的Arrow库使用，包括了Python 处理日期时间的Arrow库使用的使用技巧和注意事项，需要的朋友参考一下 Python针对日期时间的处理提供了大量的package，类和方法，但在可用性上来看非常繁琐和麻烦 第三方库Arrow提供了一个合理的、人性化的方法来创建、操作、格式转换的日期，时间，和时间戳，帮助我们使用较少的导入和更少的代码来处理日期和时间。

        同类工具

        laser-javaLiteracyexcel-beanAda Utildianping-open-sdkJalangi2Luwracryptography

        相关阅读

        Python实用日期时间处理方法汇总C++  boost 时间与日期处理详细介绍“导入日期时间”与“从日期时间导入日期时间”如何更改Go日志包的日期/时间格式将JS日期时间转换为MySQL日期时间

        相关文章

        PostgreSQL 时间/日期Perl 时间日期Ruby 日期 & 时间VBA日期时间函数PL/SQL日期及时间

        相关问答

        JavaFX实时时间和日期swagger日期字段与日期-时间字段vue.js - 日期组件有有开始日期和结束日期 怎么处理选中的时间在一个月30天？将一个日期时间与当前日期时间进行比较Java8:本地日期时间或时间戳

        相关文档

        Python 文本处理PyTorch 自然语言处理Python 自然语言处理Python 自然语言处理教程Python 和 NLTK 自然语言处理
        快捷导航： 新手教程 算法原理 架构设计 Java进阶 数据库进阶 大厂专栏 面试经验 编程笔记 编程问答 所有专题 文档资料 工具软件 电子书籍 小牛导航
        在线工具： 房贷计算器 个税计算器 Linux命令查询 Json格式化 正则表达式 颜色转换 AES加解密 SHA1加密 MD5加密 毒鸡汤 字数统计 随机密码生成 进制转换 Base64编解码 励志句子
        Copyright © 2019-2024 小牛知识库@xnip.cn. All Rights Reserved.