Holds absolute and relative date/time values in Qore with precision to the microsecond. More...

#include <DateTime.h>

Inheritance diagram for DateTime:

Public Member Methods
DLLEXPORT	DateTime (bool r=false)
	constructor for an empty object

DLLEXPORT	DateTime (const AbstractQoreZoneInfo zone, const char date)
	constructor for setting the date from a string with a flexible format

DLLEXPORT	DateTime (const AbstractQoreZoneInfo *zone, const QoreValue v)
	constructor for creating an absolute date from a value representing a number of seconds

DLLEXPORT	DateTime (const char *date)
	constructor for setting the date from a string

DLLEXPORT	DateTime (const char date, ExceptionSink xsink)
	constructor for setting the date from a string with a flexible format, throws a Qore-language exception if the date string is invalid

DLLEXPORT	DateTime (const DateTime &dt)
	copy constructor

DLLEXPORT	DateTime (const QoreValue v)
	constructor for creating a relative date from a value representing a number of seconds

DLLEXPORT	DateTime (const hashdecl tm *tms)
	constructor for setting an absolute date based on a "hashdecl tm"

DLLEXPORT	DateTime (int n_year, int n_month, int n_day, int n_hour=0, int n_minute=0, int n_second=0, short n_ms=0, bool n_relative=false)
	constructor for setting all parameters

DLLEXPORT	DateTime (int64 seconds)
	constructor for setting an absolute date based on the number of seconds from January 1, 1970

DLLEXPORT	DateTime (int64 seconds, int ms)
	constructor for setting an absolute date based on the number of seconds from January 1, 1970 (plus milliseconds)

DLLEXPORT	~DateTime ()
	destroys the object and frees all memory

DLLEXPORT void	addSecondsTo (int64 secs, int us=0)
	adds the given number of seconds (and microseconds) to the date/time value

DLLEXPORT void	format (QoreString &str, const char *fmt) const
	formats the date/time value to a QoreString

DLLEXPORT int	getDay () const
	returns the day portion of the date-time value (in local time according to the time zone for absolute date/time values)

DLLEXPORT int	getDayNumber () const
	returns the ordinal number of the day in the year for absolute dates, sometimes (mistakenly) referred to as the Julian date

DLLEXPORT int	getDayOfWeek () const
	returns the day of week for the current date (0-6, Sun-Sat)

DLLEXPORT int64	getEpochMicrosecondsUTC () const
	gets the number of microseconds since January 1, 1970Z for the current date

DLLEXPORT int64	getEpochMillisecondsUTC () const
	gets the number of milliseconds since January 1, 1970Z for the current date

DLLEXPORT int64	getEpochSeconds () const
	gets the number of seconds since January 1, 1970 for the current date offset in local time

DLLEXPORT int64	getEpochSecondsUTC () const
	gets the number of seconds since January 1, 1970Z for the current date

DLLEXPORT int	getHour () const
	returns the hour portion of the date-time value (in local time according to the time zone for absolute date/time values)

DLLEXPORT void	getInfo (const AbstractQoreZoneInfo *n_zone, qore_tm &info) const
	returns the broken-down time in the given time zone (n_zone = 0 means UTC)

DLLEXPORT void	getInfo (qore_tm &info) const
	returns the broken-down time in the current time zone

DLLEXPORT void	getISOWeek (int &year, int &week, int &day) const
	returns the ISO-8601 week information

DLLEXPORT int	getMicrosecond () const
	returns the microsecond portion of the date-time value

DLLEXPORT int	getMillisecond () const
	returns the microsecond portion of the date-time value divided by 1000

DLLEXPORT int	getMinute () const
	returns the minute portion of the date-time value (in local time according to the time zone for absolute date/time values)

DLLEXPORT int	getMonth () const
	returns the month portion of the date-time value (in local time according to the time zone for absolute date/time values)

DLLEXPORT int64	getRelativeMicroseconds () const
	returns the difference as the number of microseconds between the date/time value and the local time at the moment of the call, for absolute date/time values; for relative date/time values, the duration is converted to microseconds and returned as an integer

DLLEXPORT int64	getRelativeMilliseconds () const
	returns the difference as the number of milliseconds between the date/time value and the local time at the moment of the call, for absolute date/time values; for relative date/time values, the duration is converted to milliseconds and returned as an integer

DLLEXPORT int64	getRelativeSeconds () const
	returns the difference as the number of seconds between the date/time value and the local time at the moment of the call for absolute date/time values; for relative date/time values, the duration is converted to seconds and returned as an integer

DLLEXPORT double	getRelativeSecondsDouble () const
	returns the difference as the number of seconds between the date/time value and the local time at the moment of the call for absolute date/time values; for relative date/time values, the duration is converted to seconds and returned as a floating-point value with fractional seconds as digits to the right of the decimal point

DLLEXPORT int	getSecond () const
	returns the second portion of the date-time value (in local time according to the time zone for absolute date/time values)

DLLEXPORT void	getTM (hashdecl tm *tms) const
	sets a "hashdecl tm" from the current date/time value for the time zone for the object; use DateTime::getInfo() instead

DLLEXPORT short	getYear () const
	returns the year portion of the date-time value (in local time according to the time zone for absolute date/time values)

DLLEXPORT const AbstractQoreZoneInfo *	getZone () const
	gets the time zone for the object; returns 0 for relative date/time values

DLLEXPORT bool	hasValue () const
	returns true if the object has a value, false if not (zero value = 1970-01-01Z for absolute times, or all relative components = 0)

DLLEXPORT bool	isAbsolute () const
	returns true if the value is an absolute date-time value

DLLEXPORT bool	isRelative () const
	returns true if the value is a relative date-time value

DLLEXPORT void	setDate (const AbstractQoreZoneInfo *n_zone, int n_year, int n_month, int n_day, int n_hour=0, int n_minute=0, int n_second=0, int n_us=0)
	sets the date to an absolute date/time as given

DLLEXPORT void	setDate (const AbstractQoreZoneInfo zone, const char str)
	sets an absolute date value from a time zone pointer and a string with a flexible format

DLLEXPORT void	setDate (const AbstractQoreZoneInfo *zone, int64 seconds, int us)
	sets the absolute date value based on the number of seconds from January 1, 1970 UTC (plus microseconds)

DLLEXPORT void	setDate (const char *str)
	sets an absolute date value from a string with a flexible format

DLLEXPORT void	setDate (const char str, ExceptionSink xsink)
	sets an absolute date value from a string with a flexible format

DLLEXPORT void	setDate (const DateTime &date)
	sets the date from a DateTime reference

DLLEXPORT void	setDate (const hashdecl tm *tms, short ms=0)
	sets the absolute date from a "hashdecl tm" pointer and millisecond value

DLLEXPORT void	setDate (int64 seconds)
	sets the absolute date value based on the number of seconds from January 1, 1970

DLLEXPORT void	setDate (int64 seconds, int ms)
	sets the absolute date value based on the number of seconds from January 1, 1970 UTC (plus milliseconds)

DLLEXPORT void	setLocalDate (const AbstractQoreZoneInfo *zone, int64 seconds, int us)
	sets the absolute date value based on the number of seconds from January 1, 1970 in the given time zone (plus microseconds)

DLLEXPORT void	setNow ()
	sets the current date and time in the current time zone; current contents are overwritten

DLLEXPORT void	setNow (const AbstractQoreZoneInfo *zone)
	sets the current date and time in the given time zone; current contents are overwritten

DLLEXPORT void	setRelativeDate (const char *str)
	sets a relative date from a string in the format YYYYMMDDHHmmSS

DLLEXPORT void	setRelativeDateSeconds (int64 s, int us=0)
	set the object to a relative date/time value as given in seconds and optionally microseconds

DLLEXPORT void	setTime (int h, int m, int s, short ms=0)
	sets the time from hours, minutes, seconds, and milliseconds

DLLEXPORT void	setZone (const AbstractQoreZoneInfo *n_zone)
	changes the time zone for the time without updating the epoch offset

DLLEXPORT DateTime *	unaryMinus () const
	returns the negative time from the current time

DLLEXPORT void	unaryMinusInPlace ()
	converts the current value to the negative of itself

Static Public Member Methods
static DLLEXPORT int	compareDates (const DateTime left, const DateTime right)
	returns -1, 0, or 1 if the left date is less than, equal, or greater than the right date

static DLLEXPORT DateTime *	getDateFromISOWeek (int year, int week, int day, ExceptionSink *xsink)
	returns a DateTime value from ISO-8601 week and day offsets

static DLLEXPORT int	getLastDayOfMonth (int month, int year)
	returns the number of days in the month given according to a proleptic gregorian calendar

static DLLEXPORT bool	isLeapYear (int year)
	returns true if the year passed is a leap year according to a proleptic gregorian calendar

static DLLEXPORT DateTime *	makeAbsolute (const AbstractQoreZoneInfo *n_zone, int n_year, int n_month, int n_day, int n_hour=0, int n_minute=0, int n_second=0, int n_us=0)
	static "constructor" to create an absolute time, including microseconds

static DLLEXPORT DateTime *	makeAbsolute (const AbstractQoreZoneInfo *zone, int64 seconds, int us=0)
	static "constructor" to create an absolute time as an offset from the epoch, including microseconds

static DLLEXPORT DateTime *	makeAbsoluteLocal (const AbstractQoreZoneInfo *zone, int64 seconds, int us=0)
	static "constructor" to create an absolute time as an offset from the given time zone's epoch, including microseconds

static DLLEXPORT DateTime *	makeRelative (int n_year, int n_month, int n_day, int n_hour=0, int n_minute=0, int n_second=0, int n_us=0)
	static "constructor" to create a relative time, including microseconds

static DLLEXPORT DateTime *	makeRelativeFromSeconds (int64 n_second, int n_us=0)
	static "constructor" to create a relative time, including microseconds

Private Member Methods
DLLLOCAL	DateTime (qore_date_private *n_priv)
	this constructor is not exported in the library

DLLLOCAL DateTime &	operator= (const DateTime &)
	this function is not implemented; it is here as a private function in order to prohibit it from being used

Private Attributes
class qore_date_private *	priv
	private date data - most are ints so relative dates can hold a lot of data

Friends
class	DateTimeNode

Detailed Description

Holds absolute and relative date/time values in Qore with precision to the microsecond.

Date arithmetic and date formatting is supported by this class. As of qore 0.8.0, the internal representation for absolute date/time values has changed. Now, absolute date/time values are stored internally as a 64-bit offset in seconds since the UNIX epoch (January 1, 1970 UTC), plus a 4-byte integer microseconds offset, plus a pointer to an AbstractQoreZoneInfo object, which gives the time zone information (UTC offset, daylights savings time transitions, if any, etc).

Therefore, for absolute date/time values, it is expensive to call functions that get discrete values for the date (DateTime::getYear(), DateTime::getMonth(), and DateTime::getDay()), because for each call, all broken-down components are calculated for each call. In the case that more than one component of an absolute date/time value is required, it's recommended to call DateTime::getInfo() instead.

Relative date/time values are stored with discrete values for years, months, days, hours, minutes, seconds, and microseconds.

This is a "normal" (i.e. not reference counted) class, for the equivalent Qore value type, see DateTimeNode

See also: DateTimeNode

Constructor & Destructor Documentation

◆ DateTime() [1/10]

DLLEXPORT DateTime::DateTime ( bool r = false )

constructor for an empty object

Parameters

r	sets the "relative" flag for the object

◆ DateTime() [2/10]

DLLEXPORT DateTime::DateTime	(	int	n_year,
		int	n_month,
		int	n_day,
		int	n_hour = `0`,
		int	n_minute = `0`,
		int	n_second = `0`,
		short	n_ms = `0`,
		bool	n_relative = `false`
	)

constructor for setting all parameters

note that for absolute date/time values, the local time zone will be assumed

Parameters

n_year	the year value
n_month	the months value
n_day	the days value
n_hour	the hours value
n_minute	the minutes value
n_second	the seconds value
n_ms	the milliseconds value
n_relative	the relative flag

◆ DateTime() [3/10]

DLLEXPORT DateTime::DateTime ( int64 seconds )

constructor for setting an absolute date based on the number of seconds from January 1, 1970

note that the local time zone will be assumed

Parameters

seconds the number of seconds from January 1, 1970

◆ DateTime() [4/10]

DLLEXPORT DateTime::DateTime	(	int64	seconds,
		int	ms
	)

constructor for setting an absolute date based on the number of seconds from January 1, 1970 (plus milliseconds)

note that the local time zone will be assumed

Parameters

seconds	the number of seconds from January 1, 1970
ms	the milliseconds portion of the time

◆ DateTime() [5/10]

DLLEXPORT DateTime::DateTime	(	const AbstractQoreZoneInfo *	zone,
		const QoreValue	v
	)

explicit

constructor for creating an absolute date from a value representing a number of seconds

Parameters

zone	time zone for the date/time value, 0 = UTC,

See also: currentTZ()

Parameters

v	the value representing the number of seconds representing the offset from the epoch (1970-01-01)

Note: the zone argument is the assumed time zone for values without a specified time zone; for example, if the value is a string with a time zone specification then the zone argument is ignored

◆ DateTime() [6/10]

DLLEXPORT DateTime::DateTime ( const QoreValue v )

explicit

constructor for creating a relative date from a value representing a number of seconds

Parameters

v	the value representing the number of seconds

◆ DateTime() [7/10]

DLLEXPORT DateTime::DateTime ( const char * date )

constructor for setting the date from a string

Parameters

date	the string to use to set the date in the format YYYYMMDDHHmmSS[.xxx]

◆ DateTime() [8/10]

DLLEXPORT DateTime::DateTime	(	const char *	date,
		ExceptionSink *	xsink
	)

constructor for setting the date from a string with a flexible format, throws a Qore-language exception if the date string is invalid

Parameters

date	the string to use to set the date
xsink	any errors in the data string cause a Qore-language exception to be thrown here

Since: Qore 0.8.12.4

◆ DateTime() [9/10]

DLLEXPORT DateTime::DateTime	(	const AbstractQoreZoneInfo *	zone,
		const char *	date
	)

constructor for setting the date from a string with a flexible format

Parameters

zone	the time zone for the time (0 = UTC,

See also: currentTZ())

Parameters

date	the string to use to set the date

◆ DateTime() [10/10]

DLLEXPORT DateTime::DateTime ( const hashdecl tm * tms )

constructor for setting an absolute date based on a "hashdecl tm"

Parameters

tms	a structure giving the absolute date to set

Member Function Documentation

◆ addSecondsTo()

DLLEXPORT void DateTime::addSecondsTo	(	int64	secs,
		int	us = `0`
	)

adds the given number of seconds (and microseconds) to the date/time value

this is a very fast operation and particularly useful for date arithmentic on absolute date/time values

Parameters

secs	the number of seconds to add (a negative argument results in subtraction)
us	the number of microseconds to add (a negative argument results in subtraction)

Since: Qore 0.8.12

◆ format()

DLLEXPORT void DateTime::format	(	QoreString &	str,
		const char *	fmt
	)		const

formats the date/time value to a QoreString

the formatted date/time value will be appended to the QoreString argument according to the format string Format codes are as follows:

YY: last two-digits of year
YYYY: four-digit year
M: month number (1-12)
MM: month number (1-12), zero padded
Month: long month string (ex: January)
MONTH: long month string capitalised (ex: JANUARY)
Mon: abbreviated month (ex: Jan)
MON: abbreviated month capitalised (ex: JAN)
D: day number (1 - 31)
DD: day number (1 - 31), zero padded
Day: long day of week string (ex: Monday)
DAY: long day of week string capitalised (ex: MONDAY)
Dy: abbreviated day of week string (ex: Mon)
DY: abbreviated day of week string capitalised (ex: MON)
H: hour number (0 - 23)
HH: hour number (00 - 23), zero padded
h: hour number (1 - 12)
hh: hour number (01 - 12), zero padded
m: minute number (0 - 59)
mm: minute number (00 - 59), zero padded
ms: milliseconds (000 - 999), zero padded (same as 'uu')
S: second number (0 - 59)
SS: second number (00 - 59), zero padded
u: milliseconds (0 - 999)
uu: milliseconds (000 - 999), zero padded (same as 'ms')
x: microseconds (0 - 999999)
xx: microseconds (000000 - 999999), zero padded
y: microseconds, with trailing zeros removed
z: local time zone name (ex: 'EST') if available, otherwise the UTC offset (see 'Z')
Z: UTC offset like +HH:mm[:SS], seconds are included if non-zero
P: AM or PM
p: am or pm

Note: currently locale settings are ignored

Parameters

str	the QoreString where the formatted date data will be written (appended)
fmt	the format string as per the above description

◆ getDateFromISOWeek()

static DLLEXPORT DateTime * DateTime::getDateFromISOWeek	(	int	year,
		int	week,
		int	day,
		ExceptionSink *	xsink
	)

static

returns a DateTime value from ISO-8601 week and day offsets

note that ISO-8601 week days go from 1 - 7 = Mon - Sun a 0 return value means an exception was raised

Parameters

year	the year portion of the date in which the ISO-8601 week is found in
week	the ISO-8601 week number
day	the day offset in the week (1-7 = Mon-Sun)
xsink	if an error occurs, the Qore-language exception information will be added here

Returns: the DateTime value corresponding to the ISO-8601 week information (or 0 if an error occured)

◆ getDay()

DLLEXPORT int DateTime::getDay ( ) const

returns the day portion of the date-time value (in local time according to the time zone for absolute date/time values)

Note: if more than one of DateTime::getYear(), DateTime::getMonth(), or DateTime::getDay() is called for an absolute date/time value, then DateTime::getInfo() should be used instead to avoid the broken-down components of the date being calculated for each call that retrieves a discrete value from the date. This restriction does not apply to relative date/time values.

Returns: the day portion of the date-time value

◆ getDayNumber()

DLLEXPORT int DateTime::getDayNumber ( ) const

returns the ordinal number of the day in the year for absolute dates, sometimes (mistakenly) referred to as the Julian date

does not return sensible values for relative dates

Returns: the number of the day in the year

◆ getDayOfWeek()

DLLEXPORT int DateTime::getDayOfWeek ( ) const

returns the day of week for the current date (0-6, Sun-Sat)

Returns: the day of week for the current date (0-6, Sun-Sat)

◆ getEpochMicrosecondsUTC()

DLLEXPORT int64 DateTime::getEpochMicrosecondsUTC ( ) const

gets the number of microseconds since January 1, 1970Z for the current date

Returns: the number of microseconds since January 1, 1970Z

◆ getEpochMillisecondsUTC()

DLLEXPORT int64 DateTime::getEpochMillisecondsUTC ( ) const

gets the number of milliseconds since January 1, 1970Z for the current date

Returns: the number of milliseconds since January 1, 1970Z

◆ getEpochSeconds()

DLLEXPORT int64 DateTime::getEpochSeconds ( ) const

gets the number of seconds since January 1, 1970 for the current date offset in local time

Returns: the number of seconds since January 1, 1970 offset in local time

◆ getEpochSecondsUTC()

DLLEXPORT int64 DateTime::getEpochSecondsUTC ( ) const

gets the number of seconds since January 1, 1970Z for the current date

Returns: the number of seconds since January 1, 1970Z

◆ getHour()

DLLEXPORT int DateTime::getHour ( ) const

returns the hour portion of the date-time value (in local time according to the time zone for absolute date/time values)

Note: DateTime::getHour() is calculated mathematically from the epoch offset for absolute date/time values, therefore it's much faster than DateTime::getYear(), DateTime::getMonth(), and DateTime::getDay(), however DateTime::getInfo() should be used if all date components are needed instead to avoid the broken-down components of the date being calculated for each call that retrieves a discrete value from the date

Returns: the hour portion of the date-time value

◆ getISOWeek()

DLLEXPORT void DateTime::getISOWeek	(	int &	year,
		int &	week,
		int &	day
	)		const

returns the ISO-8601 week information

NOTE: the year may be different than the actual year

Parameters

year	the year portion of the ISO-9601 week information
week	the ISO-9601 week number
day	the day offset in the week (1-7 = Mon-Sun)

◆ getMicrosecond()

DLLEXPORT int DateTime::getMicrosecond ( ) const

returns the microsecond portion of the date-time value

Returns: the microsecond portion of the date-time value

◆ getMillisecond()

DLLEXPORT int DateTime::getMillisecond ( ) const

returns the microsecond portion of the date-time value divided by 1000

Returns: the microsecond portion of the date-time value divided by 1000

See also: DateTime::getMicrosecond(), DateTime::getInfo()

◆ getMinute()

DLLEXPORT int DateTime::getMinute ( ) const

returns the minute portion of the date-time value (in local time according to the time zone for absolute date/time values)

Note: DateTime::getMinute() is calculated mathematically from the epoch offset for absolute date/time values, therefore it's much faster than DateTime::getYear(), DateTime::getMonth(), and DateTime::getDay(), however DateTime::getInfo() should be used if all date components are needed instead to avoid the broken-down components of the date being calculated for each call that retrieves a discrete value from the date

Returns: the minute portion of the date-time value

◆ getMonth()

DLLEXPORT int DateTime::getMonth ( ) const

returns the month portion of the date-time value (in local time according to the time zone for absolute date/time values)

Note: if more than one of DateTime::getYear(), DateTime::getMonth(), or DateTime::getDay() is called for an absolute date/time value, then DateTime::getInfo() should be used instead to avoid the broken-down components of the date being calculated for each call that retrieves a discrete value from the date. This restriction does not apply to relative date/time values.

Returns: the month portion of the date-time value

◆ getRelativeMicroseconds()

DLLEXPORT int64 DateTime::getRelativeMicroseconds ( ) const

returns the difference as the number of microseconds between the date/time value and the local time at the moment of the call, for absolute date/time values; for relative date/time values, the duration is converted to microseconds and returned as an integer

Returns: the difference as the number of microseconds between the date/time value and the local time at the moment of the call, for absolute date/time values; for relative date/time values, the duration is converted to microseconds and returned as an integer

◆ getRelativeMilliseconds()

DLLEXPORT int64 DateTime::getRelativeMilliseconds ( ) const

returns the difference as the number of milliseconds between the date/time value and the local time at the moment of the call, for absolute date/time values; for relative date/time values, the duration is converted to milliseconds and returned as an integer

Returns: the difference as the number of milliseconds between the date/time value and the local time at the moment of the call, for absolute date/time values; for relative date/time values, the duration is converted to milliseconds and returned as an integer

◆ getRelativeSeconds()

DLLEXPORT int64 DateTime::getRelativeSeconds ( ) const

returns the difference as the number of seconds between the date/time value and the local time at the moment of the call for absolute date/time values; for relative date/time values, the duration is converted to seconds and returned as an integer

Returns: the difference as the number of seconds between the date/time value and the local time at the moment of the call for absolute date/time values; for relative date/time values, the duration is converted to seconds and returned as an integer

◆ getRelativeSecondsDouble()

DLLEXPORT double DateTime::getRelativeSecondsDouble ( ) const

returns the difference as the number of seconds between the date/time value and the local time at the moment of the call for absolute date/time values; for relative date/time values, the duration is converted to seconds and returned as a floating-point value with fractional seconds as digits to the right of the decimal point

Returns: the difference as the number of seconds between the date/time value and the local time at the moment of the call for absolute date/time values; for relative date/time values, the duration is converted to seconds and returned as a floating-point value with fractional seconds as digits to the right of the decimal point

◆ getSecond()

DLLEXPORT int DateTime::getSecond ( ) const

returns the second portion of the date-time value (in local time according to the time zone for absolute date/time values)

Note: DateTime::getSecond() is calculated mathematically from the epoch offset for absolute date/time values, therefore it's much faster than DateTime::getYear(), DateTime::getMonth(), and DateTime::getDay(), however DateTime::getInfo() should be used if all date components are needed instead to avoid the broken-down components of the date being calculated for each call that retrieves a discrete value from the date

Returns: the second portion of the date-time value

◆ getYear()

DLLEXPORT short DateTime::getYear ( ) const

returns the year portion of the date-time value (in local time according to the time zone for absolute date/time values)

Note: if more than one of DateTime::getYear(), DateTime::getMonth(), or DateTime::getDay() is called, then DateTime::getInfo() should be used instead to avoid the broken-down components of the date being calculated for each call that retrieves a discrete value from the date. This restriction does not apply to relative date/time values.

Returns: the year portion of the date-time value

◆ isAbsolute()

DLLEXPORT bool DateTime::isAbsolute ( ) const

returns true if the value is an absolute date-time value

Returns: true if the value is an absolute date-time value

◆ isRelative()

DLLEXPORT bool DateTime::isRelative ( ) const

returns true if the value is a relative date-time value

Returns: true if the value is a relative date-time value

◆ makeAbsolute()

static DLLEXPORT DateTime * DateTime::makeAbsolute	(	const AbstractQoreZoneInfo *	zone,
		int64	seconds,
		int	us = `0`
	)

static

static "constructor" to create an absolute time as an offset from the epoch, including microseconds

Parameters

zone	time zone for the date/time value, 0 = UTC,

See also: currentTZ()

Parameters

seconds	the number of seconds from January 1, 1970Z
us	the microseconds portion of the time

◆ makeAbsoluteLocal()

static DLLEXPORT DateTime * DateTime::makeAbsoluteLocal	(	const AbstractQoreZoneInfo *	zone,
		int64	seconds,
		int	us = `0`
	)

static

static "constructor" to create an absolute time as an offset from the given time zone's epoch, including microseconds

Parameters

zone	time zone for the date/time value, 0 = UTC,

See also: currentTZ()

Parameters

seconds	the number of seconds from January 1, 1970 in the time zone passed as the first argument
us	the microseconds portion of the time

◆ setDate() [1/6]

DLLEXPORT void DateTime::setDate	(	const AbstractQoreZoneInfo *	zone,
		const char *	str
	)

sets an absolute date value from a time zone pointer and a string with a flexible format

Parameters

zone	the time zone for the time (0 = UTC,

See also: currentTZ())

Parameters

str	the string to use to set the date with a flexible format

◆ setDate() [2/6]

DLLEXPORT void DateTime::setDate	(	const AbstractQoreZoneInfo *	zone,
		int64	seconds,
		int	us
	)

sets the absolute date value based on the number of seconds from January 1, 1970 UTC (plus microseconds)

Parameters

zone	the time zone for the time (0 = UTC,

See also: currentTZ())

Parameters

seconds	the number of seconds from January 1, 1970 UTC
us	the microseconds portion of the time

◆ setDate() [3/6]

DLLEXPORT void DateTime::setDate ( const char * str )

sets an absolute date value from a string with a flexible format

note that the local time zone will be assumed

Parameters

str	the string to use to set the date

◆ setDate() [4/6]

DLLEXPORT void DateTime::setDate	(	const char *	str,
		ExceptionSink *	xsink
	)

sets an absolute date value from a string with a flexible format

note that the local time zone will be assumed

Parameters

str	the string to use to set the date
xsink	any errors in the data string cause a Qore-language exception to be thrown here

Since: Qore 0.8.12.4

◆ setDate() [5/6]

DLLEXPORT void DateTime::setDate ( int64 seconds )

sets the absolute date value based on the number of seconds from January 1, 1970

note that the local time zone will be assumed

Parameters

seconds the number of seconds from January 1, 1970

◆ setDate() [6/6]

DLLEXPORT void DateTime::setDate	(	int64	seconds,
		int	ms
	)

sets the absolute date value based on the number of seconds from January 1, 1970 UTC (plus milliseconds)

note that the local time zone will be assumed

Parameters

seconds	the number of seconds from January 1, 1970 UTC
ms	the milliseconds portion of the time

◆ setLocalDate()

DLLEXPORT void DateTime::setLocalDate	(	const AbstractQoreZoneInfo *	zone,
		int64	seconds,
		int	us
	)

sets the absolute date value based on the number of seconds from January 1, 1970 in the given time zone (plus microseconds)

Parameters

zone	the time zone for the time (0 = UTC,

See also: currentTZ())

Parameters

seconds	the number of seconds from January 1, 1970 in the given time zone
us	the microseconds portion of the time

◆ setNow() [1/2]

DLLEXPORT void DateTime::setNow ( )

sets the current date and time in the current time zone; current contents are overwritten

Since: Qore 0.8.7

◆ setNow() [2/2]

DLLEXPORT void DateTime::setNow ( const AbstractQoreZoneInfo * zone )

sets the current date and time in the given time zone; current contents are overwritten

Parameters

zone	the time zone for the time (0 = UTC,

See also: currentTZ())

Since: Qore 0.8.7

◆ setTime()

DLLEXPORT void DateTime::setTime	(	int	h,
		int	m,
		int	s,
		short	ms = `0`
	)

sets the time from hours, minutes, seconds, and milliseconds

Parameters

h	the hours value
m	the minutes value
s	the seconds value
ms	the milliseconds value

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

/tmp/qore/include/qore/DateTime.h

Public Member Methods

Static Public Member Methods

Private Member Methods

Private Attributes

Friends

Detailed Description

Constructor & Destructor Documentation

◆ DateTime() [1/10]

◆ DateTime() [2/10]

◆ DateTime() [3/10]

◆ DateTime() [4/10]

◆ DateTime() [5/10]

◆ DateTime() [6/10]

◆ DateTime() [7/10]

◆ DateTime() [8/10]

◆ DateTime() [9/10]

◆ DateTime() [10/10]

Member Function Documentation

◆ addSecondsTo()

◆ format()

◆ getDateFromISOWeek()

◆ getDay()

◆ getDayNumber()

◆ getDayOfWeek()

◆ getEpochMicrosecondsUTC()

◆ getEpochMillisecondsUTC()

◆ getEpochSeconds()

◆ getEpochSecondsUTC()

◆ getHour()

◆ getISOWeek()

◆ getMicrosecond()

◆ getMillisecond()

◆ getMinute()

◆ getMonth()

◆ getRelativeMicroseconds()

◆ getRelativeMilliseconds()

◆ getRelativeSeconds()

◆ getRelativeSecondsDouble()

◆ getSecond()

◆ getYear()

◆ isAbsolute()

◆ isRelative()

◆ makeAbsolute()

◆ makeAbsoluteLocal()

◆ setDate() [1/6]

◆ setDate() [2/6]

◆ setDate() [3/6]

◆ setDate() [4/6]

◆ setDate() [5/6]

◆ setDate() [6/6]

◆ setLocalDate()

◆ setNow() [1/2]

◆ setNow() [2/2]

◆ setTime()