time: document that a marshaled time does not include location name

Fixes #28421

Change-Id: I00878ec246d5249d910f2b57749f74cfc38dbec6
Reviewed-on: https://go-review.googlesource.com/c/148117
Reviewed-by: Rob Pike <r@golang.org>
This commit is contained in:
Agniva De Sarker 2018-11-07 19:56:30 +05:30 committed by Brad Fitzpatrick
parent c9762b8a7e
commit d258bac41c
1 changed files with 4 additions and 0 deletions

View File

@ -105,6 +105,10 @@ import (
// change the instant in time being denoted and therefore does not affect the
// computations described in earlier paragraphs.
//
// Representations of a Time value saved by the GobEncode, MarshalBinary
// MarshalJSON, and MarshalText methods store the Time.Location's offset, but not
// the location name. They therefore lose information about Daylight Saving Time.
//
// In addition to the required “wall clock” reading, a Time may contain an optional
// reading of the current process's monotonic clock, to provide additional precision
// for comparison or subtraction.