\hypertarget{group__date__and__time__functions}{}\doxysection{Date and Time Functions}
\label{group__date__and__time__functions}\index{Date and Time Functions@{Date and Time Functions}}
\doxysubsection*{Functions}
\begin{DoxyCompactItemize}
\item 
\mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} \mbox{\hyperlink{group__date__and__time__functions_ga8027edf6a9aee300be71b546c34a37c1}{Qore\+::clock\+\_\+getmicros}} ()
\begin{DoxyCompactList}\small\item\em Returns an integer representing the system time in microseconds (1/1000000 second intervals) since Jan 1, 1970 00\+:00\+:00Z. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} \mbox{\hyperlink{group__date__and__time__functions_ga2515bef23859efbcc2f8895b204010cb}{Qore\+::clock\+\_\+getmillis}} ()
\begin{DoxyCompactList}\small\item\em Returns an integer representing the system time in milliseconds (1/1000 second intervals since Jan 1, 1970 00\+:00) \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} \mbox{\hyperlink{group__date__and__time__functions_gaf231c253db97a5c471e79358a789585b}{Qore\+::clock\+\_\+getnanos}} ()
\begin{DoxyCompactList}\small\item\em Returns an integer representing the system time in nanoseconds (1/1000000000 second intervals) since Jan 1, 1970 00\+:00\+:00Z. \end{DoxyCompactList}\item 
date \mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{Qore\+::date}} (date dt)
\begin{DoxyCompactList}\small\item\em Returns the date passed. \end{DoxyCompactList}\item 
date \mbox{\hyperlink{group__date__and__time__functions_ga835071f44cebd259e52045a822009cac}{Qore\+::date}} (\mbox{\hyperlink{group__type__conversion__functions_gacf16b4126b795f4b6933ef3425cadae3}{string}} dtstr)
\begin{DoxyCompactList}\small\item\em Converts the argument to a date and returns the date. \end{DoxyCompactList}\item 
date \mbox{\hyperlink{group__date__and__time__functions_gaf9fd5313613906b343c60da01f8a9a58}{Qore\+::date}} (softfloat f)
\begin{DoxyCompactList}\small\item\em The argument is assumed to be the number of seconds and fractions of a second. \end{DoxyCompactList}\item 
date \mbox{\hyperlink{group__date__and__time__functions_ga8f73e9afa16ebe73ddc8e1b5fe2b873c}{Qore\+::date}} (\mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} i)
\begin{DoxyCompactList}\small\item\em The argument is assumed to be the number of seconds. \end{DoxyCompactList}\item 
date \mbox{\hyperlink{group__date__and__time__functions_ga1bd6722e7ca0b4332f0f30aaaa989b08}{Qore\+::date}} ()
\begin{DoxyCompactList}\small\item\em This function just returns 1970-\/01-\/01Z. \end{DoxyCompactList}\item 
date \mbox{\hyperlink{group__date__and__time__functions_gaaa7df678ffcdd4f57f1f2f412b5a6f2b}{Qore\+::date}} (null null)
\begin{DoxyCompactList}\small\item\em This function just returns 1970-\/01-\/01Z. \end{DoxyCompactList}\item 
date \mbox{\hyperlink{group__date__and__time__functions_gaa990826f93b4f22f786fcfe431c4886d}{Qore\+::date}} (\mbox{\hyperlink{group__type__conversion__functions_gacf16b4126b795f4b6933ef3425cadae3}{string}} dtstr, \mbox{\hyperlink{group__type__conversion__functions_gacf16b4126b795f4b6933ef3425cadae3}{string}} mask)
\begin{DoxyCompactList}\small\item\em Returns the \mbox{\hyperlink{basic_data_types_date}{date/time}} value corresponding to parsing a string argument according to a \mbox{\hyperlink{group__date__and__time__functions_date_mask}{format mask}}. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__type__conversion__functions_ga24ee71727f0785d3b826833ed6f5e2ee}{hash}}$<$ \mbox{\hyperlink{struct_qore_1_1_date_time_info}{Date\+Time\+Info}} $>$ \mbox{\hyperlink{group__date__and__time__functions_ga1c2a86badef767277a64c5b8bb35ce00}{Qore\+::date\+\_\+info}} (\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} dt)
\begin{DoxyCompactList}\small\item\em Returns a \mbox{\hyperlink{struct_qore_1_1_date_time_info}{Date\+Time\+Info}} hash for the given date argument (can be either a \mbox{\hyperlink{basic_data_types_relative_dates}{relative}} or \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute}} date) \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__type__conversion__functions_ga24ee71727f0785d3b826833ed6f5e2ee}{hash}}$<$ \mbox{\hyperlink{struct_qore_1_1_date_time_info}{Date\+Time\+Info}} $>$ \mbox{\hyperlink{group__date__and__time__functions_gae353b093c6e90bfd20e609c1a7cf60b5}{Qore\+::date\+\_\+info}} ()
\begin{DoxyCompactList}\small\item\em Returns a \mbox{\hyperlink{struct_qore_1_1_date_time_info}{Date\+Time\+Info}} hash for the current date and time. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} \mbox{\hyperlink{group__date__and__time__functions_gaa3c93eee1ff2667b2cded39f0fb01639}{Qore\+::date\+\_\+ms}} (softint ms)
\begin{DoxyCompactList}\small\item\em Converts an integer argument representing the offset in milliseconds from January 1, 1970 in the local time zone to a date in the local time zone. \end{DoxyCompactList}\item 
nothing \mbox{\hyperlink{group__date__and__time__functions_ga4a67e87acc70debe7b4d841f3a0d7279}{Qore\+::date\+\_\+ms}} ()
\begin{DoxyCompactList}\small\item\em This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} \mbox{\hyperlink{group__date__and__time__functions_ga9200d06a35e6a2c19aa2a6c952a049c0}{Qore\+::date\+\_\+us}} (softint us)
\begin{DoxyCompactList}\small\item\em Converts an integer argument representing the offset in microseconds from January 1, 1970 in the local time zone to a date in the local time zone. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} \mbox{\hyperlink{group__date__and__time__functions_ga0f5bfff6ce4b534b1c3a6c5357b1377a}{Qore\+::days}} (softint days)
\begin{DoxyCompactList}\small\item\em Returns a \mbox{\hyperlink{basic_data_types_relative_dates}{relative date/time value}} in days based on the integer argument passed to be used in date arithmetic. \end{DoxyCompactList}\item 
nothing \mbox{\hyperlink{group__date__and__time__functions_ga09afb095d65e3393a85af466384c8bc4}{Qore\+::days}} ()
\begin{DoxyCompactList}\small\item\em This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__type__conversion__functions_gacf16b4126b795f4b6933ef3425cadae3}{string}} \mbox{\hyperlink{group__date__and__time__functions_gad5572fcb49964bfe3005e144da579361}{Qore\+::format\+\_\+date}} (\mbox{\hyperlink{group__type__conversion__functions_gacf16b4126b795f4b6933ef3425cadae3}{string}} format, \mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} dt)
\begin{DoxyCompactList}\small\item\em Returns a formatted string for a date argument passed. \end{DoxyCompactList}\item 
nothing \mbox{\hyperlink{group__date__and__time__functions_ga4512b76526538194359a25ec63b60369}{Qore\+::format\+\_\+date}} ()
\begin{DoxyCompactList}\small\item\em This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} \mbox{\hyperlink{group__date__and__time__functions_ga86f47ab9a928a2c8aff8cbac9b5f3518}{Qore\+::get\+Date\+From\+ISOWeek}} (softint year, softint week, softint day=1)
\begin{DoxyCompactList}\small\item\em Retuns an \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date value}} for the \href{http://en.wikipedia.org/wiki/ISO_week_date}{\texttt{ ISO-\/8601 calendar week information}} passed (year, week number, optional\+: weekday, where 1=Monday, 7=Sunday) in the current time zone. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} \mbox{\hyperlink{group__date__and__time__functions_ga08d26e9c0ed9635a1ee1158ee4bf24a5}{Qore\+::get\+Day\+Number}} (\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} dt)
\begin{DoxyCompactList}\small\item\em Returns an integer representing the ordinal day number in the year (corresponding to the \href{http://en.wikipedia.org/wiki/ISO_8601\#Ordinal_dates}{\texttt{ ISO-\/8601 day number}}) for the \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date}} value passed. \end{DoxyCompactList}\item 
nothing \mbox{\hyperlink{group__date__and__time__functions_ga43bb7bc0ae09fa7fd9267e248d3cb8e1}{Qore\+::get\+Day\+Number}} ()
\begin{DoxyCompactList}\small\item\em This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} \mbox{\hyperlink{group__date__and__time__functions_ga5719e06bb6919c3cc370f99910f78277}{Qore\+::get\+Day\+Of\+Week}} (\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} dt)
\begin{DoxyCompactList}\small\item\em Returns an integer representing the day of the week for the \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date}} value passed (0=Sunday, 6=Saturday) \end{DoxyCompactList}\item 
nothing \mbox{\hyperlink{group__date__and__time__functions_ga0c77571be96a607e6509a443924bbfa0}{Qore\+::get\+Day\+Of\+Week}} ()
\begin{DoxyCompactList}\small\item\em This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} \mbox{\hyperlink{group__date__and__time__functions_ga92ef075d0aa1945a11580a864bc7f4cb}{Qore\+::get\+ISODay\+Of\+Week}} (\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} dt)
\begin{DoxyCompactList}\small\item\em Returns an integer representing the ISO-\/8601 day of the week for the \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date}} value passed (1=Monday, 7=Sunday) \end{DoxyCompactList}\item 
nothing \mbox{\hyperlink{group__date__and__time__functions_ga23973fcabb1d70ccb1fefe7f405988ec}{Qore\+::get\+ISODay\+Of\+Week}} ()
\begin{DoxyCompactList}\small\item\em This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__type__conversion__functions_ga24ee71727f0785d3b826833ed6f5e2ee}{hash}}$<$ \mbox{\hyperlink{struct_qore_1_1_iso_week_info}{Iso\+Week\+Info}} $>$ \mbox{\hyperlink{group__date__and__time__functions_gadee68a84b85d12b3bba3543d7dec293d}{Qore\+::get\+ISOWeek\+Hash}} (\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} dt)
\begin{DoxyCompactList}\small\item\em Returns an \mbox{\hyperlink{struct_qore_1_1_iso_week_info}{Iso\+Week\+Info}} hash representing the ISO-\/8601 calendar week information for the \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date}} passed (hash keys\+: {\ttfamily \char`\"{}year\char`\"{}}, {\ttfamily \char`\"{}week\char`\"{}}, {\ttfamily \char`\"{}day\char`\"{}}) \end{DoxyCompactList}\item 
nothing \mbox{\hyperlink{group__date__and__time__functions_ga6492bcbbb26c4b8466a9203a86b4306c}{Qore\+::get\+ISOWeek\+Hash}} ()
\begin{DoxyCompactList}\small\item\em This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__type__conversion__functions_gacf16b4126b795f4b6933ef3425cadae3}{string}} \mbox{\hyperlink{group__date__and__time__functions_ga04331a3a415abfaaa228c4253a04859b}{Qore\+::get\+ISOWeek\+String}} (\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} dt)
\begin{DoxyCompactList}\small\item\em Returns a string representing the ISO-\/8601 calendar week information for the \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date}} passed (ex\+: 2006-\/01-\/01 = \char`\"{}2005-\/\+W52-\/7\char`\"{}) \end{DoxyCompactList}\item 
nothing \mbox{\hyperlink{group__date__and__time__functions_ga6f1fd787412d97d01c7b8450c5a6f82a}{Qore\+::get\+ISOWeek\+String}} ()
\begin{DoxyCompactList}\small\item\em This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} \mbox{\hyperlink{group__date__and__time__functions_ga1401d634f3bcbec80d64f75cdd9d4921}{Qore\+::get\+\_\+date\+\_\+from\+\_\+iso\+\_\+week}} (softint year, softint week, softint day=1)
\begin{DoxyCompactList}\small\item\em Retuns an \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date value}} for the \href{http://en.wikipedia.org/wiki/ISO_week_date}{\texttt{ ISO-\/8601 calendar week information}} passed (year, week number, optional\+: weekday, where 1=Monday, 7=Sunday) in the current time zone. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} \mbox{\hyperlink{group__date__and__time__functions_gaec9d8c1ba3a39869904f27e8c0706589}{Qore\+::get\+\_\+day\+\_\+number}} (\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} dt)
\begin{DoxyCompactList}\small\item\em Returns an integer representing the ordinal day number in the year (corresponding to the \href{http://en.wikipedia.org/wiki/ISO_8601\#Ordinal_dates}{\texttt{ ISO-\/8601 day number}}) for the \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date}} value passed. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} \mbox{\hyperlink{group__date__and__time__functions_gaa546956fb71d56f18c903aff1f3fc01a}{Qore\+::get\+\_\+day\+\_\+of\+\_\+week}} (\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} dt)
\begin{DoxyCompactList}\small\item\em Returns an integer representing the day of the week for the \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date}} value passed (0=Sunday, 6=Saturday) \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} \mbox{\hyperlink{group__date__and__time__functions_ga12df9bddb196820c9278f7884d6816f0}{Qore\+::get\+\_\+days}} (\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} dt)
\begin{DoxyCompactList}\small\item\em Returns an integer corresponding to the literal day value in the date (does not calculate a duration) \end{DoxyCompactList}\item 
nothing \mbox{\hyperlink{group__date__and__time__functions_gac3b2e2b48cfa2cf2fded33e742a33b3c}{Qore\+::get\+\_\+days}} ()
\begin{DoxyCompactList}\small\item\em This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} \mbox{\hyperlink{group__date__and__time__functions_ga314baf84678a796209a67156b4f5d8b8}{Qore\+::get\+\_\+duration\+\_\+microseconds}} (\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} dt)
\begin{DoxyCompactList}\small\item\em Returns an integer value representing the the number of microseconds of duration in the value of the date passed (can be either a \mbox{\hyperlink{basic_data_types_relative_dates}{relative}} or \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute}} date) \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} \mbox{\hyperlink{group__date__and__time__functions_ga9577b42c40fd075fb0bcb5ecabec75a1}{Qore\+::get\+\_\+duration\+\_\+milliseconds}} (\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} dt)
\begin{DoxyCompactList}\small\item\em Returns an integer value representing the the number of milliseconds of duration in the value of the date passed (can be either a \mbox{\hyperlink{basic_data_types_relative_dates}{relative}} or \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute}} date) \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} \mbox{\hyperlink{group__date__and__time__functions_ga98ef4a4d08621926630c15c1bbd769df}{Qore\+::get\+\_\+duration\+\_\+seconds}} (\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} dt)
\begin{DoxyCompactList}\small\item\em Returns an integer value representing the the number of seconds of duration in the value of the date passed (can be either a \mbox{\hyperlink{basic_data_types_relative_dates}{relative}} or \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute}} date) \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__type__conversion__functions_ga113d18216af1bdb70545081b6a9892ef}{float}} \mbox{\hyperlink{group__date__and__time__functions_gac96ed9dc0e5436a5f77c7fbeb5c5842e}{Qore\+::get\+\_\+duration\+\_\+seconds\+\_\+f}} (\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} dt)
\begin{DoxyCompactList}\small\item\em Returns a floating-\/point value representing the the number of seconds of duration in the value of the date passed (can be either a \mbox{\hyperlink{basic_data_types_relative_dates}{relative}} or \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute}} date) \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} \mbox{\hyperlink{group__date__and__time__functions_gaa69c5fbab2d5e245d89cb3253523c310}{Qore\+::get\+\_\+epoch\+\_\+seconds}} (\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} dt)
\begin{DoxyCompactList}\small\item\em Returns the number of seconds of the date and time in local time passed since Jan 1, 1970, 00\+:00\+:00 Z (UTC); negative values are returned for dates before the epoch. \end{DoxyCompactList}\item 
nothing \mbox{\hyperlink{group__date__and__time__functions_gaeca2765fa7aa631c885e61490c2421a2}{Qore\+::get\+\_\+epoch\+\_\+seconds}} ()
\begin{DoxyCompactList}\small\item\em This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} \mbox{\hyperlink{group__date__and__time__functions_ga83e582adb5ad1401911345ba306dabd2}{Qore\+::get\+\_\+hours}} (\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} dt)
\begin{DoxyCompactList}\small\item\em Returns an integer corresponding to the literal hour value in the date (does not calculate a duration) \end{DoxyCompactList}\item 
nothing \mbox{\hyperlink{group__date__and__time__functions_gad6e926ac468f32b6f269b6d62dcc186f}{Qore\+::get\+\_\+hours}} ()
\begin{DoxyCompactList}\small\item\em This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} \mbox{\hyperlink{group__date__and__time__functions_ga64bfe13c03c1b2746bfb5c80f5279e2a}{Qore\+::get\+\_\+iso\+\_\+day\+\_\+of\+\_\+week}} (\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} dt)
\begin{DoxyCompactList}\small\item\em Returns an integer representing the ISO-\/8601 day of the week for the \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date}} value passed (1=Monday, 7=Sunday) \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__type__conversion__functions_ga24ee71727f0785d3b826833ed6f5e2ee}{hash}}$<$ \mbox{\hyperlink{struct_qore_1_1_iso_week_info}{Iso\+Week\+Info}} $>$ \mbox{\hyperlink{group__date__and__time__functions_ga8cfd46ea9e98be647d8206732a63c1d9}{Qore\+::get\+\_\+iso\+\_\+week\+\_\+hash}} (\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} dt)
\begin{DoxyCompactList}\small\item\em Returns an \mbox{\hyperlink{struct_qore_1_1_iso_week_info}{Iso\+Week\+Info}} hash representing the ISO-\/8601 calendar week information for the \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date}} passed (hash keys\+: {\ttfamily \char`\"{}year\char`\"{}}, {\ttfamily \char`\"{}week\char`\"{}}, {\ttfamily \char`\"{}day\char`\"{}}) \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__type__conversion__functions_gacf16b4126b795f4b6933ef3425cadae3}{string}} \mbox{\hyperlink{group__date__and__time__functions_gadfb87ebf695f7e037efb64367cdb6626}{Qore\+::get\+\_\+iso\+\_\+week\+\_\+string}} (\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} dt)
\begin{DoxyCompactList}\small\item\em Returns a string representing the ISO-\/8601 calendar week information for the \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date}} passed (ex\+: 2006-\/01-\/01 = \char`\"{}2005-\/\+W52-\/7\char`\"{}) \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} \mbox{\hyperlink{group__date__and__time__functions_ga8ae5ae186ff94fc2033ee0f6f308688a}{Qore\+::get\+\_\+microseconds}} (\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} dt)
\begin{DoxyCompactList}\small\item\em Returns an integer corresponding to the literal microsecond value in the date (does not calculate a duration) \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} \mbox{\hyperlink{group__date__and__time__functions_ga83dc9f23f27ec426d6eea28dea040bca}{Qore\+::get\+\_\+midnight}} (\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} dt)
\begin{DoxyCompactList}\small\item\em Returns midnight on the date passed (strips the time component on the new value) \end{DoxyCompactList}\item 
nothing \mbox{\hyperlink{group__date__and__time__functions_ga15e3b79ea0fabd6d544398e9c6d849bf}{Qore\+::get\+\_\+midnight}} ()
\begin{DoxyCompactList}\small\item\em This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} \mbox{\hyperlink{group__date__and__time__functions_gaabefaf27c91bdc7bf6ffa50b391279ea}{Qore\+::get\+\_\+milliseconds}} (\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} dt)
\begin{DoxyCompactList}\small\item\em Returns an integer corresponding to the literal millisecond value in the date (does not calculate a duration) \end{DoxyCompactList}\item 
nothing \mbox{\hyperlink{group__date__and__time__functions_ga2247d7d6516390915ab492813184da7b}{Qore\+::get\+\_\+milliseconds}} ()
\begin{DoxyCompactList}\small\item\em This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} \mbox{\hyperlink{group__date__and__time__functions_ga4dbc1e7f615407a2aaa60610e03cf1ea}{Qore\+::get\+\_\+minutes}} (\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} dt)
\begin{DoxyCompactList}\small\item\em Returns an integer corresponding to the literal minute value in the date (does not calculate a duration) \end{DoxyCompactList}\item 
nothing \mbox{\hyperlink{group__date__and__time__functions_ga9d2be4bc7d936dbe4881a6d2b3a45ad0}{Qore\+::get\+\_\+minutes}} ()
\begin{DoxyCompactList}\small\item\em This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} \mbox{\hyperlink{group__date__and__time__functions_ga6a37327d1be86abe99b29c133c3fd0bc}{Qore\+::get\+\_\+months}} (\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} dt)
\begin{DoxyCompactList}\small\item\em Returns an integer corresponding to the literal month value in the date (does not calculate a duration) \end{DoxyCompactList}\item 
nothing \mbox{\hyperlink{group__date__and__time__functions_ga5b22eb495f16c4e23fa1a902041588da}{Qore\+::get\+\_\+months}} ()
\begin{DoxyCompactList}\small\item\em This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} \mbox{\hyperlink{group__date__and__time__functions_ga8872de33c58a5b4a2ffe01818f226f48}{Qore\+::get\+\_\+seconds}} (\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} dt)
\begin{DoxyCompactList}\small\item\em Returns an integer corresponding to the literal second value in the date (does not calculate a duration) \end{DoxyCompactList}\item 
nothing \mbox{\hyperlink{group__date__and__time__functions_gaaa477a2c5a1da483a4fcc58bb913064d}{Qore\+::get\+\_\+seconds}} ()
\begin{DoxyCompactList}\small\item\em This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} \mbox{\hyperlink{group__date__and__time__functions_ga730632dedaa1b9cef875a5a12861f1d1}{Qore\+::get\+\_\+years}} (\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} dt)
\begin{DoxyCompactList}\small\item\em Returns an integer corresponding to the literal year value in the date (does not calculate a duration) \end{DoxyCompactList}\item 
nothing \mbox{\hyperlink{group__date__and__time__functions_gad0d4c9db88f9089f385724476119ea3c}{Qore\+::get\+\_\+years}} ()
\begin{DoxyCompactList}\small\item\em This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} \mbox{\hyperlink{group__date__and__time__functions_ga098fc81e482c4ad4eeef3446c98f9b38}{Qore\+::gmtime}} ()
\begin{DoxyCompactList}\small\item\em Returns the current UTC (GMT) time with a resolution of a second. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} \mbox{\hyperlink{group__date__and__time__functions_ga9ca9d46f2eced39da05a7a6cb9723bb1}{Qore\+::gmtime}} (softint secs, softint us=0)
\begin{DoxyCompactList}\small\item\em Returns a date/time value in UTC (GMT) from arguments giving the number of seconds and microseconds since Jan 1, 1970, 00\+:00\+:00 Z (UTC) \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} \mbox{\hyperlink{group__date__and__time__functions_ga755457185eb53b30eef65346922aae1a}{Qore\+::gmtime}} (\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} dt)
\begin{DoxyCompactList}\small\item\em Returns the date and time in UTC (GMT) corresponding to the date argument passed. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} \mbox{\hyperlink{group__date__and__time__functions_gab342176f1a1c5ac93fbf18faeda3e943}{Qore\+::hours}} (softint hours)
\begin{DoxyCompactList}\small\item\em Returns a \mbox{\hyperlink{basic_data_types_relative_dates}{relative date/time value}} in hours based on the integer argument passed to be used in date arithmetic. \end{DoxyCompactList}\item 
nothing \mbox{\hyperlink{group__date__and__time__functions_ga6f8b91eee380336342e0af0fd1b2a28f}{Qore\+::hours}} ()
\begin{DoxyCompactList}\small\item\em This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. \end{DoxyCompactList}\item 
bool \mbox{\hyperlink{group__date__and__time__functions_ga544832cd9178c98718296c83dfddc2f6}{Qore\+::is\+\_\+date\+\_\+absolute}} (\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} dt)
\begin{DoxyCompactList}\small\item\em Returns \mbox{\hyperlink{basic_data_types_True}{True}} if the argument is an \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date/time value}}, \mbox{\hyperlink{basic_data_types_False}{False}} if not. \end{DoxyCompactList}\item 
bool \mbox{\hyperlink{group__date__and__time__functions_ga1a78ee645b0b9816f7a1bbc77f0e4e3b}{Qore\+::is\+\_\+date\+\_\+absolute}} ()
\begin{DoxyCompactList}\small\item\em This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. \end{DoxyCompactList}\item 
bool \mbox{\hyperlink{group__date__and__time__functions_gaf7de7b0823a39642087140ff1224e033}{Qore\+::is\+\_\+date\+\_\+relative}} (\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} dt)
\begin{DoxyCompactList}\small\item\em Returns \mbox{\hyperlink{basic_data_types_True}{True}} if the argument is an \mbox{\hyperlink{basic_data_types_relative_dates}{relative date/time value}}, \mbox{\hyperlink{basic_data_types_False}{False}} if not. \end{DoxyCompactList}\item 
bool \mbox{\hyperlink{group__date__and__time__functions_ga72eac18903961ac29592aa649823a5da}{Qore\+::is\+\_\+date\+\_\+relative}} ()
\begin{DoxyCompactList}\small\item\em This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} \mbox{\hyperlink{group__date__and__time__functions_ga9e3f17815e16f8b91b489d60803f265d}{Qore\+::localtime}} ()
\begin{DoxyCompactList}\small\item\em Returns the current date and time with a resolution to the second. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} \mbox{\hyperlink{group__date__and__time__functions_ga695f842b668a13ca581975abb53e735b}{Qore\+::localtime}} (softint secs, softint us=0)
\begin{DoxyCompactList}\small\item\em Returns the date and time in the local time zone corresponding to the integer arguments passed, which are interpreted as the number of seconds and microseconds since Jan 1, 1970, 00\+:00\+:00 Z (UTC) \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} \mbox{\hyperlink{group__date__and__time__functions_gaa5194ca5a38b76a102c02bc4774e6723}{Qore\+::localtime}} (\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} dt)
\begin{DoxyCompactList}\small\item\em Returns the date and time in the local time zone corresponding to the date argument passed. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} \mbox{\hyperlink{group__date__and__time__functions_ga5ecb2657b5cc84fc2f16ae1a4cc3fae7}{Qore\+::microseconds}} (softint us)
\begin{DoxyCompactList}\small\item\em Returns a \mbox{\hyperlink{basic_data_types_relative_dates}{relative date/time value}} in microseconds based on the integer argument passed to be used in date arithmetic. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} \mbox{\hyperlink{group__date__and__time__functions_gac8e561799a9f873502e161695670c06d}{Qore\+::milliseconds}} (softint ms)
\begin{DoxyCompactList}\small\item\em Returns a \mbox{\hyperlink{basic_data_types_relative_dates}{relative date/time value}} in milliseconds based on the integer argument passed to be used in date arithmetic. \end{DoxyCompactList}\item 
nothing \mbox{\hyperlink{group__date__and__time__functions_gaaca16fe50892b686b205610d8496e9ab}{Qore\+::milliseconds}} ()
\begin{DoxyCompactList}\small\item\em This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} \mbox{\hyperlink{group__date__and__time__functions_ga4d6d3d90deac1387573033793c668586}{Qore\+::minutes}} (softint minutes)
\begin{DoxyCompactList}\small\item\em Returns a \mbox{\hyperlink{basic_data_types_relative_dates}{relative date/time value}} in minutes based on the integer argument passed to be used in date arithmetic. \end{DoxyCompactList}\item 
nothing \mbox{\hyperlink{group__date__and__time__functions_ga1633103f30ca698b3864e93e440dea00}{Qore\+::minutes}} ()
\begin{DoxyCompactList}\small\item\em This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} \mbox{\hyperlink{group__date__and__time__functions_ga3278590d05035f64ba18170e87e8293a}{Qore\+::mktime}} (\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} dt)
\begin{DoxyCompactList}\small\item\em Returns the number of seconds of the date and time in local time passed since Jan 1, 1970, 00\+:00\+:00 Z (UTC); negative values are returned for dates before the epoch. \end{DoxyCompactList}\item 
nothing \mbox{\hyperlink{group__date__and__time__functions_gaa545a3ae1c8c055949d2931285d02882}{Qore\+::mktime}} ()
\begin{DoxyCompactList}\small\item\em This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} \mbox{\hyperlink{group__date__and__time__functions_gacf1db8004f38d76ad6028855f36772ce}{Qore\+::months}} (softint months)
\begin{DoxyCompactList}\small\item\em Returns a \mbox{\hyperlink{basic_data_types_relative_dates}{relative date/time value}} in months based on the integer argument passed to be used in date arithmetic. \end{DoxyCompactList}\item 
nothing \mbox{\hyperlink{group__date__and__time__functions_ga0a6ebdc9e4a3dbaa7222f0b4c98fdda9}{Qore\+::months}} ()
\begin{DoxyCompactList}\small\item\em This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} \mbox{\hyperlink{group__date__and__time__functions_ga23f067a4f82596346d4fef09782e1945}{Qore\+::now}} ()
\begin{DoxyCompactList}\small\item\em Returns the current date and time with a resolution to the second. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} \mbox{\hyperlink{group__date__and__time__functions_ga4916588a63c91c6632ce877ec1d6cc1b}{Qore\+::now\+\_\+ms}} ()
\begin{DoxyCompactList}\small\item\em Returns the current date and time with a resolution to the millisecond. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} \mbox{\hyperlink{group__date__and__time__functions_ga61b29a943e0e85abdc9792a9434e5b39}{Qore\+::now\+\_\+us}} ()
\begin{DoxyCompactList}\small\item\em Returns the current date and time with a resolution to the microsecond. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} \mbox{\hyperlink{group__date__and__time__functions_ga014569059b153ad30b0951ba0113bd04}{Qore\+::now\+\_\+utc}} ()
\begin{DoxyCompactList}\small\item\em Returns the current UTC date and time with a resolution to the microsecond. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} \mbox{\hyperlink{group__date__and__time__functions_ga19566ff46f3818f4554c73ba145fd8e1}{Qore\+::seconds}} (softint seconds)
\begin{DoxyCompactList}\small\item\em Returns a \mbox{\hyperlink{basic_data_types_relative_dates}{relative date/time value}} in seconds based on the integer argument passed to be used in date arithmetic. \end{DoxyCompactList}\item 
nothing \mbox{\hyperlink{group__date__and__time__functions_gad7edd4b61aca5344ad2dd94b23c934d7}{Qore\+::seconds}} ()
\begin{DoxyCompactList}\small\item\em This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} \mbox{\hyperlink{group__date__and__time__functions_ga62c3c23b7423b9583193a8a5cb16eb29}{Qore\+::timegm}} (\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} dt)
\begin{DoxyCompactList}\small\item\em Returns the number of seconds since January 1, 1970 00\+:00\+:00 in the local time zone for the given date. \end{DoxyCompactList}\item 
nothing \mbox{\hyperlink{group__date__and__time__functions_ga2bd5e056f0b35e599aaecd7e5e26512f}{Qore\+::timegm}} ()
\begin{DoxyCompactList}\small\item\em This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. \end{DoxyCompactList}\item 
\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} \mbox{\hyperlink{group__date__and__time__functions_ga71eac87de4a337ec7d6dc6456d86d8c4}{Qore\+::years}} (softint years)
\begin{DoxyCompactList}\small\item\em Returns a \mbox{\hyperlink{basic_data_types_relative_dates}{relative date/time value}} in years based on the integer argument passed to be used in date arithmetic. \end{DoxyCompactList}\item 
nothing \mbox{\hyperlink{group__date__and__time__functions_ga22b8473aff75818b568aac6ca76c87eb}{Qore\+::years}} ()
\begin{DoxyCompactList}\small\item\em This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. \end{DoxyCompactList}\end{DoxyCompactItemize}


\doxysubsection{Detailed Description}
\hypertarget{group__date__and__time__functions_date_formatting}{}\doxysubsection{Date Formatting Codes}\label{group__date__and__time__functions_date_formatting}
 \tabulinesep=1mm
\begin{longtabu}spread 0pt [c]{*{2}{|X[-1]}|}
\hline
{\bfseries{Format Code}} &{\bfseries{Description}}  \\\cline{1-2}
{\ttfamily YY}  &last two digits of year  \\\cline{1-2}
{\ttfamily YYYY}  &four-\/digit year  \\\cline{1-2}
{\ttfamily M}  &non zero-\/padded month number (1-\/12)  \\\cline{1-2}
{\ttfamily MM}  &zero-\/padded two-\/digit month number (01-\/12)  \\\cline{1-2}
{\ttfamily Month}  &long month string (ex\+: {\ttfamily \char`\"{}\+January\char`\"{}})  \\\cline{1-2}
{\ttfamily MONTH}  &long month string capitalized (ex\+: {\ttfamily \char`\"{}\+JANUARY\char`\"{}})  \\\cline{1-2}
{\ttfamily Mon}  &abbreviated month (ex\+: {\ttfamily \char`\"{}\+Jan\char`\"{}})  \\\cline{1-2}
{\ttfamily MON}  &abbreviated month, capitalized (ex\+: {\ttfamily \char`\"{}\+JAN\char`\"{}})  \\\cline{1-2}
{\ttfamily D}  &non zero-\/padded day number (1 -\/ 31)  \\\cline{1-2}
{\ttfamily DD}  &zero-\/padded day number (01 -\/ 31)  \\\cline{1-2}
{\ttfamily Day}  &long day of week string (ex\+: {\ttfamily \char`\"{}\+Monday\char`\"{}})  \\\cline{1-2}
{\ttfamily DAY}  &long day of week string, capitalized (ex\+: {\ttfamily \char`\"{}\+MONDAY\char`\"{}})  \\\cline{1-2}
{\ttfamily Dn}  &the ordinal day number in the year without zero padding ({\ttfamily \char`\"{}1\char`\"{}} -\/ {\ttfamily \char`\"{}366\char`\"{}} for leap years; ex\+: {\ttfamily \char`\"{}85\char`\"{}})  \\\cline{1-2}
{\ttfamily DN}  &the day number in the year with zero padding to 3 digits ({\ttfamily \char`\"{}001\char`\"{}} -\/ {\ttfamily \char`\"{}366\char`\"{}} for leap years; ex\+: {\ttfamily \char`\"{}085\char`\"{}})  \\\cline{1-2}
{\ttfamily Dy}  &abbreviated day of week string (ex\+: {\ttfamily \char`\"{}\+Mon\char`\"{}})  \\\cline{1-2}
{\ttfamily DY}  &abbreviated day of week string capitalized (ex\+: {\ttfamily \char`\"{}\+MON\char`\"{}})  \\\cline{1-2}
{\ttfamily H}  &non zero-\/padded hour number (0 -\/ 23)  \\\cline{1-2}
{\ttfamily HH}  &zero-\/padded hour number (00 -\/ 23)  \\\cline{1-2}
{\ttfamily h}  &non zero-\/padded hour number, 12-\/hour clock (1 -\/ 12)  \\\cline{1-2}
{\ttfamily hh}  &zero-\/padded hour number, 12-\/hour clock (01 -\/ 12)  \\\cline{1-2}
{\ttfamily I}  &the \href{http://en.wikipedia.org/wiki/ISO_week_date}{\texttt{ ISO-\/8601 week string}} for the date (ex\+: {\ttfamily \char`\"{}2018-\/\+W12-\/5\char`\"{}})  \\\cline{1-2}
{\ttfamily Id}  &the \href{http://en.wikipedia.org/wiki/ISO_week_date}{\texttt{ ISO-\/8601 week day number}} in the week ({\ttfamily \char`\"{}1\char`\"{}} -\/ {\ttfamily \char`\"{}7\char`\"{}})  \\\cline{1-2}
{\ttfamily ID}  &the \href{http://en.wikipedia.org/wiki/ISO_week_date}{\texttt{ ISO-\/8601 week day number}} in the week ({\ttfamily \char`\"{}1\char`\"{}} -\/ {\ttfamily \char`\"{}7\char`\"{}})  \\\cline{1-2}
{\ttfamily IF}  &the value in \href{https://en.wikipedia.org/wiki/ISO_8601}{\texttt{ ISO-\/8601}} format for both \mbox{\hyperlink{basic_data_types_relative_dates}{relative}} (ex\+: {\ttfamily \char`\"{}\+P2\+Y1\+M3\+DT5\+H7\+M9.\+002\+S\char`\"{}}) and \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute}} dates (ex\+: {\ttfamily \char`\"{}2018-\/03-\/23\+T10\+:43\+:12.\+067628+01\+:00\char`\"{}})  \\\cline{1-2}
{\ttfamily Iw}  &the \href{http://en.wikipedia.org/wiki/ISO_week_date}{\texttt{ ISO-\/8601 week number}} for the year without zero padding ({\ttfamily \char`\"{}1\char`\"{}} -\/ {\ttfamily \char`\"{}53\char`\"{}})  \\\cline{1-2}
{\ttfamily IW}  &the \href{http://en.wikipedia.org/wiki/ISO_week_date}{\texttt{ ISO-\/8601 week number}} for the year with zero padding to 2 digits ({\ttfamily \char`\"{}01\char`\"{}} -\/ {\ttfamily \char`\"{}53\char`\"{}})  \\\cline{1-2}
{\ttfamily Iy}  &the \href{http://en.wikipedia.org/wiki/ISO_week_date}{\texttt{ ISO-\/8601 week year number}} without zero padding (ex\+: {\ttfamily \char`\"{}2018\char`\"{}})  \\\cline{1-2}
{\ttfamily IY}  &the \href{http://en.wikipedia.org/wiki/ISO_week_date}{\texttt{ ISO-\/8601 week year number}} with zero padding to 4 digits (ex\+: {\ttfamily \char`\"{}2018\char`\"{}})  \\\cline{1-2}
{\ttfamily m}  &non zero-\/padded minute number (0 -\/ 59)  \\\cline{1-2}
{\ttfamily mm}  &zero-\/padded minute number (00 -\/ 59)  \\\cline{1-2}
{\ttfamily S}  &non zero-\/padded second number (0 -\/ 59)  \\\cline{1-2}
{\ttfamily SS}  &zero-\/padded second number (00 -\/ 59)  \\\cline{1-2}
{\ttfamily P}  &{\ttfamily \char`\"{}\+AM\char`\"{}} or {\ttfamily \char`\"{}\+PM\char`\"{}} (upper-\/case)  \\\cline{1-2}
{\ttfamily p}  &{\ttfamily \char`\"{}am\char`\"{}} or {\ttfamily \char`\"{}pm\char`\"{}} (lower-\/case)  \\\cline{1-2}
{\ttfamily u}  &non zero-\/padded millisecond number (0 -\/ 999)  \\\cline{1-2}
{\ttfamily uu} or {\ttfamily ms}  &zero-\/padded millisecond number (000 -\/ 999)  \\\cline{1-2}
{\ttfamily x}  &non zero-\/padded microsecond number (0 -\/ 999999)  \\\cline{1-2}
{\ttfamily xx} or {\ttfamily us}  &zero-\/padded microsecond number (000000 -\/ 999999)  \\\cline{1-2}
{\ttfamily y}  &microseconds, with trailing zeros removed (suitable for use after the \textquotesingle{}.\textquotesingle{})  \\\cline{1-2}
{\ttfamily z}  &local time zone name (ex\+: {\ttfamily \char`\"{}\+EST\char`\"{}}) if available, otherwise the UTC offset (ex\+: {\ttfamily \char`\"{}+01\+:00\char`\"{}})  \\\cline{1-2}
{\ttfamily Z}  &time zone UTC offset like +HH\+:mm\mbox{[}\+:SS\mbox{]} (ex\+: {\ttfamily \char`\"{}+01\+:00\char`\"{}}), seconds are only included if non-\/zero  \\\cline{1-2}
\end{longtabu}


\begin{DoxySince}{Since}

\begin{DoxyItemize}
\item {\ttfamily us} was added in Qore 0.\+8.\+7
\item {\ttfamily Dn}, {\ttfamily DN}, {\ttfamily I}, {\ttfamily Id}, {\ttfamily ID}, {\ttfamily IF}, {\ttfamily Iw}, {\ttfamily IW}, {\ttfamily Iy}, {\ttfamily IY} format codes were added in Qore 0.\+9
\end{DoxyItemize}
\end{DoxySince}
\begin{DoxyRefDesc}{Bug}
\item[\mbox{\hyperlink{bug__bug000005}{Bug}}]the {\ttfamily \char`\"{}u\char`\"{}} and {\ttfamily \char`\"{}uu\char`\"{}} format codes work with milliseconds and not microseconds since they were implemented before qore supported microsecond time resolution; this cannot be changed without breaking backwards-\/compatibility\end{DoxyRefDesc}
\hypertarget{group__date__and__time__functions_date_mask}{}\doxysubsection{Date Mask Format}\label{group__date__and__time__functions_date_mask}
The date mask (as used in \mbox{\hyperlink{group__date__and__time__functions_gaa990826f93b4f22f786fcfe431c4886d}{Qore\+::date(string, string)}} and \mbox{\hyperlink{class_qore_1_1_time_zone_ab22bd3acfbfb1d7b7ce56f54c81897c7}{Qore\+::\+Time\+Zone\+::date(string, string)}}) is used to specify the string format of a date/time value for parsing to a \mbox{\hyperlink{basic_data_types_date}{date/time value}}.

The fields in the mask string are as follows\+:
\begin{DoxyItemize}
\item {\ttfamily YY\+:} The last 2 digits of the year; the current century is assumed
\item {\ttfamily YYYY\+:} A 4-\/digit year value (ex\+: 1956, 0870)
\item {\ttfamily MM\+:} A 2-\/digit month number (ex\+: 01, 11)
\item {\ttfamily Mon} or {\ttfamily MON\+:} A 3-\/character English month name abbreviation (parsing is case-\/insensitive\+: ex\+: {\ttfamily \char`\"{}\+Apr\char`\"{}} or {\ttfamily \char`\"{}\+APR\char`\"{}} or {\ttfamily \char`\"{}apr\char`\"{}} for April)
\item {\ttfamily DD\+:} A 2-\/digit day number (ex\+: 29, 04)
\item {\ttfamily HH\+:} A 2-\/digit hour number (ex\+: 23, 04)
\item {\ttfamily mm\+:} A 2-\/digit minute number (ex\+: 11, 04)
\item {\ttfamily ms\+:} A 3-\/digit millisecond number (ex\+: 511, 042)
\item {\ttfamily SS\+:} A 2-\/digit second number (ex\+: 11, 04)
\item {\ttfamily sss\+:} A 3-\/digit millisecond number (ex\+: 511, 042)
\item {\ttfamily ssssss\+:} A 6-\/digit microsecond number (ex\+: 240511, 005142)
\item {\ttfamily us\+:} A 6-\/digit microsecond number (ex\+: 240511, 005142)
\end{DoxyItemize}

\begin{DoxyRefDesc}{Bug}
\item[\mbox{\hyperlink{bug__bug000006}{Bug}}]currently only English month abbreviations are accepted in the date/time mask\end{DoxyRefDesc}


\doxysubsection{Function Documentation}
\mbox{\Hypertarget{group__date__and__time__functions_ga8027edf6a9aee300be71b546c34a37c1}\label{group__date__and__time__functions_ga8027edf6a9aee300be71b546c34a37c1}} 
\index{Date and Time Functions@{Date and Time Functions}!clock\_getmicros@{clock\_getmicros}}
\index{clock\_getmicros@{clock\_getmicros}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{clock\_getmicros()}{clock\_getmicros()}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} Qore\+::clock\+\_\+getmicros (\begin{DoxyParamCaption}{ }\end{DoxyParamCaption})}



Returns an integer representing the system time in microseconds (1/1000000 second intervals) since Jan 1, 1970 00\+:00\+:00Z. 

\begin{DoxyReturn}{Returns}
an integer representing the system time in microseconds (1/1000000 second intervals) since Jan 1, 1970 00\+:00\+:00Z
\end{DoxyReturn}
\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{int us = clock\_getmicros();}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxySeeAlso}{See also}

\begin{DoxyItemize}
\item \mbox{\hyperlink{group__date__and__time__functions_ga2515bef23859efbcc2f8895b204010cb}{clock\+\_\+getmillis()}}
\item \mbox{\hyperlink{group__date__and__time__functions_ga8027edf6a9aee300be71b546c34a37c1}{clock\+\_\+getmicros()}} 
\end{DoxyItemize}
\end{DoxySeeAlso}
\mbox{\Hypertarget{group__date__and__time__functions_ga2515bef23859efbcc2f8895b204010cb}\label{group__date__and__time__functions_ga2515bef23859efbcc2f8895b204010cb}} 
\index{Date and Time Functions@{Date and Time Functions}!clock\_getmillis@{clock\_getmillis}}
\index{clock\_getmillis@{clock\_getmillis}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{clock\_getmillis()}{clock\_getmillis()}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} Qore\+::clock\+\_\+getmillis (\begin{DoxyParamCaption}{ }\end{DoxyParamCaption})}



Returns an integer representing the system time in milliseconds (1/1000 second intervals since Jan 1, 1970 00\+:00) 

\begin{DoxyReturn}{Returns}
an integer representing the system time in milliseconds (1/1000 second intervals since Jan 1, 1970 00\+:00)
\end{DoxyReturn}
\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{int ms = clock\_getmillis();}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxySeeAlso}{See also}

\begin{DoxyItemize}
\item \mbox{\hyperlink{group__date__and__time__functions_gaf231c253db97a5c471e79358a789585b}{clock\+\_\+getnanos()}}
\item \mbox{\hyperlink{group__date__and__time__functions_ga8027edf6a9aee300be71b546c34a37c1}{clock\+\_\+getmicros()}} 
\end{DoxyItemize}
\end{DoxySeeAlso}
\mbox{\Hypertarget{group__date__and__time__functions_gaf231c253db97a5c471e79358a789585b}\label{group__date__and__time__functions_gaf231c253db97a5c471e79358a789585b}} 
\index{Date and Time Functions@{Date and Time Functions}!clock\_getnanos@{clock\_getnanos}}
\index{clock\_getnanos@{clock\_getnanos}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{clock\_getnanos()}{clock\_getnanos()}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} Qore\+::clock\+\_\+getnanos (\begin{DoxyParamCaption}{ }\end{DoxyParamCaption})}



Returns an integer representing the system time in nanoseconds (1/1000000000 second intervals) since Jan 1, 1970 00\+:00\+:00Z. 

\begin{DoxyReturn}{Returns}
an integer representing the system time in nanoseconds (1/1000000000 second intervals) since Jan 1, 1970 00\+:00\+:00Z
\end{DoxyReturn}
\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{int ns = clock\_getnanos();}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxySeeAlso}{See also}

\begin{DoxyItemize}
\item \mbox{\hyperlink{group__date__and__time__functions_ga2515bef23859efbcc2f8895b204010cb}{clock\+\_\+getmillis()}}
\item \mbox{\hyperlink{group__date__and__time__functions_ga8027edf6a9aee300be71b546c34a37c1}{clock\+\_\+getmicros()}} 
\end{DoxyItemize}
\end{DoxySeeAlso}
\mbox{\Hypertarget{group__date__and__time__functions_ga1bd6722e7ca0b4332f0f30aaaa989b08}\label{group__date__and__time__functions_ga1bd6722e7ca0b4332f0f30aaaa989b08}} 
\index{Date and Time Functions@{Date and Time Functions}!date@{date}}
\index{date@{date}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{date()}{date()}\hspace{0.1cm}{\footnotesize\ttfamily [1/7]}}
{\footnotesize\ttfamily date Qore\+::date (\begin{DoxyParamCaption}{ }\end{DoxyParamCaption})}



This function just returns 1970-\/01-\/01Z. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}
This function is included because the \mbox{\hyperlink{group__date__and__time__functions_ga1bd6722e7ca0b4332f0f30aaaa989b08}{date()}} function is used to convert values to dates (similar to a C/\+C++ cast)

\begin{DoxyReturn}{Returns}
1970-\/01-\/01Z 
\end{DoxyReturn}
\mbox{\Hypertarget{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}\label{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}} 
\index{Date and Time Functions@{Date and Time Functions}!date@{date}}
\index{date@{date}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{date()}{date()}\hspace{0.1cm}{\footnotesize\ttfamily [2/7]}}
{\footnotesize\ttfamily date Qore\+::date (\begin{DoxyParamCaption}\item[{date}]{dt }\end{DoxyParamCaption})}



Returns the date passed. 

This function is included because the \mbox{\hyperlink{group__date__and__time__functions_ga1bd6722e7ca0b4332f0f30aaaa989b08}{date()}} function is used to convert values to dates (similar to a C/\+C++ cast)

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em dt} & the date to return\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
the date passed 
\end{DoxyReturn}
\mbox{\Hypertarget{group__date__and__time__functions_ga8f73e9afa16ebe73ddc8e1b5fe2b873c}\label{group__date__and__time__functions_ga8f73e9afa16ebe73ddc8e1b5fe2b873c}} 
\index{Date and Time Functions@{Date and Time Functions}!date@{date}}
\index{date@{date}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{date()}{date()}\hspace{0.1cm}{\footnotesize\ttfamily [3/7]}}
{\footnotesize\ttfamily date Qore\+::date (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}}}]{i }\end{DoxyParamCaption})}



The argument is assumed to be the number of seconds. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em i} & the number of seconds\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
a \mbox{\hyperlink{basic_data_types_relative_dates}{relative date/time value}} corresponding to the number of seconds
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{date d = date(i);}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxySince}{Since}
Qore 0.\+8.\+13 the return value is a \mbox{\hyperlink{basic_data_types_relative_dates}{relative date/time value}} in seconds 
\end{DoxySince}
\mbox{\Hypertarget{group__date__and__time__functions_gaaa7df678ffcdd4f57f1f2f412b5a6f2b}\label{group__date__and__time__functions_gaaa7df678ffcdd4f57f1f2f412b5a6f2b}} 
\index{Date and Time Functions@{Date and Time Functions}!date@{date}}
\index{date@{date}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{date()}{date()}\hspace{0.1cm}{\footnotesize\ttfamily [4/7]}}
{\footnotesize\ttfamily date Qore\+::date (\begin{DoxyParamCaption}\item[{null}]{null }\end{DoxyParamCaption})}



This function just returns 1970-\/01-\/01Z. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}
This function is included because the \mbox{\hyperlink{group__date__and__time__functions_ga1bd6722e7ca0b4332f0f30aaaa989b08}{date()}} function is used to convert values to dates (similar to a C/\+C++ cast)

\begin{DoxyReturn}{Returns}
1970-\/01-\/01Z 
\end{DoxyReturn}
\mbox{\Hypertarget{group__date__and__time__functions_gaf9fd5313613906b343c60da01f8a9a58}\label{group__date__and__time__functions_gaf9fd5313613906b343c60da01f8a9a58}} 
\index{Date and Time Functions@{Date and Time Functions}!date@{date}}
\index{date@{date}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{date()}{date()}\hspace{0.1cm}{\footnotesize\ttfamily [5/7]}}
{\footnotesize\ttfamily date Qore\+::date (\begin{DoxyParamCaption}\item[{softfloat}]{f }\end{DoxyParamCaption})}



The argument is assumed to be the number of seconds and fractions of a second. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em f} & the number of seconds and fractions of a second\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
a \mbox{\hyperlink{basic_data_types_relative_dates}{relative date/time value}} corresponding to the number of seconds and fractions of a second in the argument
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{date d = date(f);}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxySince}{Since}
Qore 0.\+8.\+13 the return value is a \mbox{\hyperlink{basic_data_types_relative_dates}{relative date/time value}} in seconds 
\end{DoxySince}
\mbox{\Hypertarget{group__date__and__time__functions_ga835071f44cebd259e52045a822009cac}\label{group__date__and__time__functions_ga835071f44cebd259e52045a822009cac}} 
\index{Date and Time Functions@{Date and Time Functions}!date@{date}}
\index{date@{date}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{date()}{date()}\hspace{0.1cm}{\footnotesize\ttfamily [6/7]}}
{\footnotesize\ttfamily date Qore\+::date (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__type__conversion__functions_gacf16b4126b795f4b6933ef3425cadae3}{string}}}]{dtstr }\end{DoxyParamCaption})}



Converts the argument to a date and returns the date. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em dtstr} & string a string to bo converted literally to an \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date/time value}}; if no time zone information is present, the local time zone is assumed\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
the \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date/time value}} corresponding to the string argument passed
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{date d = date(\textcolor{stringliteral}{"{}2001-\/01-\/01T15:35:23"{}}); \textcolor{comment}{\# returns 2001-\/01-\/01 15:35:23 Mon +01:00 (CET)}}
\DoxyCodeLine{date d = date(\textcolor{stringliteral}{"{}20010101 15:35:23Z"{}}); \textcolor{comment}{\# returns 2001-\/01-\/01 15:35:23 Mon Z (UTC)}}
\DoxyCodeLine{date d = date(\textcolor{stringliteral}{"{}20010101 153523Z"{}}); \textcolor{comment}{\# returns 2001-\/01-\/01 15:35:23 Mon Z (UTC)}}
\DoxyCodeLine{date d = date(\textcolor{stringliteral}{"{}20010101 153523-\/02"{}}); \textcolor{comment}{\# returns 2001-\/01-\/01 15:35:23 Mon -\/02:00 (-\/02:00)}}
\DoxyCodeLine{date d = date(\textcolor{stringliteral}{"{}20010101 153523-\/02:00:00"{}}); \textcolor{comment}{\# returns 2001-\/01-\/01 15:35:23 Mon -\/02:00 (-\/02:00)}}
\DoxyCodeLine{date d = date(\textcolor{stringliteral}{"{}2001-\/01-\/01-\/153523-\/020000"{}}); \textcolor{comment}{\# returns 2001-\/01-\/01 15:35:23 Mon -\/02:00 (-\/02:00)}}
\DoxyCodeLine{date d = date(\textcolor{stringliteral}{"{}20010101-\/153523"{}}); \textcolor{comment}{\# returns 2001-\/01-\/01 15:35:23 Mon +01:00 (CET)}}

\end{DoxyCode}

\end{DoxyParagraph}

\begin{DoxyExceptions}{Exceptions}
{\em INVALID-\/\+DATE} & thrown if the date is invalid; invalid or missing date components\\
\hline
\end{DoxyExceptions}
\begin{DoxySeeAlso}{See also}
\mbox{\hyperlink{group__date__and__time__functions_gaa990826f93b4f22f786fcfe431c4886d}{date(string, string)}}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
Qore 0.\+8.\+12.\+4 {\ttfamily INVALID-\/\+DATE} exceptions are thrown if the date is invalid 
\end{DoxySince}
\mbox{\Hypertarget{group__date__and__time__functions_gaa990826f93b4f22f786fcfe431c4886d}\label{group__date__and__time__functions_gaa990826f93b4f22f786fcfe431c4886d}} 
\index{Date and Time Functions@{Date and Time Functions}!date@{date}}
\index{date@{date}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{date()}{date()}\hspace{0.1cm}{\footnotesize\ttfamily [7/7]}}
{\footnotesize\ttfamily date Qore\+::date (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__type__conversion__functions_gacf16b4126b795f4b6933ef3425cadae3}{string}}}]{dtstr,  }\item[{\mbox{\hyperlink{group__type__conversion__functions_gacf16b4126b795f4b6933ef3425cadae3}{string}}}]{mask }\end{DoxyParamCaption})}



Returns the \mbox{\hyperlink{basic_data_types_date}{date/time}} value corresponding to parsing a string argument according to a \mbox{\hyperlink{group__date__and__time__functions_date_mask}{format mask}}. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_RET_VALUE_ONLY}{RET\+\_\+\+VALUE\+\_\+\+ONLY}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em dtstr} & a string giving a date \\
\hline
{\em mask} & the mask for the date value; see \mbox{\hyperlink{group__date__and__time__functions_date_mask}{Date Mask Format}} for information on the format of the \mbox{\hyperlink{group__date__and__time__functions_date_mask}{format mask}}\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
the \mbox{\hyperlink{basic_data_types_date}{date/time}} value corresponding to parsing the {\itshape dtstr} string argument according to {\itshape mask} serving as a \mbox{\hyperlink{group__date__and__time__functions_date_mask}{format mask}}
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{date dt = date(\textcolor{stringliteral}{"{}20100401 234520 230394"{}}, \textcolor{stringliteral}{"{}YYYYMMDD HHmmSS ssssss"{}}); \textcolor{comment}{\# returns 2010-\/04-\/01T23:45:20.230394}}

\end{DoxyCode}

\end{DoxyParagraph}

\begin{DoxyExceptions}{Exceptions}
{\em INVALID-\/\+DATE} & invalid mask specification\\
\hline
\end{DoxyExceptions}
\begin{DoxySeeAlso}{See also}
\mbox{\hyperlink{class_qore_1_1_time_zone_ab22bd3acfbfb1d7b7ce56f54c81897c7}{Qore\+::\+Time\+Zone\+::date(string, string)}} for a method that allows the \mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} to be parsed in a particular \mbox{\hyperlink{time_zones}{time zone}} 
\end{DoxySeeAlso}
\mbox{\Hypertarget{group__date__and__time__functions_gae353b093c6e90bfd20e609c1a7cf60b5}\label{group__date__and__time__functions_gae353b093c6e90bfd20e609c1a7cf60b5}} 
\index{Date and Time Functions@{Date and Time Functions}!date\_info@{date\_info}}
\index{date\_info@{date\_info}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{date\_info()}{date\_info()}\hspace{0.1cm}{\footnotesize\ttfamily [1/2]}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__type__conversion__functions_ga24ee71727f0785d3b826833ed6f5e2ee}{hash}}$<$ \mbox{\hyperlink{struct_qore_1_1_date_time_info}{Date\+Time\+Info}} $>$ Qore\+::date\+\_\+info (\begin{DoxyParamCaption}{ }\end{DoxyParamCaption})}



Returns a \mbox{\hyperlink{struct_qore_1_1_date_time_info}{Date\+Time\+Info}} hash for the current date and time. 

\begin{DoxyReturn}{Returns}
a \mbox{\hyperlink{struct_qore_1_1_date_time_info}{Date\+Time\+Info}} hash for the current date and time
\end{DoxyReturn}
\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{hash<DateTimeInfo> h = date\_info();}

\end{DoxyCode}
 
\end{DoxyParagraph}
\mbox{\Hypertarget{group__date__and__time__functions_ga1c2a86badef767277a64c5b8bb35ce00}\label{group__date__and__time__functions_ga1c2a86badef767277a64c5b8bb35ce00}} 
\index{Date and Time Functions@{Date and Time Functions}!date\_info@{date\_info}}
\index{date\_info@{date\_info}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{date\_info()}{date\_info()}\hspace{0.1cm}{\footnotesize\ttfamily [2/2]}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__type__conversion__functions_ga24ee71727f0785d3b826833ed6f5e2ee}{hash}}$<$ \mbox{\hyperlink{struct_qore_1_1_date_time_info}{Date\+Time\+Info}} $>$ Qore\+::date\+\_\+info (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}}}]{dt }\end{DoxyParamCaption})}



Returns a \mbox{\hyperlink{struct_qore_1_1_date_time_info}{Date\+Time\+Info}} hash for the given date argument (can be either a \mbox{\hyperlink{basic_data_types_relative_dates}{relative}} or \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute}} date) 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em dt} & the date to return information for\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
a \mbox{\hyperlink{struct_qore_1_1_date_time_info}{Date\+Time\+Info}} hash for the given date argument
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{hash<DateTimeInfo> h = date\_info(date);}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxyNote}{Note}
equivalent to \mbox{\hyperlink{class_qore_1_1zzz8datezzz9_a8570798c5d3d8273e45af77bd1817a3e}{Qore\+::zzz8datezzz9\+::info()}} 
\end{DoxyNote}
\mbox{\Hypertarget{group__date__and__time__functions_ga4a67e87acc70debe7b4d841f3a0d7279}\label{group__date__and__time__functions_ga4a67e87acc70debe7b4d841f3a0d7279}} 
\index{Date and Time Functions@{Date and Time Functions}!date\_ms@{date\_ms}}
\index{date\_ms@{date\_ms}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{date\_ms()}{date\_ms()}\hspace{0.1cm}{\footnotesize\ttfamily [1/2]}}
{\footnotesize\ttfamily nothing Qore\+::date\+\_\+ms (\begin{DoxyParamCaption}{ }\end{DoxyParamCaption})}



This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_RUNTIME_NOOP}{RUNTIME\+\_\+\+NOOP}} 
\end{DoxyParagraph}
\mbox{\Hypertarget{group__date__and__time__functions_gaa3c93eee1ff2667b2cded39f0fb01639}\label{group__date__and__time__functions_gaa3c93eee1ff2667b2cded39f0fb01639}} 
\index{Date and Time Functions@{Date and Time Functions}!date\_ms@{date\_ms}}
\index{date\_ms@{date\_ms}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{date\_ms()}{date\_ms()}\hspace{0.1cm}{\footnotesize\ttfamily [2/2]}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} Qore\+::date\+\_\+ms (\begin{DoxyParamCaption}\item[{softint}]{ms }\end{DoxyParamCaption})}



Converts an integer argument representing the offset in milliseconds from January 1, 1970 in the local time zone to a date in the local time zone. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em ms} & an integer argument representing the offset in milliseconds from January 1, 1970 in the local time zone\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
a date in the local time zone corresponding to the argument passed which is an offset in milliseconds from January 1, 1970 in the local time zone
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{date date = date\_ms(1); \textcolor{comment}{\# returns 1970-\/01-\/01T00:00:00.001 in the local time zone}}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxySeeAlso}{See also}
\mbox{\hyperlink{group__date__and__time__functions_ga9200d06a35e6a2c19aa2a6c952a049c0}{date\+\_\+us(softint)}} 
\end{DoxySeeAlso}
\mbox{\Hypertarget{group__date__and__time__functions_ga9200d06a35e6a2c19aa2a6c952a049c0}\label{group__date__and__time__functions_ga9200d06a35e6a2c19aa2a6c952a049c0}} 
\index{Date and Time Functions@{Date and Time Functions}!date\_us@{date\_us}}
\index{date\_us@{date\_us}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{date\_us()}{date\_us()}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} Qore\+::date\+\_\+us (\begin{DoxyParamCaption}\item[{softint}]{us }\end{DoxyParamCaption})}



Converts an integer argument representing the offset in microseconds from January 1, 1970 in the local time zone to a date in the local time zone. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em us} & an integer argument representing the offset in microseconds from January 1, 1970 in the local time zone\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
a date in the local time zone corresponding to the argument passed which is an offset in microseconds from January 1, 1970 in the local time zone
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{date date = date\_us(1); \textcolor{comment}{\# returns 1970-\/01-\/01T00:00:00.000001 in the local time zone}}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxySeeAlso}{See also}
\mbox{\hyperlink{group__date__and__time__functions_gaa3c93eee1ff2667b2cded39f0fb01639}{date\+\_\+ms(softint)}} 
\end{DoxySeeAlso}
\mbox{\Hypertarget{group__date__and__time__functions_ga09afb095d65e3393a85af466384c8bc4}\label{group__date__and__time__functions_ga09afb095d65e3393a85af466384c8bc4}} 
\index{Date and Time Functions@{Date and Time Functions}!days@{days}}
\index{days@{days}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{days()}{days()}\hspace{0.1cm}{\footnotesize\ttfamily [1/2]}}
{\footnotesize\ttfamily nothing Qore\+::days (\begin{DoxyParamCaption}{ }\end{DoxyParamCaption})}



This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_RUNTIME_NOOP}{RUNTIME\+\_\+\+NOOP}} 
\end{DoxyParagraph}
\mbox{\Hypertarget{group__date__and__time__functions_ga0f5bfff6ce4b534b1c3a6c5357b1377a}\label{group__date__and__time__functions_ga0f5bfff6ce4b534b1c3a6c5357b1377a}} 
\index{Date and Time Functions@{Date and Time Functions}!days@{days}}
\index{days@{days}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{days()}{days()}\hspace{0.1cm}{\footnotesize\ttfamily [2/2]}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} Qore\+::days (\begin{DoxyParamCaption}\item[{softint}]{days }\end{DoxyParamCaption})}



Returns a \mbox{\hyperlink{basic_data_types_relative_dates}{relative date/time value}} in days based on the integer argument passed to be used in date arithmetic. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em days} & the number of days to return\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
a \mbox{\hyperlink{basic_data_types_relative_dates}{relative date/time value}} in days based on the integer argument passed to be used in date arithmetic
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{date rd = days(100);}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxySeeAlso}{See also}

\begin{DoxyItemize}
\item \mbox{\hyperlink{group__date__and__time__functions_ga71eac87de4a337ec7d6dc6456d86d8c4}{years(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_gacf1db8004f38d76ad6028855f36772ce}{months(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_gab342176f1a1c5ac93fbf18faeda3e943}{hours(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_ga4d6d3d90deac1387573033793c668586}{minutes(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_ga19566ff46f3818f4554c73ba145fd8e1}{seconds(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_gac8e561799a9f873502e161695670c06d}{milliseconds(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_ga5ecb2657b5cc84fc2f16ae1a4cc3fae7}{microseconds(softint)}} 
\end{DoxyItemize}
\end{DoxySeeAlso}
\mbox{\Hypertarget{group__date__and__time__functions_ga4512b76526538194359a25ec63b60369}\label{group__date__and__time__functions_ga4512b76526538194359a25ec63b60369}} 
\index{Date and Time Functions@{Date and Time Functions}!format\_date@{format\_date}}
\index{format\_date@{format\_date}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{format\_date()}{format\_date()}\hspace{0.1cm}{\footnotesize\ttfamily [1/2]}}
{\footnotesize\ttfamily nothing Qore\+::format\+\_\+date (\begin{DoxyParamCaption}{ }\end{DoxyParamCaption})}



This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_RUNTIME_NOOP}{RUNTIME\+\_\+\+NOOP}} 
\end{DoxyParagraph}
\mbox{\Hypertarget{group__date__and__time__functions_gad5572fcb49964bfe3005e144da579361}\label{group__date__and__time__functions_gad5572fcb49964bfe3005e144da579361}} 
\index{Date and Time Functions@{Date and Time Functions}!format\_date@{format\_date}}
\index{format\_date@{format\_date}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{format\_date()}{format\_date()}\hspace{0.1cm}{\footnotesize\ttfamily [2/2]}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__type__conversion__functions_gacf16b4126b795f4b6933ef3425cadae3}{string}} Qore\+::format\+\_\+date (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__type__conversion__functions_gacf16b4126b795f4b6933ef3425cadae3}{string}}}]{format,  }\item[{\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}}}]{dt }\end{DoxyParamCaption})}



