/* * Imp for the CEP date * * Copyright (C) Michael Still 2002 * Copyright (C) Kristy Van Der Vlist 2002 * * 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. */ #ifndef CEP_DATE_HEADER #define CEP_DATE_HEADER #include #include "cepUtility.h" #include "cepError.h" #include "math.h" /****************************************************************************** DOCBOOK START FUNCTION cepDate PURPOSE Converts a decimal date in the format of YYYY.DDDD, where YYYY is a four digit year and DDDD is the number of days into that year as a decimal to a standard Gregorian date. cepDate will also convert a date in the form of DD MMMMMM YYYY to a decimal date, where DD is the day of the month - 1..31 MMMMMM is the name of the month - either Jan...Dec or January...December and YYYY is a four Digit year. SYNOPSIS START To create a cepDate object to convert a decimal date to a Gregorian date use:- cepDate date(value); value:- The decimal value to be converted. It must be of the form YYYY.DDDD where YYYY is the four digit year and DDDD is the decimal represenation of the number of days into the year To create a cepDate object to convert a Gregorian date to a decimal date use:- cepDate date(day, month, year); day:- interger value of the day of the month from 1..31 month:- the name of the month. This can be either Jan...Dec or January...December year:- interger value of the year SYNOPSIS END DESCRIPTION START An implementation of the cepDate class converts a decimal date to a Gegorian date or a Gregorian date to a decimal. const string getDay() returns day of month in the format of 01...31. A return value of -1 indicates an error because the date entered was invalid. const string getMonth() returns month in the format of 01...12. A return value of -1 indicates an error because the date entered was invalid. const string getMonthName() returns month as a string in the format of January...December const string getShortMonthName() returns month as a string in the format of Jan...Dec const string getYear() returns year in the format of YYYY. A return value of -1 indicates an error because the date entered was invalid. const string getShortDate() returns date in short date in the format of DD/MM/YY const string getLongDate() returns date in long date date in the format of DD MMMMMM YY const string getDecimalDate() returns the date as a decimal date in the form YYYY.DDDD. A return value of -1 indicates an error because the date entered was invalid. 2 new methods added yearsToJulian and julianToYears. Both take and return doubles and have no relation to the member variables of this object. DESCRIPTION END DOCBOOK END ******************************************************************************/ const string MONTH_NAMES[12] = { "January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December" }; const string SHORTMONTH_NAMES[12] = { "Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec" }; const double LEAP_DAY_VAL = 0.002732240437; const double DAY_VAL = 0.002739726027; class cepError; class cepDate { public: cepDate (const double &decimal); cepDate (const int &day, string month, const int &year); // Returns day of month 01...31 const string getDay (); // Returns month 01...12 const string getMonth (); // Returns month as a string January...December const string getMonthName (); // Returns month as a string Jan...Dec const string getShortMonthName (); // Returns year in format YYYY const string getYear (); // Returns date in short date format DD/MM/YY const string getShortDate (); // Returns date in long date format DD MMMMMM YY const string getLongDate (); // Returns a decimal date const double getDecimalDate (); // --- yearsToJulian --- // This Method based on doy2 - fortran code written by Peter Morgan // Converts the decimal years format standard to this project to a linear truncated // Julian day number (day 0 = Jan 1st 1900). // These two date conversion methods were added at a very long date to fix the problem // of the decimal date format not being linear. // // Limits: yearsToJulian always assumes that each sample has been taken at exactly // 12 o'clock on a given day. This makes interpolation for input frequencies that // are multiples of daily. However it won't be able to cope with input datasets with // sampling rates of less than daily without modification of this function. // // Import: year: decimal year date as is used by the GDMS project // Export: Trunctated Julian day double yearsToJulian (double year); // -- julianToYears --- // Converts truncated Julian days back to decimal years // // note: places whole number of days at 12 noon on a given day // // Import: trunctated julain day // Export: decimal year double julianToYears (double julian); private: int m_month, m_day, m_year; double m_decimalDate; bool isLeap (); }; #endif