The Time class implements a basic representation of time. More...

#include <tsTime.h>

Inheritance diagram for ts::Time:

Collaboration diagram for ts::Time:

[legend]

Classes
struct	Fields
	Broken-down fields of a time value. More...

class	TimeError
	Fatal low-level time error. More...

Public Types
enum	FieldMask { YEAR = 0x01 , MONTH = 0x02 , DAY = 0x04 , DATE = YEAR \| MONTH \| DAY , HOUR = 0x08 , MINUTE = 0x10 , SECOND = 0x20 , TIME = HOUR \| MINUTE \| SECOND , DATETIME = DATE \| TIME , MILLISECOND = 0x40 , ALL = DATE \| TIME \| MILLISECOND }
	Flags indicating the list of time fields to display. More...

Public Member Functions
	Time ()=default
	Default constructor.

	Time (const Fields &fields)
	Constructor from broken-down date fields in one single object.

	Time (int year, int month, int day, int hour, int minute, int second=0, int millisecond=0)
	Constructor from broken-down date fields.

void	clear ()
	Clear the time value.

bool	decode (const UString &str, int fields=DATE\|TIME)
	Decode a time from a string.

UString	format (int fields=ALL) const
	Format a string representation of a time.

Time	JSTToUTC () const
	Convert a JST (Japan Standard Time) to UTC time.

cn::seconds	leapSecondsTo (const Time &end) const
	Get the number of leap seconds between two UTC dates.

Time	localToUTC () const
	Convert a local time to UTC time.

Time	nextDay () const
	Get the beginning of the next day.

Time	nextHour () const
	Get the beginning of the next hour.

Time	nextMonth () const
	Get the beginning of the next month.

Time	nextYear () const
	Get the beginning of the next year.

	operator Fields () const
	Conversion operator from `Time` to `Time::Fields`.

template<class Rep , class Period >
Time	operator+ (cn::duration< Rep, Period > duration) const
	Operator Time + std::chrono::duration => Time.

template<class Rep , class Period >
Time &	operator+= (cn::duration< Rep, Period > duration)
	Operator Time += std::chrono::duration.

template<class Rep , class Period >
Time	operator- (cn::duration< Rep, Period > duration) const
	Operator Time - std::chrono::duration => Time.

cn::milliseconds	operator- (const Time &other) const
	Operator: Time - Time => cn::milliseconds.

template<class Rep , class Period >
Time &	operator-= (cn::duration< Rep, Period > duration)
	Operator Time -= std::chrono::duration.

bool	operator< (const Time &other) const
	Lower operator.

bool	operator<= (const Time &other) const
	Lower or equal operator.

bool	operator== (const Time &other) const
	Equality operator.

bool	operator> (const Time &other) const
	Greater operator.

bool	operator>= (const Time &other) const
	Greater or equal operator.

Time	thisDay () const
	Get the beginning of the current day.

Time	thisHour () const
	Get the beginning of the current hour.

Time	thisMonth () const
	Get the beginning of the current month.

Time	thisYear () const
	Get the beginning of the current year.

cn::seconds	toGPSSeconds () const
	Convert this time to a number of seconds since 1980-01-06, the GPS epoch.

virtual UString	toString () const override
	Convert to a string object.

uint64_t	toUnixTime () const
	Convert this time in a UNIX `time_t`.

Time	UTCToJST () const
	Convert a UTC time to JST (Japan Standard Time).

Time	UTCToLocal () const
	Convert a UTC time to local time.

Static Public Member Functions
static Time	CurrentLocalTime ()
	Static method returning the current local time.

static Time	CurrentUTC ()
	Static method returning the current UTC time.

static void	GetUnixClock (::timespec &result, clockid_t clock, const cn::milliseconds &delay=cn::milliseconds::zero())
	This static routine gets a system clock and adds a delay in milliseconds (UNIX systems only).

static Time	GPSSecondsToUTC (cn::seconds gps)
	This static routine converts a number of GPS seconds to a UTC time.

static bool	IsLeapYear (int year)
	Check if a year is a leap year (29 days in February).

static Time	NextHourLocalTime ()
	Get the beginning of the next hour, local time.

static Time	NextHourUTC ()
	Get the beginning of the next hour, UTC.

static Time	NextMonthLocalTime ()
	Get the beginning of the next month, local time.

static Time	NextMonthUTC ()
	Get the beginning of the next month, UTC.

static Time	NextYearLocalTime ()
	Get the beginning of the next year, local time.

static Time	NextYearUTC ()
	Get the beginning of the next year, UTC.

static Time	ThisHourLocalTime ()
	Get the beginning of the current hour, local time.

static Time	ThisHourUTC ()
	Get the beginning of the current hour, UTC.

static Time	ThisMonthLocalTime ()
	Get the beginning of the current month, local time.

static Time	ThisMonthUTC ()
	Get the beginning of the current month, UTC.

static Time	ThisYearLocalTime ()
	Get the beginning of the current year, local time.

static Time	ThisYearUTC ()
	Get the beginning of the current year, UTC.

static Time	TodayLocalTime ()
	Get the beginning of the current day, local time.

static Time	TodayUTC ()
	Get the beginning of the current day, UTC.

static Time	TomorrowLocalTime ()
	Get the beginning of the next day, local time.

static Time	TomorrowUTC ()
	Get the beginning of the next day, UTC.

static cn::nanoseconds	UnixClockNanoSeconds (clockid_t clock, const cn::milliseconds &delay=cn::milliseconds::zero())
	This static routine gets a system clock and adds a delay in milliseconds (UNIX systems only).

static Time	UnixTimeToUTC (uint64_t unixTime)
	This static routine converts a UNIX `time_t` to a UTC time.

static cn::milliseconds	Win32FileTimeToMilliSecond (const ::FILETIME &fileTime)
	This static routine converts a Win32 `FILETIME` to `cn::milliseconds` (Microsoft Windows only).

static Time	Win32FileTimeToUTC (const ::FILETIME &fileTime)
	This static routine converts a Win32 `FILETIME` to a UTC time (Microsoft Windows only).

Static Public Attributes
static const Time	Apocalypse
	Constant representing the End Of Time (at least on this operating system).

static const Time	Epoch
	Constant representing the Epoch, ie the first representable time on this operating system.

static const Time	GPSEpoch
	Constant representing the GPS Epoch, 1980-01-06.

static constexpr cn::milliseconds	JSTOffset = cn::hours(+9)
	Offset of a JST (Japan Standard Time) value from UTC in milliseconds.

static const cn::milliseconds	JulianEpochOffset
	Constant representing the offset of the Julian Epoch from the time Epoch of the operating system (Julian epoch - Time epoch) in milliseconds.

static const Time	UnixEpoch
	Constant representing the Epoch on UNIX operating systems.

static constexpr cn::seconds	UnixEpochToGPS = cn::seconds(315964800)
	Number of seconds between 1970-01-01 and 1980-01-06.

Detailed Description

The Time class implements a basic representation of time.

The implementation is based on the operating system representation of time. This means that the range of representable time values may vary from one system to another. You may use the constants Epoch and Apocalypse as first and last representable time values.

An instance of Time may be indifferently interpreted as a local time or UTC time value. Methods are provided to convert between local and UTC values. The accuracy of these conversions depend on the configuration of the operating system.

The implementation of the class is designed to be light and fast so that Time objects may be copied without overhead. The class is not polymorphic, there is no virtual methods and no vtable. In fact, the actual representation is only a 64-bit integer.

Member Enumeration Documentation

◆ FieldMask

enum ts::Time::FieldMask

Flags indicating the list of time fields to display.

Enumerator
YEAR	Display the year.
MONTH	Display the month.
DAY	Display the day.
DATE	Display the year, month and day.
HOUR	Display the hours.
MINUTE	Display the minutes.
SECOND	Display the seconds.
TIME	Display the hours, minutes and seconds.
DATETIME	Display the year, month, day, hours, minutes and seconds.
MILLISECOND	Display the milliseconds.
ALL	Display all fields.

Constructor & Destructor Documentation

◆ Time() [1/3]

ts::Time::Time ( )

default

Default constructor.

The initial value is the Epoch.

◆ Time() [2/3]

