package tz

import "zgo.at/tz"

Package tz contains timezone lists.

Index ¶

• Variables
• type Zone
• func MustNew(ccode, zone string) *Zone
• func New(ccode, zone string) (*Zone, error)
• func (t *Zone) Display() string
• func (t *Zone) Loc() *time.Location
• func (t Zone) MarshalText() ([]byte, error)
• func (t *Zone) Offset() int
• func (t *Zone) OffsetDisplay() string
• func (t *Zone) OffsetRFC3339() string
• func (t *Zone) Scan(v any) error
• func (t *Zone) String() string
• func (t *Zone) UnmarshalText(v []byte) error
• func (t Zone) Value() (driver.Value, error)

Variables ¶

var UTC = &Zone{CountryCode: "", Zone: "UTC", Abbr: []string{"UTC"}, CountryName: "UTC", Comments: "", Location: time.UTC}

UTC timezone.

var Zones = []*Zone{ /* 429 elements not displayed */

}

Zones is a list of all timezones by country.

Types ¶

type Zone ¶

type Zone struct {
	*time.Location

	CountryCode string   // ID
	Zone        string   // Asia/Makassar
	Abbr        []string // WITA – the correct abbreviation may change depending on the time of year (i.e. CET and CEST, depending on DST).
	CountryName string   // Indonesia
	Comments    string   // Borneo (east, south); Sulawesi/Celebes, Bali, Nusa Tengarra; Timor (west)
	// contains filtered or unexported fields
}

Zone represents a time zone.

func MustNew ¶

func MustNew(ccode, zone string) *Zone

MustNew behaves like New(), but will panic on errors.

func New ¶

func New(ccode, zone string) (*Zone, error)

New timezone from country code and zone name. The country code is only informative, and may be blank or wrong, in which case it will load the first zone found.

func (*Zone) Display ¶

func (t *Zone) Display() string

Display a human-readable description of the timezone, for e.g. <option>.

func (*Zone) Loc ¶

func (t *Zone) Loc() *time.Location

Loc gets the time.Location, or UTC if it's not set.

func (Zone) MarshalText ¶

func (t Zone) MarshalText() ([]byte, error)

MarshalText converts the data to a human readable representation.

func (*Zone) Offset ¶

func (t *Zone) Offset() int

Offset gets the timezone offset in minutes.

func (*Zone) OffsetDisplay ¶

func (t *Zone) OffsetDisplay() string

OffsetDisplay gets the offset as a human readable string: "UTC +8:00", "UTC -7:30", "UTC".

Note that this displays the offset that is currently valid. For example Europe/Berlin may be +0100 or +0200, depending on whether DST is in effect.

func (*Zone) OffsetRFC3339 ¶

func (t *Zone) OffsetRFC3339() string

OffsetRFC3339 gets the offset as a RFC3339 string: "+08:00", "-07:30", "UTC".

Note that this displays the offset that is currently valid. For example Europe/Berlin may be +0100 or +0200, depending on whether DST is in effect.

func (*Zone) Scan ¶

func (t *Zone) Scan(v any) error

Scan converts the data returned from the DB into the struct.

func (*Zone) String ¶

func (t *Zone) String() string

String is an unique representation for this timezone.

func (*Zone) UnmarshalText ¶

func (t *Zone) UnmarshalText(v []byte) error

UnmarshalText parses text in to the Go data structure.

func (Zone) Value ¶

func (t Zone) Value() (driver.Value, error)

Value implements the SQL Value function to determine what to store in the DB.

Source Files ¶

alias.go list.go tz.go