This class provides a collection of time functions. More...

Public Member Functions
	OFTime ()
	default constructor.
	OFTime (const OFTime &timeVal)
	copy constructor
	OFTime (const unsigned int hour, const unsigned int minute, const double second=unspecifiedSecond, const double timeZone=unspecifiedTimeZone)
	constructor with init values
virtual	~OFTime ()
	destructor
virtual OFTime &	operator= (const OFTime &timeVal)
	assignment operator
virtual OFBool	operator== (const OFTime &timeVal) const
	comparison operator (equal).
virtual OFBool	operator!= (const OFTime &timeVal) const
	comparison operator (unequal) Please note that the time values are first transformed to the Coordinated Universal Time (UTC) before they are compared.
virtual OFBool	operator< (const OFTime &timeVal) const
	comparison operator (less than) Please note that the time values are first transformed to the Coordinated Universal Time (UTC) before they are compared.
virtual OFBool	operator<= (const OFTime &timeVal) const
	comparison operator (less than or equal) Please note that the time values are first transformed to the Coordinated Universal Time (UTC) before they are compared.
virtual OFBool	operator>= (const OFTime &timeVal) const
	comparison operator (greater than or equal) Please note that the time values are first transformed to the Coordinated Universal Time (UTC) before they are compared.
virtual OFBool	operator> (const OFTime &timeVal) const
	comparison operator (greater than) Please note that the time values are first transformed to the Coordinated Universal Time (UTC) before they are compared.
virtual void	clear ()
	reset the time value.
void	clearSecond ()
	clear the second value, i.e. set it to "unspecified"
void	clearTimeZone ()
	clear the time zone value, i.e. set it to "unspecified"
virtual OFBool	isValid () const
	check whether the currently stored time value is valid.
virtual OFBool	hasSecond () const
	check whether a second value is specified
virtual OFBool	hasFractionOfSecond () const
	check whether the second value has a fractional part, i.e. it is not an integer
virtual OFBool	hasTimeZone () const
	check whether a time zone value is specified, i.e. an offset to Coordinated Universal Time (UTC)
OFBool	setTime (const unsigned int hour, const unsigned int minute, const double second=unspecifiedSecond, const double timeZone=unspecifiedTimeZone)
	set the time value to the specified time.
OFBool	setHour (const unsigned int hour)
	set the time value to the specified hour.
OFBool	setMinute (const unsigned int minute)
	set the time value to the specified minute.
OFBool	setSecond (const double second)
	set the time value to the specified second.
OFBool	setTimeZone (const double timeZone)
	set the time zone to the specified value.
OFBool	setTimeZone (const signed int hour, const unsigned int minute)
	set the time zone to the specified value.
OFBool	setLocalTimeZone ()
	set the time zone to the local time zone.
OFBool	setTimeInSeconds (const double seconds, const double timeZone=unspecifiedTimeZone, const OFBool normalize=OFTrue)
	set the time to the specified number of seconds
OFBool	setTimeInHours (const double hours, const double timeZone=unspecifiedTimeZone, const OFBool normalize=OFTrue)
	set the time to the specified number of hours
OFBool	setCurrentTime ()
	set the time value to the current system time, including the local time zone.
OFBool	setISOFormattedTime (const OFString &formattedTime)
	set the time value to the given ISO formatted time string.
OFBool	setISOFormattedTimeZone (const OFString &formattedTimeZone)
	set the time zone value to the given ISO formatted time zone string.
unsigned int	getHour () const
	get the currently stored hour value
unsigned int	getMinute () const
	get the currently stored minute value
double	getSecond () const
	get the currently stored second value
unsigned int	getIntSecond () const
	get the integral part of the currently stored second value
unsigned int	getMilliSecond () const
	get the milli second part of the currently stored second value
unsigned int	getMicroSecond () const
	get the micro second part of the currently stored second value
double	getTimeZone () const
	get the currently stored time zone value.
double	getTimeInSeconds (const OFBool useTimeZone=OFFalse, const OFBool normalize=OFTrue) const
	get the currently stored time in seconds
double	getTimeInHours (const OFBool useTimeZone=OFFalse, const OFBool normalize=OFTrue) const
	get the currently stored time in hours.
OFTime	getCoordinatedUniversalTime () const
	get the currently stored time as Coordinated Universal Time.
OFTime	getLocalTime () const
	get the currently stored time in local time.
