go語言中的Carbon庫時間處理技巧

go語言之Carbon庫

  • carbon是一個時間擴展庫,它提供瞭易於使用接口。
  • 簡單示例:
package main

import (
	"fmt"
	"github.com/uniplaces/carbon"
	"time"
)

func main() {
	// 打印當前時間
	now :=carbon.Now().DateTimeString()
	fmt.Println("本地時間:", now)

	Japantoday, _ := carbon.NowInLocation("Japan")
	fmt.Println("日本時間:", Japantoday)
	// 明天
	tomorrow := carbon.Now().AddDay()
	fmt.Println(tomorrow)
	// 上周的今天
	subweek := carbon.Now().SubWeek()
	fmt.Println(subweek)
	nextOlympics, _ := carbon.CreateFromDate(2016, time.August,5,"Europe/London")
	fmt.Println("2016年奧林匹克運動會:",nextOlympics)
	nextOlympics = nextOlympics.AddYears(4)
	fmt.Println("下一次奧林匹克運動會:", nextOlympics.Year())
	if carbon.Now().IsWeekend() {
		fmt.Println("休息的一天")
	} else {
		fmt.Println("工作日")
	}
}

carbon庫非常便捷,它完全兼容time.Time類型,實際上它日期時間類型Carbon直接將time.Time內嵌到結構中,所以time.Time方法可直接調用。

// The Carbon type represents a Time instance.
// Provides a simple API extension for Time.
type Carbon struct {
	time.Time
	weekStartsAt time.Weekday
	weekEndsAt time.Weekday
	weekendDays []time.Weekday
	stringFormat string
	Translator *Translator
}

其次,簡化瞭創建操作。標準庫time創建一個Time對象,如果不是本地或 UTC 時區,需要自己先調用LoadLocation加載對應時區。然後將該時區對象傳給time.Date方法創建。carbon可以直接傳時區名字。

1.時區

使用go語言time,創建時區需要先加載時區。

loc, err := time.LoadLocation("Japan")
if err != nil {
 log.Fatal("failed to load location:", err)
}
d := time.Date(2020, time.July,24,20,0,0,0,loc)
fmt.Println(d) // 2020-07-24 20:00:00 +0900 JST

使用carbon就簡單很多

loc, err := carbon.Create(2020,time.July,24,20,0,0,0,"Japan")
if err != nil {
	log.Fatal(err)
}
fmt.Println(loc)// 2020-07-24 20:00:00

2.時間運算

now := carbon.Now()
fmt.Println(now)
fmt.Println("1秒後:", now.AddSecond())
fmt.Println("1分鐘後:", now.AddMinute())
fmt.Println("1小時後:", now.AddHour())
fmt.Println("3分鐘20秒後:", now.AddMinutes(3).AddSeconds(20))
fmt.Println("2小時30分後:", now.AddHours(2).AddMinutes(30))
fmt.Println("3天2小時後:",now.AddDays(3).AddHours(2))
  • 增加季度的方法:AddQuarters/AddQuarter,復數形式介紹一個表示倍數的參數,單數形式倍數為1;
  • 增加世紀的方法:AddCenturies/AddCentury
  • 增加工作日的方法:AddWeekdays/AddWeekday,這個方法會跳過非工作日;
  • 增加周的方法:AddWeeks/AddWeek

其實給上面方法傳入負數就表示減少,另外carbon也提供瞭對應的Sub*方法。

3.時間比較

carbon計算兩個日期之間相差多少秒,份,小時,天:

vancouver, _ := carbon.Today("Asia/Shanghai")
london, _ := carbon.Today("Asia/Hong_Kong")
// 相差秒數
fmt.Println(vancouver.DiffInSeconds(london, true)) // 0
ottawa, _ := carbon.CreateFromDate(2000, 1, 1, "America/Toronto")
vancouver, _ = carbon.CreateFromDate(2000, 1, 1, "America/Vancouver")
fmt.Println(ottawa.DiffInHours(vancouver, true)) // 3
fmt.Println(ottawa.DiffInHours(vancouver, false)) // 3
fmt.Println(vancouver.DiffInHours(ottawa, false)) // -3
t, _ := carbon.CreateFromDate(2012, 1, 31, "UTC")
fmt.Println(t.DiffInDays(t.AddMonth(), true)) // 31
fmt.Println(t.DiffInDays(t.SubMonth(), false)) // -31

t, _ = carbon.CreateFromDate(2012, 4, 30, "UTC")
fmt.Println(t.DiffInDays(t.AddMonth(), true)) // 30
fmt.Println(t.DiffInDays(t.AddWeek(), true)) // 7

t, _ = carbon.CreateFromTime(10, 1, 1, 0, "UTC")
fmt.Println(t.DiffInMinutes(t.AddSeconds(59), true)) // 0
fmt.Println(t.DiffInMinutes(t.AddSeconds(60), true)) // 1
fmt.Println(t.DiffInMinutes(t.AddSeconds(119), true)) // 1
fmt.Println(t.DiffInMinutes(t.AddSeconds(120), true)) // 2

