time.Date関数は繰り上がりを適切に処理してくれる

goのtime.Date関数がerrorを返さない関数だったので、通常の範囲外の値を渡したらどうなるのかと思ってやってみたら、ちゃんと繰り上がり処理されていた。

リファレンスにもちゃんと書いてあった。

The month, day, hour, min, sec, and nsec values may be outside their usual ranges and will be normalized during the conversion. For example, October 32 converts to November 1.

以下のように実行することができる。

package main

import (
	"fmt"
	"time"
)

func main() {

	// 月/日の繰り上がり
	fmt.Println(time.Date(2018, 14, 1, 0, 0, 0, 0, time.UTC).Format("2006-01-02 15:04:05")) // 2019-02-01 00:00:00
	fmt.Println(time.Date(2018, 1, 40, 0, 0, 0, 0, time.UTC).Format("2006-01-02 15:04:05")) // 2018-02-09 00:00:00

	// 時/分/秒/ナノ秒の繰り上がり
	fmt.Println(time.Date(2018, 1, 1, 26, 0, 0, 0, time.UTC).Format("2006-01-02 15:04:05"))             // 2018-01-02 02:00:00
	fmt.Println(time.Date(2018, 1, 1, 0, 80, 0, 0, time.UTC).Format("2006-01-02 15:04:05"))             // 2018-01-01 01:20:00
	fmt.Println(time.Date(2018, 1, 1, 0, 0, 80, 0, time.UTC).Format("2006-01-02 15:04:05"))             // 2018-01-01 00:01:20
	fmt.Println(time.Date(2018, 1, 1, 0, 0, 0, 2000*1000*1000, time.UTC).Format("2006-01-02 15:04:05")) // 2018-01-01 00:00:02

	// 全部
	fmt.Println(time.Date(2018, 13, 32, 24, 60, 60, 1000*1000*1000, time.UTC).Format("2006-01-02 15:04:05")) // 2019-02-02 01:01:01
}

自分の用途では27時とかを繰り上がりしたかったので、便利だった。