Time 包使用


简介

time 顾名思义,该包提供了时间相关的操作function,使用需要 import "time"


数据类型

主要数据类型有以下几种

type Time struct{       // 时间主要结构
    ... // 内容省略
}

// A Month specifies a month of the year (January = 1, ...).
type Month int        // 月份别名,主要为了实现月份的输出 实现了 Stringer 接口

// A Weekday specifies a day of the week (Sunday = 0, ...).
type WeekDay int       // 一周中的第几天, 实现了 Stringer 接口

type Duration int64     // 时间精度,最小精度为纳秒

MonthWeekDay没有相关的API,只为了输出string类型实现了 Stringer 接口,主要timeTimeDuration


API

time 包 API

func Now() Time     // 返回当前时间Time

func Unix(sec int64, nsec int64) Time // 返回sec(时间戳)、nsec(纳秒范围)的时间描述Time 

func Since(t Time) Duration // 返回指定时间距离当前时间已经过去的时间

func Until(t Time) Duration // 返回指定时间局当前时间还有的时间

func Date(year int, month Month, day, hour, min, sec, nsec int, loc *Location) Time // 指定日期、时间、时区,返回定时间Time

例子:
now := time.Now() // 获取当前时间
dateTime := time.Date(2018, 10, 10, 0, 0, 0, 0, time.Local) // 获取2018年10月10号0点0分0秒的时间Time

Time API

func (t Time) Unix() int64 // 返回时间戳,精度秒

func (t Time) UnixNano() int64 // 返回时间戳,精度纳秒

func (t Time) UTC() Time // 返回 UTC 时区的时间Time

func (t Time) After(u Time) bool // 检查时间是否在时间 u 之后

func (t Time) Before(u Time) bool // 检查时间是否在时间 u 之前

func (t Time) Equal(u Time) bool // 检查时间是否与 u 相同

func (t Time) IsZero() bool // 检查是否为零时,即格林威治时间0点

func (t Time) Date() (year int, month Month, day int)  // 返回年月日

func (t Time) Year() int  // 返回年

func (t Time) Month() Month // 返回月

func (t Time) Day() int // 返回日

func (t Time) Weekday() Weekday // 返回一周中的第几天

func (t Time) ISOWeek() (year, week int) // 返回年和当前一年中第几周

func (t Time) Clock() (hour, min, sec int) // 返回时分秒

func (t Time) Hour() int  // 返回小时

func (t Time) Minute() int  // 返回分钟

func (t Time) Second() int  // 返回秒

func (t Time) Nanosecond() int // 返回纳秒部分值

func (t Time) YearDay() int  // 返回一年中的第几天

func (t Time) Add(d Duration) Time // 返回 time +d 的时间

func (t Time) Sub(u Time) Duration // 返回 time -d 的时间

func (t Time) AddDate(years int, months int, days int) Time // 返回加上指定年、月、日的时间

func (t Time) Local() Time // 放回当前时区的time

func (t Time) In(loc *Location) Time // 设置时区

func (t Time) Location() *Location // 返回时区信息

例子:
// 获取当前0点0分0秒的时间
now := time.Now()
hour, minute, second := now.Clock()
dayStartTimeStamp := now.Add(time.Duration(-1*(3600*hour+60*minute+second)) * time.Second)
addDate := now.AddDate(-1, 1, 1)
fmt.Println("Sub:", now.Sub(addDate))

Duration API

func (d Duration) Nanoseconds() int64 // 返回纳秒级精度数据

func (d Duration) Seconds() float64 // 返回秒级精度数据

func (d Duration) Minutes() float64 // 返回分钟级精度数据

func (d Duration) Hours() float64 // 返回小时级精度数据


Exmaple

package main

import (
    "fmt"
    "time"
)

func main() {

    now := time.Now()
    fmt.Println("Now Time:", now) // 系统设置的时区时间
    fmt.Println("Now Timestamp:", now.Unix())
    fmt.Println("Now Timestamp Nano:", now.UnixNano())
    fmt.Println("Now UTC:", now.UTC()) // UTC 时区

    year, week := now.ISOWeek()
    fmt.Printf("year:%v week:%v\n", year, week)

    hour, minute, second := now.Clock()
    fmt.Printf("%v:%v:%v\n", hour, minute, second)
    fmt.Println("Houre:", now.Hour())
    fmt.Println("Minute", now.Minute())
    fmt.Println("Second", now.Second())
    fmt.Println("NanoSecond:", now.Nanosecond())

    // 获取当天0点的时间戳
    dayStartTimeStamp := now.Add(time.Duration(-1*(3600*hour+60*minute+second)) * time.Second)
    fmt.Println(dayStartTimeStamp)

    addDate := now.AddDate(-1, 1, 1)
    fmt.Println("AddDate:", addDate)

    fmt.Println("Sub:", now.Sub(addDate).Hours())

    // 获取指定日期的时间戳
    curTime := time.Date(2018, 10, 10, 0, 0, 0, 0, time.Local)
    fmt.Println(curTime)
    // 0点时间
    zeroTime := time.Date(1, 1, 1, 0, 0, 0, 0, time.UTC)
    fmt.Println("zero:", zeroTime.IsZero())

    fmt.Println(int(time.Since(curTime)) / 1e9)
    fmt.Println(time.Since(curTime).Seconds())
    fmt.Println(int(time.Until(curTime)) / 1e9)
}

// 输出--时间相关,每次输出是时间点都不一样
Now Time: 2018-10-14 16:21:11.575369147 +0800 CST m=+0.002621862
Now Timestamp: 1539505271
Now Timestamp Nano: 1539505271575369147
Now UTC: 2018-10-14 08:21:11.575369147 +0000 UTC
year:2018 week:41
16:21:11
Houre: 16
Minute 21
Second 11
NanoSecond: 575369147
2018-10-14 00:00:00.575369147 +0800 CST m=-58870.997378138
AddDate: 2017-11-15 16:21:11.575369147 +0800 CST
Sub: 7992
2018-10-10 00:00:00 +0800 CST
zero: true
404471
404471.576116895
-404471

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,242评论 5 459
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,769评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,484评论 0 319
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,133评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,007评论 4 355
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,080评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,496评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,190评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,464评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,549评论 2 309
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,330评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,205评论 3 312
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,567评论 3 298
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,889评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,160评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,475评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,650评论 2 335

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,494评论 18 139
  • 惟江上之清风,与山间之明月,耳得之为声,目遇之成色,取之不禁,用之不竭,是造物者之无尽藏也,而吾与子之所共适。
    子木聿阅读 734评论 0 0
  • “沙沙……”,风吹动树叶发出响声,叶子摆着,似乎在指引着什么,顺着看下去,一位女子正凝望着这树,风又吹动了她长长的...
    瞑雪_snow阅读 152评论 0 2
  • 想淘淘爸爸(。•́︿•̀。) 淘淘爸爸,我想你了,非常非常想。满屋子都是你的影子,我根本没办法控制自己,有你就是家...
    何牛牛阅读 613评论 2 0
  • 最近社会大众对共享单车的押金问题颇多议论,什么法律法规募集资金不当等。不过,以我亲身体验后,我想说的,如上哦! 摩...
    像一棵开花的树阅读 244评论 5 4