pqinterval

Documentation

Index

• Variables
• type Interval
  • func New(years, days, hours, minutes, seconds, microseconds int64) Interval
  • func (ival Interval) Duration() (time.Duration, error)
  • func (ival Interval) Hours() int32
  • func (ival Interval) Microseconds() int64
  • func (ival *Interval) Scan(src interface{}) error
  • func (ival Interval) Value() (driver.Value, error)
  • func (ival Interval) Years() int32
• type NullDuration
  • func (d *NullDuration) Scan(src interface{}) error
  • func (d NullDuration) Value() (driver.Value, error)
• type ParseErr
  • func (pe ParseErr) Error() string

Variables

var ErrTooBig = errors.New("interval overflows time.Duration")

ErrTooBig - returned by Interval.Duration and Duration.Scan if the interval would overflow a time.Duration.

Types

type Interval

type Interval struct {

	/**
	Value is not null
	*/
	Valid bool
	// contains filtered or unexported fields
}

Interval can represent the full range of PostgreSQL's interval type.

func New

func New(years, days, hours, minutes, seconds, microseconds int64) Interval

New creates an Interval.

func (Interval) Duration

func (ival Interval) Duration() (time.Duration, error)

Duration - converts an Interval into a time.Duration with the same semantics as `EXTRACT(EPOCH from <interval>)` in PostgreSQL.

func (Interval) Hours

func (ival Interval) Hours() int32

Hours returns the number of hours in the interval.

func (Interval) Microseconds

func (ival Interval) Microseconds() int64

Microseconds returns the number of microseconds in the interval, up to the number of microseconds in an hour.

func (*Interval) Scan

func (ival *Interval) Scan(src interface{}) error

Scan implements sql.Scanner.

func (Interval) Value

func (ival Interval) Value() (driver.Value, error)

Value implements driver.Valuer.

func (Interval) Years

func (ival Interval) Years() int32

Years returns the number of years in the interval.

type NullDuration

type NullDuration struct {
	Duration time.Duration
	Valid    bool
}

NullDuration - Duration is a time.Duration alias that supports the driver.Valuer and sql.Scanner interfaces.

func (*NullDuration) Scan

func (d *NullDuration) Scan(src interface{}) error

Scan implements sql.Scanner.

func (NullDuration) Value

func (d NullDuration) Value() (driver.Value, error)

Value implements driver.Valuer.

type ParseErr

type ParseErr struct {
	String string
	Cause  error
}

ParseErr is returned on a failure to parse a postgres result into an Interval or Duration.

func (ParseErr) Error

func (pe ParseErr) Error() string

Error implements the error interface.