humantime

Convert English strings related to time to Go time.Time. This package also implements the flags.Value and flag.Getter interfaces for use in a cli context as well.

Nomenclature

• A "time phrase" is text that represents just time, examples:
  • at 4pm
  • 3am
  • 12:03:33 // the colon format assumes 24h (no am or pm allowed)
  • 3:4:3 // interpreted as 03:04:03
• A "date phrase" is text that represents a date and optionally time, examples:
  • May 8, 2009 5:57:51 PM
  • 3/15/2022
  • yesterday
  • yesterday at [time phrase]
  • tomorrow at [time phrase]
• Weekdays: "this tuesday", "last wednesday" ...
  • Modifiers:
    • "last" is the previous week
    • "this" is this week, if today is wednesday and you input "this tuesday" it will return yesterday
    • "next" the following week
  • Day names:
    • all days of the week are supported as full names: e.g. friday
    • abbreviations are also supported: mon, tues,wed, thur, fri, sat, sun
• A complete list of supported date formats can be found here
  • In addition to this list, "yesterday", "today" and "tomorrow" are also supported

Supported formats

• since [date phrase]
• until or til [date phrase]
• before [date phrase]
• after [date phrase]
• [date phrase] ago
• from [date phrase] to [date phrase]

Example phrases

• from May 8, 2009 5:57:51 PM to Sep 12, 2021 3:21:22 PM
• 3 days ago
• after yesterday at 4pm
• last thursday at 2am
• next friday at 02:23:34
• (more in tests)

Usage

CLI flag example

  var st, err = NewString2Time(now.Location())
  result, err := st.After("after 3/15/2022")
 
  fmt.Println(result)    // From: 15 Mar 22 00:00 MDT, To: 19 Jul 22 15:02 MDT