Michael Thomas Flanagan's Java Scientific Library TimeAndDate Class:      Time and Date Methods

Last update of this class: 4 October2009
Main Page of Michael Thomas Flanagan's Java Scientific Library

This class contains methods for:

• TIME
  
  • Returning the time
  • Returning the 'computer time'
  • Calculating the 'computer time'
  • Timing the running of time-intensive blocs of code
  • Introducing a waiting period
• DATE
  
  • Returning the date
  • Checking for a leap year
  • British Summer Time clock changes
  • Returning the day of a date
  • Returning the full date of Feast Days and Holidays:
    
    • Easter Sunday, Good Friday, Maundy Thursday, Palm Sunday, Ash Wednesday, Shrove Tuesday
    • Christmas Day, Epiphany, Advent Sunday
    • St Patricks Day, St George's Day, St Andrew's Day, St David's Day, St Stephen's Day, St Valentine's Day, St Brigid's Day, St Colm Cille's Day (St Columba's Day)
    • Mother's Day (Mothering Day), Father's Day, Burn's Night, Twelfth of July, Commonwealth Day, Armed Forces Day (UK Veterans' Day), Fourth of July (US Independence Day), US Thanksgiving Day
    • Feast of the Purification (Feast of the Presentation, Candlemas), Feast of the Annunciation, Whit Sunday (Pentecost), Ascension Thursday, Trinity Sunday, Corpus Christi, Feast of the Transfiguration of Christ, Feast of the Assumption, feast of the Nativity of the Blessed Virgin, Feast of the Immaculate Conception
    • Remembrance Sunday, Holocaust Memorial Day

import directive: import flanagan.math.TimeAndDate;

• Summary table of methods
• Listing of the source code (Last update: 4 October 2009)
• Other classes, in this library, used by this class
• Main Page of Michael Thomas Flanagan's Java Scientific Library

SUMMARY OF METHODS

Constructor			public TimeAndDate()
Time	Get the time as hour.min (24 hour clock)		public String getShortTime24()
	Get the time as hour.min AM/PM (12 hour clock)		public String getShortTime12()
	Get the time as hour.min.sec (24 hour clock)		public String getMidTime24()
	Get the time as hour.min.sec AM/PM (12 hour clock)		public String getMidTime12()
	Get the time as hour.min.sec.ms (24 hour clock)		public String getFullTime24()
	Get the time as hour.min.sec.ms AM/PM (12 hour clock)		public String getFullTime12()
	Get the hour of the day (24 hour clock)		public int getHour24()
	Get the hour of the day AM/PM (12 hour clock)		public String getHour12()
	Get the minute		public int getMinute()
	Get the second		public int getSecond()
	Get the millisecond		public int getMilliSecond()
	Get the current computer time		public long getComputerTime()
	Convert a date to computer time		public long dateToJavaMilliSecondsUK(int year, int month, int dayOfTheMonth, String dayOfTheWeek, int minute, int second, int millisecond)
	Wait for n seconds		public void waitFor(int n)
			public void waitFor(long n)
			public void waitFor(double n)
	Running time	Mark start of bloc	public void blocStart()
		Mark end of bloc	public long blocEnd()
		Return running time	public long blocTime()
