30 Star 385 Fork 59

golang-module / carbon

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
getter.go 9.75 KB
一键复制 编辑 原始数据 按行查看 历史
gouguoyin 提交于 2024-04-09 20:13 . c.IsInvalid() -> c.Error != nil
package carbon
import (
"time"
)
// StdTime gets standard time.Time.
// 获取标准 time.Time
func (c Carbon) StdTime() time.Time {
return c.time.In(c.loc)
}
// DaysInYear gets total days in year like 365.
// 获取本年的总天数
func (c Carbon) DaysInYear() int {
if c.Error != nil {
return 0
}
if c.IsLeapYear() {
return DaysPerLeapYear
}
return DaysPerNormalYear
}
// DaysInMonth gets total days in month like 30.
// 获取本月的总天数
func (c Carbon) DaysInMonth() int {
if c.Error != nil {
return 0
}
return c.EndOfMonth().time.In(c.loc).Day()
}
// MonthOfYear gets month of year like 12.
// 获取本年的第几月
func (c Carbon) MonthOfYear() int {
if c.Error != nil {
return 0
}
return int(c.StdTime().Month())
}
// DayOfYear gets day of year like 365.
// 获取本年的第几天
func (c Carbon) DayOfYear() int {
if c.Error != nil {
return 0
}
return c.StdTime().YearDay()
}
// DayOfMonth gets day of month like 30.
// 获取本月的第几天
func (c Carbon) DayOfMonth() int {
if c.Error != nil {
return 0
}
return c.StdTime().Day()
}
// DayOfWeek gets day of week like 6.
// 获取本周的第几天
func (c Carbon) DayOfWeek() int {
if c.Error != nil {
return 0
}
day := int(c.StdTime().Weekday())
if day == 0 {
return DaysPerWeek
}
return day
}
// WeekOfYear gets week of year like 1, see https://en.wikipedia.org/wiki/ISO_8601#Week_dates.
// 获取本年的第几周
func (c Carbon) WeekOfYear() int {
if c.Error != nil {
return 0
}
_, week := c.StdTime().ISOWeek()
return week
}
// WeekOfMonth gets week of month like 1.
// 获取本月的第几周
func (c Carbon) WeekOfMonth() int {
if c.Error != nil {
return 0
}
days := c.Day() + c.StartOfMonth().DayOfWeek() - 1
if days%DaysPerWeek == 0 {
return days / DaysPerWeek
}
return days/DaysPerWeek + 1
}
// DateTime gets current year, month, day, hour, minute, and second like 2020, 8, 5, 13, 14, 15.
// 获取当前年、月、日、时、分、秒
func (c Carbon) DateTime() (year, month, day, hour, minute, second int) {
if c.Error != nil {
return
}
year, month, day = c.Date()
hour, minute, second = c.Time()
return year, month, day, hour, minute, second
}
// DateTimeMilli gets current year, month, day, hour, minute, second and millisecond like 2020, 8, 5, 13, 14, 15, 999.
// 获取当前年、月、日、时、分、秒、毫秒
func (c Carbon) DateTimeMilli() (year, month, day, hour, minute, second, millisecond int) {
if c.Error != nil {
return
}
year, month, day, hour, minute, second = c.DateTime()
return year, month, day, hour, minute, second, c.Millisecond()
}
// DateTimeMicro gets current year, month, day, hour, minute, second and microsecond like 2020, 8, 5, 13, 14, 15, 999999.
// 获取当前年、月、日、时、分、秒、微秒
func (c Carbon) DateTimeMicro() (year, month, day, hour, minute, second, microsecond int) {
if c.Error != nil {
return
}
year, month, day, hour, minute, second = c.DateTime()
return year, month, day, hour, minute, second, c.Microsecond()
}
// DateTimeNano gets current year, month, day, hour, minute, second and nanosecond like 2020, 8, 5, 13, 14, 15, 999999999.
// 获取当前年、月、日、时、分、秒、纳秒
func (c Carbon) DateTimeNano() (year, month, day, hour, minute, second, nanosecond int) {
if c.Error != nil {
return
}
year, month, day, hour, minute, second = c.DateTime()
return year, month, day, hour, minute, second, c.Nanosecond()
}
// Date gets current year, month, and day like 2020, 8, 5.
// 获取当前年、月、日
func (c Carbon) Date() (year, month, day int) {
if c.Error != nil {
return
}
var tm time.Month
year, tm, day = c.StdTime().Date()
return year, int(tm), day
}
// DateMilli gets current year, month, day and millisecond like 2020, 8, 5, 999.
// 获取当前年、月、日、毫秒
func (c Carbon) DateMilli() (year, month, day, millisecond int) {
if c.Error != nil {
return
}
year, month, day = c.Date()
return year, month, day, c.Millisecond()
}
// DateMicro gets current year, month, day and microsecond like 2020, 8, 5, 999999.
// 获取当前年、月、日、微秒
func (c Carbon) DateMicro() (year, month, day, microsecond int) {
if c.Error != nil {
return
}
year, month, day = c.Date()
return year, month, day, c.Microsecond()
}
// DateNano gets current year, month, day and nanosecond like 2020, 8, 5, 999999999.
// 获取当前年、月、日、纳秒
func (c Carbon) DateNano() (year, month, day, nanosecond int) {
if c.Error != nil {
return
}
year, month, day = c.Date()
return year, month, day, c.Nanosecond()
}
// Time gets current hour, minute, and second like 13, 14, 15.
// 获取当前时、分、秒
func (c Carbon) Time() (hour, minute, second int) {
if c.Error != nil {
return
}
return c.StdTime().Clock()
}
// TimeMilli gets current hour, minute, second and millisecond like 13, 14, 15, 999.
// 获取当前时、分、秒、毫秒
func (c Carbon) TimeMilli() (hour, minute, second, millisecond int) {
if c.Error != nil {
return
}
hour, minute, second = c.Time()
return hour, minute, second, c.Millisecond()
}
// TimeMicro gets current hour, minute, second and microsecond like 13, 14, 15, 999999.
// 获取当前时、分、秒、微秒
func (c Carbon) TimeMicro() (hour, minute, second, microsecond int) {
if c.Error != nil {
return
}
hour, minute, second = c.Time()
return hour, minute, second, c.Microsecond()
}
// TimeNano gets current hour, minute, second and nanosecond like 13, 14, 15, 999999999.
// 获取当前时、分、秒、纳秒
func (c Carbon) TimeNano() (hour, minute, second, nanosecond int) {
if c.Error != nil {
return
}
hour, minute, second = c.Time()
return hour, minute, second, c.Nanosecond()
}
// Century gets current century like 21.
// 获取当前世纪
func (c Carbon) Century() int {
if c.Error != nil {
return 0
}
return c.Year()/YearsPerCentury + 1
}
// Decade gets current decade like 20.
// 获取当前年代
func (c Carbon) Decade() int {
if c.Error != nil {
return 0
}
return c.Year() % YearsPerCentury / YearsPerDecade * YearsPerDecade
}
// Year gets current year like 2020.
// 获取当前年
func (c Carbon) Year() int {
if c.Error != nil {
return 0
}
return c.StdTime().Year()
}
// Quarter gets current quarter like 3.
// 获取当前季度
func (c Carbon) Quarter() (quarter int) {
if c.Error != nil {
return
}
month := c.Month()
switch {
case month >= 10:
quarter = 4
case month >= 7:
quarter = 3
case month >= 4:
quarter = 2
case month >= 1:
quarter = 1
}
return
}
// Month gets current month like 8.
// 获取当前月
func (c Carbon) Month() int {
return c.MonthOfYear()
}
// Week gets current week like 6, start from 0.
// 获取当前周(从0开始)
func (c Carbon) Week() int {
if c.Error != nil {
return -1
}
return (c.DayOfWeek() + DaysPerWeek - int(c.weekStartsAt)) % DaysPerWeek
}
// Day gets current day like 5.
// 获取当前日
func (c Carbon) Day() int {
return c.DayOfMonth()
}
// Hour gets current hour like 13.
// 获取当前小时
func (c Carbon) Hour() int {
if c.Error != nil {
return 0
}
return c.StdTime().Hour()
}
// Minute gets current minute like 14.
// 获取当前分钟数
func (c Carbon) Minute() int {
if c.Error != nil {
return 0
}
return c.StdTime().Minute()
}
// Second gets current second like 15.
// 获取当前秒数
func (c Carbon) Second() int {
if c.Error != nil {
return 0
}
return c.StdTime().Second()
}
// Millisecond gets current millisecond like 999.
// 获取当前毫秒数
func (c Carbon) Millisecond() int {
if c.Error != nil {
return 0
}
return c.StdTime().Nanosecond() / 1e6
}
// Microsecond gets current microsecond like 999999.
// 获取当前微秒数
func (c Carbon) Microsecond() int {
if c.Error != nil {
return 0
}
return c.StdTime().Nanosecond() / 1e3
}
// Nanosecond gets current nanosecond like 999999999.
// 获取当前纳秒数
func (c Carbon) Nanosecond() int {
if c.Error != nil {
return 0
}
return c.StdTime().Nanosecond()
}
// Timestamp gets timestamp with second like 1596604455.
// 输出秒级时间戳
func (c Carbon) Timestamp() int64 {
if c.Error != nil {
return 0
}
return c.StdTime().Unix()
}
// TimestampMilli gets timestamp with millisecond like 1596604455000.
// 获取毫秒级时间戳
func (c Carbon) TimestampMilli() int64 {
if c.Error != nil {
return 0
}
t := c.StdTime()
return t.Unix()*1e3 + int64(t.Nanosecond())/1e6
}
// TimestampMicro gets timestamp with microsecond like 1596604455000000.
// 获取微秒级时间戳
func (c Carbon) TimestampMicro() int64 {
if c.Error != nil {
return 0
}
t := c.StdTime()
return t.Unix()*1e6 + int64(t.Nanosecond())/1e3
}
// TimestampNano gets timestamp with nanosecond like 1596604455000000000.
// 获取纳秒级时间戳
func (c Carbon) TimestampNano() int64 {
if c.Error != nil {
return 0
}
return c.StdTime().UnixNano()
}
// Location gets location name like "PRC".
// 获取位置
func (c Carbon) Location() string {
if c.Error != nil {
return ""
}
return c.loc.String()
}
// Timezone gets timezone name like "CST".
// 获取时区
func (c Carbon) Timezone() string {
if c.Error != nil {
return ""
}
name, _ := c.StdTime().Zone()
return name
}
// Offset gets offset seconds from the UTC timezone like 28800.
// 获取距离UTC时区的偏移量,单位秒
func (c Carbon) Offset() int {
if c.Error != nil {
return 0
}
_, offset := c.StdTime().Zone()
return offset
}
// Locale gets locale name like "zh-CN".
// 获取语言区域
func (c Carbon) Locale() string {
if c.Error != nil {
return ""
}
return c.lang.locale
}
// Age gets age like 18.
// 获取年龄
func (c Carbon) Age() int {
if c.Error != nil {
return 0
}
now := c.Now()
if c.IsSetTestNow() {
now = CreateFromTimestampNano(c.testNow, c.Location())
}
if c.TimestampNano() > now.TimestampNano() {
return 0
}
return int(c.DiffInYears(now))
}
Go
1
https://gitee.com/golang-module/carbon.git
git@gitee.com:golang-module/carbon.git
golang-module
carbon
carbon
master

搜索帮助