Class SerialDateUtilities
[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.
-
Field Summary
FieldsModifier and TypeFieldDescriptionprivate DateFormatSymbols
The default date format symbols.private String[]
Strings representing the months.private String[]
Strings representing the weekdays. -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionstatic 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.String[]
Returns an array of strings representing the months.String[]
Returns an array of strings representing the days-of-the-week.static boolean
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
Converts the specified string to a weekday, using the default locale.
-
Field Details
-
dateFormatSymbols
The default date format symbols. -
weekdays
Strings representing the weekdays. -
months
Strings representing the months.
-
-
Constructor Details
-
SerialDateUtilities
public SerialDateUtilities()Creates a new utility class for the default locale.
-
-
Method Details
-
getWeekdays
Returns an array of strings representing the days-of-the-week.- Returns:
- an array of strings representing the days-of-the-week.
-
getMonths
Returns an array of strings representing the months.- Returns:
- an array of strings representing the months.
-
stringToWeekday
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
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
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
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
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
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
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
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.
-