Skip to content

Latest commit

 

History

History
116 lines (88 loc) · 2.63 KB

readme.md

File metadata and controls

116 lines (88 loc) · 2.63 KB
Raw

SwiftTime

SwiftTime is a very light weight extension of Java GregorianCalendar class. Provides more common operation for you to easily manipulating time without any other dependencies.

Features

  • Easily increase or decrease any field of time.
  • Truncate time at any field of time.
  • Get interval at any filed of time.
  • First or last day of current month or week.
  • Month starts with 1 not 0 by GregorianCalendar default.

Tutorial

Construct

You can construct a new Time simply by:

// t is just current time whose value is the same to System.currentTimeMillis().
Time t = new Time();

or from other time types:

java.util.Date date = new java.util.Date();
...
Time t = new Time(date);

of course by fields of time:

Time t = new Time(2018, 02, 13, 22, 06, 30);

if the hour, minute, second fields is not given, their default value will be 0. if the dayOfMonth is not given, the default value is 1 if the month is not given, the default value is 1, which means January.

Increase or decrease single field of time

Increase or decrease time become more simple and straightforward:

// Increase 3 years
t.increaseYears(3);

// Decrease 8 hours
t.increaseHours(-8);

Truncate time

Usually you need to get the precise second of a imprecise time, for example: Get the first day of this month but hour, minute and second be truncated to 00:00:00 . It is easy to do so now:

Time t = new Time(); //current time is 2018-02-13 22:06:30 for example
t.truncateAtMonth();
System.out.println(t);
> Thu Feb 01 00:00:00 CST 2018

Interval for fields

Calculate time interval at single time field is tedious because you have to consider the carry of time field. Now you can easily get interval at any field from one Time to another. eg:

Time t1 = new Time(2018);
Time t2 = new Time(2000);
t1.getYearIntervalFrom(t2);
System.out.println(t);
> 18

of course other fields of time can be done as well.

Set time

  • Set time to the first day of this week
t.setToFirstDayOfCurrentWeek();
  • Set time to the last day of this week
t.setToLastDayOfCurrentWeek();

Combination

You can use methods of Time combined to get useful effect, eg:

// get the first second of specified day of month
t.setDate(3).truncateAtHour();

// get the first second of the first day of this week
t.setToFirstDayOfCurrentWeek().truncateAtHour();

Misc

// get days of month
Time.getDaysOfCurrentMonth(t);

Maven

<dependency>
	<groupId>com.github.swiftech</groupId>
	<artifactId>swifttime</artifactId>
	<version>0.2.1</version>
</dependency>