DODS_Date_Time.h

 
// -*- mode: c++; c-basic-offset:4 -*-
 
// This file is part of ff_handler a FreeForm API handler for the OPeNDAP
// DAP2 data server.
 
// Copyright (c) 2005 OPeNDAP, Inc.
// Author: James Gallagher <jgallagher@opendap.org>
//
// This is free software; you can redistribute it and/or modify it under the
// terms of the GNU Lesser General Public License as published by the Free
// Software Foundation; either version 2.1 of the License, or (at your
// option) any later version.
// 
// This software 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 Lesser General Public
// License for more details.
// 
// You should have received a copy of the GNU Lesser General Public
// License along with this library; if not, write to the Free Software
// Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
//
// You can contact OPeNDAP, Inc. at PO Box 112, Saunderstown, RI. 02874-0112.
 
 
// (c) COPYRIGHT URI/MIT 1998
// Please read the full copyright statement in the file COPYRIGHT.  
//
// Authors:
//      jhrg,jimg       James Gallagher (jgallagher@gso.uri.edu)
 
#ifndef _dods_date_time_h
#define _dods_date_time_h
 
 
#include "DODS_Date.h"
#include "DODS_Time.h"

 
class DODS_Date_Time {
 private:
    DODS_Date _date;
    DODS_Time _time;
 
    void parse_fractional_time(string date_time);
 public:

    DODS_Date_Time();

    DODS_Date_Time(DODS_Date d, DODS_Time t);

    DODS_Date_Time(string date_time);

    DODS_Date_Time(BaseType *date_time);

    DODS_Date_Time(int y, int m, int d, int hh, int mm = 0, double ss = 0.0,
           bool gmt = false); 

    DODS_Date_Time(int y, int yd, int hh, int mm = 0, double ss = 0.0, 
           bool gmt = false); 


    void set(DODS_Date d, DODS_Time t);

    void set(string date_time);

    void set(BaseType *date_time);

    void set(int y, int m, int d, int hh, int mm = 0, 
               double ss = 0.0, bool gmt = false);

    void set(int y, int yd, int hh, int mm = 0, double ss = 0.0, 
               bool gmt = false);


    int year() const;

    int month() const;

    int day() const;

    int day_number() const;

    int hours() const;

    int minutes() const;

    double seconds() const;

    bool gmt() const;
 
    string get(date_format format = ymd, bool gmt = true) const;

    double julian_day() const;

    time_t unix_time() const;


    friend int operator==(DODS_Date_Time &t1, DODS_Date_Time &t2);

    friend int operator!=(DODS_Date_Time &t1, DODS_Date_Time &t2);

    friend int operator<(DODS_Date_Time &t1, DODS_Date_Time &t2);

    friend int operator>(DODS_Date_Time &t1, DODS_Date_Time &t2);

    friend int operator<=(DODS_Date_Time &t1, DODS_Date_Time &t2);

    friend int operator>=(DODS_Date_Time &t1, DODS_Date_Time &t2);

    double get_epsilon() const;

    void set_epsilon(double eps);

    bool OK() const;
 
};
 
// $Log: DODS_Date_Time.h,v $
// Revision 1.4  2000/10/11 19:37:55  jimg
// Moved the CVS log entries to the end of files.
// Changed the definition of the read method to match the dap library.
// Added exception handling.
// Added exceptions to the read methods.
//
// Revision 1.3  1999/07/22 21:28:09  jimg
// Merged changes from the release-3-0-2 branch
//
// Revision 1.2.6.1  1999/06/01 15:38:06  jimg
// Added code to parse and return floating point dates.
//
// Revision 1.2  1999/05/04 02:55:35  jimg
// Merge with no-gnu
//
// Revision 1.1.6.1  1999/05/01 04:40:30  brent
// converted old String.h to the new std C++ <string> code
//
// Revision 1.1  1999/01/08 22:08:18  jimg
// Fixed doc++ comments.
//
 
#endif // _dods_date_time_h