ts::Time::Time	(	int	year,
		int	month,
		int	day,
		int	hour,
		int	minute,
		int	second = `0`,
		int	millisecond = `0`
	)

Constructor from broken-down date fields.

Parameters

[in]	year	Number of years.
[in]	month	Number of months (1 to 12).
[in]	day	Number of days (1 to 31).
[in]	hour	Number of hours (0 to 23).
[in]	minute	Number of minutes (0 to 59).
[in]	second	Number of seconds (0 to 59).
[in]	millisecond	Number of milliseconds (0 to 999).

Exceptions

ts::Time::TimeError If any field is out of range or if the resulting time is outside the representable range for the local operating system.

◆ Time() [3/3]

ts::Time::Time ( const Fields & fields )

Constructor from broken-down date fields in one single object.

Can be used as a conversion operator from Time::Fields to Time.

Parameters

[in] fields The date fields.

Exceptions

ts::Time::TimeError If any field is out of range or if the resulting time is outside the representable range for the local operating system.

Member Function Documentation

◆ clear()

void ts::Time::clear ( )

inline

Clear the time value.

The time value becomes the Epoch.

◆ operator+()

template<class Rep , class Period >

Time ts::Time::operator+ ( cn::duration< Rep, Period > duration ) const

inline

Operator Time + std::chrono::duration => Time.

Parameters

[in] duration A duration.

Returns: A Time object representing this object plus the specified duration.

◆ operator-() [1/2]

template<class Rep , class Period >

Time ts::Time::operator- ( cn::duration< Rep, Period > duration ) const

inline

Operator Time - std::chrono::duration => Time.

Parameters

[in] duration A duration.

Returns: A Time object representing this object minus the specified duration.

◆ operator+=()

template<class Rep , class Period >

Time & ts::Time::operator+= ( cn::duration< Rep, Period > duration )

inline

Operator Time += std::chrono::duration.

Parameters

[in] duration A duration to add to this object.

Returns: A reference to this object.

◆ operator-=()

template<class Rep , class Period >

Time & ts::Time::operator-= ( cn::duration< Rep, Period > duration )

inline

Operator Time -= std::chrono::duration.

Parameters

[in] duration A duration to substract from this object.

Returns: A reference to this object.

◆ operator-() [2/2]

cn::milliseconds ts::Time::operator- ( const Time & other ) const

inline

Operator: Time - Time => cn::milliseconds.

Parameters

[in] other Another time to substract from this object.

Returns: The duration, in milliseconds, between this object and the other object.

◆ operator==()

bool ts::Time::operator== ( const Time & other ) const

inline

Equality operator.

Parameters

[in] other Another time to compare with this object.

Returns: True is this object is equal to the other object, false otherwise.

◆ operator<()

bool ts::Time::operator< ( const Time & other ) const

inline

Lower operator.

Parameters

[in] other Another time to compare with this object.

Returns: True is this time is before the other object time, false otherwise.

◆ operator<=()

bool ts::Time::operator<= ( const Time & other ) const

inline

Lower or equal operator.

Parameters

[in] other Another time to compare with this object.

Returns: True is this time is before or equal to the other object time, false otherwise.

◆ operator>()

bool ts::Time::operator> ( const Time & other ) const

inline

Greater operator.

Parameters

[in] other Another time to compare with this object.

Returns: True is this time is after the other object time, false otherwise.

◆ operator>=()

bool ts::Time::operator>= ( const Time & other ) const

inline

Greater or equal operator.

Parameters

[in] other Another time to compare with this object.

Returns: True is this time is after or equal to the other object time, false otherwise.

◆ operator Fields()

ts::Time::operator Fields ( ) const

Conversion operator from Time to Time::Fields.

Returns: A Time::Fields object containing the broken-down time.

Exceptions

ts::Time::TimeError In case of operating system time error.

◆ localToUTC()

Time ts::Time::localToUTC ( ) const

Convert a local time to UTC time.

Returns: A UTC time from this object time, interpreted as a local time.

Exceptions

ts::Time::TimeError In case of operating system time error.

◆ UTCToLocal()

Time ts::Time::UTCToLocal ( ) const

Convert a UTC time to local time.

Returns: A local time from this object time, interpreted as a UTC time.

Exceptions

ts::Time::TimeError In case of operating system time error.

◆ JSTToUTC()

Time ts::Time::JSTToUTC ( ) const

Convert a JST (Japan Standard Time) to UTC time.

Returns: A UTC time from this object time, interpreted as a JST time.

◆ UTCToJST()

Time ts::Time::UTCToJST ( ) const

Convert a UTC time to JST (Japan Standard Time).

Returns: A JST time from this object time, interpreted as a UTC time.

◆ format()

UString ts::Time::format ( int fields = ALL ) const

Format a string representation of a time.

Parameters

[in] fields A combination of option flags indicating which fields should be included. This is typically the result of or'ed values from the enum type FieldMask.

Returns: A string containing the formatted date.

Exceptions

ts::Time::TimeError In case of operating system time error.

◆ toString()

virtual UString ts::Time::toString ( ) const

overridevirtual

Convert to a string object.

Returns: This object, converted as a string.

Implements ts::StringifyInterface.

◆ decode()

bool ts::Time::decode	(	const UString &	str,
		int	fields = `DATE\|TIME`
	)

Decode a time from a string.

The resulting decoded time is stored in this object.

Parameters

[in]	str	A string describing a date and time in a rudimentary format. The string shall contain integer values describing the various fields in descending order, from year to millisecond. The integer fields can be separated by any combination of non-digit characters. The list of expected fields is given by the parameter fields.
[in]	fields	A combination of option flags indicating which fields should be included. This is typically the result of or'ed values from the enum type FieldMask.

Returns: True on success, false if the string cannot be decoded.

◆ leapSecondsTo()

cn::seconds ts::Time::leapSecondsTo ( const Time & end ) const

Get the number of leap seconds between two UTC dates.

Wikipedia: << A leap second is a one-second adjustment that is occasionally applied to Coordinated Universal Time (UTC), to accommodate the difference between precise time (as measured by atomic clocks) and imprecise observed solar time (known as UT1 and which varies due to irregularities and long-term slowdown in the Earth's rotation).

The UTC time standard, widely used for international timekeeping and as the reference for civil time in most countries, uses precise atomic time and consequently would run ahead of observed solar time unless it is reset to UT1 as needed. The leap second facility exists to provide this adjustment.

Because the Earth's rotation speed varies in response to climatic and geological events, UTC leap seconds are irregularly spaced and unpredictable. Insertion of each UTC leap second is usually decided about six months in advance by the International Earth Rotation and Reference Systems Service (IERS), to ensure that the difference between the UTC and UT1 readings will never exceed 0.9 seconds. >>

TSDuck uses a configuration file (tsduck.time.xml) to define the list of known leap seconds.

The TAI (International Atomic Time) starts Jan 1st 1958. Before this date, there is no leap second. Between 1958 and 1972, there are globally 10 leap seconds but they are not precisely allocated. On June 30 1972, the first leap second was officially allocated at a precise date and time.

If start and end date are both before 1958 or both after 1972, this function returns a precise result. If one of the dates is between 1958 and 1972, the initial 10 leap seconds may be included (or not).

Parameters

[in] end End UTC date. The time is this object is used as start date.

Returns: The number of leap seconds between this object and end. Return zero if this object is after end.

See also: https://en.wikipedia.org/wiki/Leap_second; https://en.wikipedia.org/wiki/International_Atomic_Time

◆ CurrentUTC()

static Time ts::Time::CurrentUTC ( )

static

Static method returning the current UTC time.

Returns: The current UTC time.

Exceptions

ts::Time::TimeError In case of operating system time error.

◆ CurrentLocalTime()

static Time ts::Time::CurrentLocalTime ( )

inlinestatic

Static method returning the current local time.

Returns: The current local time.

Exceptions

ts::Time::TimeError In case of operating system time error.

◆ thisHour()

Time ts::Time::thisHour ( ) const

Get the beginning of the current hour.

Returns: The time for the beginning of the current hour from this object time.

Exceptions

ts::Time::TimeError In case of operating system time error.

◆ nextHour()

Time ts::Time::nextHour ( ) const

inline

Get the beginning of the next hour.

Returns: The time for the beginning of the next hour from this object time.

Exceptions

ts::Time::TimeError In case of operating system time error.

◆ thisDay()

Time ts::Time::thisDay ( ) const

Get the beginning of the current day.

Returns: The time for the beginning of the current day from this object time.

Exceptions

ts::Time::TimeError In case of operating system time error.

◆ nextDay()

Time ts::Time::nextDay ( ) const

inline

Get the beginning of the next day.

Returns: The time for the beginning of the next day from this object time.

Exceptions

ts::Time::TimeError In case of operating system time error.

◆ thisMonth()

Time ts::Time::thisMonth ( ) const

Get the beginning of the current month.

Returns: The time for the beginning of the current month from this object time.

Exceptions

ts::Time::TimeError In case of operating system time error.

◆ nextMonth()

Time ts::Time::nextMonth ( ) const

Get the beginning of the next month.

Returns: The time for the beginning of the next month from this object time.

Exceptions

ts::Time::TimeError In case of operating system time error.

◆ thisYear()

Time ts::Time::thisYear ( ) const

Get the beginning of the current year.

Returns: The time for the beginning of the current year from this object time.

Exceptions

ts::Time::TimeError In case of operating system time error.

◆ nextYear()

Time ts::Time::nextYear ( ) const

Get the beginning of the next year.

Returns: The time for the beginning of the next year from this object time.

Exceptions

ts::Time::TimeError In case of operating system time error.

◆ ThisHourUTC()

static Time ts::Time::ThisHourUTC ( )

inlinestatic

Get the beginning of the current hour, UTC.

Returns: The time for the beginning of the current hour, UTC.

Exceptions

ts::Time::TimeError In case of operating system time error.

◆ ThisHourLocalTime()

static Time ts::Time::ThisHourLocalTime ( )

inlinestatic

Get the beginning of the current hour, local time.

Returns: The time for the beginning of the current hour, local time.

Exceptions

ts::Time::TimeError In case of operating system time error.

◆ NextHourUTC()

static Time ts::Time::NextHourUTC ( )

inlinestatic

Get the beginning of the next hour, UTC.

Returns: The time for the beginning of the next hour, UTC.

Exceptions

ts::Time::TimeError In case of operating system time error.

◆ NextHourLocalTime()

static Time ts::Time::NextHourLocalTime ( )

inlinestatic

Get the beginning of the next hour, local time.

Returns: The time for the beginning of the next hour, local time.

Exceptions

ts::Time::TimeError In case of operating system time error.

◆ TodayUTC()

static Time ts::Time::TodayUTC ( )

inlinestatic

Get the beginning of the current day, UTC.

Returns: The time for the beginning of the current day, UTC.

Exceptions

ts::Time::TimeError In case of operating system time error.

◆ TodayLocalTime()

static Time ts::Time::TodayLocalTime ( )

inlinestatic

Get the beginning of the current day, local time.

Returns: The time for the beginning of the current day, local time.

Exceptions

ts::Time::TimeError In case of operating system time error.

◆ TomorrowUTC()

static Time ts::Time::TomorrowUTC ( )

inlinestatic

Get the beginning of the next day, UTC.

Returns: The time for the beginning of the next day, UTC.

Exceptions

ts::Time::TimeError In case of operating system time error.

◆ TomorrowLocalTime()

static Time ts::Time::TomorrowLocalTime ( )

inlinestatic

Get the beginning of the next day, local time.

Returns: The time for the beginning of the next day, local time.

Exceptions

ts::Time::TimeError In case of operating system time error.

◆ ThisMonthUTC()

static Time ts::Time::ThisMonthUTC ( )

inlinestatic

Get the beginning of the current month, UTC.

Returns: The time for the beginning of the current month, UTC.

Exceptions

ts::Time::TimeError In case of operating system time error.

◆ ThisMonthLocalTime()

static Time ts::Time::ThisMonthLocalTime ( )

inlinestatic

Get the beginning of the current month, local time.

Returns: The time for the beginning of the current month, local time.

Exceptions

ts::Time::TimeError In case of operating system time error.

◆ NextMonthUTC()

static Time ts::Time::NextMonthUTC ( )

inlinestatic

Get the beginning of the next month, UTC.

Returns: The time for the beginning of the next month, UTC.

Exceptions

ts::Time::TimeError In case of operating system time error.

◆ NextMonthLocalTime()

static Time ts::Time::NextMonthLocalTime ( )

inlinestatic

Get the beginning of the next month, local time.

Returns: The time for the beginning of the next month, local time.

Exceptions

ts::Time::TimeError In case of operating system time error.

◆ ThisYearUTC()

static Time ts::Time::ThisYearUTC ( )

inlinestatic

Get the beginning of the current year, UTC.

Returns: The time for the beginning of the current year, UTC.

Exceptions

ts::Time::TimeError In case of operating system time error.

◆ ThisYearLocalTime()

static Time ts::Time::ThisYearLocalTime ( )

inlinestatic

Get the beginning of the current year, local time.

Returns: The time for the beginning of the current year, local time.

Exceptions

ts::Time::TimeError In case of operating system time error.

◆ NextYearUTC()

static Time ts::Time::NextYearUTC ( )

inlinestatic

Get the beginning of the next year, UTC.

Returns: The time for the beginning of the next year, UTC.

Exceptions

ts::Time::TimeError In case of operating system time error.

◆ NextYearLocalTime()

static Time ts::Time::NextYearLocalTime ( )

inlinestatic

Get the beginning of the next year, local time.

Returns: The time for the beginning of the next year, local time.

Exceptions

ts::Time::TimeError In case of operating system time error.

◆ IsLeapYear()

static bool ts::Time::IsLeapYear ( int year )

static

Check if a year is a leap year (29 days in February).

Parameters

[in] year The year to check.

Returns: True if year is a leap year.

◆ UnixTimeToUTC()

static Time ts::Time::UnixTimeToUTC ( uint64_t unixTime )

static

This static routine converts a UNIX time_t to a UTC time.

Parameters

[in] unixTime A UNIX time_t value. Must be unsigned. Can be 32 or 64 bits.

Returns: The corresponding UTC time.

◆ toUnixTime()

uint64_t ts::Time::toUnixTime ( ) const

Convert this time in a UNIX time_t.

Returns: The corresponding Unix time on 64 bits.

◆ GPSSecondsToUTC()

static Time ts::Time::GPSSecondsToUTC ( cn::seconds gps )

inlinestatic

This static routine converts a number of GPS seconds to a UTC time.

Parameters

[in] gps The number of seconds since the GPS Epoch (1980-01-06).

Returns: The corresponding UTC time.

◆ toGPSSeconds()

cn::seconds ts::Time::toGPSSeconds ( ) const

Convert this time to a number of seconds since 1980-01-06, the GPS epoch.

Returns: The corresponding number of secondss.

◆ Win32FileTimeToMilliSecond()

static cn::milliseconds ts::Time::Win32FileTimeToMilliSecond ( const ::FILETIME & fileTime )

static

This static routine converts a Win32 FILETIME to cn::milliseconds (Microsoft Windows only).

This function is available on Microsoft Windows systems only and should not be used on portable software.

Parameters

[in] fileTime A Win32 FILETIME value.

Returns: The corresponding number of milliseconds.

◆ Win32FileTimeToUTC()

static Time ts::Time::Win32FileTimeToUTC ( const ::FILETIME & fileTime )

static

This static routine converts a Win32 FILETIME to a UTC time (Microsoft Windows only).

This function is available on Microsoft Windows systems only and should not be used on portable software.

Parameters

[in] fileTime A Win32 FILETIME value.

Returns: The corresponding UTC time.

◆ UnixClockNanoSeconds()

static cn::nanoseconds ts::Time::UnixClockNanoSeconds	(	clockid_t	clock,
		const cn::milliseconds &	delay = `cn::milliseconds::zero()`
	)

static

This static routine gets a system clock and adds a delay in milliseconds (UNIX systems only).

This function ensures that no overflow is possible. This function is available on UNIX systems only and should not be used on portable software.

Parameters

[in]	clock	Clock id, usually `CLOCK_REALTIME` or `CLOCK_MONOTONIC`.
[in]	delay	Number of milliseconds to add to the current clock.

Returns: Absolute time in nanoseconds according to clock.

◆ GetUnixClock()

static void ts::Time::GetUnixClock	(	::timespec &	result,
		clockid_t	clock,
		const cn::milliseconds &	delay = `cn::milliseconds::zero()`
	)

static

This static routine gets a system clock and adds a delay in milliseconds (UNIX systems only).

This function ensures that no overflow is possible. This function is available on UNIX systems only and should not be used on portable software.

Parameters

[out]	result	A returned UNIX `timespec` value.
[in]	clock	Clock id, usually `CLOCK_REALTIME` or `CLOCK_MONOTONIC`.
[in]	delay	Number of milliseconds to add to the current real time clock.

Member Data Documentation

◆ JSTOffset

constexpr cn::milliseconds ts::Time::JSTOffset = cn::hours(+9)

staticconstexpr

Offset of a JST (Japan Standard Time) value from UTC in milliseconds.

JST is defined as UTC+9.

◆ UnixEpoch

const Time ts::Time::UnixEpoch

static

Constant representing the Epoch on UNIX operating systems.

The UNIX epoch is 1 Jan 1970 00:00:00. It is assumed to be representable in all operating systems.

◆ GPSEpoch

const Time ts::Time::GPSEpoch

static

Constant representing the GPS Epoch, 1980-01-06.

It is assumed to be representable in all operating systems.

◆ JulianEpochOffset

const cn::milliseconds ts::Time::JulianEpochOffset

static

Constant representing the offset of the Julian Epoch from the time Epoch of the operating system (Julian epoch - Time epoch) in milliseconds.

The Julian epoch is 17 Nov 1858 00:00:00. If this constant is negative, the Julian epoch if before the time epoch and cannot be represented as a Time object.

◆ UnixEpochToGPS

constexpr cn::seconds ts::Time::UnixEpochToGPS = cn::seconds(315964800)

staticconstexpr

Number of seconds between 1970-01-01 and 1980-01-06.

This is the difference between ATSC time and Unix time. The ATSC system time is the number of GPS seconds since 00:00:00 UTC, January 6th, 1980. This value can be displayed on a Linux system using the command: date +s --date 1980-01-06utc

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

tsTime.h

Classes

Public Types

Public Member Functions

Static Public Member Functions

Static Public Attributes

Detailed Description

Member Enumeration Documentation

◆ FieldMask

Constructor & Destructor Documentation

◆ Time() [1/3]

◆ Time() [2/3]

◆ Time() [3/3]

Member Function Documentation

◆ clear()

◆ operator+()

◆ operator-() [1/2]

◆ operator+=()

◆ operator-=()

◆ operator-() [2/2]

◆ operator==()

◆ operator<()

◆ operator<=()

◆ operator>()

◆ operator>=()

◆ operator Fields()

◆ localToUTC()

◆ UTCToLocal()

◆ JSTToUTC()

◆ UTCToJST()

◆ format()

◆ toString()

◆ decode()

◆ leapSecondsTo()

◆ CurrentUTC()

◆ CurrentLocalTime()

◆ thisHour()

◆ nextHour()

◆ thisDay()

◆ nextDay()

◆ thisMonth()

◆ nextMonth()

◆ thisYear()

◆ nextYear()

◆ ThisHourUTC()

◆ ThisHourLocalTime()

◆ NextHourUTC()

◆ NextHourLocalTime()

◆ TodayUTC()

◆ TodayLocalTime()

◆ TomorrowUTC()

◆ TomorrowLocalTime()

◆ ThisMonthUTC()

◆ ThisMonthLocalTime()

◆ NextMonthUTC()

◆ NextMonthLocalTime()

◆ ThisYearUTC()

◆ ThisYearLocalTime()

◆ NextYearUTC()

◆ NextYearLocalTime()

◆ IsLeapYear()

◆ UnixTimeToUTC()

◆ toUnixTime()

◆ GPSSecondsToUTC()

◆ toGPSSeconds()

◆ Win32FileTimeToMilliSecond()

◆ Win32FileTimeToUTC()

◆ UnixClockNanoSeconds()

◆ GetUnixClock()

Member Data Documentation

◆ JSTOffset

◆ UnixEpoch

◆ GPSEpoch

◆ JulianEpochOffset

◆ UnixEpochToGPS