zgo.at/tz Index | Files

package tz

import "zgo.at/tz"

Package tz contains timezone lists.

Index

Package Files

alias.go list.go tz.go

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.

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 interface{}) 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.

Version
v0.0.0-20211017223207-006eae99adf6 (latest)
Published
Oct 17, 2021
Platform
linux/amd64
Imports
7 packages (graph)
Last checked
1 month ago

Tools for package owners.