// Copyright 2017 The Gitea Authors. All rights reserved. // Use of this source code is governed by a MIT-style // license that can be found in the LICENSE file. package timeutil import ( "time" "code.gitea.io/gitea/modules/setting" ) // TimeStamp defines a timestamp type TimeStamp int64 var ( // mock is NOT concurrency-safe!! mock time.Time // Used for IsZero, to check if timestamp is the zero time instant. timeZeroUnix = time.Time{}.Unix() ) // Set sets the time to a mocked time.Time func Set(now time.Time) { mock = now } // Unset will unset the mocked time.Time func Unset() { mock = time.Time{} } // TimeStampNow returns now int64 func TimeStampNow() TimeStamp { if !mock.IsZero() { return TimeStamp(mock.Unix()) } return TimeStamp(time.Now().Unix()) } // Add adds seconds and return sum func (ts TimeStamp) Add(seconds int64) TimeStamp { return ts + TimeStamp(seconds) } // AddDuration adds time.Duration and return sum func (ts TimeStamp) AddDuration(interval time.Duration) TimeStamp { return ts + TimeStamp(interval/time.Second) } // Year returns the time's year func (ts TimeStamp) Year() int { return ts.AsTime().Year() } // AsTime convert timestamp as time.Time in Local locale func (ts TimeStamp) AsTime() (tm time.Time) { return ts.AsTimeInLocation(setting.DefaultUILocation) } // AsLocalTime convert timestamp as time.Time in local location func (ts TimeStamp) AsLocalTime() time.Time { return time.Unix(int64(ts), 0) } // AsTimeInLocation convert timestamp as time.Time in Local locale func (ts TimeStamp) AsTimeInLocation(loc *time.Location) (tm time.Time) { tm = time.Unix(int64(ts), 0).In(loc) return } // AsTimePtr convert timestamp as *time.Time in Local locale func (ts TimeStamp) AsTimePtr() *time.Time { return ts.AsTimePtrInLocation(setting.DefaultUILocation) } // AsTimePtrInLocation convert timestamp as *time.Time in customize location func (ts TimeStamp) AsTimePtrInLocation(loc *time.Location) *time.Time { tm := time.Unix(int64(ts), 0).In(loc) return &tm } // Format formats timestamp as given format func (ts TimeStamp) Format(f string) string { return ts.FormatInLocation(f, setting.DefaultUILocation) } // FormatInLocation formats timestamp as given format with spiecific location func (ts TimeStamp) FormatInLocation(f string, loc *time.Location) string { return ts.AsTimeInLocation(loc).Format(f) } // FormatLong formats as RFC1123Z func (ts TimeStamp) FormatLong() string { return ts.Format(time.RFC1123Z) } // FormatShort formats as short func (ts TimeStamp) FormatShort() string { return ts.Format("Jan 02, 2006") } // FormatDate formats a date in YYYY-MM-DD server time zone func (ts TimeStamp) FormatDate() string { return time.Unix(int64(ts), 0).String()[:10] } // IsZero is zero time func (ts TimeStamp) IsZero() bool { return int64(ts) == 0 || int64(ts) == timeZeroUnix }