| 限定符和类型 | 类和说明 |
|---|---|
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)
复制一个时间处理工具
此函数的原理是将原时间的时间戳与时区进行复制,然后重新计算其他数值 |
| 限定符和类型 | 方法和说明 |
|---|---|
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) |
public Time()
public Time(Time origTime)
origTime - 被复制的时间public Time(long timeStamp)
timeStamp - 时间戳public Time(long timeStamp,
int timeZone)
timeStamp - 时间戳timeZone - 时区public Time(int year,
int month,
int day,
int hour,
int minute,
int second)
year - 年month - 月day - 日hour - 时minute - 分second - 秒public Time(int year,
int month,
int day,
int hour,
int minute,
int second,
int timeZone)
year - 年month - 月day - 日hour - 时minute - 分second - 秒timeZone - 时区public static boolean isLeapYear(int year)
year - 需要判断的年份public static int daysOfMonth(int year,
int month)
year - 年month - 月IllegalArgumentException - 找不到月份public static int daysOfYear(int year)
year - 年public static long secondsOfMonth(int year,
int month)
year - 年month - 月IllegalArgumentException - 找不到月份public static long secondsOfYear(int year)
year - 年public boolean equals(Time subTime)
subTime - 被比较的时间public String toString()
public String toString(String format)
format - 格式字符串,参考 format(String format)public void set(long timeStamp)
timeStamp - 时间戳public void setTimeStamp(long timeStamp)
public void set(int year,
int month,
int day,
int hour,
int minute,
int second)
year - 年month - 月day - 日hour - 时minute - 分second - 秒public void setYear(int year)
public int getYear()
public void setMonth(int month)
public int getMonth()
public void setDay(int day)
public int getDay()
public void setHour(int hour)
public int getHour()
public void setMinute(int minute)
public int getMinute()
public void setSecond(int second)
public int getSecond()
public int getWeek()
public int getWeekOfYear()
public int getDayOfYear()
public long getTimeStamp()
public Time add(Time.DeltaTime data)
data - 时间差public Time.DeltaTime minus(Time data)
data - 需要相减的另一个时间public Time minus(Time.DeltaTime data)
data - 时间差public Time add(int field, int value)
field - 属性,必须是 cn.com.caoyue.util.time.Time.Field 中的 int 值value - 增加的数值IllegalArgumentException - 找不到属性Time.Fieldpublic Time add(long field, long value)
field - 属性,必须是 cn.com.caoyue.util.time.Time.Field 中的 long 值value - 增加的数值IllegalArgumentException - 找不到属性Time.Fieldpublic Time minus(int field, int value)
field - 属性,必须是 cn.com.caoyue.util.time.Time.Field 中的 int 值value - 减少的数值IllegalArgumentException - 找不到属性Time.Fieldpublic Time minus(long field, long value)
field - 属性,必须是 cn.com.caoyue.util.time.Time.Field 中的 long 值value - 减少的数值IllegalArgumentException - 找不到属性Time.Fieldpublic void parse(String time, String format)
time - 时间字符串format - 年:y 月:M 日:d 时:h(12制)/H(24值) 分:m 秒:s 毫秒:Spublic String format(String format)
format - 格式public void setTimeZone(String timeZone)
timeZone - 时区名字。eg:GMT,UTC ,CCT ,JST等。对时间进行转换。默认CCT。Time.TimeZonepublic void setTimeZone(int timeZone)
public int getTimeZone()
public void setMicroSecond(int microSecond)
public int get(int field)
field - 属性,必须是 cn.com.caoyue.util.time.Time.Field 中的 int 值IllegalArgumentException - 找不到属性Time.Fieldpublic long get(long field)
field - 属性,必须是 cn.com.caoyue.util.time.Time.Field 中的 long 值IllegalArgumentException - 找不到该属性Time.Fieldpublic void set(int field,
int value)
field - 属性,必须是 cn.com.caoyue.util.time.Time.Field 中的 int 值value - 该属性的值IllegalArgumentException - 找不到该属性Time.Fieldpublic void set(long field,
long value)
field - 属性,必须是 cn.com.caoyue.util.time.Time.Field 中的 long 值value - 该属性的值IllegalArgumentException - 找不到该属性Time.Field