From e5df06bc55f18ff92fb1c2fce2af69e80d9b3194 Mon Sep 17 00:00:00 2001 From: Sean Liao Date: Sat, 7 Feb 2026 14:38:05 +0000 Subject: [PATCH] time: document that LoadLocation creates new Location instances Fixes #77385 Change-Id: I7e7ddb1c71f0aebd893f640d476b273e229b059a Reviewed-on: https://go-review.googlesource.com/c/go/+/743040 Reviewed-by: Ian Lance Taylor LUCI-TryBot-Result: Go LUCI Reviewed-by: Michael Pratt Reviewed-by: Junyang Shao --- src/time/zoneinfo.go | 9 +++++---- src/time/zoneinfo_read.go | 2 +- 2 files changed, 6 insertions(+), 5 deletions(-) diff --git a/src/time/zoneinfo.go b/src/time/zoneinfo.go index f0444a5d9d..faa5691259 100644 --- a/src/time/zoneinfo.go +++ b/src/time/zoneinfo.go @@ -645,12 +645,13 @@ var errLocation = errors.New("time: invalid location name") var zoneinfo *string var zoneinfoOnce sync.Once -// LoadLocation returns the Location with the given name. +// LoadLocation returns a [Location] with the given name. // -// If the name is "" or "UTC", LoadLocation returns UTC. -// If the name is "Local", LoadLocation returns Local. +// If the name is "" or "UTC", LoadLocation returns [UTC]. +// If the name is "Local", LoadLocation returns [Local]. // -// Otherwise, the name is taken to be a location name corresponding to a file +// Otherwise, a new [Location] is created where the name is taken +// to be a location name corresponding to a file // in the IANA Time Zone database, such as "America/New_York". // // LoadLocation looks for the IANA Time Zone database in the following diff --git a/src/time/zoneinfo_read.go b/src/time/zoneinfo_read.go index 047e360d11..1f134556ec 100644 --- a/src/time/zoneinfo_read.go +++ b/src/time/zoneinfo_read.go @@ -111,7 +111,7 @@ func byteString(p []byte) string { var errBadData = errors.New("malformed time zone information") -// LoadLocationFromTZData returns a Location with the given name +// LoadLocationFromTZData returns a new [Location] with the given name // initialized from the IANA Time Zone database-formatted data. // The data should be in the format of a standard IANA time zone file // (for example, the content of /etc/localtime on Unix systems). -- 2.52.0