Package: github.com/jinzhu/now

package now Import Path github.com/jinzhu/now (on go.dev) Dependency Relation imports 3 packages, and imported by 2 packages Involved Source Files d main.go Package now is a time toolkit for golang. More details README here: https://github.com/jinzhu/now import "github.com/jinzhu/now" now.BeginningOfMinute() // 2013-11-18 17:51:00 Mon now.BeginningOfDay() // 2013-11-18 00:00:00 Mon now.EndOfDay() // 2013-11-18 23:59:59.999999999 Mon now.go time.go Package-Level Type Names (total 2) /* sort by: alphabet | popularity */ type Config (struct) Config configuration for now package Fields (total 3) TimeFormats []string TimeLocation *time.Location WeekStartDay time.Weekday Methods (total 3) (*Config) MustParse(strs ...string) time.Time MustParse must parse string to time or will panic (*Config) Parse(strs ...string) (time.Time, error) Parse parse string to time based on configuration (*Config) With(t time.Time) *Now New initialize Now based on configuration As Types Of (only one) var DefaultConfig *Config type Now (struct) Now now struct Fields (total 5) Config *Config Config.TimeFormats []string Config.TimeLocation *time.Location Config.WeekStartDay time.Weekday Time time.Time Methods (total 69) ( Now) Add(d time.Duration) time.Time Add returns the time t+d. ( Now) AddDate(years int, months int, days int) time.Time AddDate returns the time corresponding to adding the given number of years, months, and days to t. For example, AddDate(-1, 2, 3) applied to January 1, 2011 returns March 4, 2010. AddDate normalizes its result in the same way that Date does, so, for example, adding one month to October 31 yields December 1, the normalized form for November 31. ( Now) After(u time.Time) bool After reports whether the time instant t is after u. ( Now) AppendFormat(b []byte, layout string) []byte AppendFormat is like Format but appends the textual representation to b and returns the extended buffer. ( Now) Before(u time.Time) bool Before reports whether the time instant t is before u. (*Now) BeginningOfDay() time.Time BeginningOfDay beginning of day (*Now) BeginningOfHalf() time.Time BeginningOfHalf beginning of half year (*Now) BeginningOfHour() time.Time BeginningOfHour beginning of hour (*Now) BeginningOfMinute() time.Time BeginningOfMinute beginning of minute (*Now) BeginningOfMonth() time.Time BeginningOfMonth beginning of month (*Now) BeginningOfQuarter() time.Time BeginningOfQuarter beginning of quarter (*Now) BeginningOfWeek() time.Time BeginningOfWeek beginning of week (*Now) BeginningOfYear() time.Time BeginningOfYear BeginningOfYear beginning of year (*Now) Between(begin, end string) bool Between check time between the begin, end time or not ( Now) Clock() (hour, min, sec int) Clock returns the hour, minute, and second within the day specified by t. ( Now) Compare(u time.Time) int Compare compares the time instant t with u. If t is before u, it returns -1; if t is after u, it returns +1; if they're the same, it returns 0. ( Now) Date() (year int, month time.Month, day int) Date returns the year, month, and day in which t occurs. ( Now) Day() int Day returns the day of the month specified by t. (*Now) EndOfDay() time.Time EndOfDay end of day (*Now) EndOfHalf() time.Time EndOfHalf end of half year (*Now) EndOfHour() time.Time EndOfHour end of hour (*Now) EndOfMinute() time.Time EndOfMinute end of minute (*Now) EndOfMonth() time.Time EndOfMonth end of month (*Now) EndOfQuarter() time.Time EndOfQuarter end of quarter (*Now) EndOfSunday() time.Time EndOfSunday end of sunday (*Now) EndOfWeek() time.Time EndOfWeek end of week (*Now) EndOfYear() time.Time EndOfYear end of year ( Now) Equal(u time.Time) bool Equal reports whether t and u represent the same time instant. Two times can be equal even if they are in different locations. For example, 6:00 +0200 and 4:00 UTC are Equal. See the documentation on the Time type for the pitfalls of using == with Time values; most code should use Equal instead. ( Now) Format(layout string) string Format returns a textual representation of the time value formatted according to the layout defined by the argument. See the documentation for the constant called Layout to see how to represent the layout format. The executable example for Time.Format demonstrates the working of the layout string in detail and is a good reference. ( Now) GoString() string GoString implements fmt.GoStringer and formats t to be printed in Go source code. (*Now) GobDecode(data []byte) error GobDecode implements the gob.GobDecoder interface. ( Now) GobEncode() ([]byte, error) GobEncode implements the gob.GobEncoder interface. ( Now) Hour() int Hour returns the hour within the day specified by t, in the range [0, 23]. ( Now) ISOWeek() (year, week int) ISOWeek returns the ISO 8601 year and week number in which t occurs. Week ranges from 1 to 53. Jan 01 to Jan 03 of year n might belong to week 52 or 53 of year n-1, and Dec 29 to Dec 31 might belong to week 1 of year n+1. ( Now) In(loc *time.Location) time.Time In returns a copy of t representing the same time instant, but with the copy's location information set to loc for display purposes. In panics if loc is nil. ( Now) IsDST() bool IsDST reports whether the time in the configured location is in Daylight Savings Time. ( Now) IsZero() bool IsZero reports whether t represents the zero time instant, January 1, year 1, 00:00:00 UTC. ( Now) Local() time.Time Local returns t with the location set to local time. ( Now) Location() *time.Location Location returns the time zone information associated with t. ( Now) MarshalBinary() ([]byte, error) MarshalBinary implements the encoding.BinaryMarshaler interface. ( Now) MarshalJSON() ([]byte, error) MarshalJSON implements the json.Marshaler interface. The time is a quoted string in the RFC 3339 format with sub-second precision. If the timestamp cannot be represented as valid RFC 3339 (e.g., the year is out of range), then an error is reported. ( Now) MarshalText() ([]byte, error) MarshalText implements the encoding.TextMarshaler interface. The time is formatted in RFC 3339 format with sub-second precision. If the timestamp cannot be represented as valid RFC 3339 (e.g., the year is out of range), then an error is reported. ( Now) Minute() int Minute returns the minute offset within the hour specified by t, in the range [0, 59]. (*Now) Monday(strs ...string) time.Time ( Now) Month() time.Month Month returns the month of the year specified by t. (*Now) MustParse(strs ...string) (t time.Time) MustParse must parse string to time or it will panic ( Now) Nanosecond() int Nanosecond returns the nanosecond offset within the second specified by t, in the range [0, 999999999]. (*Now) Parse(strs ...string) (t time.Time, err error) Parse parse string to time (*Now) Quarter() uint Quarter returns the yearly quarter ( Now) Round(d time.Duration) time.Time Round returns the result of rounding t to the nearest multiple of d (since the zero time). The rounding behavior for halfway values is to round up. If d <= 0, Round returns t stripped of any monotonic clock reading but otherwise unchanged. Round operates on the time as an absolute duration since the zero time; it does not operate on the presentation form of the time. Thus, Round(Hour) may return a time with a non-zero minute, depending on the time's Location. ( Now) Second() int Second returns the second offset within the minute specified by t, in the range [0, 59]. ( Now) String() string String returns the time formatted using the format string "2006-01-02 15:04:05.999999999 -0700 MST" If the time has a monotonic clock reading, the returned string includes a final field "m=±<value>", where value is the monotonic clock reading formatted as a decimal number of seconds. The returned string is meant for debugging; for a stable serialized representation, use t.MarshalText, t.MarshalBinary, or t.Format with an explicit format string. ( Now) Sub(u time.Time) time.Duration Sub returns the duration t-u. If the result exceeds the maximum (or minimum) value that can be stored in a Duration, the maximum (or minimum) duration will be returned. To compute t-d for a duration d, use t.Add(-d). (*Now) Sunday(strs ...string) time.Time ( Now) Truncate(d time.Duration) time.Time Truncate returns the result of rounding t down to a multiple of d (since the zero time). If d <= 0, Truncate returns t stripped of any monotonic clock reading but otherwise unchanged. Truncate operates on the time as an absolute duration since the zero time; it does not operate on the presentation form of the time. Thus, Truncate(Hour) may return a time with a non-zero minute, depending on the time's Location. ( Now) UTC() time.Time UTC returns t with the location set to UTC. ( Now) Unix() int64 Unix returns t as a Unix time, the number of seconds elapsed since January 1, 1970 UTC. The result does not depend on the location associated with t. Unix-like operating systems often record time as a 32-bit count of seconds, but since the method here returns a 64-bit value it is valid for billions of years into the past or future. ( Now) UnixMicro() int64 UnixMicro returns t as a Unix time, the number of microseconds elapsed since January 1, 1970 UTC. The result is undefined if the Unix time in microseconds cannot be represented by an int64 (a date before year -290307 or after year 294246). The result does not depend on the location associated with t. ( Now) UnixMilli() int64 UnixMilli returns t as a Unix time, the number of milliseconds elapsed since January 1, 1970 UTC. The result is undefined if the Unix time in milliseconds cannot be represented by an int64 (a date more than 292 million years before or after 1970). The result does not depend on the location associated with t. ( Now) UnixNano() int64 UnixNano returns t as a Unix time, the number of nanoseconds elapsed since January 1, 1970 UTC. The result is undefined if the Unix time in nanoseconds cannot be represented by an int64 (a date before the year 1678 or after 2262). Note that this means the result of calling UnixNano on the zero Time is undefined. The result does not depend on the location associated with t. (*Now) UnmarshalBinary(data []byte) error UnmarshalBinary implements the encoding.BinaryUnmarshaler interface. (*Now) UnmarshalJSON(data []byte) error UnmarshalJSON implements the json.Unmarshaler interface. The time must be a quoted string in the RFC 3339 format. (*Now) UnmarshalText(data []byte) error UnmarshalText implements the encoding.TextUnmarshaler interface. The time must be in the RFC 3339 format. ( Now) Weekday() time.Weekday Weekday returns the day of the week specified by t. ( Now) With(t time.Time) *Now New initialize Now based on configuration ( Now) Year() int Year returns the year in which t occurs. ( Now) YearDay() int YearDay returns the day of the year specified by t, in the range [1,365] for non-leap years, and [1,366] in leap years. ( Now) Zone() (name string, offset int) Zone computes the time zone in effect at time t, returning the abbreviated name of the zone (such as "CET") and its offset in seconds east of UTC. ( Now) ZoneBounds() (start, end time.Time) ZoneBounds returns the bounds of the time zone in effect at time t. The zone begins at start and the next zone begins at end. If the zone begins at the beginning of time, start will be returned as a zero Time. If the zone goes on forever, end will be returned as a zero Time. The Location of the returned times will be the same as t. Implements (at least 11) Now : github.com/ChrisTrenkamp/goxpath/tree.Result Now : encoding.BinaryMarshaler *Now : encoding.BinaryUnmarshaler Now : encoding.TextMarshaler *Now : encoding.TextUnmarshaler *Now : encoding/gob.GobDecoder Now : encoding/gob.GobEncoder Now : encoding/json.Marshaler *Now : encoding/json.Unmarshaler Now : fmt.GoStringer Now : fmt.Stringer As Outputs Of (at least 3) func New(t time.Time) *Now func With(t time.Time) *Now func (*Config).With(t time.Time) *Now Package-Level Functions (total 25) func BeginningOfDay() time.Time BeginningOfDay beginning of day func BeginningOfHour() time.Time BeginningOfHour beginning of hour func BeginningOfMinute() time.Time BeginningOfMinute beginning of minute func BeginningOfMonth() time.Time BeginningOfMonth beginning of month func BeginningOfQuarter() time.Time BeginningOfQuarter beginning of quarter func BeginningOfWeek() time.Time BeginningOfWeek beginning of week func BeginningOfYear() time.Time BeginningOfYear beginning of year func Between(time1, time2 string) bool Between check now between the begin, end time or not func EndOfDay() time.Time EndOfDay end of day func EndOfHour() time.Time EndOfHour end of hour func EndOfMinute() time.Time EndOfMinute end of minute func EndOfMonth() time.Time EndOfMonth end of month func EndOfQuarter() time.Time EndOfQuarter end of quarter func EndOfSunday() time.Time EndOfSunday end of sunday func EndOfWeek() time.Time EndOfWeek end of week func EndOfYear() time.Time EndOfYear end of year func Monday(strs ...string) time.Time func MustParse(strs ...string) time.Time MustParse must parse string to time or will panic func MustParseInLocation(loc *time.Location, strs ...string) time.Time MustParseInLocation must parse string to time in location or will panic func New(t time.Time) *Now New initialize Now with time func Parse(strs ...string) (time.Time, error) Parse parse string to time func ParseInLocation(loc *time.Location, strs ...string) (time.Time, error) ParseInLocation parse string to time in location func Quarter() uint Quarter returns the yearly quarter func Sunday(strs ...string) time.Time Sunday sunday func With(t time.Time) *Now With initialize Now with time Package-Level Variables (total 3) var DefaultConfig *Config DefaultConfig default config var TimeFormats []string TimeFormats default time formats will be parsed as var WeekStartDay time.Weekday WeekStartDay set week start day, default is sunday

The pages are generated with Golds v0.6.7. (GOOS=linux GOARCH=amd64) Golds is a Go 101 project developed by Tapir Liu. PR and bug reports are welcome and can be submitted to the issue list. Please follow @Go100and1 (reachable from the left QR code) to get the latest news of Golds.