Mega Code Archive
Time formatting utility
<![CDATA[
/*
TimeUtil.java / Freenet
Copyright (C) 2005-2006 The Free Network project
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 2 of
the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
*/
//package freenet.support;
import java.text.DecimalFormat;
/**
* Time formatting utility.
* Formats milliseconds into a week/day/hour/second/milliseconds string.
*/
public class TimeUtil {
/**
* It converts a given time interval into a
* week/day/hour/second.milliseconds string.
* @param timeInterval interval to convert
* @param maxTerms the terms number to display
* (e.g. 2 means "h" and "m" if the time could be expressed in hour,
* 3 means "h","m","s" in the same example).
* The maximum terms number available is 6
* @param withSecondFractions if true it displays seconds.milliseconds
* @return the formatted String
*/
public static String formatTime(long timeInterval, int maxTerms, boolean withSecondFractions) {
if (maxTerms > 6 )
throw new IllegalArgumentException();
StringBuilder sb = new StringBuilder(64);
long l = timeInterval;
int termCount = 0;
//
if(l < 0) {
sb.append('-');
l = l * -1;
}
if( !withSecondFractions && l < 1000 ) {
return "0";
}
if(termCount >= maxTerms) {
return sb.toString();
}
//
long weeks = (l / (7L*24*60*60*1000));
if (weeks > 0) {
sb.append(weeks).append('w');
termCount++;
l = l - (weeks * (7L*24*60*60*1000));
}
if(termCount >= maxTerms) {
return sb.toString();
}
//
long days = (l / (24L*60*60*1000));
if (days > 0) {
sb.append(days).append('d');
termCount++;
l = l - (days * (24L*60*60*1000));
}
if(termCount >= maxTerms) {
return sb.toString();
}
//
long hours = (l / (60L*60*1000));
if (hours > 0) {
sb.append(hours).append('h');
termCount++;
l = l - (hours * (60L*60*1000));
}
if(termCount >= maxTerms) {
return sb.toString();
}
//
long minutes = (l / (60L*1000));
if (minutes > 0) {
sb.append(minutes).append('m');
termCount++;
l = l - (minutes * (60L*1000));
}
if(termCount >= maxTerms) {
return sb.toString();
}
if(withSecondFractions && ((maxTerms - termCount) >= 2)) {
if (l > 0) {
double fractionalSeconds = l / (1000.0D);
DecimalFormat fix3 = new DecimalFormat("0.000");
sb.append(fix3.format(fractionalSeconds)).append('s');
termCount++;
//l = l - ((long)fractionalSeconds * (long)1000);
}
} else {
long seconds = (l / 1000L);
if (seconds > 0) {
sb.append(seconds).append('s');
termCount++;
//l = l - ((long)seconds * (long)1000);
}
}
//
return sb.toString();
}
public static String formatTime(long timeInterval) {
return formatTime(timeInterval, 2, false);
}
public static String formatTime(long timeInterval, int maxTerms) {
return formatTime(timeInterval, maxTerms, false);
}
}
/*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
*/
package freenet.support;
import java.util.Locale;
import junit.framework.TestCase;
/**
* Test case for {@link freenet.support.TimeUtil} class.
*
* @author Alberto Bacchelli <sback@freenetproject.org>
*/
public class TimeUtilTest extends TestCase {
//1w+1d+1h+1m+1s+1ms
private long oneForTermLong = 694861001;
@Override
protected void setUp() throws Exception {
Locale.setDefault(Locale.US);
}
/**
* Tests formatTime(long,int,boolean) method
* trying the biggest long value
*/
public void testFormatTime_LongIntBoolean_MaxValue() {
String expectedForMaxLongValue = "15250284452w3d7h12m55.807s";
assertEquals(TimeUtil.formatTime(Long.MAX_VALUE,6,true),
expectedForMaxLongValue);
}
/**
* Tests formatTime(long,int) method
* trying the biggest long value
*/
public void testFormatTime_LongInt() {
String expectedForMaxLongValue = "15250284452w3d7h12m55s";
assertEquals(TimeUtil.formatTime(Long.MAX_VALUE,6),
expectedForMaxLongValue);
}
/**
* Tests formatTime(long) method
* trying the biggest long value
*/
public void testFormatTime_Long() {
//it uses two terms by default
String expectedForMaxLongValue = "15250284452w3d";
assertEquals(TimeUtil.formatTime(Long.MAX_VALUE),
expectedForMaxLongValue);
}
/**
* Tests formatTime(long) method
* using known values.
* They could be checked using Google Calculator
* http://www.google.com/intl/en/help/features.html#calculator
*/
public void testFormatTime_KnownValues() {
Long methodLong;
String[][] valAndExpected = {
//one week
{"604800000","1w"},
//one day
{"86400000","1d"},
//one hour
{"3600000","1h"},
//one minute
{"60000","1m"},
//one second
{"1000","1s"}
};
for(int i = 0; i < valAndExpected.length; i++) {
methodLong = Long.valueOf(valAndExpected[i][0]);
assertEquals(TimeUtil.formatTime(methodLong.longValue()),
valAndExpected[i][1]); }
}
/**
* Tests formatTime(long,int) method
* using a long value that generate every possible
* term kind. It tests if the maxTerms arguments
* works correctly
*/
public void testFormatTime_LongIntBoolean_maxTerms() {
String[] valAndExpected = {
//0 terms
"",
//1 term
"1w",
//2 terms
"1w1d",
//3 terms
"1w1d1h",
//4 terms
"1w1d1h1m",
//5 terms
"1w1d1h1m1s",
//6 terms
"1w1d1h1m1.001s"
};
for(int i = 0; i < valAndExpected.length; i++)
assertEquals(TimeUtil.formatTime(oneForTermLong,i,true),
valAndExpected[i]);
}
/**
* Tests formatTime(long,int) method
* using one millisecond time interval.
* It tests if the withSecondFractions argument
* works correctly
*/
public void testFormatTime_LongIntBoolean_milliseconds() {
long methodValue = 1; //1ms
assertEquals(TimeUtil.formatTime(methodValue,6,false),"0");
assertEquals(TimeUtil.formatTime(methodValue,6,true),"0.001s");
}
/**
* Tests formatTime(long,int) method
* using a long value that generate every possible
* term kind. It tests if the maxTerms arguments
* works correctly
*/
public void testFormatTime_LongIntBoolean_tooManyTerms() {
try {
TimeUtil.formatTime(oneForTermLong,7);
fail("Expected IllegalArgumentException not thrown"); }
catch (IllegalArgumentException anException) {
assertNotNull(anException); }
}
}
]]>