#DOCUMENTATION by cg
authorClaus Gittinger <cg@exept.de>
Fri, 11 May 2018 00:03:47 +0200
changeset 22890 0401fecb9c89
parent 22889 faa5502c4f9f
child 22891 ac18d6513ef8
#DOCUMENTATION by cg class: Timestamp comment/format in: #utcOffset #utcOffset:
Timestamp.st
--- a/Timestamp.st	Fri May 11 00:03:34 2018 +0200
+++ b/Timestamp.st	Fri May 11 00:03:47 2018 +0200
@@ -2445,14 +2445,14 @@
      Add utcOffset to convert from local time to UTC time.
      Subtract utcOffset to convert from UTC time to local time.
 
-     If utcOffset is negative, the local timezone is east of Greenwich.
-     If utcOffset is positive, the local timezone is west of Greenwich."
+     If utcOffset is negative, the local timezone is east of Greenwich (Russia, Asia).
+     If utcOffset is positive, the local timezone is west of Greenwich (USA)."
 
     (osTime between:MinOSTime and:MaxOSTime) ifFalse:[
-	"/ fake an info which the OS cannot give me
-	"/ we do not know about DST in the far future and in the long gone past.
-	"/ Take the utcOffset without DST
-	^ self utcOffsetWithoutDst.
+        "/ fake an info which the OS cannot give me
+        "/ we do not know about DST in the far future and in the long gone past.
+        "/ Take the utcOffset without DST
+        ^ self utcOffsetWithoutDst.
     ].
 
     ^ (OperatingSystem computeTimeAndDateFrom:osTime) utcOffset
@@ -2842,7 +2842,9 @@
 !
 
 utcOffset:anOffset
-   "answer a DateTime equivalent to the receiver but offset from UTC by offset"
+   "answer a DateTime equivalent to the receiver but offset from UTC by offset.
+     If utcOffset is negative, the local timezone is east of Greenwich (Russia, Asia).
+     If utcOffset is positive, the local timezone is west of Greenwich (USA)."
 
     ^ TZTimestamp new 
         osTime:osTime;