Date/Time Methods

dateInMillisecs(); Get a date in milliseconds
get/setCurrentDate(); Get/Set Current Date
get/setEndDate(); Get/Set End Date
getMillisFromDate(); Get Milliseconds from Date
get/setStartDate(); Get/Set Start Date
setupDate(); Setup Date

dateInMillisecs()

This method returns the time in milliseconds from the Calendar and Date classes.

SYNTAX:

double dateInMillisecs (Calendar calendar)

INPUT:

calendar: Calendar object

RETURN:

double; the time in milliseconds in internal Java format (i.e., the number of milliseconds since January 1, 1970 00:00:00.000 GMT)

get/setCurrentDate()

These methods get/set the current date for a gantt chart.

SYNTAX:

double getCurrentDate();
void   setCurrentDate (int nMonth, int nDay, int nYear);
void   setCurrentDate (double newValue);

INPUT:

nMonth; month (1..12)

nDay; day (0...31)

nYear; year (4-digits)

newValue; current date specified as the number of milliseconds since January 1, 1970 00:00:00.000 GMT (Java internal format).

RETURN:

double; current date specified as the number of milliseconds since January 1, 1970 00:00:00.000 GMT (Java internal format).

EXAMPLE:

setGraphType (99);
setTitleString ("Gantt Chart");
setData (0, 0, 8, 1, 2003); 
setData (0, 1, 8, 2, 2003); 
setData (0, 2, 25.0); 
setData (0, 3, 8, 3, 2003); 
setData (0, 4, 8, 4, 2003); 
setData (0, 5, 1); 
setData (0, 6, -1); 
setSeriesLabel (0, "Task 1 - Wash Dog");
setData (1, 0, 8, 5, 2003); 
setData (1, 1, 8, 6, 2003); 
setData (1, 2, 50.0); 
setData (1, 3, 8, 7, 2003); 
setData (1, 4, 8, 8, 2003); 
setData (1, 5, 2); 
setData (1, 6, -1); 
setSeriesLabel (1, "Task 2 - Wash Cat");
setStartDate (8, 1, 2003);
setCurrentDate (8, 11, 2003);
setEndDate (8, 30, 2003);
setDataRange (0, 0, 1, 6);

ALSO SEE:

dateInMillisecs(), get/setEndDate(), get/setStartDate()

get/setEndDate()

These methods get/set the end date in a gantt chart or a bar, line, or scatter chart where a time scale axis is defined.

SYNTAX:

double getEndDate()
void   setEndDate (int nMonth, int nDay, int nYear);
void   setEndDate (double newValue);
void   setEndDate (Calendar calendarDate);

INPUT:

nMonth; month (1...12)

nDay; day of the month (0...31)

nYear; 4-digit year value

newValue; end date value in internal Java format

calendarDate; a Java Calendar object

RETURN:

double; the end date specified as the number of milliseconds since January 1, 1970 00:00:00.000 GMT (Java internal format).

EXAMPLE:

setGraphType (99);
setTitleString ("Gantt Chart");
setData (0, 0, 8, 1, 2003); 
setData (0, 1, 8, 2, 2003); 
setData (0, 2, 25.0); 
setData (0, 3, 8, 3, 2003); 
setData (0, 4, 8, 4, 2003); 
setData (0, 5, 1); 
setData (0, 6, -1); 
setSeriesLabel (0, "Task 1 - Wash Dog");
setData (1, 0, 8, 5, 2003); 
setData (1, 1, 8, 6, 2003); 
setData (1, 2, 50.0); 
setData (1, 3, 8, 7, 2003); 
setData (1, 4, 8, 8, 2003); 
setData (1, 5, 2); 
setData (1, 6, -1); 
setSeriesLabel (1, "Task 2 - Wash Cat");
setStartDate (8, 1, 2003);
setCurrentDate (8, 11, 2003);
setEndDate (8, 30, 2003);
setDataRange (0, 0, 1, 6);

ALSO SEE:

get/setCurrentDate(), dateInMillisecs(), get/setStartDate(), "Data in Gantt Charts", "Data in Time Scale Axis Charts"

getMillisFromDate()

This function returns the time in milliseconds since January 1, 1970, 0:00:00 GMT for the date/time specified by the input parameters.

SYNTAX:

long getMillisFromDate (int year, int month, int day, int hour, int minute, int second);

INPUT:

year; a year number (e.g., 2004)

month; month number 1...12 (1=January, 12=December)

day; day in month (i.e., 1...31)

hour; hour in day (1...24)

minute; minute in hour (1...60)

second; second in minute (1...60)

RETURN:

long; current time in milliseconds since January 1, 1970, 0:00:00 GMT.

get/setStartDate()

These methods get/set the start date in a gantt chart or a bar, line, or scatter chart where a time scale axis is defined.

SYNTAX:

double getStartDate();
void setStartDate (int nMonth, int nDay, int nYear);
void setStartDate (double newValue);
void setStartDate (Calendar calendarDate);

INPUT:

nMonth; start date month (1...12)

nDay; start date day of the month (1...31)

nYear; 4-digit year (e.g., 2003)

newValue; start date value in internal Java format (double)

calendarDate; a Calendar object

RETURN:

double; start date date specified as the number of milliseconds since January 1, 1970 00:00:00.000 GMT (Java internal format)

EXAMPLE:

setGraphType (99);
setTitleString ("Gantt Chart");
setData (0, 0, 8, 1, 2003); 
setData (0, 1, 8, 2, 2003); 
setData (0, 2, 25.0); 
setData (0, 3, 8, 3, 2003); 
setData (0, 4, 8, 4, 2003); 
setData (0, 5, 1); 
setData (0, 6, -1); 
setSeriesLabel (0, "Task 1 - Wash Dog");
setData (1, 0, 8, 5, 2003); 
setData (1, 1, 8, 6, 2003); 
setData (1, 2, 50.0); 
setData (1, 3, 8, 7, 2003); 
setData (1, 4, 8, 8, 2003); 
setData (1, 5, 2); 
setData (1, 6, -1); 
setSeriesLabel (1, "Task 2 - Wash Cat");
setStartDate (8, 1, 2003);
setCurrentDate (8, 11, 2003);
setEndDate (8, 30, 2003);
setDataRange (0, 0, 1, 6);

ALSO SEE:

get/setCurrentDate(), dateInMillisecs(), get/setEndDate(), get/setCurrentDate(), "Data in Gantt Charts", "Data in Time Scale Axis Charts"

setupDate()

This method is a utility routine that is useful in setting up Gantt charts. It returns the date in milliseconds for the specified month, day and year.

SYNTAX:

double setupDate (int nMonth, int nDay, int nYear);

INPUT:

nMonth; month number 1...12 (1=January, 12=December)

nDay; day in month (i.e., 1...31)

nYear; a year number (e.g., 2004)

RETURN:

double; the current date in milliseconds

NOTES:

This method sets hour, minute, second, and millisecond values to zero.