OFBool	getISOFormattedTime (OFString &formattedTime, const OFBool showSeconds=OFTrue, const OFBool showFraction=OFFalse, const OFBool showTimeZone=OFFalse, const OFBool showDelimiter=OFTrue, const OFBool createMissingPart=OFFalse, const OFString &timeZoneSeparator=" ") const
	get the current time value in ISO format.
OFBool	getISOFormattedTimeZone (OFString &formattedTimeZone, const OFBool showDelimiter=OFTrue) const
	get the current time zone value in ISO format.

Static Public Member Functions
static OFTime	getCurrentTime ()
	get the current system time
static double	getLocalTimeZone ()
	get the local time zone.
static OFBool	isTimeValid (const unsigned int hour, const unsigned int minute, const double second=unspecifiedSecond, const double timeZone=unspecifiedTimeZone)
	check whether the given time is valid.
static OFBool	isSecondSpecified (const double second)
	check whether the given second value is specified
static OFBool	isTimeZoneValid (const double timeZone, const OFBool acceptUnspecified=OFFalse)
	check whether the given time zone is valid, i.e. within the valid range, or unspecified if explicitly accepted.
static OFBool	isTimeZoneSpecified (const double timeZone)
	check whether the given time zone is specified

Static Public Attributes
static const double	unspecifiedSecond
	constant value that denotes an unspecified second.
static const double	unspecifiedTimeZone
	constant value that denotes an unspecified time zone.

Protected Member Functions
OFBool	setCurrentTime (const time_t &tt)
	set the time value to the current system time.

Static Protected Member Functions
static double	getTimeInSeconds (const unsigned int hour, const unsigned int minute, const double second, const double timeZone=unspecifiedTimeZone, const OFBool normalize=OFTrue)
	get the given time in seconds
static double	getTimeInHours (const unsigned int hour, const unsigned int minute, const double second, const double timeZone=unspecifiedTimeZone, const OFBool normalize=OFTrue)
	get the given time in hours

Private Attributes
unsigned int	Hour
	currently stored hour value
unsigned int	Minute
	currently stored minute value
double	Second
	currently stored second value (including fraction of seconds)
double	TimeZone
	currently stored time zone value, i.e. time difference to UTC in hours

Friends
class	OFDateTime

Detailed Description

This class provides a collection of time functions.

Note: Please note that support for the leap second is limited: a value of 60 seconds is accepted (i.e. considered valid), but calculations based on such a time value might be incorrect.

Constructor & Destructor Documentation

◆ OFTime() [1/3]

OFTime::OFTime ( )

default constructor.

Initializes hour, minute and second to 0, and time zone to "unspecified".

Referenced by OFTime(), getCoordinatedUniversalTime(), getCurrentTime(), getLocalTime(), operator!=(), operator<(), operator<=(), operator=(), operator==(), operator>(), and operator>=().

◆ OFTime() [2/3]

OFTime::OFTime ( const OFTime & timeVal )

copy constructor

Parameters

timeVal time object to be copied

References OFTime().

◆ OFTime() [3/3]

OFTime::OFTime	(	const unsigned int	hour,
		const unsigned int	minute,
		const double	second = unspecifiedSecond,
		const double	timeZone = unspecifiedTimeZone )

constructor with init values

Parameters

hour	hour value to be set
minute	minute value to be set
second	optional second value to be set (including fraction of seconds)
timeZone	optional offset to Coordinated Universal Time (UTC) in hours

References unspecifiedSecond, and unspecifiedTimeZone.

Member Function Documentation

◆ clear()

virtual void OFTime::clear ( )

virtual

reset the time value.

Sets the hour and minute to 0, and second as well as time zone to "unspecified".

◆ getCoordinatedUniversalTime()

OFTime OFTime::getCoordinatedUniversalTime ( ) const

get the currently stored time as Coordinated Universal Time.

The resulting time object always has a time zone of "+00:00" since the time is corrected regarding the Coordinated Universal Time (UTC).

Returns: time object with the UTC corrected time set

References OFTime().

◆ getCurrentTime()

OFTime OFTime::getCurrentTime ( )

static

get the current system time

Returns: time object with the current system time set

References OFTime().

◆ getHour()

unsigned int OFTime::getHour ( ) const

get the currently stored hour value

Returns: hour value (might be invalid, i.e. out of range)

