Time (time 1.2 API)

java.lang.Object
- cn.com.caoyue.util.time.Time

```
public class Time
extends Object
```
时间处理工具
这个类用作时间处理，支持时间戳转换、时区转换、格式化时间解析与输出和时间加减功能
这个类直接定义出来的是一个时间点，要定义时间差，请使用 DeltaTime 子类
注意：如果没有定义，默认的时区将为 CCT(GMT +8:00)
注意：毫秒将被另外计算而不会算入时间戳中，对毫秒的处理很不完善而且容易丢失，不建议使用毫秒

另请参阅:

GitHub

嵌套类概要

嵌套类
限定符和类型	类和说明
`static class`	`Time.DeltaTime` 时间差值这个类表示一个时间差值，它表示一段时间，用于时间加减时的参数由于每个月的天数不一样，所以此类没有 month 和 year 属性你可以传入一个非法值，比如 0天29小时288分钟300秒，这个类会自动纠正成 1天9小时33分钟0秒时间差值的正负由时间戳的正负或者天数的正负决定
`static class`	`Time.Field` 属性列表用于 set, get, add, minus 函数的参数
`static class`	`Time.TimeZone` 国际时间缩写列表不支持夏令时
`static class`	`Time.Week` 星期列表 getWeek() 的返回值

构造器概要

构造器
构造器和说明
`Time()` 构造一个空的时间处理工具默认定义的时间是 1970 年 1 月 1 日 0:00:00.000 CCT(GMT +8:00)
`Time(int year, int month, int day, int hour, int minute, int second)` 用给定的时间构造时间处理工具注意：默认时区为 CCT(GMT +8:00)
`Time(int year, int month, int day, int hour, int minute, int second, int timeZone)` 用给定的时间和时区构造时间处理工具
`Time(long timeStamp)` 用已知的时间戳构造一个时间处理工具注意：默认的时区为 CCT(GMT +8:00)
`Time(long timeStamp, int timeZone)` 用已知的时间戳和给定的时区构造一个时间处理工具
`Time(String time, String format)` 格式化解析时间字符串。
`Time(Time origTime)` 复制一个时间处理工具此函数的原理是将原时间的时间戳与时区进行复制，然后重新计算其他数值

方法概要

All Methods Static Methods Instance Methods Concrete Methods 已过时的方法
限定符和类型	方法和说明
`Time`	`add(int field, int value)` 给 int 属性加一个数值
`Time`	`add(long field, long value)` 给 long 属性加一个数值
`Time`	`add(Time.DeltaTime data)` 时间加将当前时间与一个时间差相加，返回结果
`static int`	`daysOfMonth(int year, int month)` 获取某年中的某个月的天数，如果对应月份不存在则抛出 IllegalArgumentException 异常
`static int`	`daysOfYear(int year)` 获取某年的总天数
`boolean`	`equals(Time subTime)` 比较两个时间是否相等仅仅比较两个时间的时间戳
`String`	`format(String format)` 时间格式化为字符串例：输入yyyy年MM月dd日 hh:mm:ss 则返回2015年10月14日 08:00:00
`int`	`get(int field)` 获取 int 属性的值
`long`	`get(long field)` 获取 long 属性的值
`int`	`getDay()`
`int`	`getDayOfYear()` 取当天是当年第几天
`int`	`getHour()`
`int`	`getMinute()`
`int`	`getMonth()`
`int`	`getSecond()`
`long`	`getTimeStamp()` 取时间戳
`int`	`getTimeZone()`
`int`	`getWeek()` 取星期几
`int`	`getWeekOfYear()` 取当周是当年第几周注意：每年的第一个星期一所在的星期被认为是这一年的第一周
`int`	`getYear()`
`static boolean`	`isLeapYear(int year)` 判断一年是否为闰年
`Time`	`minus(int field, int value)` 给 int 属性减一个数值
`Time`	`minus(long field, long value)` 给 long 属性减一个数值
`Time`	`minus(Time.DeltaTime data)` 时间减将当前时间与一个时间差相减，返回结果
`Time.DeltaTime`	`minus(Time data)` 时间减将当前时间与另一个时间相减，返回结果
`void`	`parse(String time, String format)` 时间格式化解析例：输入yyyy年MM月dd日 hh:mm:ss 与 2015年10月14日 08:00:00 来设置时间注意：默认时间戳为 CCT(GMT +8:00)
`static long`	`secondsOfMonth(int year, int month)` 获取某年中的某月的总秒数，对应月份不存在则抛出 IllegalArgumentException 异常
`static long`	`secondsOfYear(int year)` 获取某年的总秒数
`void`	`set(int field, int value)` 设置 int 属性的值
`void`	`set(int year, int month, int day, int hour, int minute, int second)` 以给定的时间设置时间
`void`	`set(long timeStamp)` 以给定时间戳设置时间
`void`	`set(long field, long value)` 设置 long 属性的值
`void`	`setDay(int day)`
`void`	`setHour(int hour)`
`void`	`setMicroSecond(int microSecond)`
`void`	`setMinute(int minute)`
`void`	`setMonth(int month)`
`void`	`setSecond(int second)`
`void`	`setTimeStamp(long timeStamp)`
`void`	`setTimeZone(int timeZone)`
`void`	`setTimeZone(String timeZone)` 已过时。请使用 setTimeZone(int) 与 TimeZone 子类代替。
`void`	`setYear(int year)`
`String`	`toString()` 转换为字符串相当于 format("yyyy-MM-dd HH:mm:ss")
`String`	`toString(String format)` 转换为字符串相当于 format(String format)

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- 构造器详细资料
  - Time