Date	Get the date as 'day of month' 'month name' 'year'		public String getDate()
	Get the date as 'day name', 'day of month' 'month name' 'year'		public String getFullDate()
	Get the date as 'day of month'.'month'.'year'		public String getShortDateUK()
	Get the date as 'month'/'day of month'/'year'		public String getShortDateUS()
	Get the day of the week		public String getDayOfTheWeek()
	Get the day of the week as an integer		public int getDayOfTheWeekAsInteger()
	Get the day of the month		public int getDayOfTheMonth()
	Get the day of a date		public String getDayOfDate(int dayOfTheMonth, int month, int year)
			public String getDayOfDate(int dayOfTheMonth, String month, int year)
	Get the month as name		public String getMonth()
	Get the month as integer		public int getMonthAsInteger()
	Get the year		public int getYear()
	Check for a leap year		public boolean leapYear(int year)
	Check whether in British Summer Time		public boolean checkBST()
	Calculate the next British Summer Time clock change		public String nextBstClockChange()
	Easter Sunday		public String easterSunday()
			public String easterSunday(int year)
	Good Friday		public String goodFriday()
			public String goodFriday(int year)
	Maundy Thursday		public String maundyThursday()
			public String maundyThursday(int year)
	Palm Sunday		public String palmSunday()
			public String palmSunday(int year)
	Ash Wednesday		public String ashWednesday()
			public String ashWednesday(int year)
	Shrove Tuesday		public String shroveTuesday()
			public String shroveTuesday(int year)
	Christmas Day		public String christmasDay()
			public String christmasDay(int year)
	Epiphany		public String epiphany()
			public String epiphany(int year)
			public String sundayAfterEpiphany()
			public String sundayAfterEpiphany(int year)
	First Sunday of Advent		public String adventSunday()
			public String adventSunday(int year)
	St Patrick's Day		public String saintPatricksDay()
			public String saintPatricksDay(int year)
	St George's Day		public String saintGeorgesDay()
			public String saintGeorgesDay(int year)
	St Andrew's Day		public String saintAndrewsDay()
			public String saintAndrewsDay(int year)
	St David's Day		public String saintDavidsDay()
			public String saintDavidsDay(int year)
	St Stephen's Day		public String saintStephensDay()
			public String saintStephensDay(int year)
	St Valentine's Day		public String saintValentinesDay()
			public String saintValentinesDay(int year)
	St Brigid's Day		public String saintBrigidsDay()
			public String saintBrigidsDay(int year)
	St Colm Cille's Day (St Columba's Day)		public String saintColmCillesDay()
			public String saintColmCillesDay(int year)
			public String saintColumbasDay()
			public String saintColumbasDay(int year)
	Mother's Day		public String mothersDayUK()
			public String mothersDayUK(int year)
			public String mothersDayUS()
			public String mothersDayUS(int year)
	Father's Day		public String fathersDay()
			public String fathersDay(int year)
	Burns' Night		public String burnsNight()
			public String burnsNight(int year)
	Twelfth of July		public String twelfthJuly()
			public String twelfthJuly(int year)
	Commonwealth Day		public String commonwealthDay()
public String commonwealthDay(int year)
Armed Forces Day (UK Veterans' Day)		public String armedForcesDay()
		public String armedForcesDay(int year)
		public String veteransDayUK()
		public String veteransDayUK(int year)
Fourth of July (US Independence Day)		public String fourthJuly()
		public String fourthJuly(int year)
US Thanksgiving Day		public String thanksgivingDay()
		public String thanksgivingDay(int year)
Feast of the Purification (Feast of the Presentation, Candlemas)		public String purification()
		public String purification(int year)
		public String presentation()
		public String presentation(int year)
		public String candlemas()
		public String candlemas(int year)
Feast of the Annunciation		public String annunciation()
		public String annunciation(int year)
Whit Sunday (Pentecost)		public String whitSunday()
		public String whitSunday(int year)
Ascension Thursday		public String ascensionThursday()
		public String ascensionThursday(int year)
		public String sundayAfterAscensionThursday()
		public String sundayAfterAscensionThursday(int year)
Trinity Sunday		public String trinitySunday()
		public String trinitySunday(int year)
Corpus Christi		public String corpusChristi()
		public String corpusChristi(int year)
		public String sundayAfterCorpusChristi()
		public String sundayAfterCorpusChristi(int year)
Feast of the Transfiguration of Christ		public String transfiguration()
		public String transfiguration(int year)
Feast of the Assumption		public String assumption()
		public String assumption(int year)
Feast of the Nativity of the Blessed Virgin		public String nativityBlessedVirgin()
		public String nativityBlessedVirgin(int year)
Feast of the Immaculate Conception		public String immaculateConception()
		public String immaculateConception(int year)
Remembrance Sunday		public String remembranceSunday()
		public String remembranceSunday(int year)
Holocaust Memorial Day		public String holocaustMemorialDay()
		public String holocaustMemorialDay(int year)

---

DETAILS OF METHODS

CONSTRUCTOR

public TimeAndDate()
Usage:                      TimeAndDate tad = new TimeAndDate();
Creates an instance of the TimeAndDate object.

---

TIME

Get the time as hour.minutes (24 hour clock)
public String getShortTime24()
Usage:                      time = tad.getShortTime24();
This method returns the current time as hours.minutes, e.g. 9.45, 15.27, i.e. using a 24 hour clock.

Get the time as hour.minutes AM/PM (12 hour clock)
public String getShortTime12()
Usage:                      time = tad.getShortTime12();
This method returns the current time as hours.minutes AM/PM, e.g. 9.45 AM, 3.27 PM, i.e. using a 12 hour clock.

Get the time as hour.minutes.seconds (24 hour clock)
public String getMidTime24()
Usage:                      time = tad.getMidTime24();
This method returns the current time as hours.minutes.seconds, e.g. 9.45.06, 15.27.32, i.e. using a 24 hour clock.

Get the time as hour.minutes.seconds AM/PM (12 hour clock)
public String getMidTime12()
Usage:                      time = tad.getMidTime12();
This method returns the current time as hours.minutes.seconds AM/PM, e.g. 9.45.06 AM, 3.27.32 PM, i.e. using a 12 hour clock.

Get the time as hour.minutes.seconds.milliseconds (24 hour clock)
public String getFullTime24()
Usage:                      time = tad.getFullTime24();
This method returns the current time as hours.minutes.seconds.milliseconds, e.g. 9.45.06.729, 15.27.32.008, i.e. using a 24 hour clock.

Get the time as hour.minutes.seconds.milliseconds AM/PM (12 hour clock)
public String getFullTime12()
Usage:                      time = tad.getFullTime12();
This method returns the current time as hours.minutes.seconds.milliseconds AM/PM, e.g. 9.45.06.729 AM, 3.27.32.008 PM, i.e. using a 12 hour clock.

Get the hour of the day (24 hour clock)
public int getHour24()
Usage:                      hour = tad.getHour24();
Returns the hour of the day using a 24 hour clock, e.g. at the time 3.47 AM this method returns 3, at the time 3.20 PM this method returns 15.

Get the hour of the day AM/PM (12 hour clock)
public int getHour12()
Usage:                      hour = tad.getHour12();
Returns the hour of the day using a 12 hour clock, e.g. at the time 3.47 AM this method returns 3 AM, at the time 3.20 PM this method returns 3 PM.

Get the minute
public int getMinute()
Usage:                      minute = tad.getMinute();
Returns the minute, e.g. at the time 3.47 this method returns 47.

Get the second
public int getSecond()
Usage:                      second = tad.getSecond();
Returns the second, e.g. at the time 3.47.12 this method returns 12.

Get the millisecond
public int getMilliSecond()
Usage:                      millisecond = tad.getMilliSecond();
Returns the millisecond, e.g. at the time 3.47.12.072 this method returns 72.

Get computer time
public long getComputerTime()
Usage:                      compTime = tad.getComputerTime();
Returns the computer time, i.e. the time in milliseconds elapsed since 0 hours 0 minutes 0 seconds on 1 Jan 1970.

Convert date and time to milliseconds since 0 hours 0 minutes 0 seconds on 1 Jan 1970 (computer time)
public long dateToJavaMilliSecondsUK(int year, int month, int dayOfTheMonth, String dayOfTheWeek, int hour, int min, int sec, int millisec)
Usage:                      compTime = tad.dateToJavaMilliSecondsUK(2009, 9, 27, "Sunday", 15, 32, 7, 0);
Converts the date (e.g. 3.32 pm and 7 seconds and 0 milliseconds, on Sunday, 27th September 2009 (27.09.09) in the above example) to the Java time scale, i.e. millisecond since 0 hours 0 minutes 0 seconds on 1 Jan 1970. This method corrects for British summer time (BST). The days of the week should be entered as the String "Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday" or "Saturday".

Wait for n seconds
public void waitFor(int n)
public void waitFor(long n)
public void waitFor(double n)
Usage:                      tad.waitFor(n);
This method causes the program to wait for n seconds before continuing. The smallest wait interval is 1 millisecond.

Measurement of running time
These methods allow the measurement of the running time of a bloc of code preceded by and followed by the indicated marker methods. The lowest measurable running time is 1 millisecond

Mark the start of the bloc public void blocStart() Usage:                      tad.blocStart(); This method should be called at the start of the bloc of coding whose execution time is required.

Mark the end of the bloc and return the running time public void blocEnd() Usage:                      runTime = tad.blocEnd(); This method should be called at the end of the bloc of coding whose execution time is required. It returns the execution time between this call and the call to bocStart(), as a long, in milliseconds.

Return the last running time measured public void blocTime() Usage:                      runTime = tad.blocTime(); This method returns the last execution time to be measured, as a long, in milliseconds.

---

DATE

Get the date as 'day of month' 'month name' 'year'
public String getDate()
Usage:                      date = tad.getDate();
Returns the date as 'day of month' 'month name' 'year', e.g. 27 August 2009.

Get the date as 'day name', 'day of month' 'month name' 'year'
public String getFullDate()
Usage:                      date = tad.getFullDate();
Returns the date as 'day name', 'day of month' 'month name' 'year', e.g. Thursday, 27 August 2009.

Get the date as 'day of month'.'month'.'year'
public String getShortDateUK()
Usage:                      date = tad.getShortDateUK();
Returns the date as the UK convention: 'day of month'.'month'.'year', e.g. Thursday, 27 August 2009 is returned as 27.08.09.

Get the date as 'month'/'day of month'/'year'
public String getShortDateUS()
Usage:                      date = tad.getShortDateUS();
Returns the date as the US convention: 'month'/'day of month'/'year', e.g. Thursday, 27 August 2009 is returned as 08/27/09.

Get the day of the week
public String getDayOfTheWeek()
Usage:                      day = tad.getDayOfTheWeek();
Returns the day of the week, e.g. on Thursday, 27 August 2009 this method would return Thursday.

Get the day of the week as an integer
public int getDayOfTheWeekAsInteger()
Usage:                      day = tad.getDayOfTheWeekAsInteger();
Returns the day of the week as an integer, i.e. returns 1 for Sunday, returns 2 for Monday, etc.

Get the day of the month
public int getDayOfTheMonth()
Usage:                      day = tad.getDayOfTheMonth();
Returns the day of the month, e.g. on Thursday, 27 August 2009 this method would return 27.

Get the day of an entered date
public String getDayOfDate(int dayOfTheMonth, int month, int year)
public String getDayOfDate(int dayOfTheMonth, String month, int year)
Usage:                      day = tad.getDayOfDate(2, 10, 2009);
or
Usage:                      day = tad.getDayOfDate(2, "October", 2009);
Returns the day of an entered date, e.g. returned Friday when called on 2 October 2009. The month may be entered as full name of the month, e.g "January", or as an integer, e.g. 1 for January.

Get the month as a name
public String getMonth()
Usage:                      month = tad.getMonth();
Returns the month as a name, e.g. on Thursday, 27 August 2009 this method would return August.
See below for the month as a name

Get the month as an integer
public int getMonthAsInteger()
Usage:                      month = tad.getMonthAsInteger();
Returns the month as an integer, e.g. on Thursday, 27 August 2009 this method would return 8.
See above for the month as an integer.

Get the year
public int getYear()
Usage:                      year = tad.getYear();
Returns the year, e.g. on Thursday, 27 August 2009 this method would return 2009.

Check for a leap year
public boolean leapYear(int year)
Usage:                      year = tad.leapYear(year);
Returns true if the year entered (int argument year) is a leap year, otherwise false is returned. The year should be entered as a four figure integer, e.g. 2009.

Check whether within British Summer Time
public boolean checkBST()
Usage:                      bst = tad.checkBST();
Returns true if the current date is within British Summer Time (BST) [European Summer Time], i.e. lies between 1.00 am on the last Sunday of March and 2.00 am (BST) on the last Sunday of October. Returns false if it does not.

Calculate the next British Summer Time clock change
public String nextBstClockChange()
Usage:                      changeDate = tad.nextBstClockChange();
Returns the date of the next day on which the clocks have to be put forward one hour (start of British Summer Time (BST) [European Summer Time]) or put back one hour (end of British Summer Time (BST) [European Summer Time]). The day (Sunday), day of the month, month (March or October), the year and the direction of change are returned as a String.

Easter Sunday
These methods return the date for Easter Sunday as celebrated by the Western Christian Church according to the Gregorian Calendar. The algoritm used is listed on the BBC web site, http://www.bbc.co.uk/dna/h2g2/A653267, and has only been checked for the years 1700 to 2299.
public String easterSunday()
public String easterSunday(int year)
Usage:                      day = tad.easterSunday();
Returns the date of the next Easter Sunday as a string, e.g. "Sunday, 4 April 2010".

Usage:                      day = tad.easterSunday(year);
Returns the date of Easter Sunday for the entered year (argument year) as a String, e.g. "Sunday, 12 April 2009" for the entered year 2009.

Good Friday
These methods call the method easterSunday and are subject to the same limitations.
public String goodFriday()
public String goodFriday(int year)
Usage:                      day = tad.goodFriday();
Returns the date of the next Good Friday as a string, e.g. "Friday, 2 April 2010".

Usage:                      day = tad.goodFriday(year);
Returns the date of Good Friday for the entered year (argument year) as a String, e.g. "Friday, 10 April 2009" for the entered year 2009.

Maundy Thursday
These methods call the method easterSunday and are subject to the same limitations.
public String maundyThursday()
public String maundyThursday(int year)
Usage:                      day = tad.maundyThursday();
Returns the date of the next Maundy Thursday as a string, e.g. "Thursday, 1 April 2010".

Usage:                      day = tad.maundyThursday(year);
Returns the date of Maundy Thursday for the entered year (argument year) as a String, e.g. "Thursday, 9 April 2009" for the entered year 2009.

Palm Sunday
These methods call the method easterSunday and are subject to the same limitations.
public String palmSunday()
public String palmSunday(int year)
Usage:                      day = tad.palmSunday();
Returns the date of the next Palm Sunday as a string, e.g. "Sunday, 28 March 2010".

Usage:                      day = tad.palmSunday(year);
Returns the date of Palm Sunday for the entered year (argument year) as a String, e.g. "Sunday, 5 April 2009" for the entered year 2009.

Ash Wednesday
These methods call the method easterSunday and are subject to the same limitations.
public String ashWednesday()
public String ashWednesday(int year)
Usage:                      day = tad.ashWednesday();
Returns the date of the next Ash Wednesday as a string, e.g. "Wednesday, 17 February 2010".

Usage:                      day = tad.ashWednesday(year);
Returns the date of Ash Wednesday for the entered year (argument year) as a String, e.g. "Wednesday, 25 February 2009" for the entered year 2009.

Shrove Tuesday
These methods call the method easterSunday and are subject to the same limitations.
public String shroveTuesday()
public String shroveTuesday(int year)
Usage:                      day = tad.shroveTuesday();
Returns the date of the next Shrove Tuesday as a string, e.g. "Tuesday, 16 February 2010".

Usage:                      day = tad.shroveTuesday(year);
Returns the date of Shrove Tuesday for the entered year (argument year) as a String, e.g. "Tuesday, 24 February 2009" for the entered year 2009.

Christmas Day
public String christmasDay()
public String christmasDay(int year)
Usage:                      day = tad.christmasDay();
Returns the date of the next Christmas Day as a string, e.g. "Saturday, 25 December 2010".

Usage:                      day = tad.christmasDay(year);
Returns the date of Christmas Day for the entered year (argument year) as a String, e.g. "Friday, 25 December 2009" for the entered year 2009.

Epiphany
public String epiphany()
public String epiphany(int year)
public String sundayAfterEpiphany()
public String sundayAfterEpiphany(int year)
Usage:                      day = tad.epiphany();
Returns the date of the next Epiphany as a string, e.g. "Wednesday, 6 January 2010".

Usage:                      day = tad.epiphany(year);
Returns the date of Epiphany for the entered year (argument year) as a String, e.g. "Tuesday, 6 January 2009" for the entered year 2009.

Usage:                      day = tad.sundayAfterEpiphany();
Returns the date of the next Sunday after Epiphany, if Epiphany does not fall on a Sunday, as a string, e.g. "Sunday, 10 January 2010".

Usage:                      day = tad.sundayAfterEpiphany(year);
Returns the date of the Sunday after Epiphany, if Epiphany does not fall on a Sunday, for the entered year (argument year) as a String, e.g. "Sunday, 11 January 2009" for the entered year 2009.

First Sunday in Advent [Advent Sunday]
public String adventSunday()
public String adventSunday(int year)
Usage:                      day = tad.adventSunday();
Returns the date of the next First Sunday in Advent as a string, e.g. "Sunday, 28 November 2010".

Usage:                      day = tad.adventSunday(year);
Returns the date of the First Sunday in Advent for the entered year (argument year) as a String, e.g. "Sunday, 29 November 2009" for the entered year 2009.

Feast of the Purification of the Virgin (Feast of the Presentation of Jesus, Candlemas)
public String purification()
public String purification(int year)
public String presentation()
public String presentation(int year)
public String candlemas()
public String candlemas(int year)
Usage:                      day = tad.purification();
                                 day = tad.presentation();
                                 day = tad.candlemas();
Returns the date of the next Feast of the Purification as a string, e.g. "Tuesday, 2 February 2010".

Usage:                      day = tad.purification(year);
                                 day = tad.presentation(year);
                                 day = tad.candlemas(year);
Returns the date of the Feast of the Purification for the entered year (argument year) as a String, e.g. "Monday, 2 February 2009" for the entered year 2009.

Feast of the Annunciation
public String annunciation()
public String annunciation(int year)
Usage:                      day = tad.annunciation();
Returns the date of the next Feast of the Annunciation as a string, e.g. "Thursday, 25 March 2010".

Usage:                      day = tad.annunciation(year);
Returns the date of the Feast of the Annunciation for the entered year (argument year) as a String, e.g. "Wednesday, 25 March 2009" for the entered year 2009.

Whit Sunday (Pentecost)
These methods call the method easterSunday and are subject to the same limitations.
public String whitSunday()
public String whitSunday(int year)
Usage:                      day = tad.whitSunday();
Returns the date of the next Whit Sunday (Pentecost) as a string, e.g. "Sunday, 23 May 2010".

Usage:                      day = tad.whitSunday(year);
Returns the date of Whit Sunday (Pentecost) for the entered year (argument year) as a String, e.g. "Sunday, 31 May 2009" for the entered year 2009.

Ascension Day
These methods call the method easterSunday and are subject to the same limitations.
public String ascensionThursday()
public String ascensionThursday(int year)
public String sundayAfterAscensionThursday()
public String sundayAfterAscensionThursday(int year)
Usage:                      day = tad.ascensionThursday();
Returns the date of the next Ascension Thursday as a string, e.g. "Thursday, 13 May 2010".

Usage:                      day = tad.ascensionThursday(year);
Returns the date of Ascension Thursday for the entered year (argument year) as a String, e.g. "Thursday, 21 May 2009" for the entered year 2009.

Usage:                      day = tad.sundayAfterAscensionThursday();
Returns the date of the next Sunday after Ascension Thursday as a string, e.g. "Sunday, 16 May 2010".

Usage:                      day = tad.sundayAfterAscensionThursday(year);
Returns the date of the Sunday after Ascension Thursday for the entered year (argument year) as a String, e.g. "Sunday, 24 May 2009" for the entered year 2009.

Trinity Sunday
These methods call the method easterSunday and are subject to the same limitations.
public String trinitySunday()
public String trinitySunday(int year)
Usage:                      day = tad.trinitySunday();
Returns the date of the next Trinity Sunday as a string, e.g. "Sunday, 30 May 2010".

Usage:                      day = tad.trinitySunday(year);
Returns the date of Trinity Sunday for the entered year (argument year) as a String, e.g. "Sunday, 7 June 2009" for the entered year 2009.

Corpus Christi
These methods call the method easterSunday and are subject to the same limitations.
public String corpusChristi()
public String corpusChristi(int year)
public String sundayAfterCorpusChristi()
public String sundayAfterCorpusChristi(int year)
Usage:                      day = tad.corpusChristi();
Returns the date of the next Corpus Christi as a string, e.g. "Thursday, 3 June 2010".

Usage:                      day = tad.sundaycorpusChristi(year);
Returns the date of Corpus Christi for the entered year (argument year) as a String, e.g. "Thursday, 11 June 2009" for the entered year 2009.

Usage:                      day = tad.sundayAfterCorpusChristi();
Returns the date of the next Sunday after Corpus Christi as a string, e.g. "Sunday, 6 June 2010".

Usage:                      day = tad.sundayAfterCorpusChristi(year);
Returns the date of the Sunday after Corpus Christi for the entered year (argument year) as a String, e.g. "Sunday, 14 June 2009" for the entered year 2009.

Feast of the Transfiguration of Christ
public String transfiguration()
public String transfiguration(int year)
Usage:                      day = tad.transfiguration();
Returns the date of the next Feast of the Transfiguration as a String, e.g. "Friday, 6 August 2010".

Usage:                      day = tad.transfiguration(year);
Returns the date of the Feast of the Transfiguration for the entered year (argument year) as a String, e.g. "Thursday, 6 August 2009" for the entered year 2009.

Feast of the Assumption
public String assumption()
public String assumption(int year)
Usage:                      day = tad.assumption();
Returns the date of the next Feast of the Assumption as a String, e.g. "Sunday, 15 August 2010".

Usage:                      day = tad.assumption(year);
Returns the date of the Feast of the Assumption for the entered year (argument year) as a String, e.g. "Saturday, 15 August 2009" for the entered year 2009.

Feast of the Nativity of the Blessed Virgin
public String nativityBlessedVirgin()
public String nativityBlessedVirgin(int year)
Usage:                      day = tad.nativityBlessedVirgin();
Returns the date of the next Feast of the Nativity of the Blessed Virgin as a String, e.g. "Wednesday, 8 September 2010".

Usage:                      day = tad.nativityBlessedVirgin(year);
Returns the date of the FFeast of the Nativity of the Blessed Virgin for the entered year (argument year) as a String, e.g. "Tuesday, 8 September 2009" for the entered year 2009.

Feast of the Immaculate Conception
public String immaculateConception()
public String immaculateConception(int year)
Usage:                      day = tad.immaculateConception();
Returns the date of the next Feast of the Immaculate Conception as a String, e.g. "Wednesday, 8 December 2010".

Usage:                      day = tad.immaculateConception(year);
Returns the date of the FFeast of the Immaculate Conception for the entered year (argument year) as a String, e.g. "Tuesday, 8 December 2009" for the entered year 2009.

St Patrick's Day
public String saintPatricksDay()
public String saintPatricksDay(int year)
Usage:                      day = tad.saintPatricksDay();
Returns the date of the next St Patrick's Day as a string, e.g. "Wednesday, 17 March 2010".

Usage:                      day = tad.saintPatricksDay(year);
Returns the date of St Patrick's Day for the entered year (argument year) as a String, e.g. "Tuesday, 17 March 2009" for the entered year 2009.

St George's Day
public String saintGeorgesDay()
public String saintGeorgesDay(int year)
Usage:                      day = tad.saintGeorgesDay();
Returns the date of the next St George's Day as a string, e.g. "Friday, 23 April 2010".

Usage:                      day = tad.saintGeorgesDay(year);
Returns the date of St George's Day for the entered year (argument year) as a String, e.g. "Wednesday, 23 April 2009" for the entered year 2009.

St Andrew's Day
public String saintAndrewsDay()
public String saintAndrewsDay(int year)
Usage:                      day = tad.saintAndrewsDay();
Returns the date of the next St Andrew's Day as a string, e.g. "Tuesday, 30 November 2010".

Usage:                      day = tad.saintAndrewsDay(year);
Returns the date of St Andrew's Day for the entered year (argument year) as a String, e.g. "Monday, 30 November 2009" for the entered year 2009.

St David's Day
public String saintDavidsDay()
public String saintDavidsDay(int year)
Usage:                      day = tad.saintDavidsDay();
Returns the date of the next St David's Day as a string, e.g. "Monday, 1 March 2010".

Usage:                      day = tad.saintDavidsDay(year);
Returns the date of St David's Day for the entered year (argument year) as a String, e.g. "Sunday, 1 March 2009" for the entered year 2009.

St Stephen's Day
public String saintStephensDay()
public String saintStephensDay(int year)
Usage:                      day = tad.saintStephensDay();
Returns the date of the next St Stephen's Day as a string, e.g. "Sunday, 26 December 2009 2010".

Usage:                      day = tad.saintValentinesDay(year);
Returns the date of St Stephen's Day for the entered year (argument year) as a String, e.g. "Saturday, 26 December 2009" for the entered year 2009.

St Valentine's Day
public String saintValentinesDay()
public String saintValentinesDay(int year)
Usage:                      day = tad.saintValentinesDay();
Returns the date of the next St Valentine's Day as a string, e.g. "Sunday, 14 February 2010".

Usage:                      day = tad.saintValentinesDay(year);
Returns the date of St Valentine's Day for the entered year (argument year) as a String, e.g. "Saturday, 14 February 2009" for the entered year 2009.

St Brigid's Day
public String saintBrigidsDay()
public String saintBrigidsDay(int year)
Usage:                      day = tad.saintBrigidsDay();
Returns the date of the next St Brigid's Day as a string, e.g. "Monday, 1 February 2010".

Usage:                      day = tad.saintBrigidsDay(year);
Returns the date of St Brigid's Day for the entered year (argument year) as a String, e.g. "Sunday, 1 February 2009" for the entered year 2009.

St Colm Cille's Day [St Columba's Day, St Colmcille's day]
These methods return the full date of St Colm Cille's Feast day. Colm Cille is also known as Colmcille and Columba.
public String saintColmCillesDay()
public String saintColmCillesDay(int year)
public String saintColmcillesDay()
public String saintColmcillesDay(int year)
public String saintColumbasDay()
public String saintColumbasDay(int year)
Usage:                      day = tad.saintColmCillesDay();
                                  day = tad.saintColmcillesDay();
                                  day = tad.saintColumbasDay();
Returns the date of the next St Colm Cille's Day as a string, e.g. "Wednesday, 9 June 2010".

Usage:                      day = tad.saintColmCillesDay(year);
                                  day = tad.saintColmcillesDay(year);
                                  day = tad.saintColumbasDay(year);
Returns the date of St Colm Cille's Day for the entered year (argument year) as a String, e.g. "Tuesday, 9 June 2009" for the entered year 2009.

Mothers's Day (Mothering Sunday)
These methods return the date of Mother's Day (Mothering Sunday) as celebrated in either the United Kingdom and Ireland or in the United States and many other countries. See Mother's Day for a full list.

United Kingdom and Ireland public String mothersDayUK() public String mothersDayUK(int year) Usage:                      day = tad.mothersDayUK(); Returns the date of the next Mothers's Day (Mothering Sunday), in the United Kingdom and in Ireland, as a String, e.g. "Sunday, 14 March 2010". Usage:                      day = tad.mothersDayUK(year); Returns the date of Mothers's Day (Mothering Sunday), in the United Kingdom and in Ireland, for the entered year (argument year) as a String, e.g. "Sunday, 22 March 2009" for the entered year 2009. United States of America public String mothersDayUS() public String mothersDayUS(int year) Usage:                      day = tad.mothersDayUS(); Returns the date of the next Mothers's Day (Mothering Sunday), in the United States, as a String, e.g. "Sunday, 9 June 2010". Usage:                      day = tad.mothersDayUS(year); Returns the date of Mothers's Day (Mothering Sunday), in the United States, for the entered year (argument year) as a String, e.g. "Sunday, 10 May 2009" for the entered year 2009.

Father's Day
These methods return the date of Father's Day as celebrated in the United Kingdom, Ireland and the United States and many other countries. See Father's Day for a full list.
public String fathersDay()
public String fathersDay(int year)
Usage:                      day = tad.fathersDay();
Returns the date of the next Father's Day as a String, e.g. "Sunday, 20 June 2010".

Usage:                      day = tad.fathersDay(year);
Returns the date of Father's Day for the entered year (argument year) as a String, e.g. "Sunday, 21 June 2009" for the entered year 2009.

Burns' Night
public String burnsNight()
public String burnsNight(int year)
Usage:                      day = tad.burnsNight();
Returns the date of the next Burns' Night as a string, e.g. "Monday, 25 January 2010".

Usage:                      day = tad.burnsNight(year);
Returns the date of Burns' Night for the entered year (argument year) as a String, e.g. "Sunday, 25 January 2009" for the entered year 2009.

Twelfth of July
public String twelfthJuly()
public String twelfthJuly(int year)
Usage:                      day = tad.twelfthJuly();
Returns the date of the next Twelfth of July as a String, e.g. "Monday, 12 July 2010".

Usage:                      day = tad.twelfthJuly(year);
Returns the date of Twelfth of July for the entered year (argument year) as a String, e.g. "Sunday, 12 July 2009" for the entered year 2009.

Commonwealth Day
public String commonwealthDay()
public String commonwealthDay(int year)
Usage:                      day = tad.commonwealthDay();
Returns the date of the next Commonwealth Day as a String, e.g. "Monday, 8 March 2010".

Usage:                      day = tad.commonwealthDay(year);
Returns the date of Commonwealth Day for the entered year (argument year) as a String, e.g. "Monday, 9 March 2009" for the entered year 2009.

Armed Forces Day [UK Veterans' Day]
public String armedForcesDay()
public String armedForcesDay(int year)
public String veteransDayUK()
public String veteransDayUK(int year)
Usage:                      day = tad.armedForcesDay();
                                  day = tad.veteransDayUK();
Returns the date of the next Armed Forces Day as a string, e.g. "Sunday, 27 June 2010".

Usage:                      day = tad.armedForcesDay(year);
                                  day = tad.veteransDayUK(year);
Returns the date of Armed Forces Day for the entered year (argument year) as a String, e.g. "Saturday, 27 June 2009" for the entered year 2009.

Fourth of July
public String fourthJuly()
public String fourthJuly(int year)
Usage:                      day = tad.fourthJuly();
Returns the date of the next Fourth of July (US Independence Day) as a String, e.g. "Sunday, 4 July 2010".

Usage:                      day = tad.fourthJuly(year);
Returns the date of Fourth of July (US Independence Day) for the entered year (argument year) as a String, e.g. "Saturday, 4 July 2009" for the entered year 2009.

Thanksgiving Day
public String thanksgivingDay()
public String thanksgivingDay(int year)
Usage:                      day = tad.thanksgivingDay();
Returns the date of the next US Thanksgiving Day as a String, e.g. "Thursday, 18 November 2010".

Usage:                      day = tad.thanksgivingDay(year);
Returns the date of the US Thanksgiving Day for the entered year (argument year) as a String, e.g. "Thursday, 19 November 2009" for the entered year 2009.

Remembrance Sunday
public String remembranceSunday()
public String remembranceSunday(int year)
Usage:                      day = tad.remembranceSunday();
Returns the date of the next Remembrance Sunday as a String, e.g. "Sunday, 14 November 2010".

Usage:                      day = tad.remembranceSunday(year);
Returns the date of Remembrance Sunday for the entered year (argument year) as a String, e.g. "Sunday, 8 November 2009" for the entered year 2009.

Holocaust Memorial Day
public String holocaustMemorialDay()
public String holocaustMemorialDay(int year)
Usage:                      day = tad.holocaustMemorialDay();
Returns the date of the next Holocaust Memorial Day as a String, e.g. "Wednesday, 27 January 2010".

Usage:                      day = tad.holocaustMemorialDay(year);
Returns the date of Holocaust Memorial Day for the entered year (argument year) as a String, e.g. "Tuesday, 27 January 2009" for the entered year 2009.

---

OTHER CLASSES USED BY THIS CLASS

This class uses the following classes in this library:

• None

---

This page was prepared by Dr Michael Thomas Flanagan

---