/usr/include/terralib/kernel/TeTime.h is in libterralib-dev 4.0.0-5ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 | /************************************************************************************
TerraLib - a library for developing GIS applications.
Copyright © 2001-2007 INPE and Tecgraf/PUC-Rio.
This code is part of the TerraLib library.
This library 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.
You should have received a copy of the GNU Lesser General Public
License along with this library.
The authors reassure the license terms regarding the warranties.
They specifically disclaim any warranties, including, but not limited to,
the implied warranties of merchantability and fitness for a particular purpose.
The library provided hereunder is on an "as is" basis, and the authors have no
obligation to provide maintenance, support, updates, enhancements, or modifications.
In no event shall INPE and Tecgraf / PUC-Rio be held liable to any party for direct,
indirect, special, incidental, or consequential damages arising out of the use
of this library and its documentation.
*************************************************************************************/
/*! \file TeTime.h
\brief This file contains structures and definitions to deal with date and time
*/
#ifndef __TERRALIB_INTERNAL_TIME_H
#define __TERRALIB_INTERNAL_TIME_H
#include "TeDefines.h"
#include "TeDataTypes.h"
#include <time.h>
#include <stdio.h>
#include <string>
#include <iostream>
//! A class for supporting date and time.
class TL_DLL TeTime
{
struct tm ts_; // Unix time structure
time_t last_; // time in seconds
TeChronon chronon_;
public:
//! Set the date and time from the system clock.
time_t now(void);
//! Set all time information with NULL value
TeTime(void);
//! Copy constructor.
TeTime(const TeTime& t);
//! Set the date from the system clock and the time from its parameter list. Chronon defaulted to second.
TeTime(int h, int m, int s, TeChronon chronon);
//! Set date and time from arguments, though the time fields.
TeTime( const std::string& dt, TeChronon chronon, const std::string& mask,
const std::string& dateS = "/", const std::string& timeS = ":", const std::string& indPM = "PM");
//! Return a time of day std::string in format "hh:mm:ss"
std::string getTime() const;
//! Return a std::string to the date in the form "yyyy-mm-dd"
std::string getDate(void) const;
//! Return a pointer to the date and time in the form passed in mask.
std::string getDateTime (const std::string& mask= "DDsMMsYYYYsHHsmmsSS", const std::string& dateS="/", const std::string& timeS=":", const std::string& indPM="PM", const std::string& indAM="AM") const;
//! Reset time to the specified arguments. Return time_t: number of seconds since 0:00:00 Jan 1 1987
/*!
\param y year
\param m month
\param d day
\param h hour
\param min minutes
\param s seconds
*/
time_t Set(int y, int m, int d, int h = 0, int min = 0, int s = 0);
//! Get year value as an four digit integer
int year() const {return ts_.tm_year+1900;}
//! Get month value
int month() const {return ts_.tm_mon+1;}
//! Get day of the month value
int day() const {return ts_.tm_mday;}
//! Get hour value as an integer
int hour() const {return ts_.tm_hour;}
//! Get minute value as an integer
int minute() const {return ts_.tm_min;}
//! Get second value as an integer
int second() const {return ts_.tm_sec;}
//! Get week day as in integer
int weekDay() const { return ts_.tm_wday;} //(0-6) 0=Sunday
//! Get year day as in integer
int yearDay() const { return ts_.tm_yday;} //(0-365) 01/01=0
//! Get chronon definition
TeChronon chronon() const {return chronon_;}
//! Set chronon definition
void chronon (TeChronon c);
//! Assignment operator for TeTime objects.
TeTime& operator=(const TeTime&);
//! Add 'delta' chronon units to the current date. Return current date.
TeTime& operator+=(int delta);
//! Increase a chronon unit in the time (Prefix operator)
TeTime& operator++();
//! Add 'delta' chronon units to the current date and return a new date. Return new date.
TeTime operator+(int delta);
//! Subtract 'delta' chronon units from the current date. Return current date.
TeTime& operator-=(int delta);
//! Operator ==
bool operator==(const TeTime& time) const;
//! Operator <
bool operator<(const TeTime& time) const;
//! Operator <=
bool operator<=(const TeTime& time) const;
//! Returns the difference betwwen the times in seconds
int operator-(const TeTime& other);
//! Verify if the time has null values
bool isValid() const;
//! Normal destructor.
~TeTime(void) { }
};
//! Operator to display an instance of TeTime
TL_DLL std::ostream& operator<<(std::ostream& os, TeTime& N);
#endif
|