```
public Time()
```
    构造一个空的时间处理工具
    默认定义的时间是 1970 年 1 月 1 日 0:00:00.000 CCT(GMT +8:00)
  - Time
```
public Time(Time origTime)
```
    复制一个时间处理工具
    此函数的原理是将原时间的时间戳与时区进行复制，然后重新计算其他数值
    
    参数:
    
    origTime - 被复制的时间
  - Time
```
public Time(long timeStamp)
```
    用已知的时间戳构造一个时间处理工具
    注意：默认的时区为 CCT(GMT +8:00)
    
    参数:
    
    timeStamp - 时间戳
  - Time
```
public Time(long timeStamp,
            int timeZone)
```
    用已知的时间戳和给定的时区构造一个时间处理工具
    
    参数:
    
    timeStamp - 时间戳
    
    timeZone - 时区
  - Time
```
public Time(int year,
            int month,
            int day,
            int hour,
            int minute,
            int second)
```
    用给定的时间构造时间处理工具
    注意：默认时区为 CCT(GMT +8:00)
    
    参数:
    
    year - 年
    
    month - 月
    
    day - 日
    
    hour - 时
    
    minute - 分
    
    second - 秒
  - Time
```
public Time(int year,
            int month,
            int day,
            int hour,
            int minute,
            int second,
            int timeZone)
```
    用给定的时间和时区构造时间处理工具
    
    参数:
    
    year - 年
    
    month - 月
    
    day - 日
    
    hour - 时
    
    minute - 分
    
    second - 秒
    
    timeZone - 时区
  - Time
```
public Time(String time,
            String format)
```
    格式化解析时间字符串。并构造时间处理工具
    例：输入yyyy年MM月dd日 hh:mm:ss 与 2015年10月14日 08:00:00 来设置时间
    注意：默认的时区是 CCT(GMT +8:00)
    
    参数:
    
    time - 时间字符串
    
    format - 年:y 月:M 日:d 时:h(12制)/H(24值) 分:m 秒:s 毫秒:S
- 方法详细资料
  - isLeapYear
```
public static boolean isLeapYear(int year)
```
    判断一年是否为闰年
    
    参数:
    
    year - 需要判断的年份
    
    返回:
    
    闰年则为 true
  - daysOfMonth
```
public static int daysOfMonth(int year,
                              int month)
```
    获取某年中的某个月的天数，如果对应月份不存在则抛出 IllegalArgumentException 异常
    
    参数:
    
    year - 年
    
    month - 月
    
    返回:
    
    该月的天数
    
    抛出:
    
    IllegalArgumentException - 找不到月份
  - daysOfYear
```
public static int daysOfYear(int year)
```
    获取某年的总天数
    
    参数:
    
    year - 年
    
    返回:
    
    这一年的天数
  - secondsOfMonth
```
public static long secondsOfMonth(int year,
                                  int month)
```
    获取某年中的某月的总秒数，对应月份不存在则抛出 IllegalArgumentException 异常
    
    参数:
    
    year - 年
    
    month - 月
    
    返回:
    
    该月的秒数
    
    抛出:
    
    IllegalArgumentException - 找不到月份
  - secondsOfYear
