devdocs/specs/core-locale-currency-numbers-time-and-dates.txt

@@ -1,10 +1,15 @@
 TIME (DATE AND TIME handling)
 
-RAVEN stores all times and dates in UTC in DB and internally all is UTC
+SERVER RESPONSIBILITIES FOR DATES AND TIME ZONES:
-User has a timezone offset setting which is used to format dates for display at the client
+    - User object has a timezone offset field which is user selectable
-Dates coming from the client are all assumed to be in UTC format (i.e. converted at the client from input)
+    - stores all times and dates in UTC in DB
-TimeZoneOffset is also used for relative date filters in list filter retrieval.
+    - expects dates coming from client to be in UTC
-    - i.e. "NextMonth" is assumed to be client relative, so the server will use their offset to calculate what next month meens to them in the query builder
+    - Does take into account timezone offset when FILTERING a LIST for sending to the client that has a relative date filter like [NEXTMONTH]
+        - This is the only place on the server where the user's time zone offset is used for anything
+
+CLIENT RESPONSIBILITIES FOR DATES AND TIME ZONES
+    - Send all datetime fields on records to the server in UTC
+    - Displayed dates and times are adjusted to user timezoneoffset
     
    
 CURRENCY