4.格式化

我們知道time.Time提供瞭一個Format方法,相比於其他編程語言使用格式化符來描述格式(需要記憶%d/%m/%h等的含義),Go 提供瞭一個一種更簡單、直觀的方式——使用 layout。即我們傳入一個日期字符串,表示我們想要格式化成什麼樣子。Go 會用當前的時間替換字符串中的對應部分:

package main

import (
 "fmt"
 "time"
)

func main() {
 t := time.Now()
 fmt.Println(t.Format("2006-01-02 10:00:00"))
}

上面我們隻需要傳入一個2006-01-02 10:00:00表示我們想要的格式為yyyy-mm-dd hh:mm:ss,省去瞭我們需要記憶的麻煩

為瞭使用方便,Go 內置瞭一些標準的時間格式:

/ src/time/format.go
const (
 ANSIC  = "Mon Jan _2 15:04:05 2006"
 UnixDate = "Mon Jan _2 15:04:05 MST 2006"
 RubyDate = "Mon Jan 02 15:04:05 -0700 2006"
 RFC822  = "02 Jan 06 15:04 MST"
 RFC822Z  = "02 Jan 06 15:04 -0700"// RFC822 with numeric zone
 RFC850  = "Monday, 02-Jan-06 15:04:05 MST"
 RFC1123  = "Mon, 02 Jan 2006 15:04:05 MST"
 RFC1123Z = "Mon, 02 Jan 2006 15:04:05 -0700"// RFC1123 with numeric zone
 RFC3339  = "2006-01-02T15:04:05Z07:00"
 RFC3339Nano = "2006-01-02T15:04:05.999999999Z07:00"
 Kitchen  = "3:04PM"
 // Handy time stamps.
 Stamp  = "Jan _2 15:04:05"
 StampMilli = "Jan _2 15:04:05.000"
 StampMicro = "Jan _2 15:04:05.000000"
 StampNano = "Jan _2 15:04:05.000000000"
)

除瞭上面這些格式,carbon還提供瞭其他一些格式:

const (
 DefaultFormat  = "2006-01-02 15:04:05"
 DateFormat   = "2006-01-02"
 FormattedDateFormat = "Jan 2, 2006"
 TimeFormat   = "15:04:05"
 HourMinuteFormat = "15:04"
 HourFormat   = "15"
 DayDateTimeFormat = "Mon, Aug 2, 2006 3:04 PM"
 CookieFormat  = "Monday, 02-Jan-2006 15:04:05 MST"
 RFC822Format  = "Mon, 02 Jan 06 15:04:05 -0700"
 RFC1036Format  = "Mon, 02 Jan 06 15:04:05 -0700"
 RFC2822Format  = "Mon, 02 Jan 2006 15:04:05 -0700"
 RSSFormat   = "Mon, 02 Jan 2006 15:04:05 -0700"
)

5.高級特性

所謂修飾器(modifier)就是對一些特定的時間操作,獲取開始和結束時間。如當天、月、季度、年、十年、世紀、周的開始和結束時間,還能獲得上一個周二、下一個周一、下一個工作日的時間等等:

t := carbon.Now()
	fmt.Println("今天起始:", t.StartOfDay())
	fmt.Println("今天終止:", t.EndOfDay())
	fmt.Println("本月起始:", t.StartOfMonth())
	fmt.Println("本月終止:", t.EndOfMonth())
	fmt.Println("本年起始:", t.StartOfYear())
	fmt.Println("本年終止:", t.EndOfYear())
	fmt.Println("今年起始日期(年月日時分秒):", t.StartOfDecade())
	fmt.Println("今年終止日期(年月日時分秒):", t.EndOfDecade())
	fmt.Println("本世紀起始日期(年月日時分秒):", t.StartOfCentury())
	fmt.Println("本世紀終止日期(年月日時分秒):", t.EndOfCentury())
	fmt.Println("本周起始日期(年月日時分秒):", t.StartOfWeek())
	fmt.Println("本周終止日期(年月日時分秒):", t.EndOfWeek())

6.自定義工作日和周末

func main() {
	t, err := carbon.Create(2020, 02, 11, 0, 0, 0, 0, "Asia/Shanghai")
	if err != nil {
		log.Fatal(err)
	}

	t.SetWeekStartsAt(time.Sunday)
	t.SetWeekEndsAt(time.Saturday)
	t.SetWeekendDays([]time.Weekday{time.Monday, time.Tuesday, time.Wednesday})

	fmt.Printf("今天是 %s, weekend? %t\n", t.Weekday(), t.IsWeekend())
}

到此這篇關於go語言中的Carbon庫時間處理的文章就介紹到這瞭,更多相關go Carbon庫時間處理內容請搜索WalkonNet以前的文章或繼續瀏覽下面的相關文章希望大傢以後多多支持WalkonNet!

推薦閱讀: