https://github.com/swiftech/swifttime
SwiftTime is a very light weight extension of Java GregorianCalendar class.
https://github.com/swiftech/swifttime
Last synced: about 2 months ago
JSON representation
SwiftTime is a very light weight extension of Java GregorianCalendar class.
- Host: GitHub
- URL: https://github.com/swiftech/swifttime
- Owner: swiftech
- License: apache-2.0
- Created: 2018-02-13T15:16:12.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2020-10-13T06:52:47.000Z (over 4 years ago)
- Last Synced: 2025-01-19T18:47:29.226Z (4 months ago)
- Language: Java
- Size: 28.3 KB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: readme.md
- License: LICENSE
Awesome Lists containing this project
README
## 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:
```java
// t is just current time whose value is the same to System.currentTimeMillis().
Time t = new Time();
```
or from other time types:
```java
java.util.Date date = new java.util.Date();
...
Time t = new Time(date);
```
of course by fields of time:
```java
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:
```java
// 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:
```java
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:
```java
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
```java
t.setToFirstDayOfCurrentWeek();
```
* Set time to the last day of this week
```java
t.setToLastDayOfCurrentWeek();
```
#### Combination
You can use methods of Time combined to get useful effect, eg:
```java
// 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
```java
// get days of month
Time.getDaysOfCurrentMonth(t);
```
#### Maven
```xml
com.github.swiftech
swifttime
0.2.1
```