◆ getIntSecond()

unsigned int OFTime::getIntSecond ( ) const

get the integral part of the currently stored second value

Returns: second value (might be invalid, i.e. out of range), 0 if unspecified

◆ getISOFormattedTime()

OFBool OFTime::getISOFormattedTime	(	OFString &	formattedTime,
		const OFBool	showSeconds = OFTrue,
		const OFBool	showFraction = OFFalse,
		const OFBool	showTimeZone = OFFalse,
		const OFBool	showDelimiter = OFTrue,
		const OFBool	createMissingPart = OFFalse,
		const OFString &	timeZoneSeparator = " " ) const

get the current time value in ISO format.

The ISO time formats supported by this function are

"HH:MM[:SS[.FFFFFF]] [&ZZ:ZZ]" (with delimiters),
"HH:MM[:SS[.FFFFFF]][&ZZ:ZZ]" (according to ISO 8601) and
"HHMM[SS[.FFFFFF]][&ZZZZ]" (without delimiters, useful for DICOM time type)

where the brackets enclose optional parts and the "&" is a placeholder for the sign symbol ("+" or "-").

Note: If no time zone is specified, but the output of the time zone is requested, it is not added to the output parameter 'formattedTime'.

Parameters

formattedTime	reference to string variable where the result is stored
showSeconds	add optional seconds (":SS" or "SS") to the resulting string if OFTrue. By default, the seconds are only added if a value is specified.
showFraction	add optional fractional part of a second (".FFFFFF") if OFTrue. Requires parameter 'seconds' to be also OFTrue. By default, the fractional part is only added if the second value is not an integer (see hasFractionOfSecond()).
showTimeZone	add optional time zone ("&ZZ:ZZ" or "&ZZZZ") to the resulting string if OFTrue. The time zone indicates the offset from the Coordinated Universal Time (UTC) in hours and minutes. The time zone is only added if a value is specified.
showDelimiter	flag, indicating whether to use delimiters (":" and " ") or not
createMissingPart	if OFTrue, create optional parts (seconds and fractional part of a second) even if not specified (see hasSecond() and hasFractionOfSecond())
timeZoneSeparator	separator between ISO time value and time zone, e.g. " " (default) or "" (for ISO 8601 format). Only used if 'showDelimiter' is true.

Returns: OFTrue if result variable has been set, i.e. the time is valid, OFFalse otherwise

Referenced by DcmIODUtil::setContentDateAndTimeNow().

◆ getISOFormattedTimeZone()

OFBool OFTime::getISOFormattedTimeZone	(	OFString &	formattedTimeZone,
		const OFBool	showDelimiter = OFTrue ) const

get the current time zone value in ISO format.

The two ISO time zone formats supported by this function are

"&HH:MM" (with delimiter, e.g. for ISO 8601 format) and
"&HHMM" (without delimiter, useful for DICOM attribute TimezoneOffsetFromUTC)

where the "&" is a placeholder for the sign symbol ("+" or "-").

Note: If no time zone is specified, the output parameter 'formattedTimeZone' is cleared.

Parameters

formattedTimeZone	reference to string variable where the result is stored
showDelimiter	flag, indicating whether to use a delimiter (":") or not

Returns: OFTrue if result variable has been set, i.e. the time zone is valid, OFFalse otherwise

◆ getLocalTime()

OFTime OFTime::getLocalTime ( ) const

get the currently stored time in local time.

The resulting time object always has the local time zone.

Returns: time object with the corrected time set

References OFTime().

◆ getLocalTimeZone()

double OFTime::getLocalTimeZone ( )

static

get the local time zone.

This function uses operating system dependent routines. If they are unavailable for some reason, the time zone is set to "unspecified". Also please note that time zones in the range ]+12.0,+14.0] cannot be detected due to the internally used algorithm.

Returns: local time zone if available, "unspecified" otherwise

◆ getMicroSecond()

unsigned int OFTime::getMicroSecond ( ) const

get the micro second part of the currently stored second value

Returns: micro second part (0..999999), 0 if unspecified

◆ getMilliSecond()

unsigned int OFTime::getMilliSecond ( ) const

get the milli second part of the currently stored second value

Returns: milli second part (0..999), 0 if unspecified

◆ getMinute()

unsigned int OFTime::getMinute ( ) const

get the currently stored minute value

Returns: minute value (might be invalid, i.e. out of range)

◆ getSecond()

double OFTime::getSecond ( ) const

get the currently stored second value

Returns: second value (might be unspecified or invalid, i.e. out of range)

◆ getTimeInHours() [1/2]

double OFTime::getTimeInHours	(	const OFBool	useTimeZone = OFFalse,
		const OFBool	normalize = OFTrue ) const

get the currently stored time in hours.

Parameters

useTimeZone	use the currently set time zone to correct the result
normalize	if OFTrue, results larger than or equal 24.0 (hours) are normalized to a valid range

Returns: number of hours since "00:00:00" (including fraction of hours)

◆ getTimeInHours() [2/2]

double OFTime::getTimeInHours	(	const unsigned int	hour,
		const unsigned int	minute,
		const double	second,
		const double	timeZone = unspecifiedTimeZone,
		const OFBool	normalize = OFTrue )

staticprotected

get the given time in hours

Parameters

hour	hour value of the given time
minute	minute value of the given time
second	second value of the given time
timeZone	optional offset to Coordinated Universal Time (UTC) in hours
normalize	if OFTrue, results larger than or equal 24.0 (hours) are normalized to a valid range

Returns: number of hours since "00:00:00" (including fraction of hours)

References unspecifiedTimeZone.

◆ getTimeInSeconds() [1/2]

double OFTime::getTimeInSeconds	(	const OFBool	useTimeZone = OFFalse,
		const OFBool	normalize = OFTrue ) const

get the currently stored time in seconds

Parameters

useTimeZone	use the currently set time zone to correct the result
normalize	if OFTrue, results larger than or equal 86400.0 (seconds) are normalized to a valid range

Returns: number of seconds since "00:00:00"

◆ getTimeInSeconds() [2/2]

double OFTime::getTimeInSeconds	(	const unsigned int	hour,
		const unsigned int	minute,
		const double	second,
		const double	timeZone = unspecifiedTimeZone,
		const OFBool	normalize = OFTrue )

staticprotected

get the given time in seconds

Parameters

hour	hour value of the given time
minute	minute value of the given time
second	second value of the given time
timeZone	optional offset to Coordinated Universal Time (UTC) in hours
normalize	if OFTrue, results larger than or equal 86400.0 (seconds) are normalized to a valid range

Returns: number of seconds since "00:00:00"

References unspecifiedTimeZone.

◆ getTimeZone()

double OFTime::getTimeZone ( ) const

get the currently stored time zone value.

The time zone is given as the offset (in hours) to the Coordinated Universal Time (UTC). Valid values are for instance "+1.0" (plus one hour) and "-2.5" (minus two and a half hours, i.e. 2 hours and 30 minutes). Use hasTimeZone() to make sure that a time zone value is actually specified. Alternatively, the static functions isTimeZoneValid() and isTimeZoneSpecified() can be used to check whether the returned value is valid and/or specified.

Returns: time zone value (might be unspecified or invalid, i.e. out of range)

◆ hasFractionOfSecond()

virtual OFBool OFTime::hasFractionOfSecond ( ) const

virtual

check whether the second value has a fractional part, i.e. it is not an integer

Returns: OFTrue if fraction of seconds is specified, OFFalse otherwise

◆ hasSecond()

virtual OFBool OFTime::hasSecond ( ) const

virtual

check whether a second value is specified

Returns: OFTrue if a second value is specified, OFFalse otherwise

◆ hasTimeZone()

virtual OFBool OFTime::hasTimeZone ( ) const

virtual

check whether a time zone value is specified, i.e. an offset to Coordinated Universal Time (UTC)

Returns: OFTrue if a time zone value is specified, OFFalse otherwise

◆ isSecondSpecified()

OFBool OFTime::isSecondSpecified ( const double second )

static

check whether the given second value is specified

Parameters

second second value to be checked

Returns: OFTrue if the given second value is specified, OFFalse otherwise

◆ isTimeValid()

OFBool OFTime::isTimeValid	(	const unsigned int	hour,
		const unsigned int	minute,
		const double	second = unspecifiedSecond,
		const double	timeZone = unspecifiedTimeZone )

static

check whether the given time is valid.