Returns a formatted string for a date argument passed. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em format} & a string giving the format for the date; see \mbox{\hyperlink{group__date__and__time__functions_date_formatting}{Date Formatting Codes}} for more information about this string \\
\hline
{\em dt} & the date to use for the string output\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
a formatted string for a date argument passed
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{string str = format\_date(\textcolor{stringliteral}{"{}Day, Mon D, YYYY-\/MM-\/DD HH:mm:SS"{}}, 2004-\/02-\/01T12:30:00);}
\DoxyCodeLine{\textcolor{comment}{\# returns "{}Sunday, Feb 1, 2004-\/02-\/01 12:30:00"{}}}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxyRefDesc}{Bug}
\item[\mbox{\hyperlink{bug__bug000007}{Bug}}]there is no locale support; day and month names and abbreviations are only returned in English \end{DoxyRefDesc}
\mbox{\Hypertarget{group__date__and__time__functions_ga1401d634f3bcbec80d64f75cdd9d4921}\label{group__date__and__time__functions_ga1401d634f3bcbec80d64f75cdd9d4921}} 
\index{Date and Time Functions@{Date and Time Functions}!get\_date\_from\_iso\_week@{get\_date\_from\_iso\_week}}
\index{get\_date\_from\_iso\_week@{get\_date\_from\_iso\_week}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{get\_date\_from\_iso\_week()}{get\_date\_from\_iso\_week()}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} Qore\+::get\+\_\+date\+\_\+from\+\_\+iso\+\_\+week (\begin{DoxyParamCaption}\item[{softint}]{year,  }\item[{softint}]{week,  }\item[{softint}]{day = {\ttfamily 1} }\end{DoxyParamCaption})}



Retuns an \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date value}} for the \href{http://en.wikipedia.org/wiki/ISO_week_date}{\texttt{ ISO-\/8601 calendar week information}} passed (year, week number, optional\+: weekday, where 1=Monday, 7=Sunday) in the current time zone. 

Throws an exception if the arguments are invalid

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_RET_VALUE_ONLY}{RET\+\_\+\+VALUE\+\_\+\+ONLY}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em year} & the ISO-\/8601 year (which for some special days does not always correspond to the actual calendar year) \\
\hline
{\em week} & the ISO-\/8601 week number; if this argument is invalid, an {\ttfamily ISO-\/8601-\/\+INVALID-\/\+WEEK} exception is thrown \\
\hline
{\em day} & the day of the week, where 1=Monday and 7=Sunday; if this argument is invalid, an {\ttfamily ISO-\/8601-\/\+INVALID-\/\+DAY} exception is thrown\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
an \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date value}} for the \href{http://en.wikipedia.org/wiki/ISO_week_date}{\texttt{ ISO-\/8601 calendar week information}} passed (year, week number, optional\+: weekday, where 1=Monday, 7=Sunday) in the current time zone
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{date d = getDateFromISOWeek(2007, 3); \textcolor{comment}{\# returns 2007-\/01-\/15}}

\end{DoxyCode}

\end{DoxyParagraph}

\begin{DoxyExceptions}{Exceptions}
{\em ISO-\/8601-\/\+INVALID-\/\+WEEK} & The week number is not valid for the given year \\
\hline
{\em ISO-\/8601-\/\+INVALID-\/\+DAY} & The day number is not between 1 (Monday) and 7 (Sunday) inclusive\\
\hline
\end{DoxyExceptions}
\begin{DoxySince}{Since}
Qore 0.\+8.\+12 as a replacement for deprecated camel-\/case \mbox{\hyperlink{group__date__and__time__functions_ga86f47ab9a928a2c8aff8cbac9b5f3518}{get\+Date\+From\+ISOWeek()}} 
\end{DoxySince}
\mbox{\Hypertarget{group__date__and__time__functions_gaec9d8c1ba3a39869904f27e8c0706589}\label{group__date__and__time__functions_gaec9d8c1ba3a39869904f27e8c0706589}} 
\index{Date and Time Functions@{Date and Time Functions}!get\_day\_number@{get\_day\_number}}
\index{get\_day\_number@{get\_day\_number}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{get\_day\_number()}{get\_day\_number()}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} Qore\+::get\+\_\+day\+\_\+number (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}}}]{dt }\end{DoxyParamCaption})}



Returns an integer representing the ordinal day number in the year (corresponding to the \href{http://en.wikipedia.org/wiki/ISO_8601\#Ordinal_dates}{\texttt{ ISO-\/8601 day number}}) for the \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date}} value passed. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em dt} & an \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date}} value to get the ordinal day number\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
an integer representing the ordinal day number in the year (corresponding to the \href{http://en.wikipedia.org/wiki/ISO_8601\#Ordinal_dates}{\texttt{ ISO-\/8601 day number}}) for the \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date}} value passed; if a \mbox{\hyperlink{basic_data_types_relative_dates}{relative date}} value is passed, then this function will return 0
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{int dn = get\_day\_number(dt);}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxyNote}{Note}
equivalent to \mbox{\hyperlink{class_qore_1_1zzz8datezzz9_ae0566a68783890f894213258833b0b37}{Qore\+::zzz8datezzz9\+::day\+Number()}}
\end{DoxyNote}
\begin{DoxySince}{Since}
Qore 0.\+8.\+12 as a replacement for deprecated camel-\/case \mbox{\hyperlink{group__date__and__time__functions_ga43bb7bc0ae09fa7fd9267e248d3cb8e1}{get\+Day\+Number()}} 
\end{DoxySince}
\mbox{\Hypertarget{group__date__and__time__functions_gaa546956fb71d56f18c903aff1f3fc01a}\label{group__date__and__time__functions_gaa546956fb71d56f18c903aff1f3fc01a}} 
\index{Date and Time Functions@{Date and Time Functions}!get\_day\_of\_week@{get\_day\_of\_week}}
\index{get\_day\_of\_week@{get\_day\_of\_week}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{get\_day\_of\_week()}{get\_day\_of\_week()}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} Qore\+::get\+\_\+day\+\_\+of\+\_\+week (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}}}]{dt }\end{DoxyParamCaption})}



Returns an integer representing the day of the week for the \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date}} value passed (0=Sunday, 6=Saturday) 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em dt} & an \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date}} value to get the number for the day of the week\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
an integer representing the day of the week for the \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date}} value passed (0=Sunday, 6=Saturday); if a \mbox{\hyperlink{basic_data_types_relative_dates}{relative date}} value is passed, then this function will return 0
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{int dn = get\_day\_of\_week(dt);}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxyNote}{Note}
equivalent to \mbox{\hyperlink{class_qore_1_1zzz8datezzz9_a776388307af89346ac4456a09d8fb22d}{Qore\+::zzz8datezzz9\+::day\+Of\+Week()}}
\end{DoxyNote}
\begin{DoxySeeAlso}{See also}
\mbox{\hyperlink{group__date__and__time__functions_ga64bfe13c03c1b2746bfb5c80f5279e2a}{get\+\_\+iso\+\_\+day\+\_\+of\+\_\+week()}}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
Qore 0.\+8.\+12 as a replacement for deprecated camel-\/case \mbox{\hyperlink{group__date__and__time__functions_ga0c77571be96a607e6509a443924bbfa0}{get\+Day\+Of\+Week()}} 
\end{DoxySince}
\mbox{\Hypertarget{group__date__and__time__functions_gac3b2e2b48cfa2cf2fded33e742a33b3c}\label{group__date__and__time__functions_gac3b2e2b48cfa2cf2fded33e742a33b3c}} 
\index{Date and Time Functions@{Date and Time Functions}!get\_days@{get\_days}}
\index{get\_days@{get\_days}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{get\_days()}{get\_days()}\hspace{0.1cm}{\footnotesize\ttfamily [1/2]}}
{\footnotesize\ttfamily nothing Qore\+::get\+\_\+days (\begin{DoxyParamCaption}{ }\end{DoxyParamCaption})}



This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_RUNTIME_NOOP}{RUNTIME\+\_\+\+NOOP}} 
\end{DoxyParagraph}
\mbox{\Hypertarget{group__date__and__time__functions_ga12df9bddb196820c9278f7884d6816f0}\label{group__date__and__time__functions_ga12df9bddb196820c9278f7884d6816f0}} 
\index{Date and Time Functions@{Date and Time Functions}!get\_days@{get\_days}}
\index{get\_days@{get\_days}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{get\_days()}{get\_days()}\hspace{0.1cm}{\footnotesize\ttfamily [2/2]}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} Qore\+::get\+\_\+days (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}}}]{dt }\end{DoxyParamCaption})}



Returns an integer corresponding to the literal day value in the date (does not calculate a duration) 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em dt} & the date value; can be either a \mbox{\hyperlink{basic_data_types_relative_dates}{relative}} or \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute}} date\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
an integer corresponding to the day value in the date
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{int n = get\_days(dt);}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxyNote}{Note}
equivalent to pseudo-\/method \mbox{\hyperlink{class_qore_1_1zzz8datezzz9_a04d1e263ad79ed6ef30e26e49dcc4064}{Qore\+::zzz8datezzz9\+::days()}} 
\end{DoxyNote}
\mbox{\Hypertarget{group__date__and__time__functions_ga314baf84678a796209a67156b4f5d8b8}\label{group__date__and__time__functions_ga314baf84678a796209a67156b4f5d8b8}} 
\index{Date and Time Functions@{Date and Time Functions}!get\_duration\_microseconds@{get\_duration\_microseconds}}
\index{get\_duration\_microseconds@{get\_duration\_microseconds}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{get\_duration\_microseconds()}{get\_duration\_microseconds()}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} Qore\+::get\+\_\+duration\+\_\+microseconds (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}}}]{dt }\end{DoxyParamCaption})}



Returns an integer value representing the the number of microseconds of duration in the value of the date passed (can be either a \mbox{\hyperlink{basic_data_types_relative_dates}{relative}} or \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute}} date) 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em dt} & a \mbox{\hyperlink{basic_data_types_relative_dates}{relative}} or \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute}} date argument\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
an integer value representing the the number of microseconds of duration in the value of the date passed; if the argument is a \mbox{\hyperlink{basic_data_types_relative_dates}{relative date}}, the value is normalized to microseconds and the integer microseconds value is returned, if the argument is an \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date}}, the duration in microseconds is calculated from the present time; so if the present time is sent as an argument, 0 is returned, if a future date is used, the number of microseconds from the present time to the future date is returned, if an \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date}} in the past is passed as an argument, also 0 is returned (the function does not calculate microsecond differences for \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute dates}} in the past (for this use \mbox{\hyperlink{date_time_arithmetic}{Date/\+Time Arithmetic}} instead); this function can only return a negative value if passed a relative date/time value
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{int us = get\_duration\_microseconds(PT2M15S3u); \textcolor{comment}{\# returns 135000003}}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxyNote}{Note}

\begin{DoxyItemize}
\item equivalent to \mbox{\hyperlink{class_qore_1_1zzz8datezzz9_afd98bf51bd4870ddc8469e0bc19f2b9c}{Qore\+::zzz8datezzz9\+::duration\+Microseconds()}}
\item to get the literal microseconds integer value from a date/time value without calculating a duration, use \mbox{\hyperlink{group__date__and__time__functions_ga8ae5ae186ff94fc2033ee0f6f308688a}{get\+\_\+microseconds(date)}}
\end{DoxyItemize}
\end{DoxyNote}
\begin{DoxySeeAlso}{See also}

\begin{DoxyItemize}
\item \mbox{\hyperlink{group__date__and__time__functions_gac96ed9dc0e5436a5f77c7fbeb5c5842e}{get\+\_\+duration\+\_\+seconds\+\_\+f()}}
\item \mbox{\hyperlink{group__date__and__time__functions_ga98ef4a4d08621926630c15c1bbd769df}{get\+\_\+duration\+\_\+seconds()}}
\item \mbox{\hyperlink{group__date__and__time__functions_ga9577b42c40fd075fb0bcb5ecabec75a1}{get\+\_\+duration\+\_\+milliseconds()}} 
\end{DoxyItemize}
\end{DoxySeeAlso}
\mbox{\Hypertarget{group__date__and__time__functions_ga9577b42c40fd075fb0bcb5ecabec75a1}\label{group__date__and__time__functions_ga9577b42c40fd075fb0bcb5ecabec75a1}} 
\index{Date and Time Functions@{Date and Time Functions}!get\_duration\_milliseconds@{get\_duration\_milliseconds}}
\index{get\_duration\_milliseconds@{get\_duration\_milliseconds}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{get\_duration\_milliseconds()}{get\_duration\_milliseconds()}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} Qore\+::get\+\_\+duration\+\_\+milliseconds (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}}}]{dt }\end{DoxyParamCaption})}



Returns an integer value representing the the number of milliseconds of duration in the value of the date passed (can be either a \mbox{\hyperlink{basic_data_types_relative_dates}{relative}} or \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute}} date) 

The duration in milliseconds is calculated and any fractional milliseconds are truncated (no rounding is performed)

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em dt} & a \mbox{\hyperlink{basic_data_types_relative_dates}{relative}} or \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute}} date argument\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
an integer value representing the the number of milliseconds of duration in the value of the date passed; if the argument is a \mbox{\hyperlink{basic_data_types_relative_dates}{relative date}}, the value is normalized to milliseconds and the integer milliseconds value is returned, if the argument is an \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date}}, the duration in milliseconds is calculated from the present time; so if the present time is sent as an argument, 0 is returned, if a future date is used, the number of milliseconds from the present time to the future date is returned, if an \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date}} in the past is passed as an argument, also 0 is returned (the function does not calculate millisecond differences for \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute dates}} in the past (for this use \mbox{\hyperlink{date_time_arithmetic}{Date/\+Time Arithmetic}} instead); this function can only return a negative value if passed a relative date/time value
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{int ms = get\_duration\_milliseconds(PT2M15S3u); \textcolor{comment}{\# returns 135000}}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxyNote}{Note}

\begin{DoxyItemize}
\item equivalent to \mbox{\hyperlink{class_qore_1_1zzz8datezzz9_a0a1bf587b81314cbc5cbabd4cc618476}{Qore\+::zzz8datezzz9\+::duration\+Milliseconds()}}
\item to get the literal milliseconds integer value from a date/time value without calculating a duration, use \mbox{\hyperlink{group__date__and__time__functions_gaabefaf27c91bdc7bf6ffa50b391279ea}{get\+\_\+milliseconds(date)}}
\end{DoxyItemize}
\end{DoxyNote}
\begin{DoxySeeAlso}{See also}

\begin{DoxyItemize}
\item \mbox{\hyperlink{group__date__and__time__functions_gac96ed9dc0e5436a5f77c7fbeb5c5842e}{get\+\_\+duration\+\_\+seconds\+\_\+f()}}
\item \mbox{\hyperlink{group__date__and__time__functions_ga98ef4a4d08621926630c15c1bbd769df}{get\+\_\+duration\+\_\+seconds()}}
\item \mbox{\hyperlink{group__date__and__time__functions_ga314baf84678a796209a67156b4f5d8b8}{get\+\_\+duration\+\_\+microseconds()}} 
\end{DoxyItemize}
\end{DoxySeeAlso}
\mbox{\Hypertarget{group__date__and__time__functions_ga98ef4a4d08621926630c15c1bbd769df}\label{group__date__and__time__functions_ga98ef4a4d08621926630c15c1bbd769df}} 
\index{Date and Time Functions@{Date and Time Functions}!get\_duration\_seconds@{get\_duration\_seconds}}
\index{get\_duration\_seconds@{get\_duration\_seconds}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{get\_duration\_seconds()}{get\_duration\_seconds()}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} Qore\+::get\+\_\+duration\+\_\+seconds (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}}}]{dt }\end{DoxyParamCaption})}



Returns an integer value representing the the number of seconds of duration in the value of the date passed (can be either a \mbox{\hyperlink{basic_data_types_relative_dates}{relative}} or \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute}} date) 

The duration in seconds is calculated and any fractional seconds are truncated (no rounding is performed)

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em dt} & a \mbox{\hyperlink{basic_data_types_relative_dates}{relative}} or \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute}} date argument\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
an integer value representing the the number of seconds of duration in the value of the date passed; if the argument is a \mbox{\hyperlink{basic_data_types_relative_dates}{relative date}}, the value is normalized to seconds and the integer seconds value is returned, if the argument is an \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date}}, the duration in seconds is calculated from the present time; so if the present time is sent as an argument, 0 is returned, if a future date is used, the number of seconds from the present time to the future date is returned, if an \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date}} in the past is passed as an argument, also 0 is returned (the function does not calculate second differences for \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute dates}} in the past (for this use \mbox{\hyperlink{date_time_arithmetic}{Date/\+Time Arithmetic}} instead); this function can only return a negative value if passed a relative date/time value
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{int us = get\_duration\_seconds(PT2M15S3u); \textcolor{comment}{\# returns 135}}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxyNote}{Note}

\begin{DoxyItemize}
\item equivalent to \mbox{\hyperlink{class_qore_1_1zzz8datezzz9_aef0e1961cbf4e1f2b53b789d0727681f}{Qore\+::zzz8datezzz9\+::duration\+Seconds()}}
\item to get a similar floating-\/point value with microseconds providing the digits to the right of the decimal place, use \mbox{\hyperlink{group__date__and__time__functions_gac96ed9dc0e5436a5f77c7fbeb5c5842e}{get\+\_\+duration\+\_\+seconds\+\_\+f()}}
\item to get the literal seconds integer value from a date/time value without calculating a duration, use \mbox{\hyperlink{group__date__and__time__functions_ga8872de33c58a5b4a2ffe01818f226f48}{get\+\_\+seconds(date)}}
\end{DoxyItemize}
\end{DoxyNote}
\begin{DoxySeeAlso}{See also}

\begin{DoxyItemize}
\item \mbox{\hyperlink{group__date__and__time__functions_gac96ed9dc0e5436a5f77c7fbeb5c5842e}{get\+\_\+duration\+\_\+seconds\+\_\+f()}}
\item \mbox{\hyperlink{group__date__and__time__functions_ga9577b42c40fd075fb0bcb5ecabec75a1}{get\+\_\+duration\+\_\+milliseconds()}}
\item \mbox{\hyperlink{group__date__and__time__functions_ga314baf84678a796209a67156b4f5d8b8}{get\+\_\+duration\+\_\+microseconds()}} 
\end{DoxyItemize}
\end{DoxySeeAlso}
\mbox{\Hypertarget{group__date__and__time__functions_gac96ed9dc0e5436a5f77c7fbeb5c5842e}\label{group__date__and__time__functions_gac96ed9dc0e5436a5f77c7fbeb5c5842e}} 
\index{Date and Time Functions@{Date and Time Functions}!get\_duration\_seconds\_f@{get\_duration\_seconds\_f}}
\index{get\_duration\_seconds\_f@{get\_duration\_seconds\_f}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{get\_duration\_seconds\_f()}{get\_duration\_seconds\_f()}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__type__conversion__functions_ga113d18216af1bdb70545081b6a9892ef}{float}} Qore\+::get\+\_\+duration\+\_\+seconds\+\_\+f (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}}}]{dt }\end{DoxyParamCaption})}



Returns a floating-\/point value representing the the number of seconds of duration in the value of the date passed (can be either a \mbox{\hyperlink{basic_data_types_relative_dates}{relative}} or \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute}} date) 

The duration in seconds is calculated and any fractional seconds are returned as digits to the right of the decimal point.

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em dt} & a \mbox{\hyperlink{basic_data_types_relative_dates}{relative}} or \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute}} date argument\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
a floating-\/point value representing the the number of seconds of duration in the value of the date passed; if the argument is a \mbox{\hyperlink{basic_data_types_relative_dates}{relative date}}, the value is normalized to seconds and the floating-\/point seconds value is returned with microseconds providing the digits to the right of the decimal place, if the argument is an \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date}}, the duration in seconds is calculated from the present time; so if the present time is sent as an argument, 0 is returned, if a future date is used, the number of seconds from the present time to the future date is returned, if an \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date}} in the past is passed as an argument, also 0 is returned (the function does not calculate second differences for \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute dates}} in the past (for this use \mbox{\hyperlink{date_time_arithmetic}{Date/\+Time Arithmetic}} instead); this function can only return a negative value if passed a relative date/time value
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{float dt = get\_duration\_seconds\_f(PT2M15S3u); \textcolor{comment}{\# returns 135.000003}}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxyNote}{Note}

\begin{DoxyItemize}
\item equivalent to \mbox{\hyperlink{class_qore_1_1zzz8datezzz9_a51af864148656e9fe7dd6e9bc1aba1df}{Qore\+::zzz8datezzz9\+::duration\+Seconds\+Float()}}
\item to get the literal seconds integer value from a date/time value without calculating a duration, use \mbox{\hyperlink{group__date__and__time__functions_ga8872de33c58a5b4a2ffe01818f226f48}{get\+\_\+seconds(date)}}
\end{DoxyItemize}
\end{DoxyNote}
\begin{DoxySeeAlso}{See also}

\begin{DoxyItemize}
\item \mbox{\hyperlink{group__date__and__time__functions_ga98ef4a4d08621926630c15c1bbd769df}{get\+\_\+duration\+\_\+seconds()}}
\item \mbox{\hyperlink{group__date__and__time__functions_ga9577b42c40fd075fb0bcb5ecabec75a1}{get\+\_\+duration\+\_\+milliseconds()}}
\item \mbox{\hyperlink{group__date__and__time__functions_ga314baf84678a796209a67156b4f5d8b8}{get\+\_\+duration\+\_\+microseconds()}}
\end{DoxyItemize}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
Qore 0.\+8.\+12 
\end{DoxySince}
\mbox{\Hypertarget{group__date__and__time__functions_gaeca2765fa7aa631c885e61490c2421a2}\label{group__date__and__time__functions_gaeca2765fa7aa631c885e61490c2421a2}} 
\index{Date and Time Functions@{Date and Time Functions}!get\_epoch\_seconds@{get\_epoch\_seconds}}
\index{get\_epoch\_seconds@{get\_epoch\_seconds}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{get\_epoch\_seconds()}{get\_epoch\_seconds()}\hspace{0.1cm}{\footnotesize\ttfamily [1/2]}}
{\footnotesize\ttfamily nothing Qore\+::get\+\_\+epoch\+\_\+seconds (\begin{DoxyParamCaption}{ }\end{DoxyParamCaption})}



This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_RUNTIME_NOOP}{RUNTIME\+\_\+\+NOOP}} 
\end{DoxyParagraph}
\mbox{\Hypertarget{group__date__and__time__functions_gaa69c5fbab2d5e245d89cb3253523c310}\label{group__date__and__time__functions_gaa69c5fbab2d5e245d89cb3253523c310}} 
\index{Date and Time Functions@{Date and Time Functions}!get\_epoch\_seconds@{get\_epoch\_seconds}}
\index{get\_epoch\_seconds@{get\_epoch\_seconds}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{get\_epoch\_seconds()}{get\_epoch\_seconds()}\hspace{0.1cm}{\footnotesize\ttfamily [2/2]}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} Qore\+::get\+\_\+epoch\+\_\+seconds (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}}}]{dt }\end{DoxyParamCaption})}



Returns the number of seconds of the date and time in local time passed since Jan 1, 1970, 00\+:00\+:00 Z (UTC); negative values are returned for dates before the epoch. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em dt} & The date to process\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
the number of seconds of the date and time in local time passed since Jan 1, 1970, 00\+:00\+:00 Z (UTC); negative values are returned for dates before the epoch
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{int i = get\_epoch\_seconds(2012-\/01-\/19T08:02:15+01:00);}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxySeeAlso}{See also}
\mbox{\hyperlink{group__date__and__time__functions_ga62c3c23b7423b9583193a8a5cb16eb29}{timegm(date)}}
\end{DoxySeeAlso}
\begin{DoxyNote}{Note}
This function is equivalent to \mbox{\hyperlink{group__date__and__time__functions_ga3278590d05035f64ba18170e87e8293a}{mktime(date)}} 
\end{DoxyNote}
\mbox{\Hypertarget{group__date__and__time__functions_gad6e926ac468f32b6f269b6d62dcc186f}\label{group__date__and__time__functions_gad6e926ac468f32b6f269b6d62dcc186f}} 
\index{Date and Time Functions@{Date and Time Functions}!get\_hours@{get\_hours}}
\index{get\_hours@{get\_hours}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{get\_hours()}{get\_hours()}\hspace{0.1cm}{\footnotesize\ttfamily [1/2]}}
{\footnotesize\ttfamily nothing Qore\+::get\+\_\+hours (\begin{DoxyParamCaption}{ }\end{DoxyParamCaption})}



This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_RUNTIME_NOOP}{RUNTIME\+\_\+\+NOOP}} 
\end{DoxyParagraph}
\mbox{\Hypertarget{group__date__and__time__functions_ga83e582adb5ad1401911345ba306dabd2}\label{group__date__and__time__functions_ga83e582adb5ad1401911345ba306dabd2}} 
\index{Date and Time Functions@{Date and Time Functions}!get\_hours@{get\_hours}}
\index{get\_hours@{get\_hours}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{get\_hours()}{get\_hours()}\hspace{0.1cm}{\footnotesize\ttfamily [2/2]}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} Qore\+::get\+\_\+hours (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}}}]{dt }\end{DoxyParamCaption})}



Returns an integer corresponding to the literal hour value in the date (does not calculate a duration) 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em dt} & the date value; can be either a \mbox{\hyperlink{basic_data_types_relative_dates}{relative}} or \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute}} date\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
an integer corresponding to the hour value in the date
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{int n = get\_hours(dt);}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxyNote}{Note}
equivalent to pseudo-\/method \mbox{\hyperlink{class_qore_1_1zzz8datezzz9_a020025625850084710c7eddd0fa2ab51}{Qore\+::zzz8datezzz9\+::hours()}} 
\end{DoxyNote}
\mbox{\Hypertarget{group__date__and__time__functions_ga64bfe13c03c1b2746bfb5c80f5279e2a}\label{group__date__and__time__functions_ga64bfe13c03c1b2746bfb5c80f5279e2a}} 
\index{Date and Time Functions@{Date and Time Functions}!get\_iso\_day\_of\_week@{get\_iso\_day\_of\_week}}
\index{get\_iso\_day\_of\_week@{get\_iso\_day\_of\_week}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{get\_iso\_day\_of\_week()}{get\_iso\_day\_of\_week()}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} Qore\+::get\+\_\+iso\+\_\+day\+\_\+of\+\_\+week (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}}}]{dt }\end{DoxyParamCaption})}



Returns an integer representing the ISO-\/8601 day of the week for the \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date}} value passed (1=Monday, 7=Sunday) 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em dt} & an \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date}} value to get the number for the day of the week\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
an integer representing the day of the week for the \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date}} value passed (1=Monday, 7=Sunday); if a \mbox{\hyperlink{basic_data_types_relative_dates}{relative date}} value is passed, then this function will return 7
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{int dn = get\_iso\_day\_of\_week(dt);}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxyNote}{Note}
equivalent to \mbox{\hyperlink{class_qore_1_1zzz8datezzz9_ad38a12c3b55fab4825bbb7d6125df1e5}{Qore\+::zzz8datezzz9\+::iso\+Day\+Of\+Week()}}
\end{DoxyNote}
\begin{DoxySeeAlso}{See also}
\mbox{\hyperlink{group__date__and__time__functions_gaa546956fb71d56f18c903aff1f3fc01a}{get\+\_\+day\+\_\+of\+\_\+week()}}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
Qore 0.\+8.\+12 as a replacement for deprecated camel-\/case \mbox{\hyperlink{group__date__and__time__functions_ga23973fcabb1d70ccb1fefe7f405988ec}{get\+ISODay\+Of\+Week()}} 
\end{DoxySince}
\mbox{\Hypertarget{group__date__and__time__functions_ga8cfd46ea9e98be647d8206732a63c1d9}\label{group__date__and__time__functions_ga8cfd46ea9e98be647d8206732a63c1d9}} 
\index{Date and Time Functions@{Date and Time Functions}!get\_iso\_week\_hash@{get\_iso\_week\_hash}}
\index{get\_iso\_week\_hash@{get\_iso\_week\_hash}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{get\_iso\_week\_hash()}{get\_iso\_week\_hash()}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__type__conversion__functions_ga24ee71727f0785d3b826833ed6f5e2ee}{hash}}$<$ \mbox{\hyperlink{struct_qore_1_1_iso_week_info}{Iso\+Week\+Info}} $>$ Qore\+::get\+\_\+iso\+\_\+week\+\_\+hash (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}}}]{dt }\end{DoxyParamCaption})}



Returns an \mbox{\hyperlink{struct_qore_1_1_iso_week_info}{Iso\+Week\+Info}} hash representing the ISO-\/8601 calendar week information for the \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date}} passed (hash keys\+: {\ttfamily \char`\"{}year\char`\"{}}, {\ttfamily \char`\"{}week\char`\"{}}, {\ttfamily \char`\"{}day\char`\"{}}) 

\begin{DoxyNote}{Note}
that the ISO-\/8601 year does not always correspond with the calendar year at the end and the beginning of every year (for example 2006-\/01-\/01 in ISO-\/8601 calendar week format is\+: year=2005, week=52, day=7)
\end{DoxyNote}
\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em dt} & the date to get information for\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
an \mbox{\hyperlink{struct_qore_1_1_iso_week_info}{Iso\+Week\+Info}} hash representing the ISO-\/8601 calendar week information for the \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date}} passed (hash keys\+: {\ttfamily \char`\"{}year\char`\"{}}, {\ttfamily \char`\"{}week\char`\"{}}, {\ttfamily \char`\"{}day\char`\"{}}); if a \mbox{\hyperlink{basic_data_types_relative_dates}{relative date}} value is passed, then this function will return year=1970, week=1, day=1
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{hash<IsoWeekInfo> h = get\_iso\_week\_hash(2007-\/05-\/15); \textcolor{comment}{\# returns year=2007, week=20, day=2}}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxyNote}{Note}
equivalent to \mbox{\hyperlink{class_qore_1_1zzz8datezzz9_ad8c2c004a04ac7db6427f3e158d7400b}{Qore\+::zzz8datezzz9\+::iso\+Week\+Hash()}}
\end{DoxyNote}
\begin{DoxySeeAlso}{See also}
\mbox{\hyperlink{group__date__and__time__functions_gadfb87ebf695f7e037efb64367cdb6626}{get\+\_\+iso\+\_\+week\+\_\+string()}}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
Qore 0.\+8.\+12 as a replacement for deprecated camel-\/case \mbox{\hyperlink{group__date__and__time__functions_ga6492bcbbb26c4b8466a9203a86b4306c}{get\+ISOWeek\+Hash()}} 
\end{DoxySince}
\mbox{\Hypertarget{group__date__and__time__functions_gadfb87ebf695f7e037efb64367cdb6626}\label{group__date__and__time__functions_gadfb87ebf695f7e037efb64367cdb6626}} 
\index{Date and Time Functions@{Date and Time Functions}!get\_iso\_week\_string@{get\_iso\_week\_string}}
\index{get\_iso\_week\_string@{get\_iso\_week\_string}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{get\_iso\_week\_string()}{get\_iso\_week\_string()}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__type__conversion__functions_gacf16b4126b795f4b6933ef3425cadae3}{string}} Qore\+::get\+\_\+iso\+\_\+week\+\_\+string (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}}}]{dt }\end{DoxyParamCaption})}



Returns a string representing the ISO-\/8601 calendar week information for the \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date}} passed (ex\+: 2006-\/01-\/01 = \char`\"{}2005-\/\+W52-\/7\char`\"{}) 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em dt} & the date to get information for\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
a string representing the ISO-\/8601 calendar week information for the \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date}} passed (ex\+: 2006-\/01-\/01 = \char`\"{}2005-\/\+W52-\/7\char`\"{}); if a \mbox{\hyperlink{basic_data_types_relative_dates}{relative date}} value is passed, then this function will return {\ttfamily \char`\"{}1970-\/\+W01-\/1\char`\"{}} 
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{string str = get\_iso\_week\_string(2007-\/05-\/15); \textcolor{comment}{\# returns "{}2007-\/W20-\/2"{}}}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxyNote}{Note}
equivalent to \mbox{\hyperlink{class_qore_1_1zzz8datezzz9_aa03daafa0fe01dfa0abf447d8ca135fd}{Qore\+::zzz8datezzz9\+::iso\+Week\+String()}}
\end{DoxyNote}
\begin{DoxySeeAlso}{See also}
\mbox{\hyperlink{group__date__and__time__functions_ga8cfd46ea9e98be647d8206732a63c1d9}{get\+\_\+iso\+\_\+week\+\_\+hash()}}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
Qore 0.\+8.\+12 as a replacement for deprecated camel-\/case \mbox{\hyperlink{group__date__and__time__functions_ga6f1fd787412d97d01c7b8450c5a6f82a}{get\+ISOWeek\+String()}} 
\end{DoxySince}
\mbox{\Hypertarget{group__date__and__time__functions_ga8ae5ae186ff94fc2033ee0f6f308688a}\label{group__date__and__time__functions_ga8ae5ae186ff94fc2033ee0f6f308688a}} 
\index{Date and Time Functions@{Date and Time Functions}!get\_microseconds@{get\_microseconds}}
\index{get\_microseconds@{get\_microseconds}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{get\_microseconds()}{get\_microseconds()}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} Qore\+::get\+\_\+microseconds (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}}}]{dt }\end{DoxyParamCaption})}



Returns an integer corresponding to the literal microsecond value in the date (does not calculate a duration) 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em dt} & the date value; can be either a \mbox{\hyperlink{basic_data_types_relative_dates}{relative}} or \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute}} date\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
an integer corresponding to the literal microsecond value in the date (does not calculate a duration)
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{int n = get\_microseconds(dt);}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxyNote}{Note}

\begin{DoxyItemize}
\item equivalent to pseudo-\/method \mbox{\hyperlink{class_qore_1_1zzz8datezzz9_aacf57fbebe79940acf8012374393efa5}{Qore\+::zzz8datezzz9\+::microseconds()}}
\item to get the number of microseconds of duration in a date/time value, use \mbox{\hyperlink{group__date__and__time__functions_ga314baf84678a796209a67156b4f5d8b8}{get\+\_\+duration\+\_\+microseconds()}} instead 
\end{DoxyItemize}
\end{DoxyNote}
\mbox{\Hypertarget{group__date__and__time__functions_ga15e3b79ea0fabd6d544398e9c6d849bf}\label{group__date__and__time__functions_ga15e3b79ea0fabd6d544398e9c6d849bf}} 
\index{Date and Time Functions@{Date and Time Functions}!get\_midnight@{get\_midnight}}
\index{get\_midnight@{get\_midnight}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{get\_midnight()}{get\_midnight()}\hspace{0.1cm}{\footnotesize\ttfamily [1/2]}}
{\footnotesize\ttfamily nothing Qore\+::get\+\_\+midnight (\begin{DoxyParamCaption}{ }\end{DoxyParamCaption})}



This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_RUNTIME_NOOP}{RUNTIME\+\_\+\+NOOP}} 
\end{DoxyParagraph}
\mbox{\Hypertarget{group__date__and__time__functions_ga83dc9f23f27ec426d6eea28dea040bca}\label{group__date__and__time__functions_ga83dc9f23f27ec426d6eea28dea040bca}} 
\index{Date and Time Functions@{Date and Time Functions}!get\_midnight@{get\_midnight}}
\index{get\_midnight@{get\_midnight}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{get\_midnight()}{get\_midnight()}\hspace{0.1cm}{\footnotesize\ttfamily [2/2]}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} Qore\+::get\+\_\+midnight (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}}}]{dt }\end{DoxyParamCaption})}



Returns midnight on the date passed (strips the time component on the new value) 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em dt} & the date to process\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
midnight on the date passed (strips the time component on the new value)
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{date midnight = get\_midnight(dt);}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxyNote}{Note}
equivalent to pseudo-\/method \mbox{\hyperlink{class_qore_1_1zzz8datezzz9_a1946f38ad9528c2e80552b8e2bc39f62}{Qore\+::zzz8datezzz9\+::midnight()}} 
\end{DoxyNote}
\mbox{\Hypertarget{group__date__and__time__functions_ga2247d7d6516390915ab492813184da7b}\label{group__date__and__time__functions_ga2247d7d6516390915ab492813184da7b}} 
\index{Date and Time Functions@{Date and Time Functions}!get\_milliseconds@{get\_milliseconds}}
\index{get\_milliseconds@{get\_milliseconds}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{get\_milliseconds()}{get\_milliseconds()}\hspace{0.1cm}{\footnotesize\ttfamily [1/2]}}
{\footnotesize\ttfamily nothing Qore\+::get\+\_\+milliseconds (\begin{DoxyParamCaption}{ }\end{DoxyParamCaption})}



This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_RUNTIME_NOOP}{RUNTIME\+\_\+\+NOOP}} 
\end{DoxyParagraph}
\mbox{\Hypertarget{group__date__and__time__functions_gaabefaf27c91bdc7bf6ffa50b391279ea}\label{group__date__and__time__functions_gaabefaf27c91bdc7bf6ffa50b391279ea}} 
\index{Date and Time Functions@{Date and Time Functions}!get\_milliseconds@{get\_milliseconds}}
\index{get\_milliseconds@{get\_milliseconds}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{get\_milliseconds()}{get\_milliseconds()}\hspace{0.1cm}{\footnotesize\ttfamily [2/2]}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} Qore\+::get\+\_\+milliseconds (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}}}]{dt }\end{DoxyParamCaption})}



Returns an integer corresponding to the literal millisecond value in the date (does not calculate a duration) 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em dt} & the date value; can be either a \mbox{\hyperlink{basic_data_types_relative_dates}{relative}} or \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute}} date\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
an integer corresponding to the literal millisecond value in the date (does not calculate a duration)
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{int n = get\_milliseconds(dt);}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxyNote}{Note}

\begin{DoxyItemize}
\item equivalent to pseudo-\/method \mbox{\hyperlink{class_qore_1_1zzz8datezzz9_a3c9429701ac6b58b051352abf153b735}{Qore\+::zzz8datezzz9\+::milliseconds()}}
\item to get the number of milliseconds of duration in a date/time value, use \mbox{\hyperlink{group__date__and__time__functions_ga9577b42c40fd075fb0bcb5ecabec75a1}{get\+\_\+duration\+\_\+milliseconds()}} instead 
\end{DoxyItemize}
\end{DoxyNote}
\mbox{\Hypertarget{group__date__and__time__functions_ga9d2be4bc7d936dbe4881a6d2b3a45ad0}\label{group__date__and__time__functions_ga9d2be4bc7d936dbe4881a6d2b3a45ad0}} 
\index{Date and Time Functions@{Date and Time Functions}!get\_minutes@{get\_minutes}}
\index{get\_minutes@{get\_minutes}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{get\_minutes()}{get\_minutes()}\hspace{0.1cm}{\footnotesize\ttfamily [1/2]}}
{\footnotesize\ttfamily nothing Qore\+::get\+\_\+minutes (\begin{DoxyParamCaption}{ }\end{DoxyParamCaption})}



This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_RUNTIME_NOOP}{RUNTIME\+\_\+\+NOOP}} 
\end{DoxyParagraph}
\mbox{\Hypertarget{group__date__and__time__functions_ga4dbc1e7f615407a2aaa60610e03cf1ea}\label{group__date__and__time__functions_ga4dbc1e7f615407a2aaa60610e03cf1ea}} 
\index{Date and Time Functions@{Date and Time Functions}!get\_minutes@{get\_minutes}}
\index{get\_minutes@{get\_minutes}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{get\_minutes()}{get\_minutes()}\hspace{0.1cm}{\footnotesize\ttfamily [2/2]}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} Qore\+::get\+\_\+minutes (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}}}]{dt }\end{DoxyParamCaption})}



Returns an integer corresponding to the literal minute value in the date (does not calculate a duration) 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em dt} & the date value; can be either a \mbox{\hyperlink{basic_data_types_relative_dates}{relative}} or \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute}} date\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
an integer corresponding to the minute value in the date
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{int n = get\_minutes(dt);}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxyNote}{Note}
equivalent to pseudo-\/method \mbox{\hyperlink{class_qore_1_1zzz8datezzz9_abac32dbfcda338145542f5dd5ddd37af}{Qore\+::zzz8datezzz9\+::minutes()}} 
\end{DoxyNote}
\mbox{\Hypertarget{group__date__and__time__functions_ga5b22eb495f16c4e23fa1a902041588da}\label{group__date__and__time__functions_ga5b22eb495f16c4e23fa1a902041588da}} 
\index{Date and Time Functions@{Date and Time Functions}!get\_months@{get\_months}}
\index{get\_months@{get\_months}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{get\_months()}{get\_months()}\hspace{0.1cm}{\footnotesize\ttfamily [1/2]}}
{\footnotesize\ttfamily nothing Qore\+::get\+\_\+months (\begin{DoxyParamCaption}{ }\end{DoxyParamCaption})}



This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_RUNTIME_NOOP}{RUNTIME\+\_\+\+NOOP}} 
\end{DoxyParagraph}
\mbox{\Hypertarget{group__date__and__time__functions_ga6a37327d1be86abe99b29c133c3fd0bc}\label{group__date__and__time__functions_ga6a37327d1be86abe99b29c133c3fd0bc}} 
\index{Date and Time Functions@{Date and Time Functions}!get\_months@{get\_months}}
\index{get\_months@{get\_months}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{get\_months()}{get\_months()}\hspace{0.1cm}{\footnotesize\ttfamily [2/2]}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} Qore\+::get\+\_\+months (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}}}]{dt }\end{DoxyParamCaption})}



Returns an integer corresponding to the literal month value in the date (does not calculate a duration) 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em dt} & the date value; can be either a \mbox{\hyperlink{basic_data_types_relative_dates}{relative}} or \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute}} date\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
an integer corresponding to the month value in the date
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{int n = get\_months(dt);}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxyNote}{Note}
equivalent to pseudo-\/method \mbox{\hyperlink{class_qore_1_1zzz8datezzz9_a75eb73a84fad87f7b94e932d3afb929a}{Qore\+::zzz8datezzz9\+::months()}} 
\end{DoxyNote}
\mbox{\Hypertarget{group__date__and__time__functions_gaaa477a2c5a1da483a4fcc58bb913064d}\label{group__date__and__time__functions_gaaa477a2c5a1da483a4fcc58bb913064d}} 
\index{Date and Time Functions@{Date and Time Functions}!get\_seconds@{get\_seconds}}
\index{get\_seconds@{get\_seconds}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{get\_seconds()}{get\_seconds()}\hspace{0.1cm}{\footnotesize\ttfamily [1/2]}}
{\footnotesize\ttfamily nothing Qore\+::get\+\_\+seconds (\begin{DoxyParamCaption}{ }\end{DoxyParamCaption})}



This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_RUNTIME_NOOP}{RUNTIME\+\_\+\+NOOP}} 
\end{DoxyParagraph}
\mbox{\Hypertarget{group__date__and__time__functions_ga8872de33c58a5b4a2ffe01818f226f48}\label{group__date__and__time__functions_ga8872de33c58a5b4a2ffe01818f226f48}} 
\index{Date and Time Functions@{Date and Time Functions}!get\_seconds@{get\_seconds}}
\index{get\_seconds@{get\_seconds}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{get\_seconds()}{get\_seconds()}\hspace{0.1cm}{\footnotesize\ttfamily [2/2]}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} Qore\+::get\+\_\+seconds (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}}}]{dt }\end{DoxyParamCaption})}



Returns an integer corresponding to the literal second value in the date (does not calculate a duration) 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em dt} & the date value; can be either a \mbox{\hyperlink{basic_data_types_relative_dates}{relative}} or \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute}} date\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
an integer corresponding to the literal second value in the date (does not calculate a duration)
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{int n = get\_seconds(dt);}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxyNote}{Note}

\begin{DoxyItemize}
\item equivalent to pseudo-\/method \mbox{\hyperlink{class_qore_1_1zzz8datezzz9_a2c3593e5034555434a59b1637b1eb2af}{Qore\+::zzz8datezzz9\+::seconds()}}
\item to get the number of seconds of duration in a date/time value, use \mbox{\hyperlink{group__date__and__time__functions_ga98ef4a4d08621926630c15c1bbd769df}{get\+\_\+duration\+\_\+seconds()}} instead 
\end{DoxyItemize}
\end{DoxyNote}
\mbox{\Hypertarget{group__date__and__time__functions_gad0d4c9db88f9089f385724476119ea3c}\label{group__date__and__time__functions_gad0d4c9db88f9089f385724476119ea3c}} 
\index{Date and Time Functions@{Date and Time Functions}!get\_years@{get\_years}}
\index{get\_years@{get\_years}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{get\_years()}{get\_years()}\hspace{0.1cm}{\footnotesize\ttfamily [1/2]}}
{\footnotesize\ttfamily nothing Qore\+::get\+\_\+years (\begin{DoxyParamCaption}{ }\end{DoxyParamCaption})}



This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_RUNTIME_NOOP}{RUNTIME\+\_\+\+NOOP}} 
\end{DoxyParagraph}
\mbox{\Hypertarget{group__date__and__time__functions_ga730632dedaa1b9cef875a5a12861f1d1}\label{group__date__and__time__functions_ga730632dedaa1b9cef875a5a12861f1d1}} 
\index{Date and Time Functions@{Date and Time Functions}!get\_years@{get\_years}}
\index{get\_years@{get\_years}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{get\_years()}{get\_years()}\hspace{0.1cm}{\footnotesize\ttfamily [2/2]}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} Qore\+::get\+\_\+years (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}}}]{dt }\end{DoxyParamCaption})}



Returns an integer corresponding to the literal year value in the date (does not calculate a duration) 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em dt} & the date value; can be either a \mbox{\hyperlink{basic_data_types_relative_dates}{relative}} or \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute}} date\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
an integer corresponding to the year value in the date
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{int n = get\_years(dt);}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxyNote}{Note}
equivalent to pseudo-\/method \mbox{\hyperlink{class_qore_1_1zzz8datezzz9_ab52a41f7b16ad2b9115dd1ae05e0b21c}{Qore\+::zzz8datezzz9\+::years()}} 
\end{DoxyNote}
\mbox{\Hypertarget{group__date__and__time__functions_ga86f47ab9a928a2c8aff8cbac9b5f3518}\label{group__date__and__time__functions_ga86f47ab9a928a2c8aff8cbac9b5f3518}} 
\index{Date and Time Functions@{Date and Time Functions}!getDateFromISOWeek@{getDateFromISOWeek}}
\index{getDateFromISOWeek@{getDateFromISOWeek}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{getDateFromISOWeek()}{getDateFromISOWeek()}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} Qore\+::get\+Date\+From\+ISOWeek (\begin{DoxyParamCaption}\item[{softint}]{year,  }\item[{softint}]{week,  }\item[{softint}]{day = {\ttfamily 1} }\end{DoxyParamCaption})}



Retuns an \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date value}} for the \href{http://en.wikipedia.org/wiki/ISO_week_date}{\texttt{ ISO-\/8601 calendar week information}} passed (year, week number, optional\+: weekday, where 1=Monday, 7=Sunday) in the current time zone. 

Throws an exception if the arguments are invalid

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_RET_VALUE_ONLY}{RET\+\_\+\+VALUE\+\_\+\+ONLY}}, \mbox{\hyperlink{code_flags_DEPRECATED}{DEPRECATED}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em year} & the ISO-\/8601 year (which for some special days does not always correspond to the actual calendar year) \\
\hline
{\em week} & the ISO-\/8601 week number; if this argument is invalid, an {\ttfamily ISO-\/8601-\/\+INVALID-\/\+WEEK} exception is thrown \\
\hline
{\em day} & the day of the week, where 1=Monday and 7=Sunday; if this argument is invalid, an {\ttfamily ISO-\/8601-\/\+INVALID-\/\+DAY} exception is thrown\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
an \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date value}} for the \href{http://en.wikipedia.org/wiki/ISO_week_date}{\texttt{ ISO-\/8601 calendar week information}} passed (year, week number, optional\+: weekday, where 1=Monday, 7=Sunday) in the current time zone
\end{DoxyReturn}

\begin{DoxyExceptions}{Exceptions}
{\em ISO-\/8601-\/\+INVALID-\/\+WEEK} & The week number is not valid for the given year \\
\hline
{\em ISO-\/8601-\/\+INVALID-\/\+DAY} & The day number is not between 1 (Monday) and 7 (Sunday) inclusive\\
\hline
\end{DoxyExceptions}
\begin{DoxyRefDesc}{Deprecated}
\item[\mbox{\hyperlink{deprecated__deprecated000022}{Deprecated}}]use \mbox{\hyperlink{group__date__and__time__functions_ga1401d634f3bcbec80d64f75cdd9d4921}{get\+\_\+date\+\_\+from\+\_\+iso\+\_\+week()}}; camel-\/case function names were deprecated in Qore 0.\+8.\+12 \end{DoxyRefDesc}
\mbox{\Hypertarget{group__date__and__time__functions_ga43bb7bc0ae09fa7fd9267e248d3cb8e1}\label{group__date__and__time__functions_ga43bb7bc0ae09fa7fd9267e248d3cb8e1}} 
\index{Date and Time Functions@{Date and Time Functions}!getDayNumber@{getDayNumber}}
\index{getDayNumber@{getDayNumber}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{getDayNumber()}{getDayNumber()}\hspace{0.1cm}{\footnotesize\ttfamily [1/2]}}
{\footnotesize\ttfamily nothing Qore\+::get\+Day\+Number (\begin{DoxyParamCaption}{ }\end{DoxyParamCaption})}



This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_RUNTIME_NOOP}{RUNTIME\+\_\+\+NOOP}}, \mbox{\hyperlink{code_flags_DEPRECATED}{DEPRECATED}} 
\end{DoxyParagraph}
\mbox{\Hypertarget{group__date__and__time__functions_ga08d26e9c0ed9635a1ee1158ee4bf24a5}\label{group__date__and__time__functions_ga08d26e9c0ed9635a1ee1158ee4bf24a5}} 
\index{Date and Time Functions@{Date and Time Functions}!getDayNumber@{getDayNumber}}
\index{getDayNumber@{getDayNumber}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{getDayNumber()}{getDayNumber()}\hspace{0.1cm}{\footnotesize\ttfamily [2/2]}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} Qore\+::get\+Day\+Number (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}}}]{dt }\end{DoxyParamCaption})}



Returns an integer representing the ordinal day number in the year (corresponding to the \href{http://en.wikipedia.org/wiki/ISO_8601\#Ordinal_dates}{\texttt{ ISO-\/8601 day number}}) for the \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date}} value passed. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}, \mbox{\hyperlink{code_flags_DEPRECATED}{DEPRECATED}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em dt} & an \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date}} value to get the ordinal day number\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
an integer representing the ordinal day number in the year (corresponding to the \href{http://en.wikipedia.org/wiki/ISO_8601\#Ordinal_dates}{\texttt{ ISO-\/8601 day number}}) for the \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date}} value passed; if a \mbox{\hyperlink{basic_data_types_relative_dates}{relative date}} value is passed, then this function will return 0
\end{DoxyReturn}
\begin{DoxyRefDesc}{Deprecated}
\item[\mbox{\hyperlink{deprecated__deprecated000023}{Deprecated}}]use \mbox{\hyperlink{group__date__and__time__functions_gaec9d8c1ba3a39869904f27e8c0706589}{get\+\_\+day\+\_\+number()}}; camel-\/case function names were deprecated in Qore 0.\+8.\+12 \end{DoxyRefDesc}
\mbox{\Hypertarget{group__date__and__time__functions_ga0c77571be96a607e6509a443924bbfa0}\label{group__date__and__time__functions_ga0c77571be96a607e6509a443924bbfa0}} 
\index{Date and Time Functions@{Date and Time Functions}!getDayOfWeek@{getDayOfWeek}}
\index{getDayOfWeek@{getDayOfWeek}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{getDayOfWeek()}{getDayOfWeek()}\hspace{0.1cm}{\footnotesize\ttfamily [1/2]}}
{\footnotesize\ttfamily nothing Qore\+::get\+Day\+Of\+Week (\begin{DoxyParamCaption}{ }\end{DoxyParamCaption})}



This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_RUNTIME_NOOP}{RUNTIME\+\_\+\+NOOP}}, \mbox{\hyperlink{code_flags_DEPRECATED}{DEPRECATED}} 
\end{DoxyParagraph}
\mbox{\Hypertarget{group__date__and__time__functions_ga5719e06bb6919c3cc370f99910f78277}\label{group__date__and__time__functions_ga5719e06bb6919c3cc370f99910f78277}} 
\index{Date and Time Functions@{Date and Time Functions}!getDayOfWeek@{getDayOfWeek}}
\index{getDayOfWeek@{getDayOfWeek}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{getDayOfWeek()}{getDayOfWeek()}\hspace{0.1cm}{\footnotesize\ttfamily [2/2]}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} Qore\+::get\+Day\+Of\+Week (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}}}]{dt }\end{DoxyParamCaption})}



Returns an integer representing the day of the week for the \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date}} value passed (0=Sunday, 6=Saturday) 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}, \mbox{\hyperlink{code_flags_DEPRECATED}{DEPRECATED}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em dt} & an \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date}} value to get the number for the day of the week\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
an integer representing the day of the week for the \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date}} value passed (0=Sunday, 6=Saturday); if a \mbox{\hyperlink{basic_data_types_relative_dates}{relative date}} value is passed, then this function will return 0
\end{DoxyReturn}
\begin{DoxySeeAlso}{See also}
\mbox{\hyperlink{group__date__and__time__functions_ga64bfe13c03c1b2746bfb5c80f5279e2a}{get\+\_\+iso\+\_\+day\+\_\+of\+\_\+week()}}
\end{DoxySeeAlso}
\begin{DoxyRefDesc}{Deprecated}
\item[\mbox{\hyperlink{deprecated__deprecated000024}{Deprecated}}]use \mbox{\hyperlink{group__date__and__time__functions_gaa546956fb71d56f18c903aff1f3fc01a}{get\+\_\+day\+\_\+of\+\_\+week()}}; camel-\/case function names were deprecated in Qore 0.\+8.\+12 \end{DoxyRefDesc}
\mbox{\Hypertarget{group__date__and__time__functions_ga23973fcabb1d70ccb1fefe7f405988ec}\label{group__date__and__time__functions_ga23973fcabb1d70ccb1fefe7f405988ec}} 
\index{Date and Time Functions@{Date and Time Functions}!getISODayOfWeek@{getISODayOfWeek}}
\index{getISODayOfWeek@{getISODayOfWeek}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{getISODayOfWeek()}{getISODayOfWeek()}\hspace{0.1cm}{\footnotesize\ttfamily [1/2]}}
{\footnotesize\ttfamily nothing Qore\+::get\+ISODay\+Of\+Week (\begin{DoxyParamCaption}{ }\end{DoxyParamCaption})}



This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_RUNTIME_NOOP}{RUNTIME\+\_\+\+NOOP}}, \mbox{\hyperlink{code_flags_DEPRECATED}{DEPRECATED}} 
\end{DoxyParagraph}
\mbox{\Hypertarget{group__date__and__time__functions_ga92ef075d0aa1945a11580a864bc7f4cb}\label{group__date__and__time__functions_ga92ef075d0aa1945a11580a864bc7f4cb}} 
\index{Date and Time Functions@{Date and Time Functions}!getISODayOfWeek@{getISODayOfWeek}}
\index{getISODayOfWeek@{getISODayOfWeek}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{getISODayOfWeek()}{getISODayOfWeek()}\hspace{0.1cm}{\footnotesize\ttfamily [2/2]}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} Qore\+::get\+ISODay\+Of\+Week (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}}}]{dt }\end{DoxyParamCaption})}



Returns an integer representing the ISO-\/8601 day of the week for the \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date}} value passed (1=Monday, 7=Sunday) 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}, \mbox{\hyperlink{code_flags_DEPRECATED}{DEPRECATED}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em dt} & an \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date}} value to get the number for the day of the week\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
an integer representing the day of the week for the \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date}} value passed (1=Monday, 7=Sunday); if a \mbox{\hyperlink{basic_data_types_relative_dates}{relative date}} value is passed, then this function will return 7
\end{DoxyReturn}
\begin{DoxySeeAlso}{See also}
\mbox{\hyperlink{group__date__and__time__functions_gaa546956fb71d56f18c903aff1f3fc01a}{get\+\_\+day\+\_\+of\+\_\+week()}}
\end{DoxySeeAlso}
\begin{DoxyRefDesc}{Deprecated}
\item[\mbox{\hyperlink{deprecated__deprecated000025}{Deprecated}}]use \mbox{\hyperlink{group__date__and__time__functions_ga64bfe13c03c1b2746bfb5c80f5279e2a}{get\+\_\+iso\+\_\+day\+\_\+of\+\_\+week()}}; camel-\/case function names were deprecated in Qore 0.\+8.\+12 \end{DoxyRefDesc}
\mbox{\Hypertarget{group__date__and__time__functions_ga6492bcbbb26c4b8466a9203a86b4306c}\label{group__date__and__time__functions_ga6492bcbbb26c4b8466a9203a86b4306c}} 
\index{Date and Time Functions@{Date and Time Functions}!getISOWeekHash@{getISOWeekHash}}
\index{getISOWeekHash@{getISOWeekHash}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{getISOWeekHash()}{getISOWeekHash()}\hspace{0.1cm}{\footnotesize\ttfamily [1/2]}}
{\footnotesize\ttfamily nothing Qore\+::get\+ISOWeek\+Hash (\begin{DoxyParamCaption}{ }\end{DoxyParamCaption})}



This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_RUNTIME_NOOP}{RUNTIME\+\_\+\+NOOP}}, \mbox{\hyperlink{code_flags_DEPRECATED}{DEPRECATED}} 
\end{DoxyParagraph}
\mbox{\Hypertarget{group__date__and__time__functions_gadee68a84b85d12b3bba3543d7dec293d}\label{group__date__and__time__functions_gadee68a84b85d12b3bba3543d7dec293d}} 
\index{Date and Time Functions@{Date and Time Functions}!getISOWeekHash@{getISOWeekHash}}
\index{getISOWeekHash@{getISOWeekHash}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{getISOWeekHash()}{getISOWeekHash()}\hspace{0.1cm}{\footnotesize\ttfamily [2/2]}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__type__conversion__functions_ga24ee71727f0785d3b826833ed6f5e2ee}{hash}}$<$ \mbox{\hyperlink{struct_qore_1_1_iso_week_info}{Iso\+Week\+Info}} $>$ Qore\+::get\+ISOWeek\+Hash (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}}}]{dt }\end{DoxyParamCaption})}



Returns an \mbox{\hyperlink{struct_qore_1_1_iso_week_info}{Iso\+Week\+Info}} hash representing the ISO-\/8601 calendar week information for the \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date}} passed (hash keys\+: {\ttfamily \char`\"{}year\char`\"{}}, {\ttfamily \char`\"{}week\char`\"{}}, {\ttfamily \char`\"{}day\char`\"{}}) 

\begin{DoxyNote}{Note}
that the ISO-\/8601 year does not always correspond with the calendar year at the end and the beginning of every year (for example 2006-\/01-\/01 in ISO-\/8601 calendar week format is\+: year=2005, week=52, day=7)
\end{DoxyNote}
\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}, \mbox{\hyperlink{code_flags_DEPRECATED}{DEPRECATED}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em dt} & the date to get information for\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
an \mbox{\hyperlink{struct_qore_1_1_iso_week_info}{Iso\+Week\+Info}} hash representing the ISO-\/8601 calendar week information for the \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date}} passed (hash keys\+: {\ttfamily \char`\"{}year\char`\"{}}, {\ttfamily \char`\"{}week\char`\"{}}, {\ttfamily \char`\"{}day\char`\"{}}); if a \mbox{\hyperlink{basic_data_types_relative_dates}{relative date}} value is passed, then this function will return year=1970, week=1, day=1
\end{DoxyReturn}
\begin{DoxySeeAlso}{See also}
\mbox{\hyperlink{group__date__and__time__functions_gadfb87ebf695f7e037efb64367cdb6626}{get\+\_\+iso\+\_\+week\+\_\+string()}}
\end{DoxySeeAlso}
\begin{DoxyRefDesc}{Deprecated}
\item[\mbox{\hyperlink{deprecated__deprecated000026}{Deprecated}}]use \mbox{\hyperlink{group__date__and__time__functions_ga8cfd46ea9e98be647d8206732a63c1d9}{get\+\_\+iso\+\_\+week\+\_\+hash()}}; camel-\/case function names were deprecated in Qore 0.\+8.\+12 \end{DoxyRefDesc}
\mbox{\Hypertarget{group__date__and__time__functions_ga6f1fd787412d97d01c7b8450c5a6f82a}\label{group__date__and__time__functions_ga6f1fd787412d97d01c7b8450c5a6f82a}} 
\index{Date and Time Functions@{Date and Time Functions}!getISOWeekString@{getISOWeekString}}
\index{getISOWeekString@{getISOWeekString}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{getISOWeekString()}{getISOWeekString()}\hspace{0.1cm}{\footnotesize\ttfamily [1/2]}}
{\footnotesize\ttfamily nothing Qore\+::get\+ISOWeek\+String (\begin{DoxyParamCaption}{ }\end{DoxyParamCaption})}



This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_RUNTIME_NOOP}{RUNTIME\+\_\+\+NOOP}}, \mbox{\hyperlink{code_flags_DEPRECATED}{DEPRECATED}} 
\end{DoxyParagraph}
\mbox{\Hypertarget{group__date__and__time__functions_ga04331a3a415abfaaa228c4253a04859b}\label{group__date__and__time__functions_ga04331a3a415abfaaa228c4253a04859b}} 
\index{Date and Time Functions@{Date and Time Functions}!getISOWeekString@{getISOWeekString}}
\index{getISOWeekString@{getISOWeekString}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{getISOWeekString()}{getISOWeekString()}\hspace{0.1cm}{\footnotesize\ttfamily [2/2]}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__type__conversion__functions_gacf16b4126b795f4b6933ef3425cadae3}{string}} Qore\+::get\+ISOWeek\+String (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}}}]{dt }\end{DoxyParamCaption})}



Returns a string representing the ISO-\/8601 calendar week information for the \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date}} passed (ex\+: 2006-\/01-\/01 = \char`\"{}2005-\/\+W52-\/7\char`\"{}) 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}, \mbox{\hyperlink{code_flags_DEPRECATED}{DEPRECATED}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em dt} & the date to get information for\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
a string representing the ISO-\/8601 calendar week information for the \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date}} passed (ex\+: 2006-\/01-\/01 = \char`\"{}2005-\/\+W52-\/7\char`\"{}); if a \mbox{\hyperlink{basic_data_types_relative_dates}{relative date}} value is passed, then this function will return {\ttfamily \char`\"{}1970-\/\+W01-\/1\char`\"{}} 
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{string str = getISOWeekString(2007-\/05-\/15); \textcolor{comment}{\# returns "{}2007-\/W20-\/2"{}}}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxySeeAlso}{See also}
\mbox{\hyperlink{group__date__and__time__functions_ga8cfd46ea9e98be647d8206732a63c1d9}{get\+\_\+iso\+\_\+week\+\_\+hash()}}
\end{DoxySeeAlso}
\begin{DoxyRefDesc}{Deprecated}
\item[\mbox{\hyperlink{deprecated__deprecated000027}{Deprecated}}]use \mbox{\hyperlink{group__date__and__time__functions_gadfb87ebf695f7e037efb64367cdb6626}{get\+\_\+iso\+\_\+week\+\_\+string()}}; camel-\/case function names were deprecated in Qore 0.\+8.\+12 \end{DoxyRefDesc}
\mbox{\Hypertarget{group__date__and__time__functions_ga098fc81e482c4ad4eeef3446c98f9b38}\label{group__date__and__time__functions_ga098fc81e482c4ad4eeef3446c98f9b38}} 
\index{Date and Time Functions@{Date and Time Functions}!gmtime@{gmtime}}
\index{gmtime@{gmtime}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{gmtime()}{gmtime()}\hspace{0.1cm}{\footnotesize\ttfamily [1/3]}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} Qore\+::gmtime (\begin{DoxyParamCaption}{ }\end{DoxyParamCaption})}



Returns the current UTC (GMT) time with a resolution of a second. 

\begin{DoxyReturn}{Returns}
the current UTC (GMT) time with a resolution of a second
\end{DoxyReturn}
\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{date utc = gmtime();}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxySeeAlso}{See also}

\begin{DoxyItemize}
\item \mbox{\hyperlink{group__date__and__time__functions_ga014569059b153ad30b0951ba0113bd04}{now\+\_\+utc()}}
\item \mbox{\hyperlink{group__date__and__time__functions_ga9e3f17815e16f8b91b489d60803f265d}{localtime()}} 
\end{DoxyItemize}
\end{DoxySeeAlso}
\mbox{\Hypertarget{group__date__and__time__functions_ga755457185eb53b30eef65346922aae1a}\label{group__date__and__time__functions_ga755457185eb53b30eef65346922aae1a}} 
\index{Date and Time Functions@{Date and Time Functions}!gmtime@{gmtime}}
\index{gmtime@{gmtime}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{gmtime()}{gmtime()}\hspace{0.1cm}{\footnotesize\ttfamily [2/3]}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} Qore\+::gmtime (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}}}]{dt }\end{DoxyParamCaption})}



Returns the date and time in UTC (GMT) corresponding to the date argument passed. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em dt} & a date to process; if the date passed is already in UTC, then the same value is returned\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
the date and time in UTC (GMT) corresponding to the date argument passed
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{date dt = gmtime(2012-\/01-\/19T15:00:00-\/07:00);}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxySeeAlso}{See also}
\mbox{\hyperlink{group__date__and__time__functions_gaa5194ca5a38b76a102c02bc4774e6723}{localtime(date)}} 
\end{DoxySeeAlso}
\mbox{\Hypertarget{group__date__and__time__functions_ga9ca9d46f2eced39da05a7a6cb9723bb1}\label{group__date__and__time__functions_ga9ca9d46f2eced39da05a7a6cb9723bb1}} 
\index{Date and Time Functions@{Date and Time Functions}!gmtime@{gmtime}}
\index{gmtime@{gmtime}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{gmtime()}{gmtime()}\hspace{0.1cm}{\footnotesize\ttfamily [3/3]}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} Qore\+::gmtime (\begin{DoxyParamCaption}\item[{softint}]{secs,  }\item[{softint}]{us = {\ttfamily 0} }\end{DoxyParamCaption})}



Returns a date/time value in UTC (GMT) from arguments giving the number of seconds and microseconds since Jan 1, 1970, 00\+:00\+:00 Z (UTC) 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em secs} & the number of seconds and microseconds since Jan 1, 1970, 00\+:00\+:00 Z (UTC) \\
\hline
{\em us} & a microsecond offset for the time returned\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
a date/time value in UTC (GMT) from arguments giving the number of seconds and microseconds since Jan 1, 1970, 00\+:00\+:00 Z (UTC)
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{date dt = gmtime(10);}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxySeeAlso}{See also}
\mbox{\hyperlink{group__date__and__time__functions_ga695f842b668a13ca581975abb53e735b}{localtime(softint, softint)}} 
\end{DoxySeeAlso}
\mbox{\Hypertarget{group__date__and__time__functions_ga6f8b91eee380336342e0af0fd1b2a28f}\label{group__date__and__time__functions_ga6f8b91eee380336342e0af0fd1b2a28f}} 
\index{Date and Time Functions@{Date and Time Functions}!hours@{hours}}
\index{hours@{hours}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{hours()}{hours()}\hspace{0.1cm}{\footnotesize\ttfamily [1/2]}}
{\footnotesize\ttfamily nothing Qore\+::hours (\begin{DoxyParamCaption}{ }\end{DoxyParamCaption})}



This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_RUNTIME_NOOP}{RUNTIME\+\_\+\+NOOP}} 
\end{DoxyParagraph}
\mbox{\Hypertarget{group__date__and__time__functions_gab342176f1a1c5ac93fbf18faeda3e943}\label{group__date__and__time__functions_gab342176f1a1c5ac93fbf18faeda3e943}} 
\index{Date and Time Functions@{Date and Time Functions}!hours@{hours}}
\index{hours@{hours}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{hours()}{hours()}\hspace{0.1cm}{\footnotesize\ttfamily [2/2]}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} Qore\+::hours (\begin{DoxyParamCaption}\item[{softint}]{hours }\end{DoxyParamCaption})}



Returns a \mbox{\hyperlink{basic_data_types_relative_dates}{relative date/time value}} in hours based on the integer argument passed to be used in date arithmetic. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em hours} & the number of hours to return\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
a \mbox{\hyperlink{basic_data_types_relative_dates}{relative date/time value}} in hours based on the integer argument passed to be used in date arithmetic
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{date rd = hours(100);}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxySeeAlso}{See also}

\begin{DoxyItemize}
\item \mbox{\hyperlink{group__date__and__time__functions_ga71eac87de4a337ec7d6dc6456d86d8c4}{years(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_gacf1db8004f38d76ad6028855f36772ce}{months(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_gab342176f1a1c5ac93fbf18faeda3e943}{hours(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_ga4d6d3d90deac1387573033793c668586}{minutes(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_ga19566ff46f3818f4554c73ba145fd8e1}{seconds(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_gac8e561799a9f873502e161695670c06d}{milliseconds(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_ga5ecb2657b5cc84fc2f16ae1a4cc3fae7}{microseconds(softint)}} 
\end{DoxyItemize}
\end{DoxySeeAlso}
\mbox{\Hypertarget{group__date__and__time__functions_ga1a78ee645b0b9816f7a1bbc77f0e4e3b}\label{group__date__and__time__functions_ga1a78ee645b0b9816f7a1bbc77f0e4e3b}} 
\index{Date and Time Functions@{Date and Time Functions}!is\_date\_absolute@{is\_date\_absolute}}
\index{is\_date\_absolute@{is\_date\_absolute}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{is\_date\_absolute()}{is\_date\_absolute()}\hspace{0.1cm}{\footnotesize\ttfamily [1/2]}}
{\footnotesize\ttfamily bool Qore\+::is\+\_\+date\+\_\+absolute (\begin{DoxyParamCaption}{ }\end{DoxyParamCaption})}



This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_NOOP}{NOOP}} 
\end{DoxyParagraph}
\mbox{\Hypertarget{group__date__and__time__functions_ga544832cd9178c98718296c83dfddc2f6}\label{group__date__and__time__functions_ga544832cd9178c98718296c83dfddc2f6}} 
\index{Date and Time Functions@{Date and Time Functions}!is\_date\_absolute@{is\_date\_absolute}}
\index{is\_date\_absolute@{is\_date\_absolute}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{is\_date\_absolute()}{is\_date\_absolute()}\hspace{0.1cm}{\footnotesize\ttfamily [2/2]}}
{\footnotesize\ttfamily bool Qore\+::is\+\_\+date\+\_\+absolute (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}}}]{dt }\end{DoxyParamCaption})}



Returns \mbox{\hyperlink{basic_data_types_True}{True}} if the argument is an \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date/time value}}, \mbox{\hyperlink{basic_data_types_False}{False}} if not. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em dt} & the date to check\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
\mbox{\hyperlink{basic_data_types_True}{True}} if the argument is an \mbox{\hyperlink{basic_data_types_absolute_dates}{absolute date/time value}}, \mbox{\hyperlink{basic_data_types_False}{False}} if not
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{bool b = is\_date\_absolute(dt)}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxySeeAlso}{See also}
\mbox{\hyperlink{group__date__and__time__functions_ga72eac18903961ac29592aa649823a5da}{is\+\_\+date\+\_\+relative()}} 
\end{DoxySeeAlso}
\mbox{\Hypertarget{group__date__and__time__functions_ga72eac18903961ac29592aa649823a5da}\label{group__date__and__time__functions_ga72eac18903961ac29592aa649823a5da}} 
\index{Date and Time Functions@{Date and Time Functions}!is\_date\_relative@{is\_date\_relative}}
\index{is\_date\_relative@{is\_date\_relative}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{is\_date\_relative()}{is\_date\_relative()}\hspace{0.1cm}{\footnotesize\ttfamily [1/2]}}
{\footnotesize\ttfamily bool Qore\+::is\+\_\+date\+\_\+relative (\begin{DoxyParamCaption}{ }\end{DoxyParamCaption})}



This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_NOOP}{NOOP}} 
\end{DoxyParagraph}
\mbox{\Hypertarget{group__date__and__time__functions_gaf7de7b0823a39642087140ff1224e033}\label{group__date__and__time__functions_gaf7de7b0823a39642087140ff1224e033}} 
\index{Date and Time Functions@{Date and Time Functions}!is\_date\_relative@{is\_date\_relative}}
\index{is\_date\_relative@{is\_date\_relative}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{is\_date\_relative()}{is\_date\_relative()}\hspace{0.1cm}{\footnotesize\ttfamily [2/2]}}
{\footnotesize\ttfamily bool Qore\+::is\+\_\+date\+\_\+relative (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}}}]{dt }\end{DoxyParamCaption})}



Returns \mbox{\hyperlink{basic_data_types_True}{True}} if the argument is an \mbox{\hyperlink{basic_data_types_relative_dates}{relative date/time value}}, \mbox{\hyperlink{basic_data_types_False}{False}} if not. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em dt} & the date to check\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
\mbox{\hyperlink{basic_data_types_True}{True}} if the argument is an \mbox{\hyperlink{basic_data_types_relative_dates}{relative date/time value}}, \mbox{\hyperlink{basic_data_types_False}{False}} if not
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{bool b = is\_date\_relative(dt)}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxySeeAlso}{See also}
\mbox{\hyperlink{group__date__and__time__functions_ga1a78ee645b0b9816f7a1bbc77f0e4e3b}{is\+\_\+date\+\_\+absolute()}} 
\end{DoxySeeAlso}
\mbox{\Hypertarget{group__date__and__time__functions_ga9e3f17815e16f8b91b489d60803f265d}\label{group__date__and__time__functions_ga9e3f17815e16f8b91b489d60803f265d}} 
\index{Date and Time Functions@{Date and Time Functions}!localtime@{localtime}}
\index{localtime@{localtime}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{localtime()}{localtime()}\hspace{0.1cm}{\footnotesize\ttfamily [1/3]}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} Qore\+::localtime (\begin{DoxyParamCaption}{ }\end{DoxyParamCaption})}



Returns the current date and time with a resolution to the second. 

\begin{DoxyReturn}{Returns}
the current date and time with a resolution to the second
\end{DoxyReturn}
\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{date d = localtime();}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxySeeAlso}{See also}
\mbox{\hyperlink{group__date__and__time__functions_ga098fc81e482c4ad4eeef3446c98f9b38}{gmtime()}}
\end{DoxySeeAlso}
\begin{DoxyNote}{Note}
this variant of \mbox{\hyperlink{group__date__and__time__functions_ga9e3f17815e16f8b91b489d60803f265d}{localtime()}} is equivalent to \mbox{\hyperlink{group__date__and__time__functions_ga23f067a4f82596346d4fef09782e1945}{now()}} 
\end{DoxyNote}
\mbox{\Hypertarget{group__date__and__time__functions_gaa5194ca5a38b76a102c02bc4774e6723}\label{group__date__and__time__functions_gaa5194ca5a38b76a102c02bc4774e6723}} 
\index{Date and Time Functions@{Date and Time Functions}!localtime@{localtime}}
\index{localtime@{localtime}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{localtime()}{localtime()}\hspace{0.1cm}{\footnotesize\ttfamily [2/3]}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} Qore\+::localtime (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}}}]{dt }\end{DoxyParamCaption})}



Returns the date and time in the local time zone corresponding to the date argument passed. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em dt} & a date to process; if the date passed is in the local time zone, then the same value is returned\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
the date and time in the local time zone corresponding to the date argument passed
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{date dt = localtime(2012-\/01-\/19T15:00:00-\/07:00);}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxySeeAlso}{See also}
\mbox{\hyperlink{group__date__and__time__functions_ga755457185eb53b30eef65346922aae1a}{gmtime(date)}} 
\end{DoxySeeAlso}
\mbox{\Hypertarget{group__date__and__time__functions_ga695f842b668a13ca581975abb53e735b}\label{group__date__and__time__functions_ga695f842b668a13ca581975abb53e735b}} 
\index{Date and Time Functions@{Date and Time Functions}!localtime@{localtime}}
\index{localtime@{localtime}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{localtime()}{localtime()}\hspace{0.1cm}{\footnotesize\ttfamily [3/3]}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} Qore\+::localtime (\begin{DoxyParamCaption}\item[{softint}]{secs,  }\item[{softint}]{us = {\ttfamily 0} }\end{DoxyParamCaption})}



Returns the date and time in the local time zone corresponding to the integer arguments passed, which are interpreted as the number of seconds and microseconds since Jan 1, 1970, 00\+:00\+:00 Z (UTC) 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em secs} & the number of seconds and microseconds since Jan 1, 1970, 00\+:00\+:00 Z (UTC) \\
\hline
{\em us} & a microsecond offset for the time returned\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
the date and time in the local time zone corresponding to the arguments passed
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{date dt = localtime(10);}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxySeeAlso}{See also}
\mbox{\hyperlink{group__date__and__time__functions_ga9ca9d46f2eced39da05a7a6cb9723bb1}{gmtime(softint, softint)}} 
\end{DoxySeeAlso}
\mbox{\Hypertarget{group__date__and__time__functions_ga5ecb2657b5cc84fc2f16ae1a4cc3fae7}\label{group__date__and__time__functions_ga5ecb2657b5cc84fc2f16ae1a4cc3fae7}} 
\index{Date and Time Functions@{Date and Time Functions}!microseconds@{microseconds}}
\index{microseconds@{microseconds}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{microseconds()}{microseconds()}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} Qore\+::microseconds (\begin{DoxyParamCaption}\item[{softint}]{us }\end{DoxyParamCaption})}



Returns a \mbox{\hyperlink{basic_data_types_relative_dates}{relative date/time value}} in microseconds based on the integer argument passed to be used in date arithmetic. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em us} & the number of microseconds to return\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
a \mbox{\hyperlink{basic_data_types_relative_dates}{relative date/time value}} in microseconds based on the integer argument passed to be used in date arithmetic
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{date rd = microseconds(100);}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxySeeAlso}{See also}

\begin{DoxyItemize}
\item \mbox{\hyperlink{group__date__and__time__functions_ga71eac87de4a337ec7d6dc6456d86d8c4}{years(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_gacf1db8004f38d76ad6028855f36772ce}{months(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_ga0f5bfff6ce4b534b1c3a6c5357b1377a}{days(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_gab342176f1a1c5ac93fbf18faeda3e943}{hours(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_ga4d6d3d90deac1387573033793c668586}{minutes(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_ga19566ff46f3818f4554c73ba145fd8e1}{seconds(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_gac8e561799a9f873502e161695670c06d}{milliseconds(softint)}} 
\end{DoxyItemize}
\end{DoxySeeAlso}
\mbox{\Hypertarget{group__date__and__time__functions_gaaca16fe50892b686b205610d8496e9ab}\label{group__date__and__time__functions_gaaca16fe50892b686b205610d8496e9ab}} 
\index{Date and Time Functions@{Date and Time Functions}!milliseconds@{milliseconds}}
\index{milliseconds@{milliseconds}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{milliseconds()}{milliseconds()}\hspace{0.1cm}{\footnotesize\ttfamily [1/2]}}
{\footnotesize\ttfamily nothing Qore\+::milliseconds (\begin{DoxyParamCaption}{ }\end{DoxyParamCaption})}



This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_RUNTIME_NOOP}{RUNTIME\+\_\+\+NOOP}} 
\end{DoxyParagraph}
\mbox{\Hypertarget{group__date__and__time__functions_gac8e561799a9f873502e161695670c06d}\label{group__date__and__time__functions_gac8e561799a9f873502e161695670c06d}} 
\index{Date and Time Functions@{Date and Time Functions}!milliseconds@{milliseconds}}
\index{milliseconds@{milliseconds}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{milliseconds()}{milliseconds()}\hspace{0.1cm}{\footnotesize\ttfamily [2/2]}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} Qore\+::milliseconds (\begin{DoxyParamCaption}\item[{softint}]{ms }\end{DoxyParamCaption})}



Returns a \mbox{\hyperlink{basic_data_types_relative_dates}{relative date/time value}} in milliseconds based on the integer argument passed to be used in date arithmetic. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em ms} & the number of milliseconds to return\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
a \mbox{\hyperlink{basic_data_types_relative_dates}{relative date/time value}} in milliseconds based on the integer argument passed to be used in date arithmetic
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{date rd = milliseconds(100);}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxySeeAlso}{See also}

\begin{DoxyItemize}
\item \mbox{\hyperlink{group__date__and__time__functions_ga71eac87de4a337ec7d6dc6456d86d8c4}{years(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_gacf1db8004f38d76ad6028855f36772ce}{months(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_ga0f5bfff6ce4b534b1c3a6c5357b1377a}{days(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_gab342176f1a1c5ac93fbf18faeda3e943}{hours(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_ga4d6d3d90deac1387573033793c668586}{minutes(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_ga19566ff46f3818f4554c73ba145fd8e1}{seconds(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_ga5ecb2657b5cc84fc2f16ae1a4cc3fae7}{microseconds(softint)}} 
\end{DoxyItemize}
\end{DoxySeeAlso}
\mbox{\Hypertarget{group__date__and__time__functions_ga1633103f30ca698b3864e93e440dea00}\label{group__date__and__time__functions_ga1633103f30ca698b3864e93e440dea00}} 
\index{Date and Time Functions@{Date and Time Functions}!minutes@{minutes}}
\index{minutes@{minutes}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{minutes()}{minutes()}\hspace{0.1cm}{\footnotesize\ttfamily [1/2]}}
{\footnotesize\ttfamily nothing Qore\+::minutes (\begin{DoxyParamCaption}{ }\end{DoxyParamCaption})}



This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_RUNTIME_NOOP}{RUNTIME\+\_\+\+NOOP}} 
\end{DoxyParagraph}
\mbox{\Hypertarget{group__date__and__time__functions_ga4d6d3d90deac1387573033793c668586}\label{group__date__and__time__functions_ga4d6d3d90deac1387573033793c668586}} 
\index{Date and Time Functions@{Date and Time Functions}!minutes@{minutes}}
\index{minutes@{minutes}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{minutes()}{minutes()}\hspace{0.1cm}{\footnotesize\ttfamily [2/2]}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} Qore\+::minutes (\begin{DoxyParamCaption}\item[{softint}]{minutes }\end{DoxyParamCaption})}



Returns a \mbox{\hyperlink{basic_data_types_relative_dates}{relative date/time value}} in minutes based on the integer argument passed to be used in date arithmetic. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em minutes} & the number of minutes to return\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
a \mbox{\hyperlink{basic_data_types_relative_dates}{relative date/time value}} in minutes based on the integer argument passed to be used in date arithmetic
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{date rd = minutes(100);}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxySeeAlso}{See also}

\begin{DoxyItemize}
\item \mbox{\hyperlink{group__date__and__time__functions_ga71eac87de4a337ec7d6dc6456d86d8c4}{years(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_gacf1db8004f38d76ad6028855f36772ce}{months(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_ga0f5bfff6ce4b534b1c3a6c5357b1377a}{days(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_gab342176f1a1c5ac93fbf18faeda3e943}{hours(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_ga19566ff46f3818f4554c73ba145fd8e1}{seconds(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_gac8e561799a9f873502e161695670c06d}{milliseconds(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_ga5ecb2657b5cc84fc2f16ae1a4cc3fae7}{microseconds(softint)}} 
\end{DoxyItemize}
\end{DoxySeeAlso}
\mbox{\Hypertarget{group__date__and__time__functions_gaa545a3ae1c8c055949d2931285d02882}\label{group__date__and__time__functions_gaa545a3ae1c8c055949d2931285d02882}} 
\index{Date and Time Functions@{Date and Time Functions}!mktime@{mktime}}
\index{mktime@{mktime}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{mktime()}{mktime()}\hspace{0.1cm}{\footnotesize\ttfamily [1/2]}}
{\footnotesize\ttfamily nothing Qore\+::mktime (\begin{DoxyParamCaption}{ }\end{DoxyParamCaption})}



This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_RUNTIME_NOOP}{RUNTIME\+\_\+\+NOOP}} 
\end{DoxyParagraph}
\mbox{\Hypertarget{group__date__and__time__functions_ga3278590d05035f64ba18170e87e8293a}\label{group__date__and__time__functions_ga3278590d05035f64ba18170e87e8293a}} 
\index{Date and Time Functions@{Date and Time Functions}!mktime@{mktime}}
\index{mktime@{mktime}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{mktime()}{mktime()}\hspace{0.1cm}{\footnotesize\ttfamily [2/2]}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} Qore\+::mktime (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}}}]{dt }\end{DoxyParamCaption})}



Returns the number of seconds of the date and time in local time passed since Jan 1, 1970, 00\+:00\+:00 Z (UTC); negative values are returned for dates before the epoch. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em dt} & The date to process\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
the number of seconds of the date and time in local time passed since Jan 1, 1970, 00\+:00\+:00 Z (UTC); negative values are returned for dates before the epoch
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{int i = mktime(2012-\/01-\/19T08:02:15+01:00);}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxySeeAlso}{See also}
\mbox{\hyperlink{group__date__and__time__functions_ga62c3c23b7423b9583193a8a5cb16eb29}{timegm(date)}}
\end{DoxySeeAlso}
\begin{DoxyNote}{Note}
This function is equivalent to \mbox{\hyperlink{group__date__and__time__functions_gaa69c5fbab2d5e245d89cb3253523c310}{get\+\_\+epoch\+\_\+seconds(date)}} 
\end{DoxyNote}
\mbox{\Hypertarget{group__date__and__time__functions_ga0a6ebdc9e4a3dbaa7222f0b4c98fdda9}\label{group__date__and__time__functions_ga0a6ebdc9e4a3dbaa7222f0b4c98fdda9}} 
\index{Date and Time Functions@{Date and Time Functions}!months@{months}}
\index{months@{months}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{months()}{months()}\hspace{0.1cm}{\footnotesize\ttfamily [1/2]}}
{\footnotesize\ttfamily nothing Qore\+::months (\begin{DoxyParamCaption}{ }\end{DoxyParamCaption})}



This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_RUNTIME_NOOP}{RUNTIME\+\_\+\+NOOP}} 
\end{DoxyParagraph}
\mbox{\Hypertarget{group__date__and__time__functions_gacf1db8004f38d76ad6028855f36772ce}\label{group__date__and__time__functions_gacf1db8004f38d76ad6028855f36772ce}} 
\index{Date and Time Functions@{Date and Time Functions}!months@{months}}
\index{months@{months}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{months()}{months()}\hspace{0.1cm}{\footnotesize\ttfamily [2/2]}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} Qore\+::months (\begin{DoxyParamCaption}\item[{softint}]{months }\end{DoxyParamCaption})}



Returns a \mbox{\hyperlink{basic_data_types_relative_dates}{relative date/time value}} in months based on the integer argument passed to be used in date arithmetic. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em months} & the number of months to return\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
a \mbox{\hyperlink{basic_data_types_relative_dates}{relative date/time value}} in months based on the integer argument passed to be used in date arithmetic
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{date rd = months(100);}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxySeeAlso}{See also}

\begin{DoxyItemize}
\item \mbox{\hyperlink{group__date__and__time__functions_ga71eac87de4a337ec7d6dc6456d86d8c4}{years(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_ga0f5bfff6ce4b534b1c3a6c5357b1377a}{days(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_gab342176f1a1c5ac93fbf18faeda3e943}{hours(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_ga4d6d3d90deac1387573033793c668586}{minutes(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_ga19566ff46f3818f4554c73ba145fd8e1}{seconds(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_gac8e561799a9f873502e161695670c06d}{milliseconds(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_ga5ecb2657b5cc84fc2f16ae1a4cc3fae7}{microseconds(softint)}} 
\end{DoxyItemize}
\end{DoxySeeAlso}
\mbox{\Hypertarget{group__date__and__time__functions_ga23f067a4f82596346d4fef09782e1945}\label{group__date__and__time__functions_ga23f067a4f82596346d4fef09782e1945}} 
\index{Date and Time Functions@{Date and Time Functions}!now@{now}}
\index{now@{now}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{now()}{now()}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} Qore\+::now (\begin{DoxyParamCaption}{ }\end{DoxyParamCaption})}



Returns the current date and time with a resolution to the second. 

\begin{DoxyReturn}{Returns}
the current date and time with a resolution to the second
\end{DoxyReturn}
\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{date d = now();}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxySeeAlso}{See also}

\begin{DoxyItemize}
\item \mbox{\hyperlink{group__date__and__time__functions_ga4916588a63c91c6632ce877ec1d6cc1b}{now\+\_\+ms()}}
\item \mbox{\hyperlink{group__date__and__time__functions_ga61b29a943e0e85abdc9792a9434e5b39}{now\+\_\+us()}}
\item \mbox{\hyperlink{group__date__and__time__functions_ga014569059b153ad30b0951ba0113bd04}{now\+\_\+utc()}}
\end{DoxyItemize}
\end{DoxySeeAlso}
\begin{DoxyNote}{Note}
this function is equivalent to \mbox{\hyperlink{group__date__and__time__functions_ga9e3f17815e16f8b91b489d60803f265d}{localtime()}} 
\end{DoxyNote}
\mbox{\Hypertarget{group__date__and__time__functions_ga4916588a63c91c6632ce877ec1d6cc1b}\label{group__date__and__time__functions_ga4916588a63c91c6632ce877ec1d6cc1b}} 
\index{Date and Time Functions@{Date and Time Functions}!now\_ms@{now\_ms}}
\index{now\_ms@{now\_ms}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{now\_ms()}{now\_ms()}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} Qore\+::now\+\_\+ms (\begin{DoxyParamCaption}{ }\end{DoxyParamCaption})}



Returns the current date and time with a resolution to the millisecond. 

\begin{DoxyReturn}{Returns}
the current date and time with a resolution to the millisecond
\end{DoxyReturn}
\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{date d = now\_ms();}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxySeeAlso}{See also}

\begin{DoxyItemize}
\item \mbox{\hyperlink{group__date__and__time__functions_ga23f067a4f82596346d4fef09782e1945}{now()}} For a similar function returning the current \mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} and time in the local time zone with coarser granularity, when resolution only to the second is needed
\item \mbox{\hyperlink{group__date__and__time__functions_ga61b29a943e0e85abdc9792a9434e5b39}{now\+\_\+us()}} for a similar function returning the current \mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} and time with a resolution to the microsecond
\item \mbox{\hyperlink{group__date__and__time__functions_ga014569059b153ad30b0951ba0113bd04}{now\+\_\+utc()}};
\end{DoxyItemize}
\end{DoxySeeAlso}
\begin{DoxyNote}{Note}
There is no performance penalty for using \mbox{\hyperlink{group__date__and__time__functions_ga4916588a63c91c6632ce877ec1d6cc1b}{now\+\_\+ms()}} and \mbox{\hyperlink{group__date__and__time__functions_ga61b29a943e0e85abdc9792a9434e5b39}{now\+\_\+us()}} versus \mbox{\hyperlink{group__date__and__time__functions_ga23f067a4f82596346d4fef09782e1945}{now()}}; \mbox{\hyperlink{group__date__and__time__functions_ga23f067a4f82596346d4fef09782e1945}{now()}} and \mbox{\hyperlink{group__date__and__time__functions_ga4916588a63c91c6632ce877ec1d6cc1b}{now\+\_\+ms()}} are kept for backwards compatibility 
\end{DoxyNote}
\mbox{\Hypertarget{group__date__and__time__functions_ga61b29a943e0e85abdc9792a9434e5b39}\label{group__date__and__time__functions_ga61b29a943e0e85abdc9792a9434e5b39}} 
\index{Date and Time Functions@{Date and Time Functions}!now\_us@{now\_us}}
\index{now\_us@{now\_us}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{now\_us()}{now\_us()}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} Qore\+::now\+\_\+us (\begin{DoxyParamCaption}{ }\end{DoxyParamCaption})}



Returns the current date and time with a resolution to the microsecond. 

\begin{DoxyReturn}{Returns}
the current date and time with a resolution to the microsecond
\end{DoxyReturn}
\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{date d = now\_us();}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxySeeAlso}{See also}

\begin{DoxyItemize}
\item \mbox{\hyperlink{group__date__and__time__functions_ga23f067a4f82596346d4fef09782e1945}{now()}} For a similar function returning the current \mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} and time in the local time zone with coarser granularity, when resolution only to the second is needed
\item \mbox{\hyperlink{group__date__and__time__functions_ga4916588a63c91c6632ce877ec1d6cc1b}{now\+\_\+ms()}} for a similar function returning the current \mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} and time in the local time zone with coarser granularity, when resolution only to the millisecond is needed
\item \mbox{\hyperlink{group__date__and__time__functions_ga014569059b153ad30b0951ba0113bd04}{now\+\_\+utc()}};
\end{DoxyItemize}
\end{DoxySeeAlso}
\begin{DoxyNote}{Note}
There is no performance penalty for using \mbox{\hyperlink{group__date__and__time__functions_ga4916588a63c91c6632ce877ec1d6cc1b}{now\+\_\+ms()}} and \mbox{\hyperlink{group__date__and__time__functions_ga61b29a943e0e85abdc9792a9434e5b39}{now\+\_\+us()}} versus \mbox{\hyperlink{group__date__and__time__functions_ga23f067a4f82596346d4fef09782e1945}{now()}}; \mbox{\hyperlink{group__date__and__time__functions_ga23f067a4f82596346d4fef09782e1945}{now()}} and \mbox{\hyperlink{group__date__and__time__functions_ga4916588a63c91c6632ce877ec1d6cc1b}{now\+\_\+ms()}} are kept for backwards compatibility 
\end{DoxyNote}
\mbox{\Hypertarget{group__date__and__time__functions_ga014569059b153ad30b0951ba0113bd04}\label{group__date__and__time__functions_ga014569059b153ad30b0951ba0113bd04}} 
\index{Date and Time Functions@{Date and Time Functions}!now\_utc@{now\_utc}}
\index{now\_utc@{now\_utc}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{now\_utc()}{now\_utc()}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} Qore\+::now\+\_\+utc (\begin{DoxyParamCaption}{ }\end{DoxyParamCaption})}



Returns the current UTC date and time with a resolution to the microsecond. 

\begin{DoxyReturn}{Returns}
the current UTC date and time with a resolution to the microsecond
\end{DoxyReturn}
\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{date d = now\_utc();}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxySeeAlso}{See also}
\mbox{\hyperlink{group__date__and__time__functions_ga61b29a943e0e85abdc9792a9434e5b39}{now\+\_\+us()}} for a similar function that returns the current \mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} and time in the local time zone 
\end{DoxySeeAlso}
\mbox{\Hypertarget{group__date__and__time__functions_gad7edd4b61aca5344ad2dd94b23c934d7}\label{group__date__and__time__functions_gad7edd4b61aca5344ad2dd94b23c934d7}} 
\index{Date and Time Functions@{Date and Time Functions}!seconds@{seconds}}
\index{seconds@{seconds}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{seconds()}{seconds()}\hspace{0.1cm}{\footnotesize\ttfamily [1/2]}}
{\footnotesize\ttfamily nothing Qore\+::seconds (\begin{DoxyParamCaption}{ }\end{DoxyParamCaption})}



This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_RUNTIME_NOOP}{RUNTIME\+\_\+\+NOOP}} 
\end{DoxyParagraph}
\mbox{\Hypertarget{group__date__and__time__functions_ga19566ff46f3818f4554c73ba145fd8e1}\label{group__date__and__time__functions_ga19566ff46f3818f4554c73ba145fd8e1}} 
\index{Date and Time Functions@{Date and Time Functions}!seconds@{seconds}}
\index{seconds@{seconds}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{seconds()}{seconds()}\hspace{0.1cm}{\footnotesize\ttfamily [2/2]}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} Qore\+::seconds (\begin{DoxyParamCaption}\item[{softint}]{seconds }\end{DoxyParamCaption})}



Returns a \mbox{\hyperlink{basic_data_types_relative_dates}{relative date/time value}} in seconds based on the integer argument passed to be used in date arithmetic. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em seconds} & the number of seconds to return\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
a \mbox{\hyperlink{basic_data_types_relative_dates}{relative date/time value}} in seconds based on the integer argument passed to be used in date arithmetic
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{date rd = seconds(100);}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxySeeAlso}{See also}

\begin{DoxyItemize}
\item \mbox{\hyperlink{group__date__and__time__functions_ga71eac87de4a337ec7d6dc6456d86d8c4}{years(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_gacf1db8004f38d76ad6028855f36772ce}{months(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_ga0f5bfff6ce4b534b1c3a6c5357b1377a}{days(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_gab342176f1a1c5ac93fbf18faeda3e943}{hours(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_ga4d6d3d90deac1387573033793c668586}{minutes(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_gac8e561799a9f873502e161695670c06d}{milliseconds(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_ga5ecb2657b5cc84fc2f16ae1a4cc3fae7}{microseconds(softint)}} 
\end{DoxyItemize}
\end{DoxySeeAlso}
\mbox{\Hypertarget{group__date__and__time__functions_ga2bd5e056f0b35e599aaecd7e5e26512f}\label{group__date__and__time__functions_ga2bd5e056f0b35e599aaecd7e5e26512f}} 
\index{Date and Time Functions@{Date and Time Functions}!timegm@{timegm}}
\index{timegm@{timegm}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{timegm()}{timegm()}\hspace{0.1cm}{\footnotesize\ttfamily [1/2]}}
{\footnotesize\ttfamily nothing Qore\+::timegm (\begin{DoxyParamCaption}{ }\end{DoxyParamCaption})}



This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_RUNTIME_NOOP}{RUNTIME\+\_\+\+NOOP}} 
\end{DoxyParagraph}
\mbox{\Hypertarget{group__date__and__time__functions_ga62c3c23b7423b9583193a8a5cb16eb29}\label{group__date__and__time__functions_ga62c3c23b7423b9583193a8a5cb16eb29}} 
\index{Date and Time Functions@{Date and Time Functions}!timegm@{timegm}}
\index{timegm@{timegm}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{timegm()}{timegm()}\hspace{0.1cm}{\footnotesize\ttfamily [2/2]}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__type__conversion__functions_ga2de8717e92c5f97ccc6511f6062d6502}{int}} Qore\+::timegm (\begin{DoxyParamCaption}\item[{\mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}}}]{dt }\end{DoxyParamCaption})}



Returns the number of seconds since January 1, 1970 00\+:00\+:00 in the local time zone for the given date. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em dt} & The date to process\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
the number of seconds since January 1, 1970 00\+:00\+:00 in the local time zone for the given date
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{int secs = timegm(dt);}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxySeeAlso}{See also}
\mbox{\hyperlink{group__date__and__time__functions_gaa69c5fbab2d5e245d89cb3253523c310}{get\+\_\+epoch\+\_\+seconds(date)}} 
\end{DoxySeeAlso}
\mbox{\Hypertarget{group__date__and__time__functions_ga22b8473aff75818b568aac6ca76c87eb}\label{group__date__and__time__functions_ga22b8473aff75818b568aac6ca76c87eb}} 
\index{Date and Time Functions@{Date and Time Functions}!years@{years}}
\index{years@{years}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{years()}{years()}\hspace{0.1cm}{\footnotesize\ttfamily [1/2]}}
{\footnotesize\ttfamily nothing Qore\+::years (\begin{DoxyParamCaption}{ }\end{DoxyParamCaption})}



This function variant does nothing at all; it is only included for backwards-\/compatibility with qore prior to version 0.\+8.\+0 for functions that would ignore type errors in arguments. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_RUNTIME_NOOP}{RUNTIME\+\_\+\+NOOP}} 
\end{DoxyParagraph}
\mbox{\Hypertarget{group__date__and__time__functions_ga71eac87de4a337ec7d6dc6456d86d8c4}\label{group__date__and__time__functions_ga71eac87de4a337ec7d6dc6456d86d8c4}} 
\index{Date and Time Functions@{Date and Time Functions}!years@{years}}
\index{years@{years}!Date and Time Functions@{Date and Time Functions}}
\doxysubsubsection{\texorpdfstring{years()}{years()}\hspace{0.1cm}{\footnotesize\ttfamily [2/2]}}
{\footnotesize\ttfamily \mbox{\hyperlink{group__date__and__time__functions_gaa80ee453b6a5653ac685d7e290c74e3f}{date}} Qore\+::years (\begin{DoxyParamCaption}\item[{softint}]{years }\end{DoxyParamCaption})}



Returns a \mbox{\hyperlink{basic_data_types_relative_dates}{relative date/time value}} in years based on the integer argument passed to be used in date arithmetic. 

\begin{DoxyParagraph}{Code Flags\+:}
\mbox{\hyperlink{code_flags_CONSTANT}{CONSTANT}}
\end{DoxyParagraph}

\begin{DoxyParams}{Parameters}
{\em years} & the number of years to return\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
a \mbox{\hyperlink{basic_data_types_relative_dates}{relative date/time value}} in years based on the integer argument passed to be used in date arithmetic
\end{DoxyReturn}
\begin{DoxyParagraph}{Example\+:}

\begin{DoxyCode}{0}
\DoxyCodeLine{date y = years(100);}

\end{DoxyCode}

\end{DoxyParagraph}
\begin{DoxySeeAlso}{See also}

\begin{DoxyItemize}
\item \mbox{\hyperlink{group__date__and__time__functions_gacf1db8004f38d76ad6028855f36772ce}{months(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_ga0f5bfff6ce4b534b1c3a6c5357b1377a}{days(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_gab342176f1a1c5ac93fbf18faeda3e943}{hours(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_ga4d6d3d90deac1387573033793c668586}{minutes(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_ga19566ff46f3818f4554c73ba145fd8e1}{seconds(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_gac8e561799a9f873502e161695670c06d}{milliseconds(softint)}}
\item \mbox{\hyperlink{group__date__and__time__functions_ga5ecb2657b5cc84fc2f16ae1a4cc3fae7}{microseconds(softint)}} 
\end{DoxyItemize}
\end{DoxySeeAlso}
