mirror of
https://gitee.com/dromara/carbon.git
synced 2024-11-29 18:57:37 +08:00
更新文档
This commit is contained in:
parent
2a7e5e9cb1
commit
9b213dc8f8
36
README.cn.md
36
README.cn.md
@ -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
|
||||
```
|
||||
|
22
README.jp.md
22
README.jp.md
@ -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") から翻訳されます
|
||||
|
||||
現在サポートされている方法
|
||||
|
||||
|
22
README.md
22
README.md
@ -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
|
||||
|
||||
|
Loading…
Reference in New Issue
Block a user