com.jn.langx.util

类 Dates

java.lang.Object

com.jn.langx.util.Dates

public class Dates
extends Object

https://www.iso.org/obp/ui#iso:std:iso:8601:-1:ed-1:v1:en

标准时间：GMT时间，也叫格林威治平时，也叫 UTC时间。 Java 6 ：

 Date:
 表示一个瞬时值，单位是毫秒。它的结果是一个标准的GMT瞬时值。它和时区（timezone）地域（Locale）没有关系。
 在同一时刻，地球上两个不同时区国家的人使用Date API获取到的毫秒数完全一样的。

 Timezone:
 表示时区，其实是各个时区与GMT的毫秒数之差, 也即Offset。
 因为不同时区的时间看到的是不一样的，但是通过Date获取到的毫秒数是一样的，怎么做到的呢？
 Date#toString 或者 SimpleDateFormat 都会根据Timezone 和 Locale 来进行处理，具体处理如下：
    1） 使用GMT 毫秒数 + Timezone.offset 计算出当地的实际毫秒数
    2） 格式化显示时会使用本土语言（Locale）进行处理

 Calender：
  日历，它综合了 GMT millis（Date）, timezone, locale，也就是说它是用来表示某个时区的某个国家的时间。
  并在此基础上提供了时间的加减运算。
  setTimeInMillis，setTimeInMillis 这两个方法的参数或者返回值是 UTC millis。
  提供的时间的加减运算都是针对 Locale Time的。

 SimpleDateFormat 又是基于Calender（即基于 GMT millis（Date）, timezone, locale）的一个日期格式化工具
 Pattern 涉及的符号：https://docs.oracle.com/javase/6/docs/api/java/text/SimpleDateFormat.html
 

字段概要

字段

限定符和类型	字段和说明
static char[]	DATE_FORMAT_FLAGS
static long	DAY_TO_MILLIS
static int	DAY_TO_SECONDS
static String	dd_MM_yyyy
static String	HH_mm_ss
static String	HH_mm_ss_CN
static String	HH_MM_ssZone
static long	HOURS_TO_MILLIS
static int	HOURS_TO_SECONDS
static long	MINUTES_TO_MILLIS
static int	MINUTES_TO_SECONDS
static String	MM_dd_yyyy
static String	MM_dd_yyyy_1
static long	SECONDS_TO_MILLIS
static String	yyyy_MM_dd
static String	yyyy_MM_dd_1
static String	yyyy_MM_dd_CN
static String	yyyy_MM_dd_CN_1
static String	yyyy_MM_dd_HH_mm_ss
static String	yyyy_MM_dd_HH_mm_ss_SSS
static String	yyyy_MM_dd_T_HH_mm_ss
static String	yyyy_MM_dd_T_HH_mm_ssZone
static String	yyyyMMdd
static String	yyyyMMddHHmmss

构造器概要

构造器

构造器和说明
Dates()

方法概要

限定符和类型	方法和说明
static Date	add(Date date, Calendars.DateField calendarField, int amount)
static Date	add(Date date, int calendarField, int amount) Adds to a date returning a new object.
static Date	addDays(Date date, int amount) Adds a number of days to a date returning a new object.
static Date	addHours(Date date, int amount) Adds a number of hours to a date returning a new object.
static Date	addMilliseconds(Date date, int amount) Adds a number of milliseconds to a date returning a new object.
static Date	addMinutes(Date date, int amount) Adds a number of minutes to a date returning a new object.
static Date	addMonths(Date date, int amount) Adds a number of months to a date returning a new object.
static Date	addSeconds(Date date, int amount) Adds a number of seconds to a date returning a new object.
static Date	addWeeks(Date date, int amount) Adds a number of weeks to a date returning a new object.
static Date	addYears(Date date, int amount) Adds a number of years to a date returning a new object.
static String	format(Date date)
static String	format(Date date, String pattern)
static String	format(long millis, String pattern)
static int	get(Date date, Calendars.DateField field)
static int	getDays(Date date)
static int	getHours(Date date)
static int	getMillis(Date date)
static int	getMinutes(Date date)
static int	getMonths(Date date)
static int	getMonths(Date date, boolean getActualMonth)
static int	getSeconds(Date date)
static SimpleDateFormat	getSimpleDateFormat(String pattern)
static SimpleDateFormat	getSimpleDateFormat(String pattern, Locale locale)
static SimpleDateFormat	getSimpleDateFormat(String pattern, String timeZoneId)
static SimpleDateFormat	getSimpleDateFormat(String pattern, String timeZoneId, Locale locale)
static SimpleDateFormat	getSimpleDateFormat(String pattern, TimeZone timeZone)
static SimpleDateFormat	getSimpleDateFormat(String pattern, TimeZone timeZone, Locale locale)
static int	getYears(Date date)
static TimeZone	localTimeZone()
static long	nextTime(long durationInMills)
static long	nextTime(long baselineInMills, long durationInMills)
static Date	now()
static long	nowMills()
static String	nowReadableString()
static Date	parse(String dateString, List<String> patterns)
static Date	parse(String dateString, String... patterns)
static Date	parse(String dateString, String pattern)
static Date	set(Date date, Calendars.DateField field, int amount) Sets the specified field to a date returning a new object.
static Date	setDays(Date date, int amount) Sets the day of month field to a date returning a new object.
static Date	setHours(Date date, int amount) Sets the hours field to a date returning a new object.
static Date	setMilliseconds(Date date, int amount) Sets the milliseconds field to a date returning a new object.
static Date	setMinutes(Date date, int amount) Sets the minute field to a date returning a new object.
static Date	setMonths(Date date, int amount) Sets the months field to a date returning a new object.
static Date	setMonths(Date date, int amount, boolean valueIsActual)
static Date	setSeconds(Date date, int amount) Sets the seconds field to a date returning a new object.
static Date	setYears(Date date, int amount) Sets the years field to a date returning a new object.
static Calendar	toCalendar(Date date) Converts a Date into a Calendar.
static Calendar	toCalendar(Date date, TimeZone tz) Converts a Date of a given TimeZone into a Calendar

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

MINUTES_TO_SECONDS

public static final int MINUTES_TO_SECONDS

另请参阅:

常量字段值

HOURS_TO_SECONDS

public static final int HOURS_TO_SECONDS

另请参阅:

常量字段值

DAY_TO_SECONDS

public static final int DAY_TO_SECONDS

另请参阅:

常量字段值

SECONDS_TO_MILLIS

public static final long SECONDS_TO_MILLIS

另请参阅:

常量字段值

MINUTES_TO_MILLIS

public static final long MINUTES_TO_MILLIS

另请参阅:

常量字段值

HOURS_TO_MILLIS

public static final long HOURS_TO_MILLIS

另请参阅:

常量字段值

DAY_TO_MILLIS

public static final long DAY_TO_MILLIS

另请参阅:

常量字段值

yyyyMMdd

public static final String yyyyMMdd

另请参阅:

常量字段值

yyyy_MM_dd

public static final String yyyy_MM_dd

另请参阅:

常量字段值

yyyy_MM_dd_1

public static final String yyyy_MM_dd_1

另请参阅:

常量字段值

yyyy_MM_dd_CN

public static final String yyyy_MM_dd_CN

另请参阅:

常量字段值

yyyy_MM_dd_CN_1

public static final String yyyy_MM_dd_CN_1

另请参阅:

常量字段值

dd_MM_yyyy

public static final String dd_MM_yyyy

另请参阅:

常量字段值

MM_dd_yyyy

public static final String MM_dd_yyyy

另请参阅:

常量字段值

MM_dd_yyyy_1

public static final String MM_dd_yyyy_1

另请参阅:

常量字段值

yyyyMMddHHmmss

public static final String yyyyMMddHHmmss

另请参阅:

常量字段值

yyyy_MM_dd_HH_mm_ss

public static final String yyyy_MM_dd_HH_mm_ss

另请参阅:

常量字段值

yyyy_MM_dd_HH_mm_ss_SSS

public static final String yyyy_MM_dd_HH_mm_ss_SSS

另请参阅:

常量字段值

yyyy_MM_dd_T_HH_mm_ss

public static final String yyyy_MM_dd_T_HH_mm_ss

另请参阅:

常量字段值

yyyy_MM_dd_T_HH_mm_ssZone

public static final String yyyy_MM_dd_T_HH_mm_ssZone

另请参阅:

常量字段值

HH_mm_ss

public static final String HH_mm_ss

另请参阅:

常量字段值

HH_mm_ss_CN

public static final String HH_mm_ss_CN

另请参阅:

常量字段值

HH_MM_ssZone

public static final String HH_MM_ssZone

另请参阅:

常量字段值

DATE_FORMAT_FLAGS

public static final char[] DATE_FORMAT_FLAGS

另请参阅:

SimpleDateFormat

构造器详细资料

Dates

public Dates()

方法详细资料

format

public static String format(long millis,
                            @NonNull
                            String pattern)

format

public static String format(@NonNull
                            Date date)

format

public static String format(@NonNull
                            Date date,
                            @NotEmpty
                            String pattern)

getSimpleDateFormat

public static SimpleDateFormat getSimpleDateFormat(@NotEmpty
                                                   String pattern)

getSimpleDateFormat

public static SimpleDateFormat getSimpleDateFormat(@NotEmpty
                                                   String pattern,
                                                   @Nullable
                                                   Locale locale)

getSimpleDateFormat

public static SimpleDateFormat getSimpleDateFormat(@NotEmpty
                                                   String pattern,
                                                   @Nullable
                                                   TimeZone timeZone)

getSimpleDateFormat

public static SimpleDateFormat getSimpleDateFormat(@NotEmpty
                                                   String pattern,
                                                   @Nullable
                                                   String timeZoneId)

getSimpleDateFormat

public static SimpleDateFormat getSimpleDateFormat(@NotEmpty
                                                   String pattern,
                                                   @Nullable
                                                   TimeZone timeZone,
                                                   @Nullable
                                                   Locale locale)

getSimpleDateFormat

public static SimpleDateFormat getSimpleDateFormat(@NotEmpty
                                                   String pattern,
                                                   @Nullable
                                                   String timeZoneId,
                                                   @Nullable
                                                   Locale locale)

parse

public static Date parse(String dateString,
                         @NotEmpty
                         String pattern)

parse

public static Date parse(String dateString,
                         String... patterns)

parse

public static Date parse(String dateString,
                         List<String> patterns)

addYears

public static Date addYears(Date date,
                            int amount)

Adds a number of years to a date returning a new object. The original Date is unchanged.

参数:

date - the date, not null

amount - the amount to add, may be negative

返回:

the new Date with the amount added

抛出:

IllegalArgumentException - if the date is null

addMonths

public static Date addMonths(Date date,
                             int amount)

Adds a number of months to a date returning a new object. The original Date is unchanged.

参数:

date - the date, not null

amount - the amount to add, may be negative

返回:

the new Date with the amount added

抛出:

IllegalArgumentException - if the date is null

addWeeks

public static Date addWeeks(Date date,
                            int amount)

Adds a number of weeks to a date returning a new object. The original Date is unchanged.

参数:

date - the date, not null

amount - the amount to add, may be negative

返回:

the new Date with the amount added

抛出:

IllegalArgumentException - if the date is null

addDays

public static Date addDays(Date date,
                           int amount)

Adds a number of days to a date returning a new object. The original Date is unchanged.

参数:

date - the date, not null

amount - the amount to add, may be negative

返回:

the new Date with the amount added

抛出:

IllegalArgumentException - if the date is null

addHours

public static Date addHours(Date date,
                            int amount)

Adds a number of hours to a date returning a new object. The original Date is unchanged.

参数:

date - the date, not null

amount - the amount to add, may be negative

返回:

the new Date with the amount added

抛出:

IllegalArgumentException - if the date is null

addMinutes

public static Date addMinutes(Date date,
                              int amount)

Adds a number of minutes to a date returning a new object. The original Date is unchanged.

参数:

date - the date, not null

amount - the amount to add, may be negative

返回:

the new Date with the amount added

抛出:

IllegalArgumentException - if the date is null

addSeconds

public static Date addSeconds(Date date,
                              int amount)

Adds a number of seconds to a date returning a new object. The original Date is unchanged.

参数:

date - the date, not null

amount - the amount to add, may be negative

返回:

the new Date with the amount added

抛出:

IllegalArgumentException - if the date is null

addMilliseconds

public static Date addMilliseconds(Date date,
                                   int amount)

Adds a number of milliseconds to a date returning a new object. The original Date is unchanged.

参数:

date - the date, not null

amount - the amount to add, may be negative

返回:

the new Date with the amount added

抛出:

IllegalArgumentException - if the date is null

add

public static Date add(Date date,
                       int calendarField,
                       int amount)

Adds to a date returning a new object. The original Date is unchanged.

参数:

date - the date, not null

calendarField - the calendar field to add to

amount - the amount to add, may be negative

返回:

the new Date with the amount added

抛出:

IllegalArgumentException - if the date is null

add

public static Date add(Date date,
                       Calendars.DateField calendarField,
                       int amount)

setYears

public static Date setYears(Date date,
                            int amount)

Sets the years field to a date returning a new object. The original Date is unchanged.

参数:

date - the date, not null

amount - the amount to set

返回:

a new Date set with the specified value

抛出:

IllegalArgumentException - if the date is null

setMonths

public static Date setMonths(Date date,
                             int amount)

Sets the months field to a date returning a new object. The original Date is unchanged.

参数:

date - the date, not null

amount - the amount to set

返回:

a new Date set with the specified value

抛出:

IllegalArgumentException - if the date is null

setMonths

public static Date setMonths(Date date,
                             int amount,
                             boolean valueIsActual)

setDays

public static Date setDays(Date date,
                           int amount)

Sets the day of month field to a date returning a new object. The original Date is unchanged.

参数:

date - the date, not null

amount - the amount to set

返回:

a new Date set with the specified value

抛出:

IllegalArgumentException - if the date is null

setHours

public static Date setHours(Date date,
                            int amount)

Sets the hours field to a date returning a new object. Hours range from 0-23. The original Date is unchanged.

参数:

date - the date, not null

amount - the amount to set

返回:

a new Date set with the specified value

抛出:

IllegalArgumentException - if the date is null

setMinutes

public static Date setMinutes(Date date,
                              int amount)

Sets the minute field to a date returning a new object. The original Date is unchanged.

参数:

date - the date, not null

amount - the amount to set

返回:

a new Date set with the specified value

抛出:

IllegalArgumentException - if the date is null

setSeconds

public static Date setSeconds(Date date,
                              int amount)

Sets the seconds field to a date returning a new object. The original Date is unchanged.

参数:

date - the date, not null

amount - the amount to set

返回:

a new Date set with the specified value

抛出:

IllegalArgumentException - if the date is null

setMilliseconds

public static Date setMilliseconds(Date date,
                                   int amount)

Sets the milliseconds field to a date returning a new object. The original Date is unchanged.

参数:

date - the date, not null

amount - the amount to set

返回:

a new Date set with the specified value

抛出:

IllegalArgumentException - if the date is null

set

public static Date set(Date date,
                       Calendars.DateField field,
                       int amount)

Sets the specified field to a date returning a new object. This does not use a lenient calendar. The original Date is unchanged.

参数:

date - the date, not null

field - the Calendars.DateField field to set the amount to

amount - the amount to set

返回:

a new Date set with the specified value

抛出:

IllegalArgumentException - if the date is null

get

public static int get(@NonNull
                      Date date,
                      Calendars.DateField field)

getYears

public static int getYears(@NonNull
                           Date date)

getMonths

public static int getMonths(@NonNull
                            Date date)

getMonths

public static int getMonths(@NonNull
                            Date date,
                            boolean getActualMonth)

getDays

public static int getDays(@NonNull
                          Date date)

getHours

public static int getHours(@NonNull
                           Date date)

getMinutes

public static int getMinutes(@NonNull
                             Date date)

getSeconds

public static int getSeconds(@NonNull
                             Date date)

getMillis

public static int getMillis(@NonNull
                            Date date)

nextTime

public static long nextTime(long baselineInMills,
                            long durationInMills)

nextTime

public static long nextTime(long durationInMills)

nowMills

public static long nowMills()

now

public static Date now()

nowReadableString

public static String nowReadableString()

toCalendar

public static Calendar toCalendar(Date date)

Converts a Date into a Calendar.

参数:

date - the date to convert to a Calendar

返回:

the created Calendar

抛出:

NullPointerException - if null is passed in

toCalendar

public static Calendar toCalendar(Date date,
                                  TimeZone tz)

Converts a Date of a given TimeZone into a Calendar

参数:

date - the date to convert to a Calendar

tz - the time zone of the date

返回:

the created Calendar

抛出:

NullPointerException - if date or tz is null

localTimeZone

public static TimeZone localTimeZone()