Valid ranges: [0,24[ for 'hour', [0,60[ for 'minute', [0.0,60.0[ for 'second' and [-12.0,+14.0] for 'timeZone' (if specified)

Parameters

hour	hour value to be checked
minute	minute value to be checked
second	optional second value to be checked
timeZone	optional offset to Coordinated Universal Time (UTC) in hours

Returns: OFTrue if the given time is valid, OFFalse otherwise

References unspecifiedSecond, and unspecifiedTimeZone.

◆ isTimeZoneSpecified()

OFBool OFTime::isTimeZoneSpecified ( const double timeZone )

static

check whether the given time zone is specified

Parameters

timeZone offset to Coordinated Universal Time (UTC) in hours

Returns: OFTrue if the given time zone is specified, OFFalse otherwise

◆ isTimeZoneValid()

OFBool OFTime::isTimeZoneValid	(	const double	timeZone,
		const OFBool	acceptUnspecified = OFFalse )

static

check whether the given time zone is valid, i.e. within the valid range, or unspecified if explicitly accepted.

Valid range: [-12.0,+14.0]

Parameters

timeZone	offset to Coordinated Universal Time (UTC) in hours
acceptUnspecified	also accept unspecified time zone if OFTrue

Returns: OFTrue if the given time zone is valid, OFFalse otherwise

◆ isValid()

virtual OFBool OFTime::isValid ( ) const

virtual

check whether the currently stored time value is valid.

Valid ranges: [0,24[ for 'hour', [0,60[ for 'minute', [0.0,60.0] for 'second' (including leap second) and [-12.0,+14.0] for 'timeZone'

Returns: OFTrue if the current value is valid, OFFalse otherwise

◆ operator!=()

virtual OFBool OFTime::operator!= ( const OFTime & timeVal ) const

virtual

comparison operator (unequal) Please note that the time values are first transformed to the Coordinated Universal Time (UTC) before they are compared.

Parameters

timeVal time value compared with the current value

Returns: OFTrue if given time is unequal, OFFalse otherwise

References OFTime().

◆ operator<()

virtual OFBool OFTime::operator< ( const OFTime & timeVal ) const

virtual

comparison operator (less than) Please note that the time values are first transformed to the Coordinated Universal Time (UTC) before they are compared.

Parameters

timeVal time value compared with the current value

Returns: OFTrue if current time is earlier than the given value, OFFalse otherwise

References OFTime().

◆ operator<=()

virtual OFBool OFTime::operator<= ( const OFTime & timeVal ) const

virtual

comparison operator (less than or equal) Please note that the time values are first transformed to the Coordinated Universal Time (UTC) before they are compared.

Parameters

timeVal time value compared with the current value

Returns: OFTrue if current time is earlier than or identical to the given value, OFFalse otherwise

References OFTime().

◆ operator=()

virtual OFTime & OFTime::operator= ( const OFTime & timeVal )

virtual

assignment operator

Parameters

timeVal time value to be set

Returns: reference to this object (with new value)

References OFTime().

◆ operator==()

virtual OFBool OFTime::operator== ( const OFTime & timeVal ) const

virtual

comparison operator (equal).

Please note that the time values are first transformed to the Coordinated Universal Time (UTC) before they are compared.

Parameters

timeVal time value compared with the current value

Returns: OFTrue if given time is equal, OFFalse otherwise

References OFTime().

◆ operator>()

virtual OFBool OFTime::operator> ( const OFTime & timeVal ) const

virtual

comparison operator (greater than) Please note that the time values are first transformed to the Coordinated Universal Time (UTC) before they are compared.

Parameters

timeVal time value compared with the current value

Returns: OFTrue if current time is later than the given value, OFFalse otherwise

References OFTime().

◆ operator>=()

virtual OFBool OFTime::operator>= ( const OFTime & timeVal ) const

virtual

comparison operator (greater than or equal) Please note that the time values are first transformed to the Coordinated Universal Time (UTC) before they are compared.

Parameters

timeVal time value compared with the current value

Returns: OFTrue if current time is later than or identical to the given value, OFFalse otherwise

References OFTime().

◆ setCurrentTime() [1/2]

OFBool OFTime::setCurrentTime ( )

set the time value to the current system time, including the local time zone.

This function uses operating system dependent routines. If they are unavailable for some reason the current value is not modified.

Returns: OFTrue if the current system time has been set, OFFalse otherwise

Referenced by DcmIODUtil::setContentDateAndTimeNow().

◆ setCurrentTime() [2/2]

OFBool OFTime::setCurrentTime ( const time_t & tt )

protected

set the time value to the current system time.

This function uses operating system dependent routines. If they are unavailable for some reason the current value is not modified.

Parameters

tt	current system time (as returned by the time() function)

Returns: OFTrue if the current system time has been set, OFFalse otherwise

◆ setHour()

OFBool OFTime::setHour ( const unsigned int hour )

set the time value to the specified hour.

Before the new value is set, it is checked using the isTimeValid() method.

Parameters

hour	new hour value to be set

Returns: OFTrue if the new value is valid and has been set, OFFalse otherwise

◆ setISOFormattedTime()

OFBool OFTime::setISOFormattedTime ( const OFString & formattedTime )

set the time value to the given ISO formatted time string.

The most common ISO time formats supported by this function are

"HH:MM[:SS[.FFFFFF]] [&ZZ:ZZ]" (with arbitrary delimiters),
"HH:MM[:SS[.FFFFFF]][&ZZ:ZZ]" (according to ISO 8601) and
"HHMM[SS[.FFFFFF]][&ZZZZ]" (without delimiters)

where the brackets enclose optional parts and the "&" is a placeholder for the sign symbol ("+" or "-"). The pattern "FFFFFF" contains a fractional part of a second. If specified, it shall contain one to six digits representing a range from 0 to 999999. In the first two formats listed, spaces between time and time zone components are accepted. Leading or trailing spaces are never accepted.

Parameters

formattedTime ISO formatted time value to be set

Returns: OFTrue if input is valid and result variable has been set, OFFalse otherwise

◆ setISOFormattedTimeZone()

OFBool OFTime::setISOFormattedTimeZone ( const OFString & formattedTimeZone )

set the time zone value to the given ISO formatted time zone string.

The two ISO time zone formats supported by this function are

"&HH:MM" (with arbitrary delimiter, e.g. for ISO 8601 format) and
"&HHMM" (without delimiter, useful for DICOM attribute TimezoneOffsetFromUTC).

where the "&" is a placeholder for the sign symbol ("+" or "-").

Note: If the parameter 'formattedTimeZone' is an empty string, the time zone value is set to "unspecified".

Parameters

formattedTimeZone ISO formatted time zone value to be set, or an empty string

Returns: OFTrue if input is valid and result variable has been set, OFFalse otherwise

◆ setLocalTimeZone()

OFBool OFTime::setLocalTimeZone ( )

set the time zone to the local time zone.

See getLocalTimeZone() for details.

Returns: OFTrue if the new value is valid and has been set, OFFalse otherwise

◆ setMinute()

OFBool OFTime::setMinute ( const unsigned int minute )

set the time value to the specified minute.

Before the new value is set, it is checked using the isTimeValid() method.

Parameters

minute new minute value to be set

Returns: OFTrue if the new value is valid and has been set, OFFalse otherwise

◆ setSecond()

OFBool OFTime::setSecond ( const double second )

set the time value to the specified second.

Before the new value is set, it is checked using the isTimeValid() method.

Parameters

second new second value to be set (including fraction of seconds)

Returns: OFTrue if the new value is valid and has been set, OFFalse otherwise

◆ setTime()

OFBool OFTime::setTime	(	const unsigned int	hour,
		const unsigned int	minute,
		const double	second = unspecifiedSecond,
		const double	timeZone = unspecifiedTimeZone )

set the time value to the specified time.

Before the new value is set, it is checked using the isTimeValid() method.

Parameters

hour	new hour value to be set
minute	new minute value to be set
second	optional second value to be set (including fraction of seconds)
timeZone	optional offset to Coordinated Universal Time (UTC) in hours

Returns: OFTrue if the new value is valid and has been set, OFFalse otherwise

References unspecifiedSecond, and unspecifiedTimeZone.

◆ setTimeInHours()

OFBool OFTime::setTimeInHours	(	const double	hours,
		const double	timeZone = unspecifiedTimeZone,
		const OFBool	normalize = OFTrue )

set the time to the specified number of hours

Parameters

hours	number of hours since "00:00:00" specifying time to set
timeZone	optional offset to Coordinated Universal Time (UTC) in hours
normalize	if OFTrue, the 'hours' value is normalized to the valid range [0.0,24.0[ otherwise the value is checked as is

Returns: OFTrue if the new value is valid and has been set, OFFalse otherwise

References unspecifiedTimeZone.

◆ setTimeInSeconds()

OFBool OFTime::setTimeInSeconds	(	const double	seconds,
		const double	timeZone = unspecifiedTimeZone,
		const OFBool	normalize = OFTrue )

set the time to the specified number of seconds

Parameters

seconds	number of seconds since "00:00:00" specifying time to set
timeZone	optional offset to Coordinated Universal Time (UTC) in hours
normalize	if OFTrue, the 'seconds' value is normalized to the valid range [0.0,86400.0[ otherwise the value is checked as is

Returns: OFTrue if the new value is valid and has been set, OFFalse otherwise

References unspecifiedTimeZone.

◆ setTimeZone() [1/2]

OFBool OFTime::setTimeZone ( const double timeZone )

set the time zone to the specified value.

The time zone is given as the offset (in hours) to the Coordinated Universal Time (UTC). Valid values are for instance "+1.0" (plus one hour) and "-2.5" (minus two and a half hour, i.e. 2 hours and 30 minutes). Before the new value is set, it is checked using isTimeZoneSpecified() and isTimeZoneValid().

Parameters

timeZone new timeZone value to be set

Returns: OFTrue if the new value is valid and has been set, OFFalse otherwise

◆ setTimeZone() [2/2]

OFBool OFTime::setTimeZone	(	const signed int	hour,
		const unsigned int	minute )

set the time zone to the specified value.

The time zone is given as the offset (in hours and minutes) to the Coordinated Universal Time (UTC). Before the new value is set, it is checked using the isTimeZoneValid() method.

Parameters

hour	new hour value to be set for the time zone
minute	new minute value to be set for the time zone

Returns: OFTrue if the new value is valid and has been set, OFFalse otherwise

Member Data Documentation

◆ unspecifiedSecond

const double OFTime::unspecifiedSecond

static

constant value that denotes an unspecified second.

Note: Do not use this value for comparison purposes.

Referenced by OFTime(), isTimeValid(), and setTime().

◆ unspecifiedTimeZone

const double OFTime::unspecifiedTimeZone

static

constant value that denotes an unspecified time zone.

Note: Do not use this value for comparison purposes.

Referenced by OFDateTime::OFDateTime(), OFTime(), DcmTime::getOFTimeFromString(), DcmTime::getOFTimeFromString(), getTimeInHours(), getTimeInSeconds(), isTimeValid(), OFDateTime::setDateTime(), setTime(), setTimeInHours(), and setTimeInSeconds().

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

ofstd/include/dcmtk/ofstd/oftime.h

Public Member Functions

Static Public Member Functions

Static Public Attributes

Protected Member Functions

Static Protected Member Functions

Private Attributes

Friends

Detailed Description

Constructor & Destructor Documentation

◆ OFTime() [1/3]

◆ OFTime() [2/3]

◆ OFTime() [3/3]

Member Function Documentation

◆ clear()

◆ getCoordinatedUniversalTime()

◆ getCurrentTime()

◆ getHour()

◆ getIntSecond()

◆ getISOFormattedTime()

◆ getISOFormattedTimeZone()

◆ getLocalTime()

◆ getLocalTimeZone()

◆ getMicroSecond()

◆ getMilliSecond()

◆ getMinute()

◆ getSecond()

◆ getTimeInHours() [1/2]

◆ getTimeInHours() [2/2]

◆ getTimeInSeconds() [1/2]

◆ getTimeInSeconds() [2/2]

◆ getTimeZone()

◆ hasFractionOfSecond()

◆ hasSecond()

◆ hasTimeZone()

◆ isSecondSpecified()

◆ isTimeValid()

◆ isTimeZoneSpecified()

◆ isTimeZoneValid()

◆ isValid()

◆ operator!=()

◆ operator<()

◆ operator<=()

◆ operator=()

◆ operator==()

◆ operator>()

◆ operator>=()

◆ setCurrentTime() [1/2]

◆ setCurrentTime() [2/2]

◆ setHour()

◆ setISOFormattedTime()

◆ setISOFormattedTimeZone()

◆ setLocalTimeZone()

◆ setMinute()

◆ setSecond()

◆ setTime()

◆ setTimeInHours()

◆ setTimeInSeconds()

◆ setTimeZone() [1/2]

◆ setTimeZone() [2/2]

Member Data Documentation

◆ unspecifiedSecond

◆ unspecifiedTimeZone