docs: Update time formatting example

kuafuRace · kuafuRace · commit cd94c98af27f · 2025-03-27T08:31:05.000+08:00
diff --git a/README.cn.md b/README.cn.md
@@ -11,7 +11,9 @@
 
 #### 项目简介
 
-一个轻量级、语义化、对开发者友好的 `golang` 时间处理库，已被 [awesome-go](https://github.com/yinggaozhen/awesome-go-cn#日期和时间 "awesome-go-cn") 收录，并获得 `gitee` 2024 年最有价值项目（`GVP`）和 `gitcode` 2024 年度开源摘星计划 (`G-Star`) 项目 
+一个轻量级、语义化、对开发者友好的 `golang`
+时间处理库，已被 [awesome-go](https://github.com/yinggaozhen/awesome-go-cn#日期和时间 "awesome-go-cn") 收录，并获得
+`gitee` 2024 年最有价值项目（`GVP`）和 `gitcode` 2024 年度开源摘星计划 (`G-Star`) 项目
 
 #### 仓库地址
 
@@ -868,17 +870,17 @@ carbon.Parse("2020-08-05 13:14:15").BetweenIncludedBoth(carbon.Parse("2020-08-04
 
 ```go
 // 设置时区
-carbon.Parse("2020-08-05 13:14:15").SetTimezone(carbon.UTC).ToDateTimeString() // 2020-08-05 13:14:15
-carbon.Parse("2020-08-05 13:14:15").SetTimezone(carbon.PRC).ToDateTimeString() // 2020-08-05 21:14:15
-carbon.Parse("2020-08-05 13:14:15").SetTimezone(carbon.Tokyo).ToDateTimeString() // 2020-08-05 22:14:15
+carbon.Parse("2020-08-05 13:14:15").SetTimezone(carbon.UTC).ToString() // 2020-08-05 13:14:15 +0000 UTC
+carbon.Parse("2020-08-05 13:14:15").SetTimezone(carbon.PRC).ToString() // 2020-08-05 21:14:15 +0800 CST
+carbon.Parse("2020-08-05 13:14:15").SetTimezone(carbon.Tokyo).ToString() // 2020-08-05 22:14:15 +0900 JST
 
 // 设置位置
 utc, _ := time.LoadLocation(carbon.UTC)
-carbon.Parse("2020-08-05 13:14:15").SetLocation(utc).ToDateTimeString() // 2020-08-05 13:14:15
+carbon.Parse("2020-08-05 13:14:15").SetLocation(utc).ToString() // 2020-08-05 13:14:15 +0000 UTC
 prc, _ := time.LoadLocation(carbon.PRC)
-carbon.Parse("2020-08-05 13:14:15").SetLocation(prc).ToDateTimeString() // 2020-08-05 21:14:15
+carbon.Parse("2020-08-05 13:14:15").SetLocation(prc).ToString() // 2020-08-05 21:14:15 +0800 CST
 tokyo, _ := time.LoadLocation(carbon.Tokyo)
-carbon.Parse("2020-08-05 13:14:15").SetLocation(tokyo).ToDateTimeString() // 2020-08-05 22:14:15
+carbon.Parse("2020-08-05 13:14:15").SetLocation(tokyo).ToString() // 2020-08-05 22:14:15 +0900 JST
 
 // 设置区域
 carbon.Parse("2020-07-05 13:14:15").SetLocale("en").DiffForHumans() // 1 month ago
diff --git a/README.jp.md b/README.jp.md
@@ -865,17 +865,17 @@ carbon.Parse("2020-08-05 13:14:15").BetweenIncludedBoth(carbon.Parse("2020-08-04
 
 ```go
 // タイムゾーンを設定
-carbon.Parse("2020-08-05 13:14:15").SetTimezone(carbon.UTC).ToDateTimeString() // 2020-08-05 13:14:15
-carbon.Parse("2020-08-05 13:14:15").SetTimezone(carbon.PRC).ToDateTimeString() // 2020-08-05 21:14:15
-carbon.Parse("2020-08-05 13:14:15").SetTimezone(carbon.Tokyo).ToDateTimeString() // 2020-08-05 22:14:15
+carbon.Parse("2020-08-05 13:14:15").SetTimezone(carbon.UTC).ToString() // 2020-08-05 13:14:15 +0000 UTC
+carbon.Parse("2020-08-05 13:14:15").SetTimezone(carbon.PRC).ToString() // 2020-08-05 21:14:15 +0800 CST
+carbon.Parse("2020-08-05 13:14:15").SetTimezone(carbon.Tokyo).ToString() // 2020-08-05 22:14:15 +0900 JST
 
 // リージョンを設定
 utc, _ := time.LoadLocation(carbon.UTC)
-carbon.Parse("2020-08-05 13:14:15").SetLocation(utc).ToDateTimeString() // 2020-08-05 13:14:15
+carbon.Parse("2020-08-05 13:14:15").SetLocation(utc).ToString() // 2020-08-05 13:14:15 +0000 UTC
 prc, _ := time.LoadLocation(carbon.PRC)
-carbon.Parse("2020-08-05 13:14:15").SetLocation(prc).ToDateTimeString() // 2020-08-05 21:14:15
+carbon.Parse("2020-08-05 13:14:15").SetLocation(prc).ToString() // 2020-08-05 21:14:15 +0800 CST
 tokyo, _ := time.LoadLocation(carbon.Tokyo)
-carbon.Parse("2020-08-05 13:14:15").SetLocation(tokyo).ToDateTimeString() // 2020-08-05 22:14:15
+carbon.Parse("2020-08-05 13:14:15").SetLocation(tokyo).ToString() // 2020-08-05 22:14:15 +0900 JST
 
 // ロケールを設定
 carbon.Parse("2020-07-05 13:14:15").SetLocale("en").DiffForHumans()) // 1 month ago
@@ -1292,6 +1292,7 @@ carbon.Parse("2020-08-05 13:14:15").IsWinter() // false
 ```
 
 ##### JSON
+
 ###### 組み込みフィールドタイプ
 
 ```go
@@ -1533,45 +1534,45 @@ invalid timezone "xxx", please see the file "$GOROOT/lib/time/zoneinfo.zip" for
 
 ##### <a id="format-sign-table">書式設定記号表</a>
 
-| 記号 | 説明            | 長さ | 範囲            |  例            |
-|:--:| :------------: |:------:|:----------------:| :------------: |
-| d  | 月の日(2桁でパディング) | 2 | 01-31 | 02 |
-| D  | 略語の曜日 | 3 | Mon-Sun | Mon |
-| j  | 月の日(パディングしない) | - | 1-31 | 2 |
-| S  | 何日目の英語の略語の接尾語，普通はjと協力して使います | 2 | st/nd/rd/th | th |
-| l  | 曜日 | - | Monday-Sunday | Monday |
-| F  | 月 | - | January-December | January |
-| m  | 月(2桁でパディング) | 2 | 01-12 | 01 |
-| M  | 略語の月 | 3 | Jan-Dec | Jan |
-| n  | 月(パディングしない) | - | 1-12 | 1 |
-| Y  | 年 | 4 | 0000-9999 | 2006 |
-| y  | 年(下2桁) | 2 | 00-99 | 06 |
-| a  | 小文字の午前と午後 | 2 | am/pm | pm |
-| A  | 大文字の午前と午後 | 2 | AM/PM | PM |
-| g  | 時間, 12時間のフォーマット | - | 1-12 | 3 |
-| G  | 時間, 24時間のフォーマット | - | 0-23 | 15 |
-| h  | 時間, 12時間のフォーマット | 2 | 00-11 | 03 |
-| H  | 時間, 24時間のフォーマット | 2 | 00-23 | 15 |
-| i  | 分 | 2 | 01-59 | 04 |
-| s  | 秒 | 2 | 01-59 | 05 |
-| O  | グリニッジとの時間差の時間数 | - | - | -0700 |
-| P  | グリニッジと時間の差の時間数, 時間と分の間にコロンあり | - | - | -07:00 |
-| T  | タイムゾーンの略語 | - | - | MST |
-| W  | ISO8601 フォーマットの数字は年の中の第何週(2桁でパディング) | 2 | 1-52 | 01 |
-| N  | ISO8601 フォーマットの数字は曜日(2桁でパディング) | 2 | 01-07 | 02 |
-| L  | うるう年かどうか, うるう年が1であれば, 0 | 1 | 0-1 | 0 |
-| U  | 秒タイムスタンプ | - | - | 1596604455 |
-| V  | ミリ秒のタイムスタンプ | - | - | 1596604455666 |
-| X  | マイクロ秒タイムスタンプ | - | - | 1596604455666666 |
-| Z  | ナノ秒タイムスタンプ | - | - | 1596604455666666666 |
-| v  | ミリ秒 | - | 1-999 | 999 |
-| x  | マイクロ秒| - | 1-999999 | 999999 |
-| z  | ナノ秒 | - | 1-999999999 | 999999999 |
-| w  | 数字表示の曜日 | 1 | 0-6 | 1 |
-| t  | 月の総日数 | 2 | 28-31 | 31 |
-| e  | タイムゾーン | - | - | America/New_York |
-| q  | 四半期 | 1 | 1-4 | 1 |
-| c  | 世紀 | - | 0-99 | 21 |
+| 記号 |                 説明                  | 長さ |        範囲        |          例          |
+|:--:|:-----------------------------------:|:--:|:----------------:|:-------------------:|
+| d  |            月の日(2桁でパディング)            | 2  |      01-31       |         02          |
+| D  |                略語の曜日                | 3  |     Mon-Sun      |         Mon         |
+| j  |            月の日(パディングしない)            | -  |       1-31       |          2          |
+| S  |     何日目の英語の略語の接尾語，普通はjと協力して使います     | 2  |   st/nd/rd/th    |         th          |
+| l  |                 曜日                  | -  |  Monday-Sunday   |       Monday        |
+| F  |                  月                  | -  | January-December |       January       |
+| m  |             月(2桁でパディング)             | 2  |      01-12       |         01          |
+| M  |                略語の月                 | 3  |     Jan-Dec      |         Jan         |
+| n  |             月(パディングしない)             | -  |       1-12       |          1          |
+| Y  |                  年                  | 4  |    0000-9999     |        2006         |
+| y  |               年(下2桁)                | 2  |      00-99       |         06          |
+| a  |              小文字の午前と午後              | 2  |      am/pm       |         pm          |
+| A  |              大文字の午前と午後              | 2  |      AM/PM       |         PM          |
+| g  |           時間, 12時間のフォーマット           | -  |       1-12       |          3          |
+| G  |           時間, 24時間のフォーマット           | -  |       0-23       |         15          |
+| h  |           時間, 12時間のフォーマット           | 2  |      00-11       |         03          |
+| H  |           時間, 24時間のフォーマット           | 2  |      00-23       |         15          |
+| i  |                  分                  | 2  |      01-59       |         04          |
+| s  |                  秒                  | 2  |      01-59       |         05          |
+| O  |           グリニッジとの時間差の時間数            | -  |        -         |        -0700        |
+| P  |    グリニッジと時間の差の時間数, 時間と分の間にコロンあり     | -  |        -         |       -07:00        |
+| T  |              タイムゾーンの略語              | -  |        -         |         MST         |
+| W  | ISO8601 フォーマットの数字は年の中の第何週(2桁でパディング) | 2  |       1-52       |         01          |
+| N  |   ISO8601 フォーマットの数字は曜日(2桁でパディング)    | 2  |      01-07       |         02          |
+| L  |       うるう年かどうか, うるう年が1であれば, 0       | 1  |       0-1        |          0          |
+| U  |              秒タイムスタンプ               | -  |        -         |     1596604455      |
+| V  |             ミリ秒のタイムスタンプ             | -  |        -         |    1596604455666    |
+| X  |            マイクロ秒タイムスタンプ             | -  |        -         |  1596604455666666   |
+| Z  |             ナノ秒タイムスタンプ              | -  |        -         | 1596604455666666666 |
+| v  |                 ミリ秒                 | -  |      1-999       |         999         |
+| x  |                マイクロ秒                | -  |     1-999999     |       999999        |
+| z  |                 ナノ秒                 | -  |   1-999999999    |      999999999      |
+| w  |               数字表示の曜日               | 1  |       0-6        |          1          |
+| t  |                月の総日数                | 2  |      28-31       |         31          |
+| e  |               タイムゾーン                | -  |        -         |  America/New_York   |
+| q  |                 四半期                 | 1  |       1-4        |          1          |
+| c  |                 世紀                  | -  |       0-99       |         21          |
 
 #### FAQ
 
diff --git a/README.md b/README.md
@@ -860,17 +860,17 @@ carbon.Parse("2020-08-05 13:14:15").BetweenIncludedBoth(carbon.Parse("2020-08-04
 
 ```go
 // Set timezone
-carbon.Parse("2020-08-05 13:14:15").SetTimezone(carbon.UTC).ToDateTimeString() // 2020-08-05 13:14:15
-carbon.Parse("2020-08-05 13:14:15").SetTimezone(carbon.PRC).ToDateTimeString() // 2020-08-05 21:14:15
-carbon.Parse("2020-08-05 13:14:15").SetTimezone(carbon.Tokyo).ToDateTimeString() // 2020-08-05 22:14:15
+carbon.Parse("2020-08-05 13:14:15").SetTimezone(carbon.UTC).ToString() // 2020-08-05 13:14:15 +0000 UTC
+carbon.Parse("2020-08-05 13:14:15").SetTimezone(carbon.PRC).ToString() // 2020-08-05 21:14:15 +0800 CST
+carbon.Parse("2020-08-05 13:14:15").SetTimezone(carbon.Tokyo).ToString() // 2020-08-05 22:14:15 +0900 JST
 
 // Set location
 utc, _ := time.LoadLocation(carbon.UTC)
-carbon.Parse("2020-08-05 13:14:15").SetLocation(utc).ToDateTimeString() // 2020-08-05 13:14:15
+carbon.Parse("2020-08-05 13:14:15").SetLocation(utc).ToString() // 2020-08-05 13:14:15 +0000 UTC
 prc, _ := time.LoadLocation(carbon.PRC)
-carbon.Parse("2020-08-05 13:14:15").SetLocation(prc).ToDateTimeString() // 2020-08-05 21:14:15
+carbon.Parse("2020-08-05 13:14:15").SetLocation(prc).ToString() // 2020-08-05 21:14:15 +0800 CST
 tokyo, _ := time.LoadLocation(carbon.Tokyo)
-carbon.Parse("2020-08-05 13:14:15").SetLocation(tokyo).ToDateTimeString() // 2020-08-05 22:14:15
+carbon.Parse("2020-08-05 13:14:15").SetLocation(tokyo).ToString() // 2020-08-05 22:14:15 +0900 JST
 
 // Set locale
 carbon.Parse("2020-07-05 13:14:15").SetLocale("en").DiffForHumans() // 1 month before
@@ -1286,6 +1286,7 @@ carbon.Parse("2020-08-05 13:14:15").IsWinter() // false
 ```
 
 ##### JSON
+
 ###### Built-in type
 
 ```go
