Times (Nutz 1.r.57 API)

java.lang.Object
- org.nutz.lang.Times

```
public abstract class Times
extends Object
```
一些时间相关的帮助函数

作者:

zozoh(zozohtnt@gmail.com)

字段概要

字段
限定符和类型字段和说明

static long T_1D

static long T_1H

static long T_1M

static long T_1S

字段
限定符和类型	字段和说明
`static long`	`T_1D`
`static long`	`T_1H`
`static long`	`T_1M`
`static long`	`T_1S`

构造器概要

构造器
构造器和说明

Times()

构造器
构造器和说明
`Times()`

方法概要

所有方法静态方法具体方法已过时的方法
限定符和类型	方法和说明
`static long`	`ams(String ds)` 根据默认时区计算时间字符串的绝对毫秒数
`static long`	`ams(String ds, TimeZone tz)` 根据字符串得到相对于 "UTC 1970-01-01 00:00:00" 的绝对毫秒数。
`static Calendar`	`C(Date d)` 根据日期对象得到时间
`static Calendar`	`C(long ms)` 根据毫秒数得到时间
`static Calendar`	`C(String ds)` 根据字符串得到时间如果你输入了格式为 "yyyy-MM-dd HH:mm:ss" 那么会匹配到秒如果你输入格式为 "yyyy-MM-dd" 相当于你输入了 "yyyy-MM-dd 00:00:00"
`static int`	`countLeapYear(int year)` 判断某年（不包括自己）之前有多少个闰年
`static Date`	`D(long ms)` 根据毫秒数得到时间
`static Date`	`D(String ds)` 根据字符串得到时间对象
`static int`	`D1970(int yy, int MM, int dd)` 计算一个给定日期，距离 1970 年 1 月 1 日有多少天
`static String`	`format(DateFormat fmt, Date d)` 以给定的时间格式来安全的对时间进行格式化，并返回格式化后所对应的字符串
`static String`	`format(String fmt, Date d)` 以给定的时间格式来安全的对时间进行格式化，并返回格式化后所对应的字符串
`static String`	`formatForRead(Date d)` 将一个时间格式化成容易被人类阅读的格式如果 1 分钟内，打印 Just Now 如果 1 小时内，打印多少分钟如果 1 天之内，打印多少小时之前如果是今年之内，打印月份和日期否则打印月份和年
`static String`	`fromMillis(long mi)` 一段时间长度的毫秒数转换为一个时间长度的字符串 1000 -> 1S 120000 - 2M
`static String`	`fromMillisCN(long mi)` fromMillis的中文版本 1000 -> 1秒 120000 - 2分
`static boolean`	`leapYear(int year)` 判断一年是否为闰年，如果给定年份小于1全部为 false
`static int`	`ms()` 返回当前时间在一天中的毫秒数
`static int`	`ms(Calendar c)` 返回时间对象在一天中的毫秒数
`static long`	`ms(Date d)` 返回时间对象在一天中的毫秒数
`static long`	`ms(String ds, TimeZone tz)` 已过时。 since 1.b.49 util 1.b.51
`static String`	`mss(int ms)` 根据一个当天的绝对毫秒数，得到一个时间字符串，格式为 "HH:mm:ss.EEE"
`static Date`	`now()` 返回服务器当前时间
`static Date`	`parse(DateFormat fmt, String s)` 以给定的时间格式来安全的解析时间字符串，并返回解析后所对应的时间对象
`static Date`	`parse(String fmt, String s)` 以给定的时间格式来安全的解析时间字符串，并返回解析后所对应的时间对象
`static Date`	`parseq(DateFormat fmt, String s)` 以给定的时间格式来安全的解析时间字符串，并返回解析后所对应的时间对象（包裹RuntimeException）
`static Date`	`parseq(String fmt, String s)` 以给定的时间格式来安全的解析时间字符串，并返回解析后所对应的时间对象（包裹RuntimeException）
`static String`	`sD(Date d)` 把时间转换成格式为 yyyy-MM-dd 的字符串
`static String`	`sDT(Date d)` 把时间转换成格式为 yyyy-MM-dd HH:mm:ss 的字符串
`static String`	`sDTms(Date d)` 把时间转换成格式为 y-M-d H:m:s.S 的字符串
`static String`	`sDTms2(Date d)` 把时间转换成格式为 yy-MM-dd HH:mm:ss.SSS 的字符串
`static int`	`sec()` 返回当前时间在一天中的秒数
`static int`	`sec(Date d)` 返回时间对象在一天中的秒数
`static String`	`secs(int sec)` 根据一个当天的绝对秒数，得到一个时间字符串，格式为 "HH:mm:ss"
`static String`	`sT(int sec)` 将一个秒数（天中），转换成一个格式为 HH:mm:ss 的字符串
`static String`	`sTmin(int sec)` 将一个秒数（天中），转换成一个格式为 HH:mm 的字符串（精确到分钟）
`static int[]`	`T(int sec)` 将一个秒数（天中），转换成一个如下格式的数组: [0-23][0-59[-059]
`static int`	`T(String ts)` 将一个时间字符串，转换成一个一天中的绝对秒数
`static long`	`toMillis(String tstr)` 方便的把时间换算成毫秒数支持几个单位, s(秒), m(分钟), h(小时), d(天) 比如: 100s -> 100000 2m -> 120000 3h -> 10800000
`static Date[]`	`week(int off)` 以本周为基础获得某一周的时间范围
`static Date[]`	`week(long base, int off)` 以某周为基础获得某一周的时间范围
`static Date[]`	`weeks(int offL, int offR)` 以本周为基础获得时间范围
`static Date[]`	`weeks(long base, int offL, int offR)` 按周获得某几周周一 00:00:00 到周六的时间范围它会根据给定的 offL 和 offR 得到一个时间范围对本函数来说 week(-3,-5) 和 week(-5,-3) 是一个意思

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

- 字段详细资料
  - T_1S
```
public static final long T_1S
```
    另请参阅:
    
    常量字段值
  - T_1M
```
public static final long T_1M
```
    另请参阅:
    
    常量字段值
  - T_1H
```
public static final long T_1H
```
    另请参阅:
    
    常量字段值
  - T_1D
```
public static final long T_1D
```
    另请参阅:
    
    常量字段值
- 构造器详细资料
  - Times
```
public Times()
```
- 方法详细资料
  - leapYear
```
public static boolean leapYear(int year)
```
    判断一年是否为闰年，如果给定年份小于1全部为 false
    
    参数:
    
    year - 年份，比如 2012 就是二零一二年
    
    返回:
    
    给定年份是否是闰年
  - countLeapYear
```
public static int countLeapYear(int year)
```
    判断某年（不包括自己）之前有多少个闰年
    
    参数:
    
    year - 年份，比如 2012 就是二零一二年
    
    返回:
    
    闰年的个数
  - T
```
public static int[] T(int sec)
```
    将一个秒数（天中），转换成一个如下格式的数组:
```
 [0-23][0-59[-059]
 
```
    参数:
    
    sec - 秒数
    
    返回:
    
    时分秒的数组
  - T
```
public static int T(String ts)
```
    将一个时间字符串，转换成一个一天中的绝对秒数
    
    参数:
    
    ts - 时间字符串，符合格式 "HH:mm:ss" 或者 "HH:mm"
    
    返回:
    
    一天中的绝对秒数
  - now
```
public static Date now()
```
    返回服务器当前时间
    
    返回:
    
    服务器当前时间
  - ams
```
public static long ams(String ds)
```
    根据默认时区计算时间字符串的绝对毫秒数
    
    参数:
    
    ds - 时间字符串
    
    返回:
    
    绝对毫秒数
    
    另请参阅:
    
    ams(String, TimeZone)
  - ams
```
public static long ams(String ds,
                       TimeZone tz)
```
    根据字符串得到相对于 "UTC 1970-01-01 00:00:00" 的绝对毫秒数。本函数假想给定的时间字符串是本地时间。所以计算出来结果后，还需要减去时差支持的时间格式字符串为:
```
 yyyy-MM-dd HH:mm:ss
 yyyy-MM-dd HH:mm:ss.SSS
 yy-MM-dd HH:mm:ss;
 yy-MM-dd HH:mm:ss.SSS;
 yyyy-MM-dd;
 yy-MM-dd;
 HH:mm:ss;
 HH:mm:ss.SSS;
 
```
    时间字符串后面可以跟 +8 或者 +8:00 表示 GMT+8:00 时区。同理 -9 或者 -9:00 表示 GMT-9:00 时区
    参数:
    
    ds - 时间字符串
    
    tz - 你给定的时间字符串是属于哪个时区的
    
    返回:
    
    时间
    
    另请参阅:
    
    _P_TIME
  - ms
```
public static long ms(String ds,
                      TimeZone tz)
```
    已过时。 since 1.b.49 util 1.b.51
    
    这个接口函数是 1.b.49 提供了，下一版本将改名为 ams，预计在版本 1.b.51 之后被移除
  - ms
```
public static long ms(Date d)
```
    返回时间对象在一天中的毫秒数
    
    参数:
    
    d - 时间对象
    
    返回:
    
    时间对象在一天中的毫秒数
  - ms
```
public static int ms(Calendar c)
```
    返回时间对象在一天中的毫秒数
    
    参数:
    
    c - 时间对象
    
    返回:
    
    时间对象在一天中的毫秒数
  - ms
```
public static int ms()
```
    返回当前时间在一天中的毫秒数
    
    返回:
    
    当前时间在一天中的毫秒数
  - mss
```
public static String mss(int ms)
```
    根据一个当天的绝对毫秒数，得到一个时间字符串，格式为 "HH:mm:ss.EEE"
    
    参数:
    
    ms - 当天的绝对毫秒数
    
    返回:
    
    时间字符串
  - secs
```
public static String secs(int sec)
```
    根据一个当天的绝对秒数，得到一个时间字符串，格式为 "HH:mm:ss"
    
    参数:
    
    ms - 当天的绝对秒数
    
    返回:
    
    时间字符串
  - sec
```
public static int sec(Date d)
```
    返回时间对象在一天中的秒数
    
    参数:
    
    d - 时间对象
    
    返回:
    
    时间对象在一天中的秒数
  - sec
```
public static int sec()
```
    返回当前时间在一天中的秒数
    
    返回:
    
    当前时间在一天中的秒数
  - D
```
public static Date D(String ds)
```
    根据字符串得到时间对象
    
    参数:
    
    ds - 时间字符串
    
    返回:
    
    时间
    
    另请参阅:
    
    ams(String)
  - D1970
```
public static int D1970(int yy,
                        int MM,
                        int dd)
```
    计算一个给定日期，距离 1970 年 1 月 1 日有多少天
    
    参数:
    
    yy - 年，比如 1999，或者 43
    
    MM - 月，一月为 1，十二月为 12
    
    dd - 日，每月一号为 1
    
    返回:
    
    距离 1970 年 1 月 1 日的天数
  - D
```
public static Date D(long ms)
```
    根据毫秒数得到时间
    
    参数:
    
    ms - 时间的毫秒数
    
    返回:
    
    时间
  - C
```
public static Calendar C(String ds)
```
    根据字符串得到时间
```
 如果你输入了格式为 "yyyy-MM-dd HH:mm:ss"
    那么会匹配到秒
    
 如果你输入格式为 "yyyy-MM-dd"
    相当于你输入了 "yyyy-MM-dd 00:00:00"
 
```
    参数:
    
    ds - 时间字符串
    
    返回:
    
    时间
  - C
```
public static Calendar C(Date d)
```
    根据日期对象得到时间
    
    参数:
    
    d - 时间对象
    
    返回:
    
    时间
  - C
```
public static Calendar C(long ms)
```
    根据毫秒数得到时间
    
    参数:
    
    ms - 时间的毫秒数
    
    返回:
    
    时间
  - sDTms
```
public static String sDTms(Date d)
```
    把时间转换成格式为 y-M-d H:m:s.S 的字符串
    
    参数:
    
    d - 时间对象
    
    返回:
    
    该时间的字符串形式 , 格式为 y-M-d H:m:s.S
  - sDTms2
```
public static String sDTms2(Date d)
```
    把时间转换成格式为 yy-MM-dd HH:mm:ss.SSS 的字符串
    
    参数:
    
    d - 时间对象
    
    返回:
    
    该时间的字符串形式 , 格式为 yy-MM-dd HH:mm:ss.SSS
  - sDT
```
public static String sDT(Date d)
```
    把时间转换成格式为 yyyy-MM-dd HH:mm:ss 的字符串
    
    参数:
    
    d - 时间对象
    
    返回:
    
    该时间的字符串形式 , 格式为 yyyy-MM-dd HH:mm:ss
  - sD
```
public static String sD(Date d)
```
    把时间转换成格式为 yyyy-MM-dd 的字符串
    
    参数:
    
    d - 时间对象
    
    返回:
    
    该时间的字符串形式 , 格式为 yyyy-MM-dd
  - sT
```
public static String sT(int sec)
```
    将一个秒数（天中），转换成一个格式为 HH:mm:ss 的字符串
    
    参数:
    
    sec - 秒数
    
    返回:
    
    格式为 HH:mm:ss 的字符串
  - sTmin
```
public static String sTmin(int sec)
```
    将一个秒数（天中），转换成一个格式为 HH:mm 的字符串（精确到分钟）
    
    参数:
    
    sec - 秒数
    
    返回:
    
    格式为 HH:mm:ss 的字符串
  - week
```
public static Date[] week(int off)
```
    以本周为基础获得某一周的时间范围
    
    参数:
    
    off - 从本周偏移几周， 0 表示本周，-1 表示上一周，1 表示下一周
    
    返回:
    
    时间范围(毫秒级别)
    
    另请参阅:
    
    org.nutz.ztask.util.ZTasks#weeks(long, int, int)
  - week
```
public static Date[] week(long base,
                          int off)
```
    以某周为基础获得某一周的时间范围
    
    参数:
    
    base - 基础时间，毫秒
    
    off - 从本周偏移几周， 0 表示本周，-1 表示上一周，1 表示下一周
    
    返回:
    
    时间范围(毫秒级别)
    
    另请参阅:
    
    org.nutz.ztask.util.ZTasks#weeks(long, int, int)
  - weeks
```
public static Date[] weeks(int offL,
                           int offR)
```
    以本周为基础获得时间范围
    
    参数:
    
    offL - 从本周偏移几周， 0 表示本周，-1 表示上一周，1 表示下一周
    
    offR - 从本周偏移几周， 0 表示本周，-1 表示上一周，1 表示下一周
    
    返回:
    
    时间范围(毫秒级别)
    
    另请参阅:
    
    org.nutz.ztask.util.ZTasks#weeks(long, int, int)
  - weeks
```
public static Date[] weeks(long base,
                           int offL,
                           int offR)
```
    按周获得某几周周一 00:00:00 到周六的时间范围
    它会根据给定的 offL 和 offR 得到一个时间范围
    对本函数来说 week(-3,-5) 和 week(-5,-3) 是一个意思
    
    参数:
    
    base - 基础时间，毫秒
    
    offL - 从本周偏移几周， 0 表示本周，-1 表示上一周，1 表示下一周
    
    offR - 从本周偏移几周， 0 表示本周，-1 表示上一周，1 表示下一周
    
    返回:
    
    时间范围(毫秒级别)
  - formatForRead
```
public static String formatForRead(Date d)
```
    将一个时间格式化成容易被人类阅读的格式
```
 如果 1 分钟内，打印 Just Now
 如果 1 小时内，打印多少分钟
 如果 1 天之内，打印多少小时之前
 如果是今年之内，打印月份和日期
 否则打印月份和年
 
```
    参数:
    
    d -
    
    返回:
  - format
```
public static String format(DateFormat fmt,
                            Date d)
```
    以给定的时间格式来安全的对时间进行格式化，并返回格式化后所对应的字符串
    
    参数:
    
    fmt - 时间格式
    
    d - 时间对象
    
    返回:
    
    格式化后的字符串
  - format
```
public static String format(String fmt,
                            Date d)
```
    以给定的时间格式来安全的对时间进行格式化，并返回格式化后所对应的字符串
    
    参数:
    
    fmt - 时间格式
    
    d - 时间对象
    
    返回:
    
    格式化后的字符串
  - parseq
```
public static Date parseq(DateFormat fmt,
                          String s)
```
    以给定的时间格式来安全的解析时间字符串，并返回解析后所对应的时间对象（包裹RuntimeException）
    
    参数:
    
    fmt - 时间格式
    
    s - 时间字符串
    
    返回:
    
    该时间字符串对应的时间对象
  - parseq
```
public static Date parseq(String fmt,
                          String s)
```
    以给定的时间格式来安全的解析时间字符串，并返回解析后所对应的时间对象（包裹RuntimeException）
    
    参数:
    
    fmt - 时间格式
    
    s - 时间字符串
    
    返回:
    
    该时间字符串对应的时间对象
  - parse
```
public static Date parse(DateFormat fmt,
                         String s)
                  throws ParseException
```
    以给定的时间格式来安全的解析时间字符串，并返回解析后所对应的时间对象
    
    参数:
    
    fmt - 时间格式
    
    s - 日期时间字符串
    
    返回:
    
    该时间字符串对应的时间对象
    
    抛出:
    
    ParseException
  - parse
```
public static Date parse(String fmt,
                         String s)
                  throws ParseException
```
    以给定的时间格式来安全的解析时间字符串，并返回解析后所对应的时间对象
    
    参数:
    
    fmt - 时间格式
    
    s - 日期时间字符串
    
    返回:
    
    该时间字符串对应的时间对象
    
    抛出:
    
    ParseException
  - toMillis
```
public static long toMillis(String tstr)
```
    方便的把时间换算成毫秒数支持几个单位, s(秒), m(分钟), h(小时), d(天) 比如: 100s -> 100000
    2m -> 120000
    3h -> 10800000
    
    参数:
    
    tstr -
    
    返回:
  - fromMillis
```
public static String fromMillis(long mi)
```
    一段时间长度的毫秒数转换为一个时间长度的字符串 1000 -> 1S 120000 - 2M
    
    参数:
    
    mi - 毫秒数
    
    返回:
    
    可读的文字
  - fromMillisCN
```
public static String fromMillisCN(long mi)
```
    fromMillis的中文版本 1000 -> 1秒 120000 - 2分
    
    参数:
    
    mi - 毫秒数
    
    返回:
    
    可读的文字

类 Times

字段概要

构造器概要

方法概要

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

字段详细资料

T_1S

T_1M

T_1H

T_1D

构造器详细资料

Times

方法详细资料

leapYear

countLeapYear

T

T

now

ams

ams

ms

ms

ms

ms

mss

secs

sec

sec

D

D1970

D

C

C

C

sDTms

sDTms2

sDT

sD

sT

sTmin

week

week

weeks

weeks

formatForRead

format

format

parseq

parseq

parse

parse

toMillis

fromMillis

fromMillisCN