更新文档

This commit is contained in:
gouguoyin 2022-11-02 15:48:04 +08:00
parent 2a7e5e9cb1
commit 9b213dc8f8
3 changed files with 54 additions and 26 deletions

View File

@ -59,7 +59,7 @@ import (
#### 用法示例
> 默认时区为 Local即服务器所在时区假设当前时间为 2020-08-05 13:14:15.999999999
> 默认时区为 Local即服务器所在时区假设当前时间为 2020-08-05 13:14:15 +0800 CST
##### 昨天、今天、明天
@ -169,14 +169,14 @@ carbon.CreateFromTimeMicro(13, 14, 15, 999999).ToString() // 2020-08-05 13:14:15
carbon.CreateFromTimeNano(13, 14, 15, 999999999).ToString() // 2020-08-05 13:14:15.999999999 +0800 CST
```
##### 将标准格式时间字符串解析成 Carbon 实例
##### 将时间字符串解析成 Carbon 实例
```go
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("0000-00-00").ToDateTimeString() // 空字符串
carbon.Parse("0000-00-00 00:00:00").ToDateTimeString() // 空字符串
carbon.Parse("2020").ToString() // 2020-01-01 00:00:00 +0800 CST
carbon.Parse("2020-8").ToString() // 2020-08-01 00:00:00 +0800 CST
@ -184,6 +184,9 @@ carbon.Parse("2020-08").ToString() // 2020-08-01 00:00:00 +0800 CST
carbon.Parse("2020-8-5").ToString() // 2020-08-05 00:00:00 +0800 CST
carbon.Parse("2020-8-05").ToString() // 2020-08-05 00:00:00 +0800 CST
carbon.Parse("2020-08-05").ToString() // 2020-08-05 00:00:00 +0800 CST
carbon.Parse("2020-08-05.999").ToString() // 2020-08-05 00:00:00.999 +0800 CST
carbon.Parse("2020-08-05.999999").ToString() // 2020-08-05 00:00:00.999999 +0800 CST
carbon.Parse("2020-08-05.999999999").ToString() // 2020-08-05 00:00:00.999999999 +0800 CST
carbon.Parse("2020-8-5 13:14:15").ToString() // 2020-08-05 13:14:15 +0800 CST
carbon.Parse("2020-8-05 13:14:15").ToString() // 2020-08-05 13:14:15 +0800 CST
@ -205,6 +208,10 @@ 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.Parse("20200805131415.999+08:00").ToString() // 2020-08-05 13:14:15.999 +0800 CST
carbon.Parse("20200805131415.999999+08:00").ToString() // 2020-08-05 13:14:15.999999 +0800 CST
carbon.Parse("20200805131415.999999999+08:00").ToString() // 2020-08-05 13:14:15.999999999 +0800 CST
```
##### 通过格式模板将时间字符串解析成 Carbon 实例
@ -1331,9 +1338,9 @@ fmt.Printf("%+v", *person)
目前支持的语言有
* [英语(en)](./lang/en.json "英语")
* [日语(jp)](./lang/jp.json "日语")
* [韩语(kr)](./lang/kr.json "韩语")
* [英语(en)](./lang/en.json "英语"): 由 [gouguoyin](https://github.com/gouguoyin "gouguoyin") 翻译
* [日语(jp)](./lang/jp.json "日语"): 由 [gouguoyin](https://github.com/gouguoyin "gouguoyin") 翻译
* [韩语(kr)](./lang/kr.json "韩语"): 由 [nannul](https://github.com/nannul "nannul") 翻译
* [德语(de)](./lang/de.json "德语"): 由 [benzammour](https://github.com/benzammour "benzammour") 翻译
* [简体中文(zh-CN)](./lang/zh-CN.json "简体中文"): 由 [gouguoyin](https://github.com/gouguoyin "gouguoyin") 翻译
* [繁体中文(zh-TW)](./lang/zh-TW.json "繁体中文"): 由 [gouguoyin](https://github.com/gouguoyin "gouguoyin") 翻译
@ -1344,6 +1351,9 @@ fmt.Printf("%+v", *person)
* [乌克兰语(uk)](./lang/uk.json "乌克兰语"): 由 [open-git](https://github.com/open-git "open-git") 翻译
* [罗马尼亚语(ro)](./lang/ro.json "罗马尼亚语"): 由 [DrOctavius](https://github.com/DrOctavius "DrOctavius") 翻译
* [印度尼西亚语(id)](./lang/id.json "印度尼西亚语"): 由 [justpoypoy](https://github.com/justpoypoy "justpoypoy") 翻译
* [马来西亚巴哈马语(ms-MY)](./lang/ms-MY.json "马来西亚巴哈马语"): 由 [hollowaykeanho](https://github.com/hollowaykeanho "hollowaykeanho") 翻译
* [法语(fr)](./lang/fr.json "法语"): 由 [hollowaykeanho](https://github.com/hollowaykeanho "hollowaykeanho") 翻译
* [泰语(th)](./lang/th.json "泰语"): 由 [izcream](https://github.com/izcream "izcream") 翻译
目前支持的方法有
@ -1494,8 +1504,8 @@ invalid timezone "xxx", please see the file "$GOROOT/lib/time/zoneinfo.zip" for
| t | 月份中的总天数 | 2 | 28-31 | 31 |
| z | 年份中的第几天 | - | 1-365 | 2 |
| e | 当前位置 | - | - | America/New_York |
| Q | 当前季节 | 1 | 1-4 | 1 |
| C | 当前世纪数 | - | 0-99 | 21 |
| Q | 当前季节 | 1 | 1-4 | 1 |
| C | 当前世纪数 | - | 0-99 | 21 |
#### 常见问题
@ -1506,14 +1516,18 @@ invalid timezone "xxx", please see the file "$GOROOT/lib/time/zoneinfo.zip" for
2、window 系统下部署二进制文件时区报错
> window 系统如果没有安装 golang 环境,部署时会报 `GOROOT/lib/time/zoneinfo.zip: no such file or directory` 异常,原因是由于 window 系统没有内置时区文件,只需要手动下载并指定 `zoneinfo.zip` 路径即可,如 `go/lib/time/zoneinfo.zip`
> window 系统如果没有安装 golang 环境,部署时会报 `GOROOT/lib/time/zoneinfo.zip: no such file or directory` 异常,原因是由于 window
> 系统没有内置时区文件,只需要手动下载并指定 `zoneinfo.zip` 路径即可,如 `go/lib/time/zoneinfo.zip`
```go
os.Setenv("ZONEINFO", "./go/lib/time/zoneinfo.zip")
```
3、docker 容器部署二进制文件时区报错
> docker 容器如果没有安装 golang 环境,部署时会报 `open /usr/local/go/lib/time/zoneinfo.zip: no such file or directory` 异常,只需要把 `zoneinfo.zip` 复制到容器中即可,即在 Dockerfile 中加入
> docker 容器如果没有安装 golang 环境,部署时会报 `open /usr/local/go/lib/time/zoneinfo.zip: no such file or directory`
> 异常,只需要把 `zoneinfo.zip` 复制到容器中即可,即在 Dockerfile 中加入
```go
COPY ./zoneinfo.zip /usr/local/go/lib/time/zoneinfo.zip
```

View File

@ -59,7 +59,7 @@ import (
人気のある問題
#### 使い方の例
> デフォルトのタイムゾーンはLocalです。つまりサーバのタイムゾーンです, 現在の時間は2020-08-05 13:14:15.999999999と仮定します
> デフォルトのタイムゾーンはLocalです。つまりサーバのタイムゾーンです, 現在の時間は 2020-08-05 13:14:15 +0800 CST と仮定します
##### 昨日、今日、明日
@ -169,14 +169,14 @@ carbon.CreateFromTimeMicro(13, 14, 15, 999999).ToString() // 2020-08-05 13:14:15
carbon.CreateFromTimeNano(13, 14, 15, 999999999).ToString() // 2020-08-05 13:14:15.999999999 +0800 CST
```
##### 標準形式の時間文字列を Carbon オブジェクトに解析します
##### 時間文字列を Carbon オブジェクトに解析します
```go
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("0000-00-00").ToDateTimeString() // 空の文字列
carbon.Parse("0000-00-00 00:00:00").ToDateTimeString() // 空の文字列
carbon.Parse("2020").ToString() // 2020-01-01 00:00:00 +0800 CST
carbon.Parse("2020-8").ToString() // 2020-08-01 00:00:00 +0800 CST
@ -184,6 +184,9 @@ carbon.Parse("2020-08").ToString() // 2020-08-01 00:00:00 +0800 CST
carbon.Parse("2020-8-5").ToString() // 2020-08-05 00:00:00 +0800 CST
carbon.Parse("2020-8-05").ToString() // 2020-08-05 00:00:00 +0800 CST
carbon.Parse("2020-08-05").ToString() // 2020-08-05 00:00:00 +0800 CST
carbon.Parse("2020-08-05.999").ToString() // 2020-08-05 00:00:00.999 +0800 CST
carbon.Parse("2020-08-05.999999").ToString() // 2020-08-05 00:00:00.999999 +0800 CST
carbon.Parse("2020-08-05.999999999").ToString() // 2020-08-05 00:00:00.999999999 +0800 CST
carbon.Parse("2020-8-5 13:14:15").ToString() // 2020-08-05 13:14:15 +0800 CST
carbon.Parse("2020-8-05 13:14:15").ToString() // 2020-08-05 13:14:15 +0800 CST
@ -1331,12 +1334,12 @@ fmt.Printf("%+v", *person)
現在サポートされている言語
* [英語(en)](./lang/en.json "英語")
* [日本語(jp)](./lang/jp.json "日本語")
* [韓国語(kr)](./lang/kr.json "韓国語")
* [英語(en)](./lang/en.json "英語")[gouguoyin](https://github.com/gouguoyin "gouguoyin") から翻訳されます
* [日本語(jp)](./lang/jp.json "日本語")[gouguoyin](https://github.com/gouguoyin "gouguoyin") から翻訳されます
* [韓国語(kr)](./lang/kr.json "韓国語")[benzammour](https://github.com/benzammour "benzammour") から翻訳されます
* [ドイツ語(de)](./lang/de.json "ドイツ語")[benzammour](https://github.com/benzammour "benzammour") から翻訳されます
* [简体中国語(zh-CN)](./lang/zh-CN.json "简体中国語")[gouguoyin](https://github.com/gouguoyin "gouguoyin") から翻訳されます
* [繁体中国語(zh-TW)](./lang/zh-TW.json "繁体中国語")[gouguoyin](https://github.com/gouguoyin "begouguoyinnzammour") から翻訳されます
* [繁体中国語(zh-TW)](./lang/zh-TW.json "繁体中国語")[gouguoyin](https://github.com/gouguoyin "gouguoyin") から翻訳されます
* [スペイン語(es)](./lang/es.json "スペイン語")[hgisinger](https://github.com/hgisinger "hgisinger") から翻訳されます
* [トルコ語(tr)](./lang/tr.json "トルコ語")[emresenyuva](https://github.com/emresenyuva "emresenyuva") から翻訳されます
* [ポルトガル語(pt)](./lang/pt.json "ポルトガル語")[felipear89](https://github.com/felipear89 "felipear89") から翻訳されます
@ -1344,6 +1347,9 @@ fmt.Printf("%+v", *person)
* [ウクライナ語(uk)](./lang/uk.json "ウクライナ語")[open-git](https://github.com/open-git "open-git") から翻訳されます
* [ルーマニア語(ro)](./lang/ro.json "ルーマニア語"): [DrOctavius](https://github.com/DrOctavius "DrOctavius") から翻訳されます
* [インドネシア語(id)](./lang/id.json "インドネシア語"): [justpoypoy](https://github.com/justpoypoy "justpoypoy") から翻訳されます
* [マレーシアバハマ語(ms-MY)](./lang/ms-MY.json "マレーシアバハマ語"): [hollowaykeanho](https://github.com/hollowaykeanho "hollowaykeanho") から翻訳されます
* [フランス語(fr)](./lang/fr.json "フランス語"): [hollowaykeanho](https://github.com/hollowaykeanho "hollowaykeanho") から翻訳されます
* [タイ語(th)](./lang/th.json "タイ語"): [izcream](https://github.com/izcream "izcream") から翻訳されます
現在サポートされている方法

View File

@ -61,7 +61,7 @@ import (
#### Usage and example
> The default timezone is Local, assuming the current time is 2020-08-05 13:14:15.999999999
> The default timezone is Local, assuming the current time is 2020-08-05 13:14:15 +0800 CST
##### Yesterday, today and tomorrow
@ -171,14 +171,14 @@ carbon.CreateFromTimeMicro(13, 14, 15, 999999).ToString() // 2020-08-05 13:14:15
carbon.CreateFromTimeNano(13, 14, 15, 999999999).ToString() // 2020-08-05 13:14:15.999999999 +0800 CST
```
##### Parse a standard time string as a Carbon instance
##### Parse a time string as a Carbon instance
```go
carbon.Parse("").ToDateTimeString() // empty string
carbon.Parse("0").ToDateTimeString() // empty string
carbon.Parse("0000-00-00 00:00:00").ToDateTimeString() // empty string
carbon.Parse("0000-00-00").ToDateTimeString() // empty string
carbon.Parse("00:00:00").ToDateTimeString() // empty string
carbon.Parse("0000-00-00").ToDateTimeString() // empty string
carbon.Parse("0000-00-00 00:00:00").ToDateTimeString() // empty string
carbon.Parse("2020").ToString() // 2020-01-01 00:00:00 +0800 CST
carbon.Parse("2020-8").ToString() // 2020-08-01 00:00:00 +0800 CST
@ -186,6 +186,9 @@ carbon.Parse("2020-08").ToString() // 2020-08-01 00:00:00 +0800 CST
carbon.Parse("2020-8-5").ToString() // 2020-08-05 00:00:00 +0800 CST
carbon.Parse("2020-8-05").ToString() // 2020-08-05 00:00:00 +0800 CST
carbon.Parse("2020-08-05").ToString() // 2020-08-05 00:00:00 +0800 CST
carbon.Parse("2020-08-05.999").ToString() // 2020-08-05 00:00:00.999 +0800 CST
carbon.Parse("2020-08-05.999999").ToString() // 2020-08-05 00:00:00.999999 +0800 CST
carbon.Parse("2020-08-05.999999999").ToString() // 2020-08-05 00:00:00.999999999 +0800 CST
carbon.Parse("2020-8-5 13:14:15").ToString() // 2020-08-05 13:14:15 +0800 CST
carbon.Parse("2020-8-05 13:14:15").ToString() // 2020-08-05 13:14:15 +0800 CST
@ -1329,9 +1332,11 @@ fmt.Printf("%+v", *person)
The following languages are supported
* [English(en)](./lang/en.json "English")
* [Japanese(jp)](./lang/jp.json "Japanese")
* [Korean(kr)](./lang/kr.json "Korean")
* [English(en)](./lang/en.json "English")translated
by [gouguoyin](https://github.com/gouguoyin "gouguoyin")
* [Japanese(jp)](./lang/jp.json "Japanese")translated
by [gouguoyin](https://github.com/gouguoyin "gouguoyin")
* [Korean(kr)](./lang/kr.json "Korean")translated by [nannul](https://github.com/nannul "nannul")
* [German(de)](./lang/de.json "German")translated by [benzammour](https://github.com/benzammour "benzammour")
* [Simplified Chinese(zh-CN)](./lang/zh-CN.json "Simplified Chinese")translated
by [gouguoyin](https://github.com/gouguoyin "gouguoyin")
@ -1344,6 +1349,9 @@ The following languages are supported
* [Ukrainian(uk)](./lang/uk.json "Ukrainian"): translated by [open-git](https://github.com/open-git "open-git")
* [Romanian(ro)](./lang/ro.json "Romanian"): translated by [DrOctavius](https://github.com/DrOctavius "DrOctavius")
* [Indonesian(id)](./lang/id.json "Indonesian"): translated by [justpoypoy](https://github.com/justpoypoy "justpoypoy")
* [Bahasa Malaysia(ms-MY)](./lang/ms-MY.json "Bahasa Malaysia"): translated by [hollowaykeanho](https://github.com/hollowaykeanho "hollowaykeanho")
* [French(fr)](./lang/ms-MY.json "French"): translated by [hollowaykeanho](https://github.com/hollowaykeanho "hollowaykeanho")
* [Thailand(th)](./lang/th.json "Thailand"): translated by [izcream](https://github.com/izcream "izcream")
The following methods are supported