org.jfree.date
Class SerialDateUtilities

java.lang.Object
  org.jfree.date.SerialDateUtilities

public class SerialDateUtilities
extends java.lang.Object

A utility class that provides a number of useful methods (some static). Many of these are used in the implementation of the day-count convention classes. I recognise some limitations in this implementation:

[1] some of the methods assume that the default Calendar is a GregorianCalendar (used mostly to determine leap years) - so the code won’t work if some other Calendar is the default. I'm not sure how to handle this properly?

[2] a whole bunch of static methods isn't very object-oriented - but I couldn't think of a good way to extend the Date and Calendar classes to add the functions I required, so static methods are doing the job for now.

Author:

David Gilbert

Constructor Summary

SerialDateUtilities()
Creates a new utility class for the default locale.

Method Summary

static int	countFeb29s(SerialDate start, SerialDate end) Returns the number of times that February 29 falls within the specified date range.
static int	dayCount30(SerialDate start, SerialDate end) Returns the number of days between the specified start and end dates, assuming that there are thirty days in every month (that is, corresponding to the 30/360 day-count convention).
static int	dayCount30E(SerialDate start, SerialDate end) Returns the number of days between the specified start and end dates, assuming that there are thirty days in every month, and applying the European adjustment (that is, corresponding to the 30E/360 day-count convention).
static int	dayCount30ISDA(SerialDate start, SerialDate end) Returns the number of days between the specified start and end dates, assuming that there are thirty days in every month, and applying the ISDA adjustments (that is, corresponding to the 30/360 (ISDA) day-count convention).
static int	dayCount30PSA(SerialDate start, SerialDate end) Returns the number of days between the specified start and end dates, assuming that there are thirty days in every month, and applying the PSA adjustments (that is, corresponding to the 30/360 (PSA) day-count convention).
static int	dayCountActual(SerialDate start, SerialDate end) Returns the actual number of days between two dates.
java.lang.String[]	getMonths() Returns an array of strings representing the months.
java.lang.String[]	getWeekdays() Returns an array of strings representing the days-of-the-week.
static boolean	isLastDayOfFebruary(SerialDate d) Returns true if the specified date is the last day in February (that is, the 28th in non-leap years, and the 29th in leap years).
int	stringToWeekday(java.lang.String s) Converts the specified string to a weekday, using the default locale.

Methods inherited from class java.lang.Object

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

Constructor Detail

SerialDateUtilities

public SerialDateUtilities()

Creates a new utility class for the default locale.

Method Detail

getWeekdays

public java.lang.String[] getWeekdays()

Returns an array of strings representing the days-of-the-week.

Returns:

an array of strings representing the days-of-the-week.

getMonths

public java.lang.String[] getMonths()

Returns an array of strings representing the months.

Returns:

an array of strings representing the months.

stringToWeekday

public int stringToWeekday(java.lang.String s)

Converts the specified string to a weekday, using the default locale.

Parameters:

s - a string representing the day-of-the-week.

Returns:

an integer representing the day-of-the-week.

dayCountActual

public static int dayCountActual(SerialDate start,
                                 SerialDate end)

Returns the actual number of days between two dates.

Parameters:

start - the start date.

end - the end date.

Returns:

the number of days between the start date and the end date.

dayCount30

public static int dayCount30(SerialDate start,
                             SerialDate end)

Returns the number of days between the specified start and end dates, assuming that there are thirty days in every month (that is, corresponding to the 30/360 day-count convention).

The method handles cases where the start date is before the end date (by switching the dates and returning a negative result).

Parameters:

start - the start date.

end - the end date.

Returns:

the number of days between the two dates, assuming the 30/360 day-count convention.

dayCount30ISDA

public static int dayCount30ISDA(SerialDate start,
                                 SerialDate end)

Returns the number of days between the specified start and end dates, assuming that there are thirty days in every month, and applying the ISDA adjustments (that is, corresponding to the 30/360 (ISDA) day-count convention).

The method handles cases where the start date is before the end date (by switching the dates around and returning a negative result).

Parameters:

start - the start date.

end - the end date.

Returns:

The number of days between the two dates, assuming the 30/360 (ISDA) day-count convention.

dayCount30PSA

public static int dayCount30PSA(SerialDate start,
                                SerialDate end)

Returns the number of days between the specified start and end dates, assuming that there are thirty days in every month, and applying the PSA adjustments (that is, corresponding to the 30/360 (PSA) day-count convention). The method handles cases where the start date is before the end date (by switching the dates around and returning a negative result).

Parameters:

start - the start date.

end - the end date.

Returns:

The number of days between the two dates, assuming the 30/360 (PSA) day-count convention.

dayCount30E

public static int dayCount30E(SerialDate start,
                              SerialDate end)

Returns the number of days between the specified start and end dates, assuming that there are thirty days in every month, and applying the European adjustment (that is, corresponding to the 30E/360 day-count convention).

The method handles cases where the start date is before the end date (by switching the dates around and returning a negative result).

Parameters:

start - the start date.

end - the end date.

Returns:

the number of days between the two dates, assuming the 30E/360 day-count convention.

isLastDayOfFebruary

public static boolean isLastDayOfFebruary(SerialDate d)

Returns true if the specified date is the last day in February (that is, the 28th in non-leap years, and the 29th in leap years).

Parameters:

d - the date to be tested.

Returns:

a boolean that indicates whether or not the specified date is the last day of February.

countFeb29s

public static int countFeb29s(SerialDate start,
                              SerialDate end)

Returns the number of times that February 29 falls within the specified date range. The result needs to correspond to the ACT/365 (Japanese) day-count convention. The difficult cases are where the start or the end date is Feb 29 (include or not?). Need to find out how JGBs do this (since this is where the ACT/365 (Japanese) convention comes from ...

Parameters:

start - the start date.

end - the end date.

Returns:

the number of times that February 29 occurs within the date range.