Added documentation for Interval Sharding Algorithm's handling of tim…

…e zones. (apache#19170)
duandao1950 · Jul 15, 2022 · 0fe7f40 · 0fe7f40
1 parent 457ca74
commit 0fe7f40
Show file tree

Hide file tree

Showing 2 changed files with 5 additions and 1 deletion.
diff --git a/...cument/content/user-manual/shardingsphere-jdbc/builtin-algorithm/sharding.cn.md b/...cument/content/user-manual/shardingsphere-jdbc/builtin-algorithm/sharding.cn.md
@@ -86,7 +86,9 @@ Apache ShardingSphere 内置的标准分片算法实现类包括：
 
 #### 时间范围分片算法
 
-当传入的分片键为 `java.time.Instant` 时存在特例处理，其会携带上系统的时区信息后转化为 `datetime-pattern` 的字符串格式, 再进行下一步分片。
+此算法主动忽视了 `datetime-pattern` 的时区信息。
+这意味着当 `datetime-lower`, `datetime-upper` 和传入的分片键含有时区信息时，不会因为时区不一致而发生时区转换。
+当传入的分片键为 `java.time.Instant` 时存在特例处理，其会携带上系统的时区信息后转化为 `datetime-pattern` 的字符串格式，再进行下一步分片。
 
 类型：INTERVAL
 

diff --git a/...cument/content/user-manual/shardingsphere-jdbc/builtin-algorithm/sharding.en.md b/...cument/content/user-manual/shardingsphere-jdbc/builtin-algorithm/sharding.en.md
@@ -89,6 +89,8 @@ Attributes:
 
 #### Interval Sharding Algorithm
 
+This algorithm actively ignores the time zone information of `datetime-pattern`. 
+This means that when `datetime-lower`, `datetime-upper` and the incoming shard key contain time zone information, time zone conversion will not occur due to time zone inconsistencies.
 When the incoming sharding key is `java.time.Instant`, there is a special case, which will carry the time zone information of the system and convert it into the string format of `datetime-pattern`, and then proceed to the next sharding.
 
 Type: INTERVAL