stdlib-times.md 5.8 KB

Module - "times"

times := import("times")

Constants

  • format_ansic: time format "Mon Jan _2 15:04:05 2006"
  • format_unix_date: time format "Mon Jan _2 15:04:05 MST 2006"
  • format_ruby_date: time format "Mon Jan 02 15:04:05 -0700 2006"
  • format_rfc822: time format "02 Jan 06 15:04 MST"
  • format_rfc822z: time format "02 Jan 06 15:04 -0700"
  • format_rfc850: time format "Monday, 02-Jan-06 15:04:05 MST"
  • format_rfc1123: time format "Mon, 02 Jan 2006 15:04:05 MST"
  • format_rfc1123z: time format "Mon, 02 Jan 2006 15:04:05 -0700"
  • format_rfc3339: time format "2006-01-02T15:04:05Z07:00"
  • format_rfc3339_nano: time format "2006-01-02T15:04:05.999999999Z07:00"
  • format_kitchen: time format "3:04PM"
  • format_stamp: time format "Jan _2 15:04:05"
  • format_stamp_milli: time format "Jan _2 15:04:05.000"
  • format_stamp_micro: time format "Jan _2 15:04:05.000000"
  • format_stamp_nano: time format "Jan _2 15:04:05.000000000"
  • nanosecond
  • microsecond
  • millisecond
  • second
  • minute
  • hour
  • january
  • february
  • march
  • april
  • may
  • june
  • july
  • august
  • september
  • october
  • november
  • december

Functions

  • sleep(duration int): pauses the current goroutine for at least the duration d. A negative or zero duration causes Sleep to return immediately.
  • parse_duration(s string) => int: parses a duration string. A duration string is a possibly signed sequence of decimal numbers, each with optional fraction and a unit suffix, such as "300ms", "-1.5h" or "2h45m". Valid time units are "ns", "us" (or "µs"), "ms", "s", "m", "h".
  • since(t time) => int: returns the time elapsed since t.
  • until(t time) => int: returns the duration until t.
  • duration_hours(duration int) => float: returns the duration as a floating point number of hours.
  • duration_minutes(duration int) => float: returns the duration as a floating point number of minutes.
  • duration_nanoseconds(duration int) => int: returns the duration as an integer of nanoseconds.
  • duration_seconds(duration int) => float: returns the duration as a floating point number of seconds.
  • duration_string(duration int) => string: returns a string representation of duration.
  • month_string(month int) => string: returns the English name of the month ("January", "February", ...).
  • date(year int, month int, day int, hour int, min int, sec int, nsec int) => time: returns the Time corresponding to "yyyy-mm-dd hh:mm:ss + nsec nanoseconds". Current location is used.
  • now() => time: returns the current local time.
  • parse(format string, s string) => time: parses a formatted string and returns the time value it represents. The layout defines the format by showing how the reference time, defined to be "Mon Jan 2 15:04:05 -0700 MST 2006" would be interpreted if it were the value; it serves as an example of the input format. The same interpretation will then be made to the input string.
  • unix(sec int, nsec int) => time: returns the local Time corresponding to the given Unix time, sec seconds and nsec nanoseconds since January 1, 1970 UTC.
  • add(t time, duration int) => time: returns the time t+d.
  • add_date(t time, years int, months int, days int) => time: 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.
  • sub(t time, u time) => int: returns the duration t-u.
  • after(t time, u time) => bool: reports whether the time instant t is after u.
  • before(t time, u time) => bool: reports whether the time instant t is before u.
  • time_year(t time) => int: returns the year in which t occurs.
  • time_month(t time) => int: returns the month of the year specified by t.
  • time_day(t time) => int: returns the day of the month specified by t.
  • time_weekday(t time) => int: returns the day of the week specified by t.
  • time_hour(t time) => int: returns the hour within the day specified by t, in the range [0, 23].
  • time_minute(t time) => int: returns the minute offset within the hour specified by t, in the range [0, 59].
  • time_second(t time) => int: returns the second offset within the minute specified by t, in the range [0, 59].
  • time_nanosecond(t time) => int: returns the nanosecond offset within the second specified by t, in the range [0, 999999999].
  • time_unix(t time) => int: 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.
  • time_unix_nano(t time) => int: 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.
  • time_format(t time, format) => string: returns a textual representation of he time value formatted according to layout, which defines the format by showing how the reference time, defined to be "Mon Jan 2 15:04:05 -0700 MST 2006" would be displayed if it were the value; it serves as an example of the desired output. The same display rules will then be applied to the time value.
  • time_location(t time) => string: returns the time zone name associated with t.
  • time_string(t time) => string: returns the time formatted using the format string "2006-01-02 15:04:05.999999999 -0700 MST".
  • is_zero(t time) => bool: reports whether t represents the zero time instant, January 1, year 1, 00:00:00 UTC.
  • to_local(t time) => time: returns t with the location set to local time.
  • to_utc(t time) => time: returns t with the location set to UTC.