USGS

Isis 3.0 Developer's Reference (API)

Home

Isis::iTime Class Reference

Parse and return pieces of a time string. More...

#include <iTime.h>

Public Member Functions

 iTime ()
 Constructs an empty iTime object.
 iTime (const QString &time)
 Constructs a iTime object and initializes it to the time from the argument.
 iTime (const double time)
 Constructs a iTime object and initializes it to the time from the argument.
 ~iTime ()
void operator= (const QString &time)
 Changes the value of the iTime object.
void operator= (const char *time)
void operator= (const double time)
bool operator>= (const iTime &time)
 Compare two iTime objects for greater than or equal.
bool operator<= (const iTime &time)
 Compare two iTime objects for less than or equal.
bool operator> (const iTime &time)
 Compare two iTime objects for greater than.
bool operator< (const iTime &time)
 Compare two iTime objects for less than.
bool operator!= (const iTime &time)
 Compare two iTime objects for inequality.
bool operator== (const iTime &time)
 Compare two iTime objects for equality.
iTime operator+ (const double &secondsToAdd) const
void operator+= (const double &secondsToAdd)
iTime operator- (const double &secondsToSubtract) const
double operator- (const iTime &iTimeToSubtract) const
void operator-= (const double &secondsToSubtract)
QString YearString () const
 Returns the year portion of the time as a string.
int Year () const
 Returns the year portion of the time as an int.
QString MonthString () const
 Returns the month portion of the time as a string.
int Month () const
 Returns the month portion of the time as an int.
QString DayString () const
 Returns the dat portion of the time as a string.
int Day () const
 Returns the day portion of the time as an int.
QString HourString () const
 Returns the hour portion of the time as a string.
int Hour () const
 Returns the hour portion of the time as an int.
QString MinuteString () const
 Returns the minute portion of the time as a string.
int Minute () const
 Returns the minute portion of the time as an int.
QString SecondString () const
 Returns the second portion of the time as a string.
double Second () const
 Returns the second portion of the time as a double.
QString DayOfYearString () const
 Returns the day of year portion of the time as a string.
int DayOfYear () const
 Returns the day of year portion of the time as an int.
QString EtString () const
 Returns the ephemeris time (TDB) representation of the time as a string.
double Et () const
 Returns the ephemeris time (TDB) representation of the time as a double.
QString UTC () const
 Returns the internally stored time, formatted as a UTC time.
void setEt (double et)
void setUtc (QString utcString)

Static Public Member Functions

static QString CurrentGMT ()
 Returns the current Greenwich Mean iTime The time is based on the system time, so it is only as accurate as the local system clock.
static QString CurrentLocalTime ()
 Returns the current local time This time is taken directly from the system clock, so if the system clock is off, this will be, too.

Friends

iTime operator+ (const double &secondsToAdd, iTime time)
iTime operator- (const double &secondsToSubtract, iTime time)

Detailed Description

Parse and return pieces of a time string.

This class parses a date/time string into individual components. The input time string can be in a variety of formats (see the NAIF routine str2et_c). The components and different representation can then be returned using the member functions.

Author
2003-10-24 Stuart Sides

Constructor & Destructor Documentation

Isis::iTime::iTime ( )

Constructs an empty iTime object.

Isis::iTime::iTime ( const QString &  time)

Constructs a iTime object and initializes it to the time from the argument.

Parameters
timeA time string formatted in standard UTC or similar format. Example:"2000/12/31 23:59:01.6789" or "2000-12-31T23:59:01.6789"
Isis::iTime::iTime ( const double  time)
inline

Constructs a iTime object and initializes it to the time from the argument.

Parameters
timeAn ephemeris time (ET).
Isis::iTime::~iTime ( )
inline

Member Function Documentation

QString Isis::iTime::CurrentGMT ( )
static

Returns the current Greenwich Mean iTime The time is based on the system time, so it is only as accurate as the local system clock.

Returns
QString The Current GMT
QString Isis::iTime::CurrentLocalTime ( )
static

Returns the current local time This time is taken directly from the system clock, so if the system clock is off, this will be, too.

Returns
QString The cutrrent local time
int Isis::iTime::Day ( ) const

Returns the day portion of the time as an int.

Returns
int

References Isis::IString::ToInteger().

int Isis::iTime::DayOfYear ( ) const

Returns the day of year portion of the time as an int.

Returns
int

References Isis::IString::ToInteger().

QString Isis::iTime::DayOfYearString ( ) const

Returns the day of year portion of the time as a string.

Returns
string

References Isis::toString().

QString Isis::iTime::DayString ( ) const

Returns the dat portion of the time as a string.

Returns
string

References Isis::toString().

double Isis::iTime::Et ( ) const
inline

Returns the ephemeris time (TDB) representation of the time as a double.

Referenced by Isis::Chandrayaan1M3Camera::Chandrayaan1M3Camera(), Isis::Spice::createCache(), Isis::CrismCamera::CrismCamera(), Isis::CTXCamera::CTXCamera(), Isis::DawnFcCamera::DawnFcCamera(), Isis::LineScanCameraGroundMap::FindFocalPlane(), Isis::HiresCamera::HiresCamera(), Isis::HiriseCamera::HiriseCamera(), Isis::VimsSkyMap::Init(), Isis::VimsGroundMap::Init(), Isis::IssNACamera::IssNACamera(), Isis::IssWACamera::IssWACamera(), Isis::KaguyaMiCamera::KaguyaMiCamera(), Isis::LoHighCamera::LoHighCamera(), Isis::LoMediumCamera::LoMediumCamera(), Isis::LroNarrowAngleCamera::LroNarrowAngleCamera(), Isis::LroWideAngleCamera::LroWideAngleCamera(), Isis::LwirCamera::LwirCamera(), Isis::MarciCamera::MarciCamera(), Isis::MiniRF::MiniRF(), Isis::MocNarrowAngleCamera::MocNarrowAngleCamera(), Isis::MocWideAngleCamera::MocWideAngleCamera(), Isis::MsiCamera::MsiCamera(), Isis::NewHorizonsLeisaCamera::NewHorizonsLeisaCamera(), Isis::NewHorizonsLorriCamera::NewHorizonsLorriCamera(), Isis::NewHorizonsMvicFrameCamera::NewHorizonsMvicFrameCamera(), Isis::NewHorizonsMvicTdiCamera::NewHorizonsMvicTdiCamera(), Isis::NirCamera::NirCamera(), Isis::NewHorizonsMvicFrameCamera::SetBand(), Isis::VariableLineScanCameraDetectorMap::SetDetector(), Isis::RadarPulseMap::SetDetector(), Isis::LineScanCameraDetectorMap::SetDetector(), Isis::RadarSlantRangeMap::SetFocalPlane(), Isis::Spice::setTime(), Isis::RadarSlantRangeMap::SetUndistortedFocalPlane(), Isis::SsiCamera::SsiCamera(), Isis::Camera::StartEndEphemerisTimes(), Isis::ThemisIrCamera::ThemisIrCamera(), Isis::ThemisVisCamera::ThemisVisCamera(), Isis::UvvisCamera::UvvisCamera(), Isis::VikingCamera::VikingCamera(), Isis::VimsCamera::VimsCamera(), and Isis::VoyagerCamera::VoyagerCamera().

QString Isis::iTime::EtString ( ) const

Returns the ephemeris time (TDB) representation of the time as a string.

See the Naif documentation "time.req" for more information.

Returns
string

References Isis::toString().

int Isis::iTime::Hour ( ) const

Returns the hour portion of the time as an int.

Returns
int

References Isis::IString::ToInteger().

QString Isis::iTime::HourString ( ) const

Returns the hour portion of the time as a string.

Returns
string

References Isis::toString().

int Isis::iTime::Minute ( ) const

Returns the minute portion of the time as an int.

Returns
int

References Isis::IString::ToInteger().

QString Isis::iTime::MinuteString ( ) const

Returns the minute portion of the time as a string.

Returns
string

References Isis::toString().

int Isis::iTime::Month ( ) const

Returns the month portion of the time as an int.

Returns
int

References Isis::IString::ToInteger().

QString Isis::iTime::MonthString ( ) const

Returns the month portion of the time as a string.

Returns
string

References Isis::toString().

bool Isis::iTime::operator!= ( const iTime time)

Compare two iTime objects for inequality.

Parameters
timeThe iTime object to be compared to "this"
Returns
bool
iTime Isis::iTime::operator+ ( const double &  secondsToAdd) const
void Isis::iTime::operator+= ( const double &  secondsToAdd)

References Isis::IsSpecial().

iTime Isis::iTime::operator- ( const double &  secondsToSubtract) const
double Isis::iTime::operator- ( const iTime iTimeToSubtract) const
void Isis::iTime::operator-= ( const double &  secondsToSubtract)

References Isis::IsSpecial().

bool Isis::iTime::operator< ( const iTime time)

Compare two iTime objects for less than.

Parameters
timeThe iTime object to be compared to "this"
Returns
bool
bool Isis::iTime::operator<= ( const iTime time)

Compare two iTime objects for less than or equal.

Parameters
timeThe iTime object to be compared to "this"
Returns
bool
void Isis::iTime::operator= ( const QString &  time)

Changes the value of the iTime object.

Parameters
timeA time string formatted in standard UTC or similar format. Example:"2000/12/31 23:59:01.6789" or "2000-12-31T23:59:01.6789"
void Isis::iTime::operator= ( const char *  time)
void Isis::iTime::operator= ( const double  time)
bool Isis::iTime::operator== ( const iTime time)

Compare two iTime objects for equality.

Parameters
timeThe iTime object to be compared to "this"
Returns
bool
bool Isis::iTime::operator> ( const iTime time)

Compare two iTime objects for greater than.

Parameters
timeThe iTime object to be compared to "this"
Returns
bool
bool Isis::iTime::operator>= ( const iTime time)

Compare two iTime objects for greater than or equal.

Parameters
timeThe iTime object to be compared to "this"
Returns
bool
double Isis::iTime::Second ( ) const

Returns the second portion of the time as a double.

Returns
double

References Isis::IString::ToDouble().

QString Isis::iTime::SecondString ( ) const

Returns the second portion of the time as a string.

Returns
string
void Isis::iTime::setEt ( double  et)

References Isis::IsSpecial().

void Isis::iTime::setUtc ( QString  utcString)
QString Isis::iTime::UTC ( ) const

Returns the internally stored time, formatted as a UTC time.

Returns
string The internalized time, in UTC format
int Isis::iTime::Year ( ) const

Returns the year portion of the time as an int.

Returns
int

References Isis::IString::ToInteger().

QString Isis::iTime::YearString ( ) const

Returns the year portion of the time as a string.

Returns
string

References Isis::toString().

Friends And Related Function Documentation

iTime operator+ ( const double &  secondsToAdd,
iTime  time 
)
friend
iTime operator- ( const double &  secondsToSubtract,
iTime  time 
)
friend

The documentation for this class was generated from the following files: