Changes between Initial Version and Version 3 of Ticket #90


Ignore:
Timestamp:
10/14/2008 04:42:49 PM (16 years ago)
Author:
Brian Warner
Comment:

minor summary reformatting

Legend:

Unmodified
Added
Removed
Modified
  • Ticket #90 – Description

    initial v3  
    1 Please use ISO-8601, except with "_" instead of "T" for the separating character for all timestamps.  Please include the ISO-8601 unambiguous timezone indicator (which is either "Z" or a number of hours offset from UTC -- I don't know what the standard is for non-integral offsets, but see below).
     1Please use ISO-8601, except with "_" instead of "T" for the separating
     2character for all timestamps. Please include the ISO-8601 unambiguous
     3timezone indicator (which is either "Z" or a number of hours offset from UTC
     4-- I don't know what the standard is for non-integral offsets, but see
     5below).
    26
    3 Next, please consider using UTC times for all timestamps instead of localtimes.  Foolscap is system for remote computation, and the remote end may or may not be in the same timezone as the local end, which may or may not be in the same timezone as the programmer who is looking at it.  A nice, consistent simple way to deal with such things is just not worry as much about how sunny the sky was, and who was awake, in the land where the server lives and just use UTC for everything.
     7Next, please consider using UTC times for all timestamps instead of
     8localtimes. Foolscap is system for remote computation, and the remote end may
     9or may not be in the same timezone as the local end, which may or may not be
     10in the same timezone as the programmer who is looking at it. A nice,
     11consistent simple way to deal with such things is just not worry as much
     12about how sunny the sky was, and who was awake, in the land where the server
     13lives and just use UTC for everything.
    414
    5 (More seriously, the trade-off is cognitive difficulty of correlating events on a server from human-rhythm events that take place in the same timezone, such as meals and sleeping, vs. the cognitive difficulty of correlating events on a server with events on other computers.  In my experience working in distributed systems, I'm more frequently interested in the latter correlations.)
     15(More seriously, the trade-off is cognitive difficulty of correlating events
     16on a server from human-rhythm events that take place in the same timezone,
     17such as meals and sleeping, vs. the cognitive difficulty of correlating
     18events on a server with events on other computers. In my experience working
     19in distributed systems, I'm more frequently interested in the latter
     20correlations.)
    621
    722Here is the related discussion from the Tahoe trac:
    823
    9 http://allmydata.org/trac/tahoe/ticket/326 # use consistent time stamps in logging
     24 * http://allmydata.org/trac/tahoe/ticket/326 # use consistent time stamps in logging
    1025
    1126Here are some Python implementations of ISO and/or UTC timestamps:
    1227
    13 http://allmydata.org/trac/tahoe/browser/src/allmydata/node.py?rev=2731#L30
    14 http://allmydata.org/trac/tahoe/browser/src/allmydata/util/time_format.py?rev=2424#L12
    15 http://allmydata.org/trac/pyutil/browser/pyutil/pyutil/time_format.py?rev=93
     28 * http://allmydata.org/trac/tahoe/browser/src/allmydata/node.py?rev=2731#L30
     29 * http://allmydata.org/trac/tahoe/browser/src/allmydata/util/time_format.py?rev=2424#L12
     30 * http://allmydata.org/trac/pyutil/browser/pyutil/pyutil/time_format.py?rev=93