From: Rob Pike <r@golang.org>
Date: Thu, 25 Sep 2014 17:52:02 +0000 (-0700)
Subject: time: make it clear that time.Time values do not compare with ==
X-Git-Tag: go1.4beta1~291
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=cfae41ff36d833719b073d1eec5f0fd535ca9e61;p=gostls13.git

time: make it clear that time.Time values do not compare with ==

LGTM=bradfitz, josharian, adg, rsc
R=golang-codereviews, bradfitz, josharian, rsc, adg
CC=golang-codereviews
https://golang.org/cl/141340043
---

diff --git a/src/time/time.go b/src/time/time.go
index 4f76d79ee5..0300e846a4 100644
--- a/src/time/time.go
+++ b/src/time/time.go
@@ -31,6 +31,11 @@ import "errors"
 // change the instant in time being denoted and therefore does not affect the
 // computations described in earlier paragraphs.
 //
+// Note that the Go == operator compares not just the time instant but also the
+// Location. Therefore, Time values should not be used as map or database keys
+// without first guaranteeing that the identical Location has been set for all
+// values, which can be achieved through use of the UTC or Local method.
+//
 type Time struct {
 	// sec gives the number of seconds elapsed since
 	// January 1, year 1 00:00:00 UTC.