#DOCUMENTATION by cg
class: Timestamp
comment/format in:
#utcOffset
#utcOffset:
--- 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;