This commit is contained in:
gouguoyin 2021-09-10 14:44:55 +02:00
parent dae8d3922b
commit 00149f6304
3 changed files with 30 additions and 60 deletions

View File

@ -19,7 +19,7 @@ Carbon 已被 [awesome-go](https://github.com/avelino/awesome-go#date-and-time "
#### 安装使用
##### Golang 版本小于1.16
> 确保已安装 `1.16` 或更高版本的 Go
```go
// 使用 github 库
@ -37,24 +37,6 @@ import (
)
```
##### Golang 版本大于等于1.16
```go
// 使用 github 库
go get -u github.com/golang-module/carbon/v2
import (
"github.com/golang-module/carbon/v2"
)
// 使用 gitee 库
go get -u gitee.com/go-package/carbon/v2
import (
"gitee.com/go-package/carbon/v2"
)
```
#### 用法示例
> 默认时区为 Local即服务器所在时区假设当前时间为 2020-08-05 13:14:15
@ -454,6 +436,15 @@ carbon.Parse("2020-08-05 13:14:15").DiffInSeconds(carbon.Parse("2020-08-05 13:14
// 相差多少秒(绝对值)
carbon.Parse("2020-08-05 13:14:15").DiffInSecondsWithAbs(carbon.Parse("2020-08-05 13:14:14")) // 1
// 相差字符串
carbon.Now().DiffInString() // just now
carbon.Now().AddYearsNoOverflow(1).DiffInString() // -1 year
carbon.Now().SubYearsNoOverflow(1).DiffInString() // 1 year
// 相差字符串(绝对值)
carbon.Now().DiffInStringWithAbs(carbon.Now()) // just now
carbon.Now().AddYearsNoOverflow(1).DiffInStringWithAbs(carbon.Now()) // 1 year
carbon.Now().SubYearsNoOverflow(1).DiffInStringWithAbs(carbon.Now()) // 1 year
// 对人类友好的可读格式时间差
carbon.Parse("2020-08-05 13:14:15").DiffForHumans() // just now
carbon.Parse("2019-08-05 13:14:15").DiffForHumans() // 1 year ago
@ -1277,10 +1268,4 @@ invalid timezone "xxx", please see the file "$GOROOT/lib/time/zoneinfo.zip" for
* [goframe/gtime](https://github.com/gogf/gf/tree/master/os/gtime)
* [arrow-py/arrow](https://github.com/arrow-py/arrow)
* [moment/moment](https://github.com/moment/moment)
* [iamkun/dayjs](https://github.com/iamkun/dayjs)
#### 相关链接
* [robeeask社区](https://carbon.robeeask.com/ "robeeask社区")
* [掘金社区](https://juejin.cn/column/6988159448736858120 "掘金社区")
* [segmentfault社区](https://segmentfault.com/blog/carbon "segmentfault社区")
* [iamkun/dayjs](https://github.com/iamkun/dayjs)

View File

@ -19,7 +19,7 @@ Carbon は [awesome-go](https://github.com/avelino/awesome-go#date-and-time "awe
#### インストール使用
##### Golangバージョンは1.16より小さいです
> `1.16` 以降のバージョンのGoがインストールされていることを確認してください
```go
// github倉庫を使う
@ -37,24 +37,6 @@ import (
)
```
##### Golangバージョンは1.16以上です
```go
// github倉庫を使う
go get -u github.com/golang-module/carbon/v2
import (
"github.com/golang-module/carbon/v2"
)
// gitee倉庫を使う
go get -u gitee.com/go-package/carbon/v2
import (
"gitee.com/go-package/carbon/v2"
)
```
#### 使い方の例
> デフォルトのタイムゾーンはLocalです。つまりサーバのタイムゾーンです, 現在の時間は2020-08-05 13:14:15と仮定します
@ -452,6 +434,15 @@ carbon.Parse("2020-08-05 13:14:15").DiffInSeconds(carbon.Parse("2020-08-05 13:14
// 何秒の差がありますか(絶対値)
carbon.Parse("2020-08-05 13:14:15").DiffInSecondsWithAbs(carbon.Parse("2020-08-05 13:14:14")) // 1
// 時間差を文字列で表す
carbon.Now().DiffInString() // just now
carbon.Now().AddYearsNoOverflow(1).DiffInString() // -1 year
carbon.Now().SubYearsNoOverflow(1).DiffInString() // 1 year
// 時間差を文字列で表す(絶対値)
carbon.Now().DiffInStringWithAbs(carbon.Now()) // just now
carbon.Now().AddYearsNoOverflow(1).DiffInStringWithAbs(carbon.Now()) // 1 year
carbon.Now().SubYearsNoOverflow(1).DiffInStringWithAbs(carbon.Now()) // 1 year
// 人間に優しい読み取り可能なフォーマットの時間差を取得します
carbon.Parse("2020-08-05 13:14:15").DiffForHumans() // just now
carbon.Parse("2019-08-05 13:14:15").DiffForHumans() // 1 year ago
@ -1103,7 +1094,7 @@ fmt.Printf("%+v", *person)
###### エリアの設定
```go
lang := NewLanguage()
lang := carbon.NewLanguage()
if err := lang.SetLocale("zh-CN"); err != nil {
// エラー処理
log.Fatal(err)
@ -1122,7 +1113,7 @@ c.Now().AddHours(1).Season() // 夏季
###### 翻訳リソースの一部を書き換える(残りはまだ指定された `locale` ファイルの内容によって翻訳されます)
```go
lang := NewLanguage()
lang := carbon.NewLanguage()
if err := lang.SetLocale("en"); err != nil {
// エラー処理
@ -1148,7 +1139,7 @@ c.Now().Season() // Summer
###### すべての翻訳リソースを書き換えます
```go
lang := NewLanguage()
lang := carbon.NewLanguage()
resources := map[string]string {
"months": "january|february|march|april|may|june|july|august|september|october|november|december",
"short_months": "jan|feb|mar|apr|may|jun|jul|aug|sep|oct|nov|dec",

View File

@ -1040,7 +1040,7 @@ if err != nil {
log.Fatal(err)
}
fmt.Printf("%s", data)
// output
// Output
{
"id": 1,
"name": "gouguoyin",
@ -1078,7 +1078,7 @@ if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v", *person)
// output
// Output
{ID:1 Name:gouguoyin Age:18 Birthday:2003-07-16 16:22:02 GraduatedAt:2020-08-05 00:00:00 UpdatedAt:2022-08-05 13:14:15 DateTime1:2023-08-05 13:14:15 DateTime2:2024-08-05 13:14:15 DateTime3:2025-08-05 13:14:15 DateTime4:2025-08-05 13:14:15}
```
@ -1110,7 +1110,7 @@ The following methods are supported
###### Set locale
```go
lang := NewLanguage()
lang := carbon.NewLanguage()
if err := lang.SetLocale("zh-CN"); err != nil {
// Error handle...
log.Fatal(err)
@ -1129,7 +1129,7 @@ c.Now().AddHours(1).Season() // 夏季
###### Reset some resources(the rests still translate from the given locale)
```go
lang := NewLanguage()
lang := carbon.NewLanguage()
if err := lang.SetLocale("en"); err != nil {
// Error handle...
@ -1155,7 +1155,7 @@ c.Now().Season() // Summer
###### Reset all resources
```go
lang := NewLanguage()
lang := carbon.NewLanguage()
resources := map[string]string {
"months": "january|february|march|april|may|june|july|august|september|october|november|december",
"short_months": "jan|feb|mar|apr|may|jun|jul|aug|sep|oct|nov|dec",
@ -1281,10 +1281,4 @@ invalid timezone "xxx", please see the file "$GOROOT/lib/time/zoneinfo.zip" for
* [goframe/gtime](https://github.com/gogf/gf/tree/master/os/gtime)
* [arrow-py/arrow](https://github.com/arrow-py/arrow)
* [moment/moment](https://github.com/moment/moment)
* [iamkun/dayjs](https://github.com/iamkun/dayjs)
#### Links
* [robeeask](https://carbon.robeeask.com/ "robeeask")
* [juejin](https://juejin.cn/column/6988159448736858120 "juejin")
* [segmentfault](https://segmentfault.com/blog/carbon "segmentfault")
* [iamkun/dayjs](https://github.com/iamkun/dayjs)