sqltime

Documentation

Overview

Package sqltime provides support for Postgres time data type.

Index

• Variables
• type AtoiError
  • func (e *AtoiError) Error() string
  • func (e *AtoiError) Unwrap() error
• type Part
  • func (p Part) String() string
• type RangeError
  • func (e *RangeError) Error() string
• type Time
  • func Parse(s string) (Time, error)
  • func (t Time) Add(d Time) Time
  • func (t Time) Hour() int
  • func (s Time) MarshalJSON() ([]byte, error)
  • func (t Time) Minute() int
  • func (t *Time) Parse(s string) error
  • func (s *Time) Scan(src any) error
  • func (t Time) Second() int
  • func (t Time) String() string
  • func (t Time) Sub(d Time) Time
  • func (s *Time) UnmarshalJSON(data []byte) error
  • func (s Time) Value() (driver.Value, error)

Variables

var ErrTooManyParts = errors.New("too many parts")

Types

type AtoiError

type AtoiError struct {
	Part Part
	Err  error
}

func (*AtoiError) Error

func (e *AtoiError) Error() string

func (*AtoiError) Unwrap

func (e *AtoiError) Unwrap() error

type Part

type Part int

Part indicates a part of time (e.g. hour).

const (
	PartHour Part = iota + 1
	PartMinute
	PartSecond
)

func (Part) String

func (p Part) String() string

type RangeError

type RangeError struct {
	Part Part
	Min  int
	Max  int
}

func (*RangeError) Error

func (e *RangeError) Error() string

type Time

type Time struct {
	// contains filtered or unexported fields
}

Time is a one-to-one representation of SQL time data type.

func Parse

func Parse(s string) (Time, error)

Parse parses a formatted string, in time.TimeOnly (15:04:05) format, and returns the time value it represents.

func (Time) Add

func (t Time) Add(d Time) Time

Add returns the time t+d.

func (Time) Hour

func (t Time) Hour() int

Hour returns the hour specified by t, in the range [0, 23].

func (Time) MarshalJSON

func (s Time) MarshalJSON() ([]byte, error)

func (Time) Minute

func (t Time) Minute() int

Minute returns the minute specified by t, in the range [0, 59].

func (*Time) Parse

func (t *Time) Parse(s string) error

Parse parses a formatted string, in time.TimeOnly (15:04:05) format.

func (*Time) Scan

func (s *Time) Scan(src any) error

func (Time) Second

func (t Time) Second() int

Second returns the second specified by t, in the range [0, 59].

func (Time) String

func (t Time) String() string

func (Time) Sub

func (t Time) Sub(d Time) Time

Sub returns the time t-d.

func (*Time) UnmarshalJSON

func (s *Time) UnmarshalJSON(data []byte) error

func (Time) Value

func (s Time) Value() (driver.Value, error)