Package tz

import "4d63.com/tz"

Overview
Index
Examples

Overview

Package tz contains time zone info so that you can predictably load Locations regardless of the locations available on the locally running operating system.

The stdlib time.LoadLocation function loads timezone data from the operating system or from zoneinfo.zip in a local Go installation. Both of these are often missing from some operating systems, especially Windows.

This package has the zoneinfo.zip from Go embedded into the package so that queries to load a location always return the same data regardless of operating system.

This package exists because of https://github.com/golang/go/issues/21881.

Index

func LoadLocation(name string) (*time.Location, error)

Examples

(Expand All)

LoadLocation

Package files

tz.go zoneinfo.go

func LoadLocation

func LoadLocation(name string) (*time.Location, error)

LoadLocation loads timezone data from embedded tzinfo and does not rely on the operating system providing tzdata.

Same as time.LoadLocation if name is "" or "UTC", time.UTC is returned, and if name is "Local", time.Local is returned.

Returns an error if the name is unknown.

Example

Code:

t := time.Date(2009, time.November, 10, 23, 0, 0, 0, time.UTC)
fmt.Println(t)

syd, _ := tz.LoadLocation("Australia/Sydney")
fmt.Println(t.In(syd))

Output:

2009-11-10 23:00:00 +0000 UTC
2009-11-11 10:00:00 +1100 AEDT

4d63.com/tz

tz