nightly commit

documents/Principle_zh-CN.md

@@ -35,6 +35,7 @@ CREATE TABLE calendar(
 
     [ccn_eventDateTimeStart] BIGINT NOT NULL,
     [ccn_eventDateTimeEnd] BIGINT NOT NULL,
+    [ccn_timezoneOffset] INT NOT NULL,
     
     [ccn_loopRules] TEXT NOT NULL,
     [ccn_loopDateTimeStart] BIGINT NOT NULL,
@@ -49,6 +50,8 @@ CREATE TABLE calendar(
 
 `ccn_eventDateTimeStart`和`ccn_eventDateTimeEnd`，分别表示开始时间和结束时间。如果是循环事件，则表示此循环事件的第一个事件发生的时间。对于常用的点事件，或者全天事件，归于前者情况里面，通过设定开始和结束时间为一分钟和全天来解决。
 
+`ccn_timezoneOffset`是客户端指定的对`ccn_eventDateTimeStart`和`ccn_eventDateTimeEnd`时区设定，这个值是传递给客户端和服务端本身进行计算用的。在服务器，2个事件时间仍然是UNIX时间戳。
+
 `ccn_loopRules`是事件循环的规则，其格式详见后文的事件循环规则字符串章节。
 
 `ccn_loopDateTimeStart`和`ccn_loopDateTimeEnd`是事件循环的时间，同时也被用于检索符合条件的事件返回给客户端。因此，对于非循环事件，其数值与`ccn_eventDateTimeStart`和`ccn_eventDateTimeEnd`保持一致。对于循环事件，则表示循环事件的循环的开始和结束时间。通常来说，`ccn_loopDateTimeStart`和`ccn_eventDateTimeStart`是一样的，无论是循环还是非循环事件。循环结束时间有3种类型，如果是无限循环，则将结束时间设置为Int64最大值。如果是指定时间，则设置成指定时间当天的最后一秒。如果是指定次数，则由算法算出最后时间。
@@ -239,12 +242,12 @@ Calendar类下的为日历请求接口
 |eventDateTimeStart|int|事件开始时间|
 |eventDateTimeEnd|int|事件结束时间|
 |loopRules|string|事件循环规则|
-|timezoneOffset|int|提交请求的用户的本地时间与UTC时间之间的差值，使用本程序指定的粒度为分钟的时间差|
+|timezoneOffset|int|此事件的本地时间与UTC时间之间的差值，使用本程序指定的粒度为分钟的时间差|
 |lastChange|string|用于同步验证|
 
 返回参数：新的lastChange，用以更新本地缓存
 
-除去token，uuid，timezoneOffset和lastChange这4项用来鉴别的条目外，其余的条目均为可选项，提供则更新，不提供则不更新。
+除去token，uuid和lastChange这3项用来鉴别的条目外，其余的条目均为可选项，提供则更新，不提供则不更新。
 
 #### add
 
@@ -261,7 +264,7 @@ Calendar类下的为日历请求接口
 |eventDateTimeStart|int|事件开始时间|
 |eventDateTimeEnd|int|事件结束时间|
 |loopRules|string|事件循环规则|
-|timezoneOffset|int|提交请求的用户的本地时间与UTC时间之间的差值，使用本程序指定的粒度为分钟的时间差|
+|timezoneOffset|int|此事件的本地时间与UTC时间之间的差值，使用本程序指定的粒度为分钟的时间差|
 
 返回参数：新事件的uuid，用以本地更新
 
@@ -321,7 +324,7 @@ Collection类下的为日历集合请求接口
 |token|string|用于用户鉴权的字符串|
 |uuid|string|需要获取集合的uuid|
 
-返回参数：一个json，返回collection数据表中对应uuid的条目
+返回参数：一个json，返回collection数据表中对应uuid的条目。没有符合条件的则返回null。
 
 #### addOwn