|
Quick Links: |
#include <bdlt_timetz.h>
Public Member Functions | |
| TimeTz () | |
| TimeTz (const Time &localTime, int offset) | |
| TimeTz (const TimeTz &original) | |
| ~TimeTz () | |
| TimeTz & | operator= (const TimeTz &rhs) |
| void | setTimeTz (const Time &localTime, int offset) |
| int | setTimeTzIfValid (const Time &localTime, int offset) |
| template<class STREAM > | |
| STREAM & | bdexStreamIn (STREAM &stream, int version) |
| Time | localTime () const |
| int | offset () const |
| Time | utcTime () const |
| template<class STREAM > | |
| STREAM & | bdexStreamOut (STREAM &stream, int version) const |
| bsl::ostream & | print (bsl::ostream &stream, int level=0, int spacesPerLevel=4) const |
| Time | gmtTime () const |
| int | validateAndSetTimeTz (const Time &localTime, int offset) |
Static Public Member Functions | |
| static bool | isValid (const Time &localTime, int offset) |
| static int | maxSupportedBdexVersion (int versionSelector) |
| static int | maxSupportedBdexVersion () |
This value-semantic class describes a time value in a particular time zone, which is indicated using an offset from UTC (in minutes). The offset is available via the offset method, and is defined by the relationship: localTime() - offset() == utcTime. The time and offset values are logically assumed to correspond to geographically valid values, however, this constraint is not enforced.
This class:
For terminology see bsldoc_glossary.
| bdlt::TimeTz::TimeTz | ( | ) |
Create a TimeTz object having the (default) attribute values.
| bdlt::TimeTz::TimeTz | ( | const Time & | localTime, | |
| int | offset | |||
| ) |
Create a TimeTz object whose local time and offset attributes have the specified localTime and offset values respectively. The behavior is undefined unless offset is in the range ( -1440 .. 1440 ), and offset is 0 if localTime has the value 24:00:00.000. Note that this method provides no validation, and it is the user's responsibility to ensure that offset represents a valid time zone and that localTime represents a valid time in that time zone.
| bdlt::TimeTz::TimeTz | ( | const TimeTz & | original | ) |
| bdlt::TimeTz::~TimeTz | ( | ) |
Destroy this object.
| static bool bdlt::TimeTz::isValid | ( | const Time & | localTime, | |
| int | offset | |||
| ) | [static] |
Return true if the specified localTime and the specified time zone offset represent a valid TimeTz value, and false otherwise. A localTime and offset represent a valid TimeTz value if offset is in the range ( -1440 .. 1440 ), and offset is 0 if localTime has the value 24:00:00.000. Note that a true result from this function does not guarantee that offset corresponds to any geographical or historical time zone. Also note that a true result from this function does not guarantee that localTime itself is a valid Time object.
| static int bdlt::TimeTz::maxSupportedBdexVersion | ( | int | versionSelector | ) | [static] |
Return the maximum valid BDEX format version, as indicated by the specified versionSelector, to be passed to the bdexStreamOut method. Note that it is highly recommended that versionSelector be formatted as "YYYYMMDD", a date representation. Also note that versionSelector should be a compile-time-chosen value that selects a format version supported by both externalizer and unexternalizer. See the bslx package-level documentation for more information on BDEX streaming of value-semantic types and containers.
Assign to this object the value of the specified rhs object, and return a reference providing modifiable access to this object.
| void bdlt::TimeTz::setTimeTz | ( | const Time & | localTime, | |
| int | offset | |||
| ) |
Set the local time and time zone offset attributes of this object to the specified localTime and offset values respectively. The behavior is undefined unless offset is in the range ( -1440 .. 1440 ). Note that this method provides no validation, and it is the user's responsibility to assure the consistency of the resulting value.
| int bdlt::TimeTz::setTimeTzIfValid | ( | const Time & | localTime, | |
| int | offset | |||
| ) |
Set the local time and the time zone offset of this object to the specified localTime and offset values respectively if localTime and offset represent a valid TimeTz value, and leave the object unmodified otherwise. Return 0 on success, and a non-zero value otherwise.
| STREAM& bdlt::TimeTz::bdexStreamIn | ( | STREAM & | stream, | |
| int | version | |||
| ) |
Assign to this object the value read from the specified input stream using the specified version format, and return a reference to stream. If stream is initially invalid, this operation has no effect. If version is not supported, this object is unaltered and stream is invalidated, but otherwise unmodified. If version is supported but stream becomes invalid during this operation, this object has an undefined, but valid, state. Note that no version is read from stream. See the bslx package-level documentation for more information on BDEX streaming of value-semantic types and containers.
| Time bdlt::TimeTz::localTime | ( | ) | const |
| int bdlt::TimeTz::offset | ( | ) | const |
Return the time zone offset of this object in minutes from UTC.
| Time bdlt::TimeTz::utcTime | ( | ) | const |
Return a Time object having the value of the UTC time represented by this object. Note that the returned value is equal to localTime() - offset() minutes.
| STREAM& bdlt::TimeTz::bdexStreamOut | ( | STREAM & | stream, | |
| int | version | |||
| ) | const |
Write the value of this object, using the specified version format, to the specified output stream, and return a reference to stream. If stream is initially invalid, this operation has no effect. If version is not supported, stream is invalidated, but otherwise unmodified. Note that version is not written to stream. See the bslx package-level documentation for more information on BDEX streaming of value-semantic types and containers.
| bsl::ostream& bdlt::TimeTz::print | ( | bsl::ostream & | stream, | |
| int | level = 0, |
|||
| int | spacesPerLevel = 4 | |||
| ) | const |
Write the value of this object to the specified output stream in a human-readable format, and return a reference to stream. Optionally specify an initial indentation level, whose absolute value is incremented recursively for nested objects. If level is specified, optionally specify spacesPerLevel, whose absolute value indicates the number of spaces per indentation level for this and all of its nested objects. If level is negative, suppress indentation of the first line. If spacesPerLevel is negative, format the entire output on one line, suppressing all but the initial indentation (as governed by level). If stream is not valid on entry, this operation has no effect. Note that the format is not fully specified, and can change without notice.
| Time bdlt::TimeTz::gmtTime | ( | ) | const |
DEPRECATED: replaced by utcTime.
Return a Time object having the value of the UTC time represented by this object. Note that the returned value is equal to localTime() - offset() minutes.
| static int bdlt::TimeTz::maxSupportedBdexVersion | ( | ) | [static] |
DEPRECATED: Use maxSupportedBdexVersion(int) instead.
Return the most current BDEX streaming version number supported by this class.
| int bdlt::TimeTz::validateAndSetTimeTz | ( | const Time & | localTime, | |
| int | offset | |||
| ) |
DEPRECATED: replaced by setTimeTzIfValid.
Set the local time and the time zone offset of this object to the specified localTime and offset values respectively if localTime and offset represent a valid TimeTz value. Return 0 on success, and a non-zero value with no effect on this object otherwise.
1.7.1