README
¶
ntime
Go 语言的时间工具库。
帮助
在集成的过程中有遇到问题，欢迎加 QQ 群 564704807 讨论。
安装
$ go get github.com/smartwalle/ntime
开始
package main
import (
"fmt"
"github.com/smartwalle/ntime"
"time"
)
func main() {
var now = ntime.Now()
fmt.Println(now)
var d = ntime.Date(2018, time.May, 20, 13, 14, 0, 0, time.Local)
fmt.Println(d)
}
获取当前日期所在周的第一天和最后一天
var now = ntime.Now()
now.BeginningDateOfWeek()
now.EndDateOfWeek()
获取当前日期所在月的第一天和最后一天
var now = ntime.Now()
now.BeginningDateOfMonth()
now.EndDateOfMonth()
JSON
- 设置序列化成 JSON 字符串时的格式
ntime.JSONFormatter = ntime.DefaultFormatter{Layout: "2006-01-02 15:04:05"}
例子:
package main
import (
"encoding/json"
"fmt"
"github.com/smartwalle/ntime"
)
func main() {
ntime.JSONFormatter = ntime.DefaultFormatter{Layout: "2006-01-02 15:04:05"}
var s = &Schedule{}
s.Begin = ntime.Now()
s.End = s.Begin.AddDate(0, 1, 0)
sBytes, _ := json.Marshal(s)
fmt.Println(string(sBytes))
var ts = `{"begin":"2019-11-10 09:59:21","end":"2019-12-10 09:59:21"}`
var s2 *Schedule
json.Unmarshal([]byte(ts), &s2)
fmt.Println(s2.Begin, s2.End)
}
type Schedule struct {
Begin *ntime.Time `json:"begin"`
End *ntime.Time `json:"end"`
}
- 自定义 Formatter
当然你也可以自定义 Formatter，只需要实现以下接口即可：
type TimeFormatter interface {
Format(t time.Time) ([]byte, error)
Parse(data []byte) (time.Time, error)
}
比如：
type MyFormatter struct {
}
func (this MyFormatter) Format(t time.Time) ([]byte, error) {
...
}
func (this MyFormatter) Parse(data []byte) (time.Time, error) {
...
}
ntime.JSONFormatter = MyFormatter{}
支持 SQL 类数据库
db, err := sql.Open("mysql", "xxx")
if err != nil {
fmt.Println("连接数据库出错：", err)
return
}
defer db.Close()
db.Exec("INSERT INTO `user` (`name`, `age`, `created_on`) VALUES (?, ?, ?)", "test", 18, ntime.Now())
写入 SQL 类数据的时候，会将时间转换为 UTC 时区的时间，从 SQL 类数据库读取的时候，会将时间转换为 UTC 时区的时间。从而避免了在使用 github.com/lib/pq 库的时候，当数据库服务器和业务服务器时区不同引发的操作 timestamp 类型字段数据会不一致的问题。
License
This project is licensed under the MIT License.
Documentation
¶
Index ¶
- Variables
- func LoadLocation(name string) (*time.Location, error)
- func MustLocation(name string) *time.Location
- func NumberOfDaysInMonth(year int, month time.Month) (number int)
- func TimeZones() []string
- type DefaultFormatter
- type Time
- func BeginningDateOfMonth(year int, month time.Month) *Time
- func BeginningDateOfWeek(year int, month time.Month, day int) *Time
- func BeginningDateOfYear(year int) *Time
- func BeginningTime(t *Time) *Time
- func BeginningTimeOfDay(year int, month time.Month, day int) *Time
- func Date(year int, month time.Month, day, hour, min, sec, nsec int, loc *time.Location) *Time
- func EndDateOfMonth(year int, month time.Month) *Time
- func EndDateOfWeek(year int, month time.Month, day int) *Time
- func EndDateOfYear(year int) *Time
- func EndTime(t *Time) *Time
- func EndTimeOfDay(year int, month time.Month, day int) *Time
- func FromMicrosecond(ms int64) *Time
- func FromMillisecond(ms int64) *Time
- func FromNanosecond(ns int64) *Time
- func FromSecond(s int64) *Time
- func FromTime(t time.Time) *Time
- func MustParse(layout, value string) *Time
- func MustParseInLocation(layout, value string, loc *time.Location) *Time
- func Now() *Time
- func Parse(layout, value string) (*Time, error)
- func ParseInLocation(layout, value string, loc *time.Location) (*Time, error)
- func Unix(sec int64, nsec int64) *Time
- func UnixIn(sec int64, nsec int64, loc *time.Location) *Time
- func (this *Time) Add(d time.Duration) *Time
- func (this *Time) AddDate(years int, months int, days int) *Time
- func (this *Time) After(t *Time) bool
- func (this *Time) Before(t *Time) bool
- func (this *Time) BeginningDateOfMonth() *Time
- func (this *Time) BeginningDateOfWeek() *Time
- func (this *Time) BeginningTime() *Time
- func (this *Time) EndDateOfMonth() *Time
- func (this *Time) EndDateOfWeek() *Time
- func (this *Time) EndTime() *Time
- func (this Time) Format(layout string) string
- func (this *Time) GobDecode(data []byte) error
- func (this Time) GobEncode() ([]byte, error)
- func (this *Time) GreaterThan(t *Time) bool
- func (this *Time) In(loc *time.Location) *Time
- func (this *Time) LessThan(t *Time) bool
- func (this *Time) Local() *Time
- func (this Time) MarshalBinary() ([]byte, error)
- func (this Time) MarshalJSON() ([]byte, error)
- func (this Time) MarshalText() ([]byte, error)
- func (this *Time) Next() *Time
- func (this *Time) Previous() *Time
- func (this *Time) Scan(value interface{}) (err error)
- func (this *Time) Sub(t *Time) time.Duration
- func (this *Time) TrimHour() *Time
- func (this *Time) TrimMinute() *Time
- func (this *Time) TrimSecond() *Time
- func (this *Time) UTC() *Time
- func (this *Time) UnixMicrosecond() int64
- func (this *Time) UnixMillisecond() int64
- func (this *Time) UnixNanosecond() int64
- func (this *Time) UnixSecond() int64
- func (this *Time) UnmarshalBinary(data []byte) error
- func (this *Time) UnmarshalJSON(data []byte) error
- func (this *Time) UnmarshalText(data []byte) error
- func (this *Time) Value() (driver.Value, error)
- type TimeFormatter
Constants ¶
This section is empty.
Variables ¶
View Source
var Local = time.Local
View Source
var UTC = time.UTC
Functions ¶
func MustLocation ¶
func NumberOfDaysInMonth ¶
NumberOfDaysInMonth 获取指定月份有多少天
Types ¶
type DefaultFormatter ¶
type DefaultFormatter struct {
Layout string
}
type Time ¶
func BeginningDateOfMonth ¶
BeginningDateOfMonth 获取指定月份的第一天
func BeginningDateOfWeek ¶
BeginningDateOfWeek 获取指定日期所在周的第一天
func BeginningTimeOfDay ¶
BeginningTimeOfDay 获取指定日期的开始时间
func EndDateOfMonth ¶
EndDateOfMonth 获取指定月份的最后一天
func EndDateOfWeek ¶
EndDateOfWeek 获取指定日期所有周的最后一天
func EndTimeOfDay ¶
EndTimeOfDay 获取指定日期的结束时间
func FromMicrosecond ¶
func FromMillisecond ¶
func FromNanosecond ¶
func FromSecond ¶
func ParseInLocation ¶
func (*Time) BeginningDateOfMonth ¶
BeginningDateOfMonth 获取当前日期所在月的第一天
func (*Time) BeginningDateOfWeek ¶
BeginningDateOfWeek 获取当前日期所在周的第一天
func (*Time) BeginningTime ¶
func (*Time) EndDateOfMonth ¶
EndDateOfMonth 获取当前日期所在月的最后一天
func (*Time) GreaterThan ¶
func (Time) MarshalBinary ¶
func (Time) MarshalJSON ¶
func (Time) MarshalText ¶
func (*Time) TrimMinute ¶ added in v1.0.4
TrimMinute 将 Minute 及以下的单位清除，只保留 Hour 及以上的信息
func (*Time) TrimSecond ¶ added in v1.0.4
TrimSecond 将 Second 及以下的单位清除，只保留 Minute 及以上的信息
func (*Time) UnmarshalBinary ¶
func (*Time) UnmarshalJSON ¶
func (*Time) UnmarshalText ¶
type TimeFormatter ¶
type TimeFormatter interface {
Format(t time.Time) ([]byte, error)
Parse(data []byte) (time.Time, error)
}
var (
JSONFormatter TimeFormatter = DefaultFormatter{time.RFC3339}
)
Source Files
Directories
Click to show internal directories.
Click to hide internal directories.