```
public static long secondsOfYear(int year)
```
    获取某年的总秒数
    
    参数:
    
    year - 年
    
    返回:
    
    这一年的总秒数
  - equals
```
public boolean equals(Time subTime)
```
    比较两个时间是否相等
    仅仅比较两个时间的时间戳
    
    参数:
    
    subTime - 被比较的时间
    
    返回:
    
    相等则为 true
  - toString
```
public String toString()
```
    转换为字符串
    相当于 format("yyyy-MM-dd HH:mm:ss")
    
    覆盖:
    
    toString 在类中 Object
    
    返回:
    
    转换成的字符串
  - toString
```
public String toString(String format)
```
    转换为字符串
    相当于 format(String format)
    
    参数:
    
    format - 格式字符串，参考 format(String format)
    
    返回:
    
    格式化好的字符串
  - set
```
public void set(long timeStamp)
```
    以给定时间戳设置时间
    
    参数:
    
    timeStamp - 时间戳
  - setTimeStamp
```
public void setTimeStamp(long timeStamp)
```
  - set
```
public void set(int year,
                int month,
                int day,
                int hour,
                int minute,
                int second)
```
    以给定的时间设置时间
    
    参数:
    
    year - 年
    
    month - 月
    
    day - 日
    
    hour - 时
    
    minute - 分
    
    second - 秒
  - setYear
```
public void setYear(int year)
```
  - getYear
```
public int getYear()
```
  - setMonth
```
public void setMonth(int month)
```
  - getMonth
```
public int getMonth()
```
  - setDay
```
public void setDay(int day)
```
  - getDay
```
public int getDay()
```
  - setHour
```
public void setHour(int hour)
```
  - getHour
```
public int getHour()
```
  - setMinute
```
public void setMinute(int minute)
```
  - getMinute
```
public int getMinute()
```
  - setSecond
```
public void setSecond(int second)
```
  - getSecond
```
public int getSecond()
```
  - getWeek
```
public int getWeek()
```
    取星期几
    
    返回:
    
    星期几
  - getWeekOfYear
```
public int getWeekOfYear()
```
    取当周是当年第几周
    注意：每年的第一个星期一所在的星期被认为是这一年的第一周
    
    返回:
    
    第几周
  - getDayOfYear
```
public int getDayOfYear()
```
    取当天是当年第几天
    
    返回:
    
    当天是当年的天数
  - getTimeStamp
```
public long getTimeStamp()
```
    取时间戳
    
    返回:
    
    时间戳
  - add
```
public Time add(Time.DeltaTime data)
```
    时间加
    将当前时间与一个时间差相加，返回结果
    
    参数:
    
    data - 时间差
    
    返回:
    
    相加的结果 this + data
  - minus
```
public Time.DeltaTime minus(Time data)
```
    时间减
    将当前时间与另一个时间相减，返回结果
    
    参数:
    
    data - 需要相减的另一个时间
    
    返回:
    
    相减的结果 this - data
  - minus
```
public Time minus(Time.DeltaTime data)
```
    时间减
    将当前时间与一个时间差相减，返回结果
    
    参数:
    
    data - 时间差
    
    返回:
    
    相减的结果 this - data
  - add
```
public Time add(int field,
                int value)
```
    给 int 属性加一个数值
    
    参数:
    
    field - 属性，必须是 cn.com.caoyue.util.time.Time.Field 中的 int 值
    
    value - 增加的数值
    
    返回:
    
    结果 this + value
    
    抛出:
    
    IllegalArgumentException - 找不到属性
    
    另请参阅:
    
    Time.Field
  - add
```
public Time add(long field,
                long value)
```
    给 long 属性加一个数值
    
    参数:
    
    field - 属性，必须是 cn.com.caoyue.util.time.Time.Field 中的 long 值
    
    value - 增加的数值
    
    返回:
    
    结果 this + value
    
    抛出:
    
    IllegalArgumentException - 找不到属性
    
    另请参阅:
    
    Time.Field
  - minus
```
public Time minus(int field,
                  int value)
```
    给 int 属性减一个数值
    
    参数:
    
    field - 属性，必须是 cn.com.caoyue.util.time.Time.Field 中的 int 值
    
    value - 减少的数值
    
    返回:
    
    结果 this - value
    
    抛出:
    
    IllegalArgumentException - 找不到属性
    
    另请参阅:
    
    Time.Field
  - minus
```
public Time minus(long field,
                  long value)
```
    给 long 属性减一个数值
    
    参数:
    
    field - 属性，必须是 cn.com.caoyue.util.time.Time.Field 中的 long 值
    
    value - 减少的数值
    
    返回:
    
    结果 this - value
    
    抛出:
    
    IllegalArgumentException - 找不到属性
    
    另请参阅:
    
    Time.Field
  - parse
```
public void parse(String time,
                  String format)
```
    时间格式化解析
    例：输入yyyy年MM月dd日 hh:mm:ss 与 2015年10月14日 08:00:00 来设置时间
    注意：默认时间戳为 CCT(GMT +8:00)
    
    参数:
    
    time - 时间字符串
    
    format - 年:y 月:M 日:d 时:h(12制)/H(24值) 分:m 秒:s 毫秒:S
  - format
```
public String format(String format)
```
    时间格式化为字符串
    例：输入yyyy年MM月dd日 hh:mm:ss 则返回2015年10月14日 08:00:00
    
    参数:
    
    format - 格式
    yyyy 年
    y 年
    MM 月（不足 10 时补 0）
    M 月
    dd 日（不足 10 时补 0）
    d 日（不足 10 时补 0）
    HH 时（24 小时制，不足 10 时补 0）
    H 时（24 小时制，不足 10 时补 0）
    hh 时（12 小时制，不足 10 时补 0）
    h 时（12 小时制，不足 10 时补 0）
    mm 分（不足 10 时补 0）
    m 分
    ss 秒（不足 10 时补 0）
    s 秒
    SS 毫秒（不足 10 时补 0）
    S 毫秒
    
    返回:
    
    格式化时间文本
  - setTimeZone
```
public void setTimeZone(String timeZone)
```
    已过时。请使用 setTimeZone(int) 与 TimeZone 子类代替。
    
    时区切换
    
    参数:
    
    timeZone - 时区名字。eg:GMT,UTC ,CCT ,JST等。对时间进行转换。默认CCT。
    
    另请参阅:
    
    Time.TimeZone
  - setTimeZone
```
public void setTimeZone(int timeZone)
```
  - getTimeZone
```
public int getTimeZone()
```
  - setMicroSecond
```
public void setMicroSecond(int microSecond)
```
  - get
```
public int get(int field)
```
    获取 int 属性的值
    
    参数:
    
    field - 属性，必须是 cn.com.caoyue.util.time.Time.Field 中的 int 值
    
    返回:
    
    该属性的值
    
    抛出:
    
    IllegalArgumentException - 找不到属性
    
    另请参阅:
    
    Time.Field
  - get
```
public long get(long field)
```
    获取 long 属性的值
    
    参数:
    
    field - 属性，必须是 cn.com.caoyue.util.time.Time.Field 中的 long 值
    
    返回:
    
    该属性的值
    
    抛出:
    
    IllegalArgumentException - 找不到该属性
    
    另请参阅:
    
    Time.Field
  - set
```
public void set(int field,
                int value)
```
    设置 int 属性的值
    
    参数:
    
    field - 属性，必须是 cn.com.caoyue.util.time.Time.Field 中的 int 值
    
    value - 该属性的值
    
    抛出:
    
    IllegalArgumentException - 找不到该属性
    
    另请参阅:
    
    Time.Field
  - set
```
public void set(long field,
                long value)
```
    设置 long 属性的值
    
    参数:
    
    field - 属性，必须是 cn.com.caoyue.util.time.Time.Field 中的 long 值
    
    value - 该属性的值
    
    抛出:
    
    IllegalArgumentException - 找不到该属性
    
    另请参阅:
    
    Time.Field

类 Time

嵌套类概要

构造器概要

方法概要

从类继承的方法 java.lang.Object

构造器详细资料

Time

Time

Time

Time

Time

Time

Time

方法详细资料

isLeapYear

daysOfMonth

daysOfYear

secondsOfMonth

secondsOfYear

equals

toString

toString

set

setTimeStamp

set

setYear

getYear

setMonth

getMonth

setDay

getDay

setHour

getHour

setMinute

getMinute

setSecond

getSecond

getWeek

getWeekOfYear

getDayOfYear

getTimeStamp

add

minus

minus

add

add

minus

minus

parse

format

setTimeZone

setTimeZone

getTimeZone

setMicroSecond

get

get

set

set