Go言語で時間を扱う(pkg/time)機能まとめ

ちょくちょく調べなおすことがあるので、この際いっきにまとめてみた。

まずはドキュメントを読んでみましょう。

https://golang.org/pkg/time/

部分的にDocumentのExampleを参考にしてるところはあります。


基本的な使い方

Now()で現在時刻、Date()で特定の時刻が取れます。

package main

import (
"fmt"
"time"
)

func main() {
fmt.Println("----- Basic usage -----")
now := time.Now()
fmt.Println("Now() : " + now.String())
time1 := time.Date(2018, 10, 15, 16, 48, 32, 12345, time.Local)
fmt.Println("Date() : " + time1.String())
fmt.Println()
}

----- Basic usage -----

Now() : 2018-12-21 18:02:48.2384152 +0900 JST m=+0.024933301
Date() : 2018-10-15 16:48:32.000012345 +0900 JST

ここ以降は出力の関係上 "strconv"もimportしておいてください。

また説明が重複するため、package, import 部分は省略します。


値取得関係の関数

日時などの値を単純に取得する関数です。

fmt.Println("----- Functions -----")

fmt.Println("Year() : " + strconv.Itoa(now.Year()))
fmt.Println("Month() : " + now.Month().String())
fmt.Println("int(now.Month()) : " + strconv.Itoa(int(now.Month())))
fmt.Println("Day() : " + strconv.Itoa(now.Day()))
fmt.Println("Hour() : " + strconv.Itoa(now.Hour()))
fmt.Println("Minute() : " + strconv.Itoa(now.Minute()))
fmt.Println("Second() : " + strconv.Itoa(now.Second()))
fmt.Println("Nanosecond() : " + strconv.Itoa(now.Nanosecond()))
fmt.Println("Weekday() : " + now.Weekday().String())
fmt.Println("int(Weekday()) : " + strconv.Itoa(int(now.Weekday())))
fmt.Println("Unix() : " + strconv.FormatInt(now.Unix(), 10))
fmt.Println("UnixNano() : " + strconv.FormatInt(now.UnixNano(), 10))

iso_year, iso_week := now.ISOWeek()

fmt.Println("ISOWeek() year : " + strconv.Itoa(iso_year))
fmt.Println("ISOWeek() week : " + strconv.Itoa(iso_week))
fmt.Println()

----- Functions -----

Year() : 2018
Month() : December
int(now.Month()) : 12
Day() : 21
Hour() : 18
Minute() : 2
Second() : 48
Nanosecond() : 238415200
Weekday() : Friday
int(Weekday()) : 5
Unix() : 1545382968
UnixNano() : 1545382968238415200
ISOWeek() year : 2018
ISOWeek() week : 51

Month()だと英文字の月名になるのが要注意ですね。なんで数字じゃないんだ。

intでキャストする必要があります。Weekday()、お前は許す。。

またIOSWeek()は年の53週間中何週間目がわかるから便利ですね。


便利な関数

じゃあ年月日を取るために Year(), Month(), Day() を使うか~っと思ったら、ちょっと待って。

下記のDate(), Clock()が便利ですよ。

fmt.Println("----- Simple Functions -----")

fmt.Println("Date() Clock()")
year, month, day := now.Date()
hour, min, sec := now.Clock()
fmt.Println(year)
fmt.Println(int(month))
fmt.Println(day)
fmt.Println(hour)
fmt.Println(min)
fmt.Println(sec)
fmt.Println()

fmt.Println("YearDay() : " + strconv.Itoa(now.YearDay()))
fmt.Println("UTC() : " + now.UTC().String())
fmt.Println("Local() : " + now.Local().String())

zoneName, zoneOffset := now.Zone()

fmt.Println("Zone() (name,offset) : " + "( " + zoneName + " , " + strconv.Itoa(zoneOffset) + " )")
fmt.Println()

----- Simple Functions -----

Date() Clock()
2018
12
21
18
2
48

YearDay() : 355
UTC() : 2018-12-21 09:02:48.2384152 +0000 UTC
Local() : 2018-12-21 18:02:48.2384152 +0900 JST
Zone() (name,offset) : ( JST , 32400 )

Date()、Clock()はいっきに取れるから便利ですね。

また年間で何日目なのか?がわかるYearDay()も便利ですね。

UTC←→JST変換も楽です。zone情報もわかりますね。


加減算

時間の加算減算です。

fmt.Println("----- Add -----")

fmt.Println("Now() : " + now.String())

now = now.Add(time.Duration(-1) * time.Hour)
fmt.Println("time 1 hour ago : " + now.String())
fmt.Println()

----- Add -----

Now() : 2018-12-21 18:02:48.2384152 +0900 JST m=+0.024933301
time 1 hour ago : 2018-12-21 17:02:48.2384152 +0900 JST m=-3599.975066699

もちろんHour以外にもDayでもMinuteでも可能です。


フォーマット変換

指定のフォーマットから文字列時刻を読み取ります。

fmt.Println("----- Parse() Format()-----")

var timeParse01 = time.Time{}
timeParse01, _ = time.Parse("2006/01/02 15:04:05 (MST)", "2018/12/21 13:45:38 (JST)")

fmt.Println("Parse() : " + timeParse01.String())
fmt.Println("Format(ANSIC) : " + timeParse01.Format(time.ANSIC))
fmt.Println("Format(RFC1123Z) : " + timeParse01.Format(time.RFC1123Z))
fmt.Println()

----- Parse() Format()-----

Parse() : 2018-12-21 13:45:38 +0900 JST
Format(ANSIC) : Fri Dec 21 13:45:38 2018
Format(RFC1123Z) : Fri, 21 Dec 2018 13:45:38 +0900

パースするところで、2006とか01とか02ってなんなんだ?と思ってましたが、そういうフォーマットの指定方法なんですね。

ここを見るとわかります。

https://golang.org/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"
)

const (
_ = iota
stdLongMonth = iota + stdNeedDate // "January"
stdMonth // "Jan"
stdNumMonth // "1"
stdZeroMonth // "01"
stdLongWeekDay // "Monday"
stdWeekDay // "Mon"
stdDay // "2"
stdUnderDay // "_2"
stdZeroDay // "02"
stdHour = iota + stdNeedClock // "15"
stdHour12 // "3"
stdZeroHour12 // "03"
stdMinute // "4"
stdZeroMinute // "04"
stdSecond // "5"
stdZeroSecond // "05"
stdLongYear = iota + stdNeedDate // "2006"
stdYear // "06"
stdPM = iota + stdNeedClock // "PM"
stdpm // "pm"
stdTZ = iota // "MST"
stdISO8601TZ // "Z0700" // prints Z for UTC
stdISO8601SecondsTZ // "Z070000"
stdISO8601ShortTZ // "Z07"
stdISO8601ColonTZ // "Z07:00" // prints Z for UTC
stdISO8601ColonSecondsTZ // "Z07:00:00"
stdNumTZ // "-0700" // always numeric
stdNumSecondsTz // "-070000"
stdNumShortTZ // "-07" // always numeric
stdNumColonTZ // "-07:00" // always numeric
stdNumColonSecondsTZ // "-07:00:00"
stdFracSecond0 // ".0", ".00", ... , trailing zeros included
stdFracSecond9 // ".9", ".99", ..., trailing zeros omitted

stdNeedDate = 1 << 8 // need month, day, year
stdNeedClock = 2 << 8 // need hour, minute, second
stdArgShift = 16 // extra argument in high bits, above low stdArgShift
stdMask = 1<<stdArgShift - 1 // mask out argument
)


時間単位の変更

X時間は何分/何秒なのか?とかの単位変換計算が楽になります。

fmt.Println("----- ParseDuration() -----")

duration, _ := time.ParseDuration("2h35m10s")
fmt.Println("Duration String : " + duration.String())
fmt.Println("Duration in minutes : " + strconv.FormatFloat(duration.Minutes(), 'f', 0, 64))
fmt.Println("Duration in seconds : " + strconv.FormatFloat(duration.Seconds(), 'f', 0, 64))
fmt.Println()

----- ParseDuration() -----

Duration String : 2h35m10s
Duration in minutes : 155
Duration in seconds : 9310


どれくらいの時間の隔たりがあるか

二つの時間の差分がSub()、その時間から今までがSince()、今から未来の時間までがUntil()。

このへんも便利ですね。

fmt.Println("----- Sub() Since() Until() -----")

time01 := time.Date(2018, 10, 10, 15, 0, 0, 0, time.Local)
time02 := time.Date(2018, 10, 25, 15, 30, 10, 0, time.Local)

fmt.Println("time01 : " + time01.String())
fmt.Println("time02 : " + time02.String())

time01Subtime02 := time01.Sub(time02)
time02Subtime01 := time02.Sub(time01)

fmt.Println("time01.Sub(time02) : " + time01Subtime02.String())
fmt.Println("time02.Sub(time01) : " + time02Subtime01.String())
fmt.Println()

time03 := time.Date(2018, 12, 10, 0, 0, 0, 0, time.Local)
time04 := time.Date(2018, 12, 25, 0, 0, 0, 0, time.Local)

fmt.Println("Now() : " + now.String())
fmt.Println("time03 : " + time03.String())
fmt.Println("time04 : " + time04.String())

fmt.Println("time.Since(time03) : " + time.Since(time03).String())
fmt.Println("time.Until(time04) : " + time.Until(time04).String())
fmt.Println()

----- Sub() Since() Until() -----

time01 : 2018-10-10 15:00:00 +0900 JST
time02 : 2018-10-25 15:30:10 +0900 JST
time01.Sub(time02) : -360h30m10s
time02.Sub(time01) : 360h30m10s

Now() : 2018-12-21 17:02:48.2384152 +0900 JST m=-3599.975066699
time03 : 2018-12-10 00:00:00 +0900 JST
time04 : 2018-12-25 00:00:00 +0900 JST
time.Since(time03) : 282h2m48.3541336s
time.Until(time04) : 77h57m11.6458664s


どっちが新しい?古い?

自分はUnixタイムで比較してましたが、こんな関数もあるんですね。

After()、Before() の方がわかりやすい!可読性がよくなります。これならぱっと見わかりやすくなりますね。



fmt.Println("----- After() Before() -----")
date11m := time.Date(2018, 11, 1, 0, 0, 0, 0, time.Local)
date12m := time.Date(2018, 12, 1, 0, 0, 0, 0, time.Local)

fmt.Println(date11m)
fmt.Println(date12m)

isDate11mAfterDate12m := date11m.After(date12m)
isDate12mAfterDate11m := date12m.After(date11m)

fmt.Printf("date11m.After(date12m) = %v\n", isDate11mAfterDate12m)
fmt.Printf("date12m.After(date11m) = %v\n", isDate12mAfterDate11m)

isDate11mBeforeDate12m := date11m.Before(date12m)
isDate12mBeforeDate11m := date12m.Before(date11m)

fmt.Printf("date11m.Before(date12m) = %v\n", isDate11mBeforeDate12m)
fmt.Printf("date12m.Before(date11m) = %v\n", isDate12mBeforeDate11m)
fmt.Println()

----- After() Before() -----

2018-11-01 00:00:00 +0900 JST
2018-12-01 00:00:00 +0900 JST
date11m.After(date12m) = false
date12m.After(date11m) = true
date11m.Before(date12m) = true
date12m.Before(date11m) = false


同じ時間か?

時差があっても同じ時刻か比較できます。ここtimeパッケージのExampleを参考にしました。

fmt.Println("----- Equal() -----")

//時差が8時間の "Beijing Time" を作ります。
secondsEastOfUTC := int((8 * time.Hour).Seconds())
beijing := time.FixedZone("Beijing Time", secondsEastOfUTC)

timeBeijin := time.Date(2018, 2, 1, 20, 15, 45, 0, beijing)
timeUtc := time.Date(2018, 2, 1, 12, 15, 45, 0, time.UTC)

fmt.Println(timeBeijin)
fmt.Println(timeUtc)

datesEqualUsingEqualOperator := timeBeijin == timeUtc
datesEqualUsingFunction := timeBeijin.Equal(timeUtc)

fmt.Printf("datesEqualUsingEqualOperator = %v\n", datesEqualUsingEqualOperator)
fmt.Printf("datesEqualUsingFunction = %v\n", datesEqualUsingFunction)
fmt.Println()

----- Equal() -----

2018-02-01 20:15:45 +0800 Beijing Time
2018-02-01 12:15:45 +0000 UTC
datesEqualUsingEqualOperator = false
datesEqualUsingFunction = true

timeBeijinとtimeUtcは時刻は違いますが、地球上の上では時差を換算すると同じ時刻ですからTrueになりますね。

(UTC)12:15 + (Beijin時差)8hr = (Beijin Time)20:15

それにしても上記のように書けば時差ロケーションが作れるんですね。


四捨五入や切り下げ

時間の四捨五入ってめんどくさいですよね。でもこれなら簡単です。

Round()は四捨五入みたいな感じで、Truncate()は切り捨てですね。



fmt.Println("----- Round() Truncate() -----")
time10 := time.Date(2018, 12, 10, 14, 15, 45, 987654321, time.Local)

fmt.Println("time10 : " + time10.String())
fmt.Println("time10.Round(time.Hour) : " + time10.Round(time.Hour).String())
fmt.Println("time10.Round(time.Minute) : " + time10.Round(time.Minute).String())
fmt.Println("time10.Round(time.Second) : " + time10.Round(time.Second).String())
fmt.Println("time10.Truncate(time.Hour) : " + time10.Truncate(time.Hour).String())
fmt.Println("time10.Truncate(time.Minute): " + time10.Truncate(time.Minute).String())
fmt.Println("time10.Truncate(time.Second): " + time10.Truncate(time.Second).String())
fmt.Println()

----- Round() Truncate() -----

time10 : 2018-12-10 14:15:45.987654321 +0900 JST
time10.Round(time.Hour) : 2018-12-10 14:00:00 +0900 JST
time10.Round(time.Minute) : 2018-12-10 14:16:00 +0900 JST
time10.Round(time.Second) : 2018-12-10 14:15:46 +0900 JST
time10.Truncate(time.Hour) : 2018-12-10 14:00:00 +0900 JST
time10.Truncate(time.Minute): 2018-12-10 14:15:00 +0900 JST
time10.Truncate(time.Second): 2018-12-10 14:15:45 +0900 JST


Parse処理うまくいったかな?

IsZero() ってなんのためにあるのかな?と思ってましたが、確認のためのようですね。

fmt.Println("----- IsZero() -----")

timeRight, _ := time.Parse("2006/01/02 15:04", "2018/12/21 13:45")
// Parse処理で不適切な形式をしてして失敗させます。
timeFail, _ := time.Parse("2006/01/02 15:04", "2018/12/21 hoge 13:45")

fmt.Println("timeRight : " + timeRight.String())
fmt.Println("timeFail : " + timeFail.String())
fmt.Println("timeRight.IsZero() : " + strconv.FormatBool(timeRight.IsZero()))
fmt.Println("timeFail.IsZero() : " + strconv.FormatBool(timeFail.IsZero()))
fmt.Println()

----- IsZero() -----

timeRight : 2018-12-21 13:45:00 +0000 UTC
timeFail : 0001-01-01 00:00:00 +0000 UTC
timeRight.IsZero() : false
timeFail.IsZero() : true

なるほど。パースに失敗すると0001-01-01....になってしまうんだな。


サンプルソース全文

こちらです

https://gist.github.com/36ca5e2245b38bf0aa4eb05ee9a3c8df