Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Showing content from http://www.ncbi.nlm.nih.gov/IEB/ToolBox/CPP_DOC/doxyhtml/group__Time.html below:

NCBI C++ ToolKit: Time And Date

Definition at line 1244 of file ncbitime.hpp.

Whether to adjust for daylight saving time.

Ignore daylight saving time.

Adjust for daylight saving time.

Definition at line 367 of file ncbitime.hpp.

Day of week names.

Definition at line 339 of file ncbitime.hpp.

Defines how to behave on error.

Throw an exception on error.

Return default value on error.

Definition at line 1193 of file ncbitime.hpp.

Error types that CTime can generate.

Bad function argument.

Error converting value from one format to another.

Invalid time value.

Incorrect format.

Definition at line 2078 of file ncbitime.hpp.

Flags.

Note

It not specified otherwise, format have fDefault value "by default", that mean simple format string and strict matching.

See also

SetFormat, AsString

Use single characters as format symbols.

(default)

Specify each format symbol with a preceding symbol '$'.

This can be useful if your format string includes output characters that otherwise can be treated as format symbols. To include symbol '$' use '$$'.

A time string should strictly match the format string.

eg "Y" and "1997"

A time/format string can have extra trailing format symbols, that do not have matching symbols in the time string.

Any missed time components will be initialized by default in the time object. eg "Y/M/D h:m:s" and "1997"

eg "Y" and "1997/07/16"

Combination of both modes above.

Note that it matches until time or format string have symbols. It not allow unprocessed symbols left in both time and format strings at the same time.

Ignore all white spaces in the time and format strings on the matching/parsing step (CTime only).

Use it for backward compatibility with old code only. Don't recommended to use, can lead to odd results and incorrect time on parsing some time strings.

Prefer "UTC" over "GMT" abbreviation for universal time.

Used for output purposes only, parsing accept both.

Default flags.

"Enum"s, used for backward compatibility. Please use flags instead.

Definition at line 139 of file ncbitime.hpp.

Which initial value to use for time.

Use current time. See also CCurrentTime.

Use "empty" time.

Definition at line 299 of file ncbitime.hpp.

Month names.

Definition at line 323 of file ncbitime.hpp.

Which format use to get name of month or week of day.

Use full name.

Use abbreviated name.

Definition at line 317 of file ncbitime.hpp.

Predefined formats.

See also

GetPredefined, CTime::SetFormat

Y (eg 1997)

Y-M (eg 1997-07)

Y-M-D (eg 1997-07-16)

Y-M-DTh:m (eg 1997-07-16T19:20)

Y-M-DTh:m:s (eg 1997-07-16T19:20:30)

Y-M-DTh:m:g (eg 1997-07-16T19:20:30.1234)

Definition at line 190 of file ncbitime.hpp.

Precision for rounding time.

See also

Round, Truncate

Round to days.

Round to hours.

Round to minutes.

Round to seconds.

Round to milliseconds.

Round to microseconds.

Definition at line 982 of file ncbitime.hpp.

AsSmartString() conversion flags.

Attention

Use one flag in each group only, or CTimeException exception will be thrown. If not specified otherwise default value will be used.

See also

AsSmartString

Round to years.

Note

precision Flags describing how many parts of time span should be returned.

• Values from fSS_Year to fSS_Nanosecond apparently describe part of time span which will be last in output string.
• Floating precision levels fSS_PrecisionN say that only up to 'N' of most significant parts of time span will be printed. The parts counting begin from first non-zero value.
• fSS_Smart is default, it tries to represent time span as close and short as possible, usually using only one or two most significant non-zero parts of the time span.

Round to months.

Round to days.

Round to hours.

Round to minutes.

Round to seconds.

Round to milliseconds.

Round to microseconds.

Do not round at all (accurate time span)

Floating precision level 1.

Floating precision level 2.

Floating precision level 3.

Floating precision level 4.

Floating precision level 5.

Floating precision level 6.

Floating precision level 7.

Be as smart as possible (see above)

Mask of precision flags (sum of all above)

Note

rounding Rounding flags. By default time span will be truncated at last value specified by precision. If fSS_Round specified, that time span will be arithmetically rounded by precision level.

Note

zero parts Flags to print or skip zero parts of time span which should be printed but have 0 value. Apply to middle and trailing zero parts of time span only. Leading zeros will be ignored in common case in any mode, they can be printed only if it is impossible to represent time span otherwise.

Attention

fSS_NoSkipZero is not compatible with fSS_Smart (exception will be thrown).

Note

naming Specify what kind of names use for output time components, short standard abbreviations for time component like "m", or full "minutes".

Default flags.

Definition at line 1440 of file ncbitime.hpp.

Precision for span "smart" string.

Used in AsSmartString() method.

Deprecated:

Use ESmartStringFlags instead

Definition at line 1503 of file ncbitime.hpp.

Which format use to output zero time span parts.

Deprecated:

Use ESmartStringFlags instead

Print zero valued parts.

Skip zero valued parts.

Definition at line 1526 of file ncbitime.hpp.

Defines how to create new timer.

Start timer immediately after creating.

Do not start timer, just create it.

Definition at line 1940 of file ncbitime.hpp.

Which initial value to use for timezone.

Local time.

UTC (Universal Coordinated Time)

GMT (Greenwich Mean Time)

Definition at line 305 of file ncbitime.hpp.

What time zone precision to use for adjusting daylight saving time.

Controls when (if ever) to adjust for the daylight saving time (only if the time is represented in local timezone format).

NOTE: if diff between previous time value and the time after manipulation is greater than this range, then try apply daylight saving conversion on the result time value.

Daylight saving not to affect time manipulations.

Check condition - new minute.

Check condition - new hour.

Check condition - new day.

Check condition - new month.

Definition at line 357 of file ncbitime.hpp.

Type of timeouts.

A finite timeout value has been set.

Default timeout (to be interpreted by the client code)

Infinite timeout.

Zero timeout, equal to CTimeout(0,0).

Definition at line 1696 of file ncbitime.hpp.

Type of special deadlines.

Infinite deadline.

No-wait, expires immediately.

Definition at line 1833 of file ncbitime.hpp.

Add specified days and adjust for daylight saving time.

Parameters

days Days to add. Default is 1 day. If negative, it will result in a "subtraction" operation. adl Whether to adjust for daylight saving time. Default is to adjust for daylight saving time. This parameter is for eLocal time zone and where the time zone precision is not eNone.

Definition at line 1788 of file ncbitime.cpp.

References CTime::CTime(), CTime::eAdjustDaylight, CTime::IsEmptyDate(), kEmptyStr, NCBI_THROW, s_Date2Number(), s_Number2Date(), CTime::x_AdjustTime(), and CTime::x_NeedAdjustTime().

Referenced by CTime::Round(), CTime::SetTimeDBI(), CTime::SetTimeDBU(), and CTime::x_AddHour().

Add specified minutes and adjust for daylight saving time.

Parameters

minutes Minutes to add. Default is 1 minute. If negative, it will result in a "subtraction" operation. adl Whether to adjust for daylight saving time. Default is to adjust for daylight saving time. This parameter is for eLocal time zone and where the time zone precision is not eNone.

Definition at line 1850 of file ncbitime.cpp.

References CTime::AddHour(), CTime::CTime(), CTime::eAdjustDaylight, CTime::eIgnoreDaylight, CTime::IsEmptyDate(), kEmptyStr, CTime::Minute(), NCBI_THROW, s_Offset(), SET_MIN, CTime::x_AdjustTime(), and CTime::x_NeedAdjustTime().

Referenced by CTime::AddSecond(), CTime::Round(), and CTime::SetTimeDBU().

Add specified months and adjust for daylight saving time.

Beware that this operation is inherently inconsistent. In case of different number of days in the months, the day number can change, e.g.:

• "Dec 31 2000".AddMonth(2) => "Feb 28 2001" ("Feb 29" if leap year). Therefore e.g. calling AddMonth(1) 12 times for e.g. "Jul 31" will result in "Jul 28" (or "Jul 29") of the next year.

  Parameters

  months Months to add. Default is 1 month. If negative, it will result in a "subtraction" operation. adl Whether to adjust for daylight saving time. Default is to adjust for daylight savings time. This parameter is for eLocal time zone and where the time zone precision is not eNone.

Definition at line 1757 of file ncbitime.cpp.

References CTime::CTime(), CTime::eAdjustDaylight, CTime::IsEmptyDate(), kEmptyStr, CTime::Month(), months, NCBI_THROW, s_Offset(), SET_MONTH, SET_YEAR, CTime::x_AdjustDay(), CTime::x_AdjustTime(), CTime::x_NeedAdjustTime(), and CTime::Year().

Referenced by CTime::AddYear().

Add specified nanoseconds.

Parameters

nanoseconds Nanoseconds to add. Default is 1 nanosecond. If negative, it will result in a "subtraction" operation.

Definition at line 1896 of file ncbitime.cpp.

References CTime::AddSecond(), CTime::IsEmptyDate(), kNanoSecondsPerSecond, CTime::m_Data, CTime::TData::nanosec, CTime::NanoSecond(), NCBI_THROW, and s_Offset().

Referenced by CTime::AddTimeSpan(), CSimpleRebalanceStrategy::NeedRebalance(), and CTime::SetTimeDBI().

Add specified seconds.

Parameters

seconds Seconds to add. Default is 1 second. If negative, it will result in a "subtraction" operation.

Definition at line 1880 of file ncbitime.cpp.

References CTime::AddMinute(), CTime::IsEmptyDate(), NCBI_THROW, s_Offset(), CTime::Second(), and SET_SEC.

Referenced by CCgiApplication::AddLBCookie(), CTime::AddNanoSecond(), CTime::AddTimeSpan(), SThrottleStats::Adjust(), CTime::AsString(), CApplogUrl::ComposeUrl(), CFastLocalTime::GetLocalTime(), CHttpCookie::Parse(), CTime::Round(), s_ParseDateTime(), CTime::SetTimeDBI(), CTime::x_Init(), and CPoolBalancer::x_InitFromCounts().

Assign value to time span object from string representation of time in formats produced by AsSmartString().

Parameters

str String representation of time span in the format produced by AsSmartString(). All numeric time parts should have letter/word specifiers. The string should represent "positive" timespan, the sign (minus) is not allowed there.

See also

AsSmartString

Note

It use the average length of the year in the Gregorian (modern) calendar (365.2425 days) to convert years and months.

Definition at line 3263 of file ncbitime.cpp.

References _ASSERT, _TROUBLE, CTimeSpan::Clear(), eDay, eHour, eMicrosecond, eMillisecond, eMinute, eMonth, eNanosecond, eSecond, eYear, i, isalpha(), isdigit(), isspace(), kNanoSecondsPerSecond, kTimeSpanUnitMultipliers, kUnitCount, kUnitNames, CTimeSpan::m_NanoSec, CTimeSpan::m_Sec, n, NCBI_THROW, NStr::NumericToString(), str(), NStr::StringToULong(), NStr::ToLower(), rapidjson::value, and CTimeSpan::x_Normalize().

Referenced by CNcbiApplogApp::Run().

Transform elapsed time to "smart" string.

For more details see CTimeSpan::AsSmartString().

Parameters

precision Enum value describing how many parts of time span should be returned. rounding Rounding mode. zero_mode Mode to print or skip zero parts of time span.

Returns

A string representation of elapsed time span.

See also

CTimeSpan::AsSmartString, AsString, Elapsed

Deprecated:

Use AsSmartString(TSmartStringFlags) instead.

Definition at line 2850 of file ncbitime.hpp.

References CTimeSpan::AsSmartString(), CStopWatch::Elapsed(), eRound, CTimeSpan::eSSZ_NoSkipZero, flags, CTimeSpan::fSS_NoSkipZero, CTimeSpan::fSS_Round, CTimeSpan::fSS_SkipZero, CTimeSpan::fSS_Trunc, and precision.

Referenced by CBlastDbBioseqSource::CBlastDbBioseqSource(), CNetBLASTUIDataSource::Close(), CConnTestThread::Main(), CSeqGraphicWidget::OnDataChanged(), CAppDialogs::OpenViewlDialog(), CAnnotMetaDataJob::Run(), CBlastVdbCmdApp::x_FormatRuntime(), CNAUtils::x_GetAllNAIds(), CNAUtils::x_GetNAMetaData(), and BlastdbCopyApplication::x_MakeDBwIDList().

Transform time span to "smart" string.

Deprecated:

Use AsSmartString(TSmartStringFlags) instead.

Definition at line 2688 of file ncbitime.hpp.

References eRound, CTimeSpan::eSSZ_NoSkipZero, flags, CTimeSpan::fSS_NoSkipZero, CTimeSpan::fSS_Round, CTimeSpan::fSS_SkipZero, CTimeSpan::fSS_Trunc, and precision.

Referenced by CThreadPool_Impl::Abort(), CStopWatch::AsSmartString(), CNSTServiceProperties::GetTTLAsString(), CBlastMasterNode::Processing(), CNSTServiceProperties::x_GetProlongAsString(), and CNetStorageHandler::x_ProcessGetObjectInfo().

Transform time span to "smart" string.

Parameters

flags How to convert string to value.

Returns

A string representation of time span. It MUST NOT be negative, or an exception will be thrown!

See also

AssignFromSmartString, AsString, ESmartStringFlags

Note

For very big time spans it use the average length of the year in the Gregorian (modern) calendar (365.2425 days) to calculate number of months and years.

Definition at line 3189 of file ncbitime.cpp.

References _ASSERT, CTimeSpan::CTimeSpan(), eNegative, f, flags, CTimeSpan::fSS_Day, CTimeSpan::fSS_Full, CTimeSpan::fSS_Hour, CTimeSpan::fSS_Microsecond, CTimeSpan::fSS_Millisecond, CTimeSpan::fSS_Minute, CTimeSpan::fSS_Month, CTimeSpan::fSS_Nanosecond, CTimeSpan::fSS_NoSkipZero, CTimeSpan::fSS_Precision1, CTimeSpan::fSS_Precision2, CTimeSpan::fSS_Precision3, CTimeSpan::fSS_Precision4, CTimeSpan::fSS_Precision5, CTimeSpan::fSS_Precision6, CTimeSpan::fSS_Precision7, CTimeSpan::fSS_PrecisionMask, CTimeSpan::fSS_Round, CTimeSpan::fSS_Second, CTimeSpan::fSS_Short, CTimeSpan::fSS_SkipZero, CTimeSpan::fSS_Smart, CTimeSpan::fSS_Trunc, CTimeSpan::fSS_Year, CTimeSpan::GetSign(), NCBI_THROW, CTimeSpan::x_AsSmartString_Precision(), CTimeSpan::x_AsSmartString_Smart_Big(), and CTimeSpan::x_AsSmartString_Smart_Small().

Transform time span to string.

Parameters

fmt Format specifier used to convert time span to string. If format is not defined, then GetFormat() will be used.

Returns

A string representation of time span in specified format.

See also

CTimeFormat, GetFormat, SetFormat

Definition at line 2681 of file ncbitime.cpp.

References abs, eNegative, f, CTimeFormat::fFormat_Simple, format, CTimeSpan::GetCompleteDays(), CTimeSpan::GetCompleteHours(), CTimeSpan::GetCompleteMinutes(), CTimeSpan::GetCompleteSeconds(), CTimeSpan::GetFormat(), CTimeSpan::GetNanoSecondsAfterSecond(), CTimeSpan::GetSign(), ITERATE, kFormatEscapeSymbol, s_AddInt(), s_AddZeroPadInt(), s_AddZeroPadInt2(), str(), CTimeSpan::x_Hour(), CTimeSpan::x_Minute(), and CTimeSpan::x_Second().

Referenced by CStopWatch::AsString(), CCgiStatistics::Compose_Timing(), CCgi2RCgiApp::PopulatePage(), CPeriodicTestJob::Run(), CTimeout::Set(), SNetStorageObjectRPC::SetExpiration(), and sToUserFriendlyString().

Transform stopwatch time to string.

According to used OS, the double representation can provide much finer grained time control. The string representation is limited by nanoseconds.

Parameters

fmt If format is not defined, then GetFormat() will be used. Format specifier used to convert value returned by Elapsed() to string.

See also

CTimeSpan::AsString, CTimeFormat, Elapsed, GetFormat, SetFormat

Definition at line 4149 of file ncbitime.cpp.

References CTimeSpan::AsString(), CStopWatch::Elapsed(), CStopWatch::GetFormat(), and CTimeFormat::IsEmpty().

Referenced by CMacroWorker::ExecuteMacros(), CDiagContext::GetProperty(), operator<<(), and CSequenceInputStats::PrintReport().

Transform time to string.

Parameters

format Format specifier used to convert time to string. If "format" is not defined, then GetFormat() will be used. out_tz Output timezone. This is a difference in seconds between universal and local time for some place (for example, for EST5 timezone its value is 18000). This parameter works only with local time. If the time object contains universal (GMT/UTC/Z) time it is ignored. Before doing transformation to string, the time will be converted to the output timezone. Timezone can be printed as a string 'GMT/UTC/Z[+|-]HHMM' using the format symbol 'z'. By default the current timezone is used.

See also

GetFormat, SetFormat

Definition at line 1512 of file ncbitime.cpp.

References STzFormatMake::activate(), STzFormatMake::active(), CTime::AddSecond(), CTime::CTime(), DSTBias, CTime::eCurrentTimeZone, ERR_POST_X, f, CTimeFormat::fConf_UTC, CTimeFormat::fFormat_Simple, format, CTime::GetFormat(), CTime::IsEmpty(), CTime::IsUniversalTime(), CTime::IsValid(), ITERATE, kEmptyStr, kFormatEscapeSymbol, kMonthAbbr, kMonthFull, kWeekdayAbbr, kWeekdayFull, NCBI_THROW, NPOS, s_AddInt(), s_AddZeroPadInt(), s_AddZeroPadInt2(), s_IsDST(), s_TimeDump(), str(), STzFormatMake::str(), t, and TimeZone.

Referenced by CRtProfiler::AddMarkerMT(), SThrottleStats::Adjust(), Convert::CassValueConvert< string >(), CBuildDatabase::CBuildDatabase(), CDbapiSampleApp::CDbapiSampleApp(), CNCHeartBeat::CheckConfFile(), CCgiStatistics::Compose_Timing(), CApplogUrl::ComposeUrl(), CPepXML::ConvertFromOMSSA(), CFeatureGenerator::ConvertLocToAnnot(), CWriteDB_ColumnIndex::CWriteDB_ColumnIndex(), CWriteDB_ConsolidateAliasFiles(), CWriteDB_CreateAliasFile(), CWriteDB_GiMaskIndex::CWriteDB_GiMaskIndex(), CWriteDB_Impl::CWriteDB_Impl(), CNcbiSample_Dbapi_Simple::DemoDynamicSql(), CSdbapiSimpleApp::DemoDynamicSql(), CwxLogDiagHandler::DoLogRecord(), CBDB_Cache::EvaluateTimeLine(), CDbapiTestSpeedApp::FetchFile(), CFeedbackReport::Format(), CProjBulderApp::GenerateUnixProjects(), CAlignFormatUtil::GetBlastDbInfo(), CSeqDB::GetDBMetaData(), CHttpCookie::GetExpirationStr(), CGBenchVersionInfo::GetLabel(), GetNetBlastJobDescription(), CELink_Request::GetQueryString(), CESearch_Request::GetQueryString(), CFileModules::GetRefInfo(), CVariant::GetString(), SLazyInitData::GetTime(), CEventViewModel::GetValueAt(), NS_FormatPreciseTime(), NST_FormatPreciseTime(), CPubseqGatewayApp::OnInfo(), operator<<(), CCgi2RCgiApp::PopulatePage(), CPerfLogger::Post(), CWNJobWatcher::Print(), CGridCommandLineInterfaceApp::PrintBlobMeta(), CSplitCacheApp::PrintVersion(), CBDB_Cache::Purge(), CCkblastindexApplication::Run(), CBlastKmerBuildIndexApplication::Run(), CXcompareAnnotsApplication::Run(), CAsnSubCacheCreateApplication::Run(), COcbdDemoApp::Run(), CCtlLibDemoAPp::RunSample(), s_ConvertV4toV5(), s_ConvertValue(), s_CreateAliasFilePriv(), s_DumpHeader(), s_ExpandProjectFolder(), s_FormatDate(), s_GetBlobMeta(), s_ListProjectFolder(), CGenBankLoadOptionPanel::SaveMruAccessions(), CProjectService::SaveSettings(), CFileLoadManager::SaveSettings(), CFileLoadMRUList::SaveToStrings(), CCgiResponse::SetHeaderValue(), CDate::SetToTime(), sFormatTimePeriod(), IBISInteraction::ToAlignAnnot(), CBlobStatusHistoryRecord::ToString(), CNetBlastJobDescriptor::ToUserObject(), CFeatureGenerator::SImplementation::TransformProteinAlignToTranscript(), WriteBlastSeqidlistFile(), CBlastDBAliasApp::x_AddVDBsToAliasFile(), CRotatingLogStream::x_BackupName(), CMessageSlotPopupWindow::x_CreateMessageSlotPanel(), CFeatureGenerator::SImplementation::x_CreateMrnaBioseq(), CCreateNeedlemanWunschJob::x_CreateProjectItems(), CFeatureGenerator::SImplementation::x_CreateProteinBioseq(), CAsnSubCacheCreateApplication::x_GetBioseqHandle(), CAgpFastaComparator::CTmpSeqVecStorage::x_GetTmpDir(), SDiagMessage::x_OldWrite(), CNetScheduleHandler::x_ProcessHealth(), CNetScheduleHandler::x_ProcessStatistics(), and CStartItem::x_SetDate().

Initialize deadline of specified type.

Definition at line 3761 of file ncbitime.cpp.

Initialize deadline using seconds and nanoseconds (adding to the current time)

Parameters

seconds Number of seconds to add to the current time nanoseconds Number of nanoseconds to add to the current time

Definition at line 3767 of file ncbitime.cpp.

References CDeadline::x_SetNowPlus().

Constructor.

It should not try to get local time from OS more often than once an hour. Default: check once, 5 seconds after each hour.

Definition at line 3925 of file ncbitime.cpp.

References Daylight, CTime::eHour, int, CFastLocalTime::m_Daylight, CFastLocalTime::m_LocalTime, CFastLocalTime::m_Timezone, CFastLocalTime::m_TunedTime, CGuard< Resource, Lock, Unlock, ReportExceptions >::Release(), CTime::SetTimeZonePrecision(), and TimeZone.

Make the time "empty",.

Definition at line 1999 of file ncbitime.cpp.

References CTime::TData::adjTimeDiff, CTime::TData::day, CTime::TData::hour, CTime::m_Data, CTime::TData::min, CTime::TData::month, CTime::TData::nanosec, CTime::TData::sec, and CTime::TData::year.

Referenced by CVariant::GetCTime(), impl::CDriverContext::MakeCDBConnection(), CHttpCookie::Parse(), CHttpCookie::Reset(), CTimeFunctions::SetDefault(), CReader::WaitBeforeNewConnection(), and CTime::x_Init().

Explicit conversion constructor for string representation of time.

Construct time object from string representation of time.

Parameters

str String representation of time in format "fmt". fmt Format in which "str" is presented. Default value of kEmptyStr, implies the format, that was previously setup using SetFormat() method, or default "M/D/Y h:m:s". tz If current format contains 'Z', then objects timezone will be set to:

• eUTC if "str" has words "GMT", "UTC" or "Z" (zero UTC offset) in the appropriate position;
• eLocal otherwise. If current format does not contain 'Z', objects timezone will be set to 'tz' value.

See also

AsString, operator=

Definition at line 1014 of file ncbitime.cpp.

References _ASSERT, CTime::eGmt, CTime::eLocal, CTime::eUTC, CTime::GetFormat(), CTimeFormat::IsEmpty(), CTime::m_Data, str(), CTime::TData::tz, CTime::TData::tzprec, and CTime::x_Init().

Constructor.

Parameters

mode Whether to build time object with current time or empty time (default). tz Whether to use local time (default) or UTC. tzp What time zone precision to use.

Definition at line 985 of file ncbitime.cpp.

References CTime::eCurrent, CTime::m_Data, CTime::SetCurrent(), CTime::TData::tz, and CTime::TData::tzprec.

Referenced by CTime::AddDay(), CTime::AddMinute(), CTime::AddMonth(), CTime::AsString(), CTime::CTime(), CTime::GetTimeDBI(), CTime::GetTimeDBU(), CTime::x_AddHour(), and CTime::YearDayNumber().

Constructor.

Construct time given the year, month, day, hour, minute, second, nanosecond parts of a time value.

Parameters

year Year part of time. month Month part of time. Note month starts from 1. day Day part of time. Note day starts from 1. hour Hour part of time. minute Minute part of time. second Second part of time. nanosecond Nanosecond part of time. tz Whether to use local time (default) or UTC. tzp What time zone precision to use.

Definition at line 952 of file ncbitime.cpp.

References CTime::TData::adjTimeDiff, CHECK_RANGE_DAY, CHECK_RANGE_HOUR, CHECK_RANGE_MIN, CHECK_RANGE_MONTH, CHECK_RANGE_NSEC, CHECK_RANGE_SEC, CHECK_RANGE_YEAR, CTime::IsValid(), CTime::m_Data, CTime::TData::nanosec, NCBI_THROW, s_TimeDump(), SET_DAY, SET_HOUR, SET_MIN, SET_MONTH, SET_SEC, SET_YEAR, CTime::TData::tz, and CTime::TData::tzprec.

Constructor.

Construct time span from number of seconds. Please, use this constructor as rarely as possible, because after doing some arithmetical operations and conversion with it, the time span can differ at some nanoseconds from expected value.

Parameters

seconds Second part of time. The fractional part is used to compute nanoseconds.

Definition at line 2509 of file ncbitime.hpp.

References CTimeSpan::Set().

Constructor.

Construct time span given the number of seconds and nanoseconds.

Parameters

seconds Second part of time. nanoseconds Nanosecond part of time.

Definition at line 2503 of file ncbitime.hpp.

References CTimeSpan::Set().

Definition at line 2184 of file ncbitime.hpp.

References CTime::eCurrent.

Referenced by BOOST_AUTO_TEST_CASE(), CSequenceEditingEventHandler::CreateSeqSubmit(), CDBConnectionFactory::CServiceInfo::GetOptions(), CDBConnectionFactory::MakeDBConnection(), CCgiApplication::ShouldRestart(), CCitSubUpdater::sx_GetCitSubForSequence(), CRotatingLogStream::x_BackupName(), CProSplignJob::x_CreateOneProjectItem(), CNGAlignJob::x_CreateProjectItems(), CSplignJob::x_CreateProjectItems(), CPoolBalancer::x_GetServer(), CNetStorageHandler::x_ProcessGetObjectInfo(), CAgpConverter::x_SetCreateAndUpdateDatesToToday(), CStartItem::x_SetDate(), CMacroFunction_SetPubStatus::x_SetStatus(), CSubmissionWizard::x_SetSubmissionDate(), and CBlockingQueue< TRequest >::x_WaitForPredicate().

Get day.

Day of the month = 1..31 AsString() format symbol "D".

Definition at line 2271 of file ncbitime.hpp.

References CTime::TData::day, and CTime::m_Data.

Referenced by python::ConvertCVariant2PCObject(), CTimeToTimeTms(), CTime::DayOfWeek(), CTime::IsEmpty(), CTime::IsValid(), CTime::operator<(), CTime::operator==(), CTime::operator>(), s_Date2Number(), s_TimeDump(), CCgiCookie::SetExpTime(), CDate_std::SetToTime(), CUser_object::UpdateNcbiCleanup(), CTime::x_AdjustDay(), and CTime::x_AdjustTime().

Difference in seconds from specified time.

Definition at line 2282 of file ncbitime.cpp.

References CTime::DiffWholeDays(), CTime::GetTimeZone(), CTime::Hour(), CTime::Minute(), CTime::Second(), and CTime::ToUniversalTime().

Referenced by CCgiStatistics::Compose(), CTime::DiffDay(), CTime::DiffHour(), CTime::DiffMinute(), CTime::DiffNanoSecond(), and CTime::DiffTimeSpan().

Return time elapsed since first Start() or last Restart() call (in seconds).

Result is 0.0 if Start() or Restart() wasn't previously called.

Definition at line 2775 of file ncbitime.hpp.

References CStopWatch::eStop, CStopWatch::GetTimeMark(), CStopWatch::m_Start, CStopWatch::m_State, and CStopWatch::m_Total.

Referenced by CBuildDatabase::AddSequences(), CThreadPool_Impl::AddTask(), CNcbiTestApplication::AdjustTestTimeout(), CStopWatch::AsSmartString(), CStopWatch::AsString(), BOOST_AUTO_TEST_CASE(), IPhyloTreeRender::BufferedRender(), CBuildDatabase::Build(), CPhyloTreePS::CalcForces(), CBamFileInfo::CBamFileInfo(), CGlWidgetPane::CheckOverlayTimer(), CompressAssembly(), ConvertToPairwise(), CBDB_Cache::EvaluateTimeLine(), CExecute::Exec(), CChangePhyloTreeCommand::Execute(), CChangePhyloPropertyCmd::Execute(), CChangePhyloExpandCollapseCmd::Execute(), CQueryParsePanel::CQueryJob::Execute(), CMacroWorker::ExecuteMacros(), CSeqEntryPresenter::Finalize(), CFlatFileGenerator::Generate(), GetBlobReader(), CSNPDataLoader_Impl::GetChunkOnce(), CReaderRequestResultRecursion::GetCurrentRequestTime(), CPerfLogger::GetElapsedTime(), CSNPFileInfo::InitializeDb(), CProcess::Kill(), IPhyloTreeRender::Layout(), CBamRefSeqInfo::LoadAlignChunk(), CSNPDataLoader_Impl::LoadBlob(), CBamRefSeqInfo::LoadMainSplit(), CBamRefSeqInfo::LoadPileupChunk(), CBamRefSeqInfo::LoadSeqChunk(), CBDB_SplitTest::LoadSplitStore(), CBDB_SplitTest::LoadTestSet(), CChainer::CChainerImpl::MakeChains(), CPhyTreeView::OnBioTreeChanged(), CProjectTreePanel::OnDragOver(), CThreadPool_Controller_PID::OnEvent(), CUpdateMultiSeq_Dlg::OnIdle(), CPhyTreeView::OnSomethingEdited(), CNetBLASTUIDataSource::Open(), CGenBankUIDataSource::Open(), CSQLITE3_Cache::Open(), CAlignSort::SAlignExtractor::operator()(), CQueryExecEvalFunc::operator()(), CFileHandleDiagHandler::Post(), CFileDiagHandler::Post(), CPerfLogger::Post(), CSeqEntryPresenter::Process(), CBam2GraphApp::ProcessFile(), CBlastMasterNode::Processing(), CGlCgiImageApplication::ProcessRequest(), CBamIndex::Read(), CBiosampleChkApp::ReadClassMember(), CAsnvalThreadState::ReadClassMember(), CTreeGraphicsModel::Render(), IPhyloTreeRender::Render(), CFileHandleDiagHandler::Reopen(), CFileDiagHandler::Reopen(), CSeqDescrRetrievalJob::Run(), CAnnotMetaDataJob::Run(), CAsnCacheTestApplication::Run(), CCacheIndexCopyApp::Run(), CAsnSubCacheCreateApplication::Run(), CWalkAsnCacheApplication::Run(), CDemoApp::Run(), CMytestApplication::Run(), CProjBulderApp::Run(), CObjConvProfile::Run(), CSampleNetScheduleClient::Run(), CConvImageApp::Run(), CSubImageApp::Run(), CDbapiTestSpeedApp::RunSample(), s_GetDBTree(), s_Win_KillGroup(), CSparseGraph::Save(), CGBenchService::SendAppFinish(), CCachedTaxon3_impl::SendOrgRefList(), UncomressAndCreate(), CPhyloTreePS::Update(), CAsnvalThreadState::ValidateTraditionally(), CAsnvalThreadState::ValidateWorker(), CThread::WaitForAllThreads(), CTimeReporter::Write(), CAsnSubCacheCreateApplication::WriteBlobsInSubCache(), CFileHandleDiagHandler::WriteMessage(), CFileDiagHandler::WriteMessage(), CBuildDatabase::x_AddRemoteSequences(), CBamRefSeqInfo::x_AddSeqChunk(), CRequestRateControl::x_Approve(), CForceJob::x_Calculate(), CImportFeatTable::x_CreateCommand(), CAlnMultiDSBuilder::x_CreateSparseDataSource(), CComponentSearchJob::x_DoSearch(), CBuildDatabase::x_DupLocal(), CWorkerNodeIdleThread::x_GetIdleTimeIfShutdown(), CWorkerNodeIdleThread::x_GetInterval(), CRemoteBlast::x_GetRequestInfoFromRID(), CRemoteBlast::x_GetSubjects(), CCSRARefSeqInfo::x_LoadRangesStat(), CSyncQueue< Type, Container, Traits >::x_LockAndWait(), CWorkspaceAutoSaver::x_OnSave(), CReadIndexSpeedApp::x_PreReadIndex(), CNetScheduleHandler::x_ProcessMsgBatchSubmit(), CId2FetchApp::x_ProcessRequest(), CBGZFFile::x_ReadBlock(), CPagedFile::x_ReadPage(), CPhyloTreePane::x_Render(), IPhyloTreeRender::x_RenderTooltipHints(), CAnnot_Collector::x_SearchMapped(), CRemoteBlast::x_SendRequest(), IPhyloTreeRender::x_SetElementVisibility(), CAlignTabExportPage2::x_StartNAAlignNamesJob(), CThreadPool_Impl::x_WaitForPredicate(), CReadIndexSpeedApp::x_WalkIndex(), CEditObjectFeaturePropagate::xGetEditCommandAllSequences(), BlastdbCopyApplication::~BlastdbCopyApplication(), CBlastDBAliasApp::~CBlastDBAliasApp(), CBlastDbCheckApplication::~CBlastDbCheckApplication(), CBlastDBCmdApp::~CBlastDBCmdApp(), CBlastdbConvertApp::~CBlastdbConvertApp(), CBlastFormatterApp::~CBlastFormatterApp(), CBlastFormatterVdbApp::~CBlastFormatterVdbApp(), CBlastnApp::~CBlastnApp(), CBlastpApp::~CBlastpApp(), CBlastVdbCmdApp::~CBlastVdbCmdApp(), CBlastxApp::~CBlastxApp(), CConvert2BlastMaskApplication::~CConvert2BlastMaskApplication(), CDeltaBlastApp::~CDeltaBlastApp(), CMagicBlastApp::~CMagicBlastApp(), CMakeBlastDBApp::~CMakeBlastDBApp(), CMakeClusterDBApp::~CMakeClusterDBApp(), CMakeProfileDBApp::~CMakeProfileDBApp(), CMultiApplication::~CMultiApplication(), CPsiBlastApp::~CPsiBlastApp(), CRPSBlastApp::~CRPSBlastApp(), CRPSTBlastnApp::~CRPSTBlastnApp(), CTblastnApp::~CTblastnApp(), CTblastxApp::~CTblastxApp(), CVDBBlastnApp::~CVDBBlastnApp(), CVDBTblastnApp::~CVDBTblastnApp(), and SW::~SW().

Get timeout in seconds and microseconds.

Definition at line 3545 of file ncbitime.cpp.

References CTimeout::IsFinite(), kMicroSecondsPerSecond, kNanoSecondsPerSecond, CTimeout::m_NanoSec, CTimeout::m_Sec, CTimeout::m_Type, NCBI_THROW, and s_SpecialValueName().

Referenced by CDeadline::CDeadline(), g_CTimeoutToSTimeout(), CCgiContext::GetStreamStatus(), SNetServerImpl::SConnectDeadline::IsExpired(), and CNetScheduleNotificationHandler::WaitForNotification().

Return time span as number of seconds.

Returns

Return representative of time span as type double. The fractional part represents nanoseconds part of time span. The double representation of the time span is aproximate.

Definition at line 2565 of file ncbitime.hpp.

References kNanoSecondsPerSecond, CTimeSpan::m_NanoSec, and CTimeSpan::m_Sec.

Referenced by CThreadPool_Impl::AddTask(), CPerfLogger::Adjust(), CNSTDatabase::ExecSP_SetExpiration(), CRequestRateControl::Reset(), s_ProgressCallback(), s_TimerCallback(), CPerfLogger::Suspend(), CRPCClient_Base::x_Ask(), CNSTServiceProperties::x_GetProlongInTTLs(), CRPCClient_Base::x_GetRetryDelay(), and CThreadPool_Impl::x_WaitForPredicate().

Get as number of seconds (fractional value).

Definition at line 3512 of file ncbitime.cpp.

References CTimeout::IsFinite(), kNanoSecondsPerSecond, CTimeout::m_NanoSec, CTimeout::m_Sec, CTimeout::m_Type, NCBI_THROW, and s_SpecialValueName().

Referenced by CNetScheduleNotificationHandler::CmdAppendTimeoutGroupAndClientInfo(), SNetServerImpl::ConnectImpl(), CTimer::PresetSeconds(), CNetICacheClientExt::ProlongBlobLifetime(), CNetScheduleNotificationHandler::RequestJobWatching(), SNetStorage_NetCacheBlob::SetExpiration(), CNSTDatabase::SetParameters(), CUsageReportAPI::SetTimeout(), and CNetStorageHandler::x_ProcessConfiguration().

Get as number of milliseconds.

Definition at line 3490 of file ncbitime.cpp.

References CTimeout::IsFinite(), kMilliSecondsPerSecond, kNanoSecondsPerSecond, CTimeout::m_NanoSec, CTimeout::m_Sec, CTimeout::m_Type, NCBI_THROW, s_SpecialValueName(), and NStr::UIntToString().

Referenced by SNetServerImpl::ConnectAndExec(), CCgiContext::GetStreamStatus(), SNetServiceImpl::IterateUntilExecOK(), CInterProcessLock::Lock(), SRetryProcessing::operator()(), s_PeekStdin(), CRWLock::TryReadLock(), CRWLock::TryWriteLock(), CThread::WaitForAllThreads(), CConditionVariable::x_WaitForSignal(), and CAsyncWriteCache::~CAsyncWriteCache().

Get number of complete seconds.

Definition at line 2559 of file ncbitime.hpp.

References CTimeSpan::m_Sec.

Referenced by CTime::AddTimeSpan(), CTimeSpan::AsString(), CServer_ConnectionPool::GetPollAndTimerVec(), s_ProgressCallback(), CTimeout::Set(), CRequestRateControl::Sleep(), CSrvDiagMsg::StopRequest(), sToUserFriendlyString(), CRPCClient_Base::x_Ask(), CTimeSpan::x_AsSmartString_Precision(), CTimeSpan::x_AsSmartString_Smart_Big(), CThreadPool_ServiceThread::x_Idle(), and CBlockingQueue< TRequest >::x_WaitForPredicate().

Get current UTC time in time_t format (with nanoseconds).

Parameters

sec The function return the number of seconds elapsed since midnight (00:00:00), January 1, 1970 UTC. nanosec Number of nanoseconds (0, if not possible to get).

Attention

Result can differs from time(NULL) due different implementation and taking into account nanosecond part on some platforms (rounding).

Definition at line 1672 of file ncbitime.cpp.

References _ASSERT, gettimeofday(), kMicroSecondsPerSecond, kNanoSecondsPerSecond, NCBI_CONST_UINT8, and NCBI_THROW.

Referenced by CFastLocalTime::GetLocalTime(), CFastLocalTime::GetLocalTimezone(), CMacroStat::LogStart(), CMacroStat::LogStop(), CNcbiApplogApp::Redirect(), CNcbiApplogApp::SetInfo(), CFastLocalTime::Tuneup(), CNcbiEncrypt::x_AddSalt(), CTar::x_Append(), CCDDClientPool::x_GetClient(), CCDDClientPool::x_ReleaseClient(), and CTime::x_SetTime().

Quick and dirty getter of local time.

Use global object of CFastLocalTime class to obtain time. See CFastLocalTime for details.

Definition at line 4167 of file ncbitime.cpp.

References s_FastLocalTime.

Referenced by BOOST_AUTO_TEST_CASE(), CGI2GRID_ComposeHtmlPage(), SThrottleStats::Check(), CGridCommandLineInterfaceApp::Cmd_RequestJob(), CBDB_Cache::EvaluateTimeLine(), CPerfLogger::GetElapsedTime(), CServer_ConnectionPool::GetPollAndTimerVec(), CCgi2RCgiApp::GetStatus(), SNetScheduleAPIImpl::Init(), CMessageDumperSender::InputMessage(), CSimpleRebalanceStrategy::NeedRebalance(), CGridCgiSampleApplication::OnEndProcessRequest(), CMessageDumperSender::OutputMessage(), CCgi2RCgiApp::PopulatePage(), CPerfLogger::Post(), CGridCommandLineInterfaceApp::PrintJobStatusNotification(), CBDB_Cache::Purge(), s_GetFastTime(), CPerfLogger::Start(), CCgi2RCgiApp::SubmitJob(), CPerfLogger::Suspend(), and CServer_ConnectionPool::x_UpdateExpiration().

Get local time.

Definition at line 3988 of file ncbitime.cpp.

References CTime::AddSecond(), Daylight, eEmptyGuard, CTime::eIgnoreDaylight, CTime::GetCurrentTimeT(), CGuard< Resource, Lock, Unlock, ReportExceptions >::Guard(), CFastLocalTime::m_Daylight, CFastLocalTime::m_IsTuneup, CFastLocalTime::m_LastSysTime, CFastLocalTime::m_LastTuneupTime, CFastLocalTime::m_LocalTime, CFastLocalTime::m_SecAfterHour, CFastLocalTime::m_Timezone, NCBI_SCHED_YIELD, CGuard< Resource, Lock, Unlock, ReportExceptions >::Release(), CTime::SetNanoSecond(), TimeZone, and CFastLocalTime::x_Tuneup().

Referenced by SDiagMessage::x_OldWrite().

Get difference in seconds between UTC and current local time (daylight information included)

Definition at line 4043 of file ncbitime.cpp.

References Daylight, CTime::GetCurrentTimeT(), CFastLocalTime::m_Daylight, CFastLocalTime::m_IsTuneup, CFastLocalTime::m_LastTuneupTime, CFastLocalTime::m_SecAfterHour, CFastLocalTime::m_Timezone, TimeZone, and CFastLocalTime::x_Tuneup().

Referenced by CBDB_Cache::GetBlobAccess(), CBDB_Cache::GetReadStream(), CBDB_Cache::GetWriteStream(), CBDB_Cache::Read(), and CBDB_Cache::x_Store().

Get number of nanoseconds.

Definition at line 2562 of file ncbitime.hpp.

References CTimeSpan::m_NanoSec.

Referenced by CTime::AddTimeSpan(), CTimeSpan::AsString(), CServer_ConnectionPool::GetPollAndTimerVec(), CTimeout::Set(), CRequestRateControl::Sleep(), CSrvDiagMsg::StopRequest(), CRPCClient_Base::x_Ask(), CTimeSpan::x_AsSmartString_Precision(), CTimeSpan::x_AsSmartString_Smart_Small(), CThreadPool_ServiceThread::x_Idle(), and CBlockingQueue< TRequest >::x_WaitForPredicate().

Get predefined format.

Parameters

fmt String of symbols describing the time format. fmt_type Specify type of the format string.

Returns

A time format object.

See also

EPredefined, SetFormat

Definition at line 389 of file ncbitime.cpp.

References CTimeFormat::CTimeFormat(), CTimeFormat::fFormat_Ncbi, and flags.

Referenced by CSeqDB::GetDBMetaData(), CFileLoadMRUList::LoadFromStrings(), CProjectService::LoadSettings(), CFileLoadManager::LoadSettings(), CGenBankLoadOptionPanel::LoadSettings(), CAsnSubCacheCreateApplication::Run(), CGenBankLoadOptionPanel::SaveMruAccessions(), CProjectService::SaveSettings(), CFileLoadManager::SaveSettings(), CFileLoadMRUList::SaveToStrings(), and IBISInteraction::ToAlignAnnot().

Get time left to the expiration.

Definition at line 3859 of file ncbitime.cpp.

References _ASSERT, CTimeout::eInfinite, int, CDeadline::IsInfinite(), kNanoSecondsPerSecond, CDeadline::m_Nanoseconds, CDeadline::m_Seconds, NCBI_THROW, s_SpecialValueName(), and CDeadline::x_SetNowPlus().

Referenced by CNetScheduleNotificationHandler::CmdAppendTimeoutGroupAndClientInfo(), SNetServerImpl::SConnectDeadline::IsExpired(), CDeadline::IsExpired(), SNetServiceImpl::IterateUntilExecOK(), CMainLoopThread::Main(), SRetryProcessing::operator()(), CNetScheduleNotificationHandler::RequestJobWatching(), SGridWorkerNodeImpl::Run(), CNetCacheWriter::TransmitImpl(), SServerNotifications::Wait(), CNetScheduleNotificationHandler::WaitForNotification(), CConditionVariable::x_WaitForSignal(), and CAsyncWriteCache::~CAsyncWriteCache().

Get sign of time span.

Definition at line 2529 of file ncbitime.hpp.

References eNegative, ePositive, eZero, CTimeSpan::m_NanoSec, and CTimeSpan::m_Sec.

Referenced by CTime::AddTimeSpan(), CTimeSpan::AsSmartString(), CTimeSpan::AsString(), CPeriodicTestJob::Run(), CTimeout::Set(), CTimeSpan::x_AsSmartString_Precision(), CTimeSpan::x_AsSmartString_Smart_Big(), CTimeSpan::x_AsSmartString_Smart_Small(), x_FindLatestSequence(), CThreadPool_ServiceThread::x_Idle(), CSyncQueue< Type, Container, Traits >::x_LockAndWait(), CNetStorageHandler::x_ProcessSetExpTime(), CBlockingQueue< TRequest >::x_WaitForPredicate(), and CThreadPool_Impl::x_WaitForPredicate().

Get time in time_t format.

The function return the number of seconds elapsed since midnight (00:00:00), January 1, 1970 UTC. Do not use this function if the year is before 1970.

Returns

Time in time_t format.

Definition at line 1396 of file ncbitime.cpp.

Referenced by python::ConvertCVariant2PCObject(), CSampleTest::CSampleTest(), CTimeToTimeTms(), CNetBlastJobDescriptor::FromUserObject(), CSQLITE3_Cache::GetBlobAccess(), CDBConnectionFactory::CServiceInfo::GetOptions(), CBlobChangelogRecord::GetUpdatedTimePartition(), CWigGraph::Init(), CSubSource::IsCollectionDateAfterTime(), CFileLoadMRUList::LoadFromStrings(), CProjectService::LoadSettings(), CFileLoadManager::LoadSettings(), CGenBankLoadOptionPanel::LoadSettings(), CSQLITE3_Cache::Purge(), CFileObsolete::Remove(), CNcbiApplogApp::Run(), CAsnSubCacheCreateApplication::Run(), s_DumpHeader(), CWigGraph::Save(), SBlobInserter::SBlobInserter(), CDirEntry::SetTime(), CSplitCacheApp::SetupCache(), CConnTest::StatefulOkay(), CSQLITE3_Cache::StoreSynchronous(), CMacroFunction_Date::TheFunction(), CTime::TimeZoneName(), CTime::ToTime(), CTaskViewModel::x_AddTasks(), CTime::x_AdjustTimeImmediately(), CPrimeCacheApplication::x_CacheSeqEntry(), CDumpASNIndex::x_CreateBlob(), CAppTaskService::x_ExecuteNextTaskInQueue(), CPoolBalancer::x_GetServer(), CPoolBalancer::x_InitFromCounts(), CPrimeCacheApplication::x_Process_Fasta(), CPrimeCacheApplication::x_Process_Ids(), and CSQLITE3_Cache::x_SetTimestamp().

Get time zone.

Definition at line 2424 of file ncbitime.hpp.

References CTime::m_Data, and CTime::TData::tz.

Referenced by CTime::DiffSecond(), CTime::GetTimeZoneFormat(), CTime::operator<(), CTime::operator==(), CTime::operator>(), CTime::SetTimeDBI(), CTime::SetTimeDBU(), CTime::ToTime(), CTime::x_AdjustTimeImmediately(), CTime::x_NeedAdjustTime(), and CTime::x_SetTime().

Get hour.

Hours since midnight = 0..23. AsString() format symbol "h".

Definition at line 2274 of file ncbitime.hpp.

References CTime::TData::hour, and CTime::m_Data.

Referenced by python::ConvertCVariant2PCObject(), CTimeToTimeTms(), CTime::DiffSecond(), CTime::IsEmpty(), CTime::IsValid(), CTime::operator<(), CTime::operator==(), CTime::operator>(), s_TimeDump(), CCgiCookie::SetExpTime(), CDate_std::SetToTime(), CTime::TimeZoneOffset(), CTime::x_AddHour(), and CTime::x_AdjustTime().

Definition at line 2723 of file ncbitime.hpp.

References CTimeout::eDefault, and CTimeout::m_Type.

Referenced by CDeadline::CDeadline(), CQueryImpl::Execute(), CQueryImpl::ExecuteSP(), g_CTimeoutToSTimeout(), CCgiContext::GetStreamStatus(), CInterProcessLock::Lock(), CUsageReportAPI::SetTimeout(), CConnHolder::SetTimeout(), CUsageReport::Wait(), and CHttpRequest::x_InitConnection().

Is DST (daylight savings time) in effect for this time?

Note

This method use current DST rules on current machine, so be aware to use it against time in the past or future, because such rules can be changed.

Definition at line 1385 of file ncbitime.cpp.

References CTime::IsEmptyDate(), NCBI_THROW, and s_IsDST().

Is time object empty (date and time)?

Definition at line 2377 of file ncbitime.hpp.

References CTime::Day(), CTime::Hour(), CTime::Minute(), CTime::Month(), CTime::NanoSecond(), CTime::Second(), and CTime::Year().

Referenced by CTime::AsString(), CHttpCookie::AsString(), CApplogUrl::ComposeUrl(), CSeqDB::GetDate(), CHttpCookie::GetExpirationStr(), CELink_Request::GetQueryString(), CESearch_Request::GetQueryString(), CCgiSession::GetSessionCookie(), CVDBMgr::GetTimestamp(), CTimeFunctions::IsDefault(), CHttpCookie::IsExpired(), CTime::IsValid(), CHttpCookie::Parse(), CPerfLogger::Post(), CCgiResponse::SetHeaderValue(), CCgiResponse::SetTrackingCookie(), CPerfLogger::Start(), CTable2AsnContext::UpdateSubmitObject(), CReader::WaitBeforeNewConnection(), CReader::x_AllocConnection(), CAsnSubCacheCreateApplication::x_GetBioseqHandle(), SDiagMessage::x_InitData(), and CPoolBalancer::x_InitFromCounts().

Is date empty?

Definition at line 2385 of file ncbitime.hpp.

References CTime::Year().

Referenced by CTime::AddDay(), CTime::AddMinute(), CTime::AddMonth(), CTime::AddNanoSecond(), CTime::AddSecond(), CTimeToTimeTms(), CTime::DayOfWeek(), CTime::DaysInMonth(), CTime::GetLocalTime(), CTime::GetTimeTM(), CTime::GetUniversalTime(), CTime::IsDST(), CTime::Round(), s_Date2Number(), CTime::ToTime(), CTime::x_AddHour(), and CTime::YearWeekNumber().

Check if the deadline is expired.

Definition at line 1855 of file ncbitime.hpp.

References CDeadline::GetRemainingTime(), CDeadline::IsInfinite(), and CTimeout::IsZero().

Referenced by SNetServerImpl::ConnectAndExec(), CConnTest::ExtraCheckOnFailure(), CNetScheduleGetJobImpl< CMainLoopThread::CImpl >::GetJobImpl(), CTimer::IsExpired(), SSuspendResume::IsJobPullbackTimerExpired(), CDiffBase::IsTimeoutExpired(), CMainLoopThread::Main(), SRetryProcessing::operator()(), s_ConnectToNamedPipe(), CNetScheduleNotificationHandler::WaitForJobCompletion(), CNetScheduleNotificationHandler::WaitForJobEvent(), CUsageReport::x_ThreadHandler(), and CAsyncWriteCache::~CAsyncWriteCache().

Check if timeout holds a numeric value.

Definition at line 2735 of file ncbitime.hpp.

References CTimeout::eFinite, and CTimeout::m_Type.

Referenced by CDeadline::CDeadline(), CRemoteAppLauncher::ExecRemoteApp(), CTimeout::Get(), CTimeout::GetAsDouble(), CTimeout::GetAsMilliSeconds(), CTimeout::GetAsTimeSpan(), CTimeout::GetNano(), CCgiContext::GetStreamStatus(), CTimeout::IsZero(), SNetStorage_NetCacheBlob::SetExpiration(), SNetStorageObjectRPC::SetExpiration(), NDirectNetStorageImpl::CNetCache::SetExpiration(), and CUsageReportAPI::SetTimeout().

Definition at line 2729 of file ncbitime.hpp.

References CTimeout::eInfinite, and CTimeout::m_Type.

Referenced by CDeadline::CDeadline(), CDiff::Diff(), CDiffText::Diff(), g_CTimeoutToSTimeout(), CCgiContext::GetStreamStatus(), CInterProcessLock::Lock(), s_PeekStdin(), CRWLock::TryReadLock(), CSemaphore::TryWait(), CRWLock::TryWriteLock(), CThread::WaitForAllThreads(), and CDiff::x_DiffHalfMatch().

Check state of stopwatch.

Returns

TRUE if stopwatch is "running", FALSE otherwise.

See also

Start, Stop

Definition at line 2835 of file ncbitime.hpp.

References CStopWatch::eStart, and CStopWatch::m_State.

Referenced by CGlWidgetPane::CheckOverlayTimer(), CFileHandleDiagHandler::Post(), CFileDiagHandler::Post(), CSeqEntryPresenter::Process(), CFileHandleDiagHandler::Reopen(), CFileDiagHandler::Reopen(), CFileHandleDiagHandler::WriteMessage(), CFileDiagHandler::WriteMessage(), and CAnnot_Collector::x_SearchMapped().

Is time valid?

Definition at line 2013 of file ncbitime.cpp.

References _ASSERT, CTime::Day(), CTime::Hour(), CTime::IsEmpty(), CTime::IsLeap(), kNanoSecondsPerSecond, CTime::m_Data, CTime::Minute(), CTime::Month(), CTime::NanoSecond(), s_DaysInMonth, CTime::Second(), CTime::TData::tz, and CTime::Year().

Referenced by CTime::AsString(), CTime::CTime(), CTime::SetDay(), CTime::SetMonth(), CTime::SetTimeTM(), CTime::SetYear(), and CTime::x_Init().

Definition at line 3476 of file ncbitime.cpp.

References CTimeout::eDefault, CTimeout::IsFinite(), CTimeout::m_NanoSec, CTimeout::m_Sec, CTimeout::m_Type, NCBI_THROW, and s_SpecialValueName().

Referenced by CDeadline::CDeadline(), CCgiContext::GetStreamStatus(), SNetServerImpl::SConnectDeadline::IsExpired(), CDeadline::IsExpired(), CMainLoopThread::Main(), CTimeout::operator<=(), SGridWorkerNodeImpl::Run(), CUsageReportAPI::SetTimeout(), CRWLock::TryReadLock(), CRWLock::TryWriteLock(), and CJobCommitterThread::WaitForTimeout().

Get minute.

Minutes after the hour = 0..59 AsString() format symbol "m".

Definition at line 2277 of file ncbitime.hpp.

References CTime::m_Data, and CTime::TData::min.

Referenced by CTime::AddMinute(), python::ConvertCVariant2PCObject(), CTimeToTimeTms(), CTime::DiffSecond(), CTime::IsEmpty(), CTime::IsValid(), CTime::operator<(), CTime::operator==(), CTime::operator>(), s_TimeDump(), CCgiCookie::SetExpTime(), CDate_std::SetToTime(), CTime::TimeZoneOffset(), and CTime::x_AdjustTime().

Get month.

Month number = 1..12. AsString() format symbols "M", "B", "b".

Definition at line 2268 of file ncbitime.hpp.

References CTime::m_Data, and CTime::TData::month.

Referenced by CTime::AddMonth(), python::ConvertCVariant2PCObject(), CTimeToTimeTms(), CTime::DayOfWeek(), CTime::DaysInMonth(), CTime::IsEmpty(), CTime::IsValid(), CTime::MonthWeekNumber(), CTime::operator<(), CTime::operator==(), CTime::operator>(), s_Date2Number(), s_TimeDump(), CCgiCookie::SetExpTime(), CDate_std::SetToTime(), CUser_object::UpdateNcbiCleanup(), and CTime::x_AdjustTime().

Get nano-seconds.

Nano-seconds after the second = 0..999999999 AsString() format symbol "S".

See also

MilliSecond, MicroSecond

Definition at line 2289 of file ncbitime.hpp.

References CTime::m_Data, and CTime::TData::nanosec.

Referenced by CTime::AddNanoSecond(), python::ConvertCVariant2PCObject(), CTime::DiffNanoSecond(), CTime::DiffTimeSpan(), CTime::IsEmpty(), CTime::IsValid(), CTime::operator<(), CTime::operator==(), CTime::operator>(), CRandom::Randomize(), s_TimeDump(), and CDirEntry::SetTime().

Operator to test in-equality of time.

Definition at line 2353 of file ncbitime.hpp.

References t.

Operator to test in-equality of timeouts.

Definition at line 2741 of file ncbitime.hpp.

References t.

Operator to test in-equality of time span.

Definition at line 2650 of file ncbitime.hpp.

References t.

Operator to test if time is earlier or equal.

Definition at line 2365 of file ncbitime.hpp.

References t.

Operator to test if timeout is less or equal.

Definition at line 3731 of file ncbitime.cpp.

References COMPARE_TIMEOUT_TYPES, CTimeout::eDefault, CTimeout::eFinite, CTimeout::eInfinite, CTimeout::IsZero(), CTimeout::m_NanoSec, CTimeout::m_Sec, CTimeout::m_Type, NCBI_THROW, s_SpecialValueName(), and t.

Operator to test if time span is less or equal.

Definition at line 2681 of file ncbitime.hpp.

References t.

Assignment operator from string.

If current format contains 'Z', then objects timezone will be set to:

• eUTC if "str" has words "GMT", "UTC" or "Z" (zero UTC offset) in the appropriate position;
• eLocal otherwise. If current format does not contain 'Z', objects timezone will not be changed.

  Note

  This operator expect a string in the format, that was previously set using SetFormat() method.

  See also

  CTime constructor from string, AsString

Definition at line 2336 of file ncbitime.hpp.

References CTime::GetFormat(), str(), and CTime::x_Init().

Operator to test if time is later or equal.

Definition at line 2359 of file ncbitime.hpp.

References t.

Operator to test if time span is greater or equal.

Definition at line 2675 of file ncbitime.hpp.

References t.

Return time elapsed since first Start() or last Restart() call (in seconds).

Start new timer after that. Result is 0.0 if Start() or Restart() wasn't previously called.

Definition at line 2816 of file ncbitime.hpp.

References CStopWatch::eStart, CStopWatch::GetTimeMark(), CStopWatch::m_Start, CStopWatch::m_State, and CStopWatch::m_Total.

Referenced by BOOST_AUTO_TEST_CASE(), CPhyloTreePS::CalcForces(), CNetBLASTUIDataSource::Close(), CDBConnectionFactory::CStopWatchScope::CStopWatchScope(), CDataTool::GenerateCode(), CSeqEntryPresenter::Initialize(), CChainer::CChainerImpl::MakeChains(), CAlignSort::MergeSortedFiles(), CProjectTreePanel::OnDragOver(), CGlWidgetPane::OnEnterWindow(), CPhyTreeView::OnSomethingEdited(), CGlWidgetPane::OnTipRemoved(), CGenBankUIDataSource::Open(), CSeqEntryPresenter::Process(), CBam2GraphApp::ProcessFile(), CFileHandleDiagHandler::Reopen(), CFileDiagHandler::Reopen(), CRequestRateControl::Reset(), CTimeReporter::ResetAll(), CSeqDescrRetrievalJob::Run(), CDemoApp::Run(), CWorkerNodeIdleThread::Schedule(), CFileDiagHandler::SetLogFile(), CRequestContext::StartRequest(), CWorkerNodeIdleThread::Suspend(), CPhyloTreePS::Update(), CUpdateMultiSeq_Dlg::x_CreatePairwiseAlignments(), CRemoteBlast::x_GetSearchResultsHTTP(), and CNetScheduleHandler::x_ProcessBatchStart().

Round time.

Round stored time to specified precision. All time components with precision less that specified will be zero-filled, all other components will be adjusted accordingly to rules for rounding numbers.

Parameters

precision Rounding precision. adl Whether to adjust for daylight saving time. Default is to adjust for daylight saving time. This parameter is for eLocal time zone and where the time zone precision is not eNone.

See also

ERoundPrecision, Truncate

Definition at line 1923 of file ncbitime.cpp.

References CTime::AddDay(), CTime::AddHour(), CTime::AddMinute(), CTime::AddSecond(), CTime::eRound_Day, CTime::eRound_Hour, CTime::eRound_Microsecond, CTime::eRound_Millisecond, CTime::eRound_Minute, CTime::eRound_Second, CTime::TData::hour, CTime::IsEmptyDate(), kNanoSecondsPerSecond, CTime::m_Data, CTime::TData::min, CTime::TData::nanosec, NCBI_THROW, precision, CTime::TData::sec, and CTime::Truncate().

Referenced by CApplogUrl::ComposeUrl().

Get second.

Seconds after the minute = 0..59 AsString() format symbol "s".

Definition at line 2280 of file ncbitime.hpp.

References CTime::m_Data, and CTime::TData::sec.

Referenced by CTime::AddSecond(), python::ConvertCVariant2PCObject(), CTimeToTimeTms(), CTime::DiffSecond(), CTime::IsEmpty(), CTime::IsValid(), CTime::operator<(), CTime::operator==(), CTime::operator>(), CRandom::Randomize(), s_TimeDump(), CCgiCookie::SetExpTime(), CDate_std::SetToTime(), and CTime::TimeZoneOffset().

Set from CTimeSpan.

Definition at line 3630 of file ncbitime.cpp.

References CTimeSpan::AsString(), CTimeout::eFinite, eNegative, CTimeSpan::GetCompleteSeconds(), CTimeSpan::GetNanoSecondsAfterSecond(), CTimeSpan::GetSign(), int, kMax_UInt, CTimeout::m_NanoSec, CTimeout::m_Sec, CTimeout::m_Type, and NCBI_THROW.

Set special value.

Definition at line 3577 of file ncbitime.cpp.

References CTimeout::eDefault, CTimeout::eFinite, CTimeout::eInfinite, CTimeout::eZero, NStr::IntToString(), CTimeout::m_Type, NCBI_THROW, and type.

Referenced by CCDDClientPool::CCDDClientPool(), CTimeout::CTimeout(), SInputValidator::GetDeadline(), CNcbiApplogApp::Redirect(), NDirectNetStorageImpl::CNetCache::SetExpiration(), CNSTDatabase::SetParameters(), CHttpRequest::SetTimeout(), CUsageReport::Wait(), CEutilsClient::x_InitParams(), and CNetStorageHandler::x_ProcessSetExpTime().

Make the time current in the presently active time zone.

Definition at line 2301 of file ncbitime.hpp.

References CTime::x_SetTimeMTSafe().

Referenced by SThrottleStats::Adjust(), CHttpCookie::AsString(), CApplogUrl::ComposeUrl(), CTime::CTime(), CScheduler_ExecThread_Impl::Main(), CHttpCookie::Parse(), CNcbiApplogApp::Run(), CXcompareAnnotsApplication::Run(), CGBProject_ver2::SetDirtyFlag(), CCurrentTime::Update(), CTime::x_Init(), and CPoolBalancer::x_InitFromCounts().

Set the current time format.

The default format is: "M/D/Y h:m:s".

Parameters

fmt An object contains string of symbols describing the time format and its type. The following format letters have the special meaning:

• Y = year with century
• y = year without century (00-99)
• M = month as decimal number (01-12)
• B = full month name (January-December)
• b = abbreviated month name (Jan-Dec)
• D = day as decimal number (01-31)
• d = day as decimal number (w/o 0) (1-31)
• H = hour in 12-hour format (00-12)
• h = hour in 24-hour format (00-23)
• m = minute as decimal number (00-59)
• s = second as decimal number (00-59)
• l = milliseconds as decimal number (000-999)
• r = microseconds as decimal number (000000-999999)
• S = nanosecond as decimal number (000000000-999999999)
• G = seconds and fraction part of second as double value ("s.nnn") with floating number (1-9) of digits after dot.
• g = same as "G" but w/o leading "0" if number of seconds < 10.
• P = am/pm (AM/PM)
• p = am/pm (am/pm)
• W = full day of week name (Sunday-Saturday)
• w = abbreviated day of week name (Sun-Sat)
• Z = UTC timezone designator (GMT/UTC/Z or none)

following available on POSIX platforms only:

• z = timezone shift ([GMT/UTC]+/-HHMM)
• o = timezone shift (+/-HH:MM)

Format string can represent date/time partially, in this case current time, or default values, will be used to amplify time object, if possible. Current date/time cannot be used if format string contains "z" (time shift) format symbol. Also, it cannot be used if time format is ambiguous, like "Y/D". Note, that you still can use "Y/M", or even "Y", where month and day will be defined as 1; or "M/D", where year will be set as the current year.

See also

CTimeFormat, GetFormat, AsString

Definition at line 1268 of file ncbitime.cpp.

References s_TlsFormatTime.

Referenced by CPepXML::ConvertFromOMSSA().

Set the current time span format.

The default format is: "-S.n".

Parameters

format An object contains string of letters describing the time format and its type. The format letters have the following meanings:

• - = add minus for negative time spans
• d = number of whole days
• H = total whole number of hours stored in the time span
• h = hours, "H" modulo 24 (-23 - 23)
• M = total whole number of minutes stored in the time span
• m = minutes, "M" modulo 60 (-59 - 59)
• S = total whole number of seconds stored in the time span
• s = seconds, "S" modulo 60 (-59 - 59)
• N = total whole number of nanoseconds stored in the time span
• n = nanoseconds (-999999999 - 999999999)
• G = total whole number of seconds and part of second as double value ("S.n") with floating number (1-9) of digits after dot.
• g = seconds, "S" modulo 60 and part of second as double value ("s.n") with floating number (1-9) of digits after dot.

See also

CTimeFormat, GetFormat, AsString

Definition at line 2659 of file ncbitime.cpp.

References s_TlsFormatSpan.

Set the current time format.

Parameters

fmt String of symbols describing the time format. flags Flags specifying how to match a time string against format string.

See also

GetFormat, EFormat, CTime::SetFormat, CTimeSpan::SetFormat

Definition at line 352 of file ncbitime.cpp.

References f, CTimeFormat::fFormat_Ncbi, CTimeFormat::fFormat_Simple, flags, CTimeFormat::fMatch_Strict, CTimeFormat::fMatch_Weak, CTimeFormat::m_Flags, CTimeFormat::m_Str, and NCBI_THROW.

Set month.

Beware that this operation is inherently inconsistent. In case of different number of days in the months, the day number can change, e.g.:

• "Dec 31 2000".SetMonth(2) => "Feb 29 2000". Therefore e.g. calling SetMonth(1) again that result will be "Jan 28".

  Parameters

  month Month number to set. Month number = 1..12.

  See also

  Month

Definition at line 1057 of file ncbitime.cpp.

References CHECK_RANGE_MONTH, CTime::TData::day, CTime::DaysInMonth(), NStr::IntToString(), CTime::IsValid(), CTime::m_Data, NCBI_THROW, SET_DAY, and SET_MONTH.

Set nanoseconds.

Parameters

nanosecond Nanoseconds after the second = 0..999999999.

See also

NanoSecond, SetMilliSecond, SetMicroSecond

Definition at line 1127 of file ncbitime.cpp.

References CHECK_RANGE_NSEC, CTime::m_Data, and CTime::TData::nanosec.

Referenced by CTarEntryInfo::GetCreationCTime(), CTarEntryInfo::GetLastAccessCTime(), CFastLocalTime::GetLocalTime(), CTarEntryInfo::GetModificationCTime(), CDirEntry::GetTime(), CTar::x_RestoreAttrs(), and CFastLocalTime::x_Tuneup().

Set time using database format time, TDBTimeI.

Object's time format will always change to eLocal after call.

Parameters

t Time to set in time object in TDBTimeI format. This is always in local time format, and seconds, and nanoseconds will be truncated.

Returns

Time object that is set.

Definition at line 1496 of file ncbitime.cpp.

References CTime::AddDay(), CTime::AddNanoSecond(), CTime::AddSecond(), CTime::eLocal, CTime::GetTimeZone(), CTime::GetTimeZonePrecision(), kNanoSecondsPerSecond, CTime::SetTimeZonePrecision(), t, and CTime::ToTime().

Referenced by CDB_DateTime::Value().

Set time using database format time, TDBTimeU.

Object's time format will always change to eLocal after call.

Parameters

t Time to set in time object in TDBTimeU format. This is always in local time format, and seconds, and nanoseconds will be truncated.

Returns

Time object that is set.

Definition at line 1481 of file ncbitime.cpp.

References CTime::AddDay(), CTime::AddMinute(), CTime::eLocal, CTime::GetTimeZone(), CTime::GetTimeZonePrecision(), CTime::SetTimeZonePrecision(), t, and CTime::ToTime().

Referenced by CDB_SmallDateTime::Value().

Set time using time_t time value.

Parameters

t Time to set in time object. This is always in UTC time format, and nanoseconds will be truncated.

Returns

Time object that is set.

Definition at line 2298 of file ncbitime.hpp.

References t, and CTime::x_SetTimeMTSafe().

Referenced by CScheduler_MT::CScheduler_MT(), CTime::CTime(), CDirEntry::GetTime(), CCgi2RCgiApp::PopulatePage(), CGridCommandLineInterfaceApp::PrintBlobMeta(), CNcbiApplogApp::Run(), s_GetBlobMeta(), CConnTest::StatefulOkay(), and CScheduler_MT::x_SchedQueueChanged().

Set time using "struct tm" time value.

Parameters

t Time to set in time object. This time always represents a local time in current time zone. Time object will be set to have eLocal time format, and nanoseconds will be truncated. Note that all significant fields in the time structure should be set and have correct vales, otherwise exception will be thrown.

Returns

Time object that is set.

Definition at line 1424 of file ncbitime.cpp.

References CTime::TData::adjTimeDiff, CHECK_RANGE_DAY, CHECK_RANGE_HOUR, CHECK_RANGE_MIN, CHECK_RANGE_MONTH, CHECK_RANGE_SEC, CHECK_RANGE_YEAR, CTime::eLocal, CTime::IsValid(), CTime::m_Data, CTime::TData::nanosec, NCBI_THROW, s_TimeDump(), SET_DAY, SET_HOUR, SET_MIN, SET_MONTH, SET_SEC, SET_YEAR, t, and CTime::TData::tz.

Referenced by CTime::CTime().

Set year.

Beware that this operation is inherently inconsistent. In case of different number of days in the months, the day number can change, e.g.:

• "Feb 29 2000".SetYear(2001) => "Feb 28 2001". Because 2001 is not leap year.

  Parameters

  See also

  Year

Definition at line 1040 of file ncbitime.cpp.

References CHECK_RANGE_YEAR, CTime::TData::day, CTime::DaysInMonth(), NStr::IntToString(), CTime::IsValid(), CTime::m_Data, NCBI_THROW, SET_DAY, and SET_YEAR.

Start the timer.

Do nothing if already started.

Definition at line 2764 of file ncbitime.hpp.

References CStopWatch::eStart, CStopWatch::GetTimeMark(), CStopWatch::m_Start, and CStopWatch::m_State.

Referenced by BlastdbCopyApplication::BlastdbCopyApplication(), BOOST_AUTO_TEST_CASE(), IPhyloTreeRender::BufferedRender(), CHitClustering::Build(), CPhyloTreePS::CalcForces(), CBamFileInfo::CBamFileInfo(), CBDB_SplitCursor< BDB_SplitStore, BDB_Vol >::CBDB_SplitCursor(), CBlastDBAliasApp::CBlastDBAliasApp(), CBlastDbBioseqSource::CBlastDbBioseqSource(), CBlastDbCheckApplication::CBlastDbCheckApplication(), CBlastDBCmdApp::CBlastDBCmdApp(), CBlastdbConvertApp::CBlastdbConvertApp(), CBlastFormatterApp::CBlastFormatterApp(), CBlastFormatterVdbApp::CBlastFormatterVdbApp(), CBlastMasterNode::CBlastMasterNode(), CBlastnApp::CBlastnApp(), CBlastpApp::CBlastpApp(), CBlastVdbCmdApp::CBlastVdbCmdApp(), CBlastxApp::CBlastxApp(), CConvert2BlastMaskApplication::CConvert2BlastMaskApplication(), CDeltaBlastApp::CDeltaBlastApp(), CMagicBlastApp::CMagicBlastApp(), CMakeBlastDBApp::CMakeBlastDBApp(), CMakeClusterDBApp::CMakeClusterDBApp(), CMakeProfileDBApp::CMakeProfileDBApp(), CMultiApplication::CMultiApplication(), ConvertToPairwise(), CPsiBlastApp::CPsiBlastApp(), CRPSBlastApp::CRPSBlastApp(), CRPSTBlastnApp::CRPSTBlastnApp(), CStopWatch::CStopWatch(), CTblastnApp::CTblastnApp(), CTblastxApp::CTblastxApp(), CVDBBlastnApp::CVDBBlastnApp(), CVDBTblastnApp::CVDBTblastnApp(), CExecute::Exec(), CChangePhyloTreeCommand::Execute(), CChangePhyloPropertyCmd::Execute(), CChangePhyloExpandCollapseCmd::Execute(), CQueryParsePanel::CQueryJob::Execute(), CMacroWorker::ExecuteMacros(), CFlatFileGenerator::Generate(), GetBlobReader(), CSNPDataLoader_Impl::GetChunkOnce(), CSNPFileInfo::InitializeDb(), CProcess::Kill(), CProcess::KillGroup(), IPhyloTreeRender::Layout(), CBamRefSeqInfo::LoadAlignChunk(), CSNPDataLoader_Impl::LoadBlob(), CBamRefSeqInfo::LoadMainSplit(), CBamRefSeqInfo::LoadPileupChunk(), CBamRefSeqInfo::LoadSeqChunk(), CIgBlastnApp::CIgWorker::Main(), CPhyTreeView::OnBioTreeChanged(), CSeqGraphicWidget::OnDataChanged(), CPhyTreeView::OnSomethingEdited(), CLBLASTUIDataSource::Open(), CNetBLASTUIDataSource::Open(), CBamUIDataSource::Open(), CGenBankUIDataSource::Open(), CSQLITE3_Cache::Open(), IPhyloTreeRender::PointToNode(), CTableFormatPanel::PreviewData(), CDeflineProcess::ProcessInitialize(), CSeqVectorProcess::ProcessInitialize(), CGlCgiImageApplication::ProcessRequest(), CTreeGraphicsModel::Render(), IPhyloTreeRender::Render(), CSeqDescrRetrievalJob::Run(), CAnnotMetaDataJob::Run(), CPubmedFetchApplication::Run(), CBlastInputDemoApplication::Run(), CAsnCacheTestApplication::Run(), CCacheIndexCopyApp::Run(), CConcatSeqEntriesApplication::Run(), CAsnCacheDumpSeqIdsApplication::Run(), CPrimeCacheApplication::Run(), CAsnSubCacheCreateApplication::Run(), CWalkAsnCacheApplication::Run(), CMytestApplication::Run(), CProjBulderApp::Run(), CObjConvProfile::Run(), CConvImageApp::Run(), CSubImageApp::Run(), CDbapiTestSpeedApp::RunSample(), s_GetDBTree(), CAlignSort::SAlignExtractor::SAlignExtractor(), CGBenchService::SendAppStart(), CPerfLogger::Start(), SW::SW(), CChangePhyloExpandCollapseCmd::Unexecute(), CPhyloTreePS::Update(), CAsnSubCacheCreateApplication::WriteBlobsInSubCache(), CBamRefSeqInfo::x_AddSeqChunk(), CPrimeCacheApplication::x_CacheSeqEntry(), CForceJob::x_Calculate(), CImportFeatTable::x_CreateCommand(), CAlnMultiDSBuilder::x_CreateSparseDataSource(), CComponentSearchJob::x_DoSearch(), CVcfSearchJob::x_DoSearch(), CCrossPanelIR::x_DrawCrossAlignment(), CNAUtils::x_GetAllNAIds(), CNAUtils::x_GetNAMetaData(), CRemoteBlast::x_GetSearchResultsHTTP(), CBlastVdbCmdApp::x_GetVDBBlastUtil(), CFast5colReader::x_IndexFile(), CAnnot_Collector::x_Initialize0(), CCSRARefSeqInfo::x_LoadRangesStat(), BlastdbCopyApplication::x_MakeDBwIDList(), CWorkspaceAutoSaver::x_OnSave(), CBlastVdbCmdApp::x_PrintBlastDatabaseInformation(), CBlastVdbCmdApp::x_PrintVDBPaths(), CPrimeCacheApplication::x_Process_Fasta(), CPrimeCacheApplication::x_Process_Ids(), CPhyloTreePane::x_Render(), CPhyloSlantedCladogram::x_RenderVbo(), IPhyloTreeRender::x_SetElementVisibility(), CAlignTabExportPage2::x_StartNAAlignNamesJob(), and CEditObjectFeaturePropagate::xGetEditCommandAllSequences().

Suspend the timer.

Next Start() call continue to count time accured before.

Definition at line 2792 of file ncbitime.hpp.

References CStopWatch::eStop, CStopWatch::GetTimeMark(), CStopWatch::m_Start, CStopWatch::m_State, and CStopWatch::m_Total.

Referenced by BOOST_AUTO_TEST_CASE(), CPhyloTreePS::CalcForces(), CBlastDbBioseqSource::CBlastDbBioseqSource(), CNetBLASTUIDataSource::Close(), CompressAssembly(), CSeqEntryPresenter::Finalize(), CNcbiTestApplication::InitTestFramework(), CBamRefSeqInfo::LoadAlignChunk(), CConnTestThread::Main(), CProjectTreePanel::OnBeginDrag(), CSeqGraphicWidget::OnDataChanged(), CProjectTreePanel::OnDragOver(), CProjectTreePanel::OnEndDrag(), CAppDialogs::OpenViewlDialog(), CSeqEntryPresenter::Process(), CAnnotMetaDataJob::Run(), CPubmedFetchApplication::Run(), CBlastInputDemoApplication::Run(), CGBenchService::SendAppFinish(), CWorkerNodeIdleThread::Suspend(), CPerfLogger::Suspend(), UncomressAndCreate(), CPhyloTreePS::Update(), CNAUtils::x_GetAllNAIds(), CNAUtils::x_GetNAMetaData(), CRemoteBlast::x_GetSearchResultsHTTP(), CBlastVdbCmdApp::x_GetVDBBlastUtil(), CFast5colReader::x_IndexFile(), BlastdbCopyApplication::x_MakeDBwIDList(), CWorkspaceAutoSaver::x_OnSave(), CBlastVdbCmdApp::x_PrintBlastDatabaseInformation(), CBlastVdbCmdApp::x_PrintVDBPaths(), CAnnot_Collector::x_StopSearchLimits(), and CDBConnectionFactory::CStopWatchScope::~CStopWatchScope().

Convert the time into local time.

Definition at line 2464 of file ncbitime.hpp.

References CTime::eLocal, and CTime::ToTime().

Referenced by CApplogUrl::ComposeUrl(), CwxLogDiagHandler::DoLogRecord(), GetNetBlastJobDescription(), SLazyInitData::GetTime(), CEventViewModel::GetValueAt(), NS_FormatPreciseTime(), NST_FormatPreciseTime(), operator<<(), PopulateEntry(), s_DumpHeader(), CGenBankLoadOptionPanel::SaveMruAccessions(), CProjectService::SaveSettings(), CFileLoadManager::SaveSettings(), CFileLoadMRUList::SaveToStrings(), sFormatTimePeriod(), CBlobStatusHistoryRecord::ToString(), CTime::x_AdjustTimeImmediately(), and CMessageSlotPopupWindow::x_CreateMessageSlotPanel().

Convert the time into specified time zone time.

Definition at line 2074 of file ncbitime.cpp.

References CTime::eLocal, CTime::GetTimeT(), CTime::GetTimeZone(), CTime::IsEmptyDate(), CTime::m_Data, NCBI_THROW, CGuard< Resource, Lock, Unlock, ReportExceptions >::Release(), SET_DAY, SET_HOUR, SET_MIN, SET_MONTH, SET_SEC, SET_YEAR, t, and CTime::TData::tz.

Referenced by CTime::SetTimeDBI(), CTime::SetTimeDBU(), CTime::ToLocalTime(), and CTime::ToUniversalTime().

Truncate time.

Truncate stored time to specified precision. All time components with precision less that specified will be zero-filled. By default method strips hours, minutes, seconds and nanoseconds.

Parameters

precision Truncating precision.

See also

ERoundPrecision, Round

Definition at line 1970 of file ncbitime.cpp.

References CTime::eRound_Day, CTime::eRound_Hour, CTime::eRound_Microsecond, CTime::eRound_Millisecond, CTime::eRound_Minute, CTime::eRound_Second, CTime::TData::hour, CTime::m_Data, CTime::TData::min, CTime::TData::nanosec, precision, and CTime::TData::sec.

Referenced by CTime::Round().

Helper method to add hour with/without shift time.

Parameter "shift_time" access or denied use time shift in process adjust hours.

Definition at line 1820 of file ncbitime.cpp.

References CTime::AddDay(), CTime::CTime(), CTime::eAdjustDaylight, CTime::eIgnoreDaylight, CTime::Hour(), CTime::IsEmptyDate(), kEmptyStr, NCBI_THROW, s_Offset(), SET_HOUR, CTime::x_AdjustTime(), and CTime::x_NeedAdjustTime().

Referenced by CTime::AddHour(), and CTime::x_AdjustTimeImmediately().

Helper method to adjust the time to correct timezone (across the barrier of winter & summer times) using "from" as a reference point.

This does the adjustment only if the time object:

• contains local time, and
• has TimeZonePrecision != CTime::eNone, and
• differs from "from" in the TimeZonePrecision (or larger) part.

Definition at line 2340 of file ncbitime.cpp.

References CTime::Day(), CTime::eDay, CTime::eHour, CTime::eMinute, CTime::eMonth, CTime::GetTimeZonePrecision(), CTime::Hour(), CTime::Minute(), CTime::Month(), CTime::x_AdjustTimeImmediately(), and CTime::x_NeedAdjustTime().

Referenced by CTime::AddDay(), CTime::AddMinute(), CTime::AddMonth(), and CTime::x_AddHour().

Helper method to forcibly adjust timezone using "from" as a reference point.

Definition at line 2365 of file ncbitime.cpp.

References CTime::TData::adjTimeDiff, CTime::eAdjustDaylight, CTime::eLocal, CTime::GetTimeT(), CTime::GetTimeZone(), CTime::GetTimeZonePrecision(), CTime::m_Data, CGuard< Resource, Lock, Unlock, ReportExceptions >::Release(), CTime::SetTimeZonePrecision(), t, CTime::TimeZoneOffset(), tmp, CTime::ToLocalTime(), and CTime::x_AddHour().

Referenced by CTime::x_AdjustTime().

Definition at line 3009 of file ncbitime.cpp.

References _ASSERT, CTimeSpan::CTimeSpan(), eDay, eHour, eMicrosecond, eMillisecond, eMinute, eMonth, eNanosecond, eNegative, ePrecision, eSecond, eYear, flags, CTimeSpan::fSS_Full, CTimeSpan::fSS_PrecisionMask, CTimeSpan::fSS_Round, CTimeSpan::fSS_SkipZero, CTimeSpan::fSS_Smart, CTimeSpan::GetCompleteSeconds(), CTimeSpan::GetNanoSecondsAfterSecond(), CTimeSpan::GetSign(), i, kAverageSecondsPerMonth, kAverageSecondsPerYear, kNanoSecondsPerSecond, kTimeSpanUnitMultipliers, kUnitNames, NStr::LongToString(), SUnitName::name_full, SUnitName::name_short, precision, result, string, val, and rapidjson::value.

Referenced by CTimeSpan::AsSmartString().

Helpers for AsSmartString()

Definition at line 2805 of file ncbitime.cpp.

References _ASSERT, CTimeSpan::CTimeSpan(), eDay, eHour, eMicrosecond, eMinute, eMonth, eNegative, eSecond, eYear, flags, CTimeSpan::fSS_Full, CTimeSpan::fSS_Round, CTimeSpan::fSS_Smart, CTimeSpan::GetCompleteSeconds(), CTimeSpan::GetSign(), kAverageSecondsPerMonth, kAverageSecondsPerYear, kNanoSecondsPerSecond, kTimeSpanUnitMultipliers, kUnitNames, NStr::LongToString(), SUnitName::name_full, SUnitName::name_short, result, string, and val.

Referenced by CTimeSpan::AsSmartString().

Definition at line 2907 of file ncbitime.cpp.

References _ASSERT, CTimeSpan::CTimeSpan(), eMicrosecond, eMillisecond, eNanosecond, eNegative, eSecond, flags, CTimeSpan::fSS_Full, CTimeSpan::fSS_Round, CTimeSpan::fSS_Smart, CTimeSpan::GetNanoSecondsAfterSecond(), CTimeSpan::GetSign(), int, kUnitNames, len, NStr::LongToString(), n, SUnitName::name_full, SUnitName::name_short, result, string, v2, and CTimeSpan::x_Second().

Referenced by CTimeSpan::AsSmartString().

Helper method to set time value from string "str" using format "fmt".

Definition at line 2480 of file ncbitime.cpp.

References CTimeSpan::Clear(), f, CTimeFormat::fFormat_Simple, CTimeFormat::fMatch_ShortFormat, CTimeFormat::fMatch_ShortTime, format, CTimeSpan::Invert(), isdigit(), kFormatEscapeSymbol, kFormatSymbolsSpan, len, CTimeSpan::m_NanoSec, CTimeSpan::m_Sec, n, NCBI_THROW, str(), NStr::StringToLong(), rapidjson::value, and CTimeSpan::x_Normalize().

Referenced by CTimeSpan::CTimeSpan(), and CTimeSpan::operator=().

Helper method to set time value from string "str" using format "fmt".

Definition at line 507 of file ncbitime.cpp.

References _ASSERT, CTime::AddSecond(), CHECK_RANGE2_DAY, CHECK_RANGE2_HOUR12, CHECK_RANGE2_HOUR24, CHECK_RANGE2_MIN, CHECK_RANGE2_MONTH, CHECK_RANGE2_NSEC, CHECK_RANGE2_SEC, CHECK_RANGE2_YEAR, CTime::Clear(), CTime::TData::day, CTime::DayOfWeek(), CTime::eErr_Throw, CTime::eIgnoreDaylight, CTime::eLocal, CTime::eUTC, NStr::fAllowTrailingSymbols, CTimeFormat::fFormat_Simple, CTimeFormat::fMatch_IgnoreSpaces, CTimeFormat::fMatch_ShortFormat, CTimeFormat::fMatch_ShortTime, CTimeFormat::fMatch_Weak, STzFormatCheck::fmt(), format, CTime::TData::hour, i, NStr::IntToString(), isdigit(), isspace(), CTime::IsValid(), kFormatEscapeSymbol, kFormatSymbolsTime, kMonthAbbr, kMonthFull, kWeekdayAbbr, kWeekdayFull, len, CTime::m_Data, CTime::TData::month, n, CTime::TData::nanosec, SET_DAY, SET_HOUR, SET_MIN, SET_MONTH, SET_SEC, SET_YEAR, CTime::SetCurrent(), SKIP_SPACES, str(), STzFormatCheck::str(), NStr::StringToLong(), NStr::strncasecmp(), CTime::TData::tz, rapidjson::value, X_INIT_ERROR, and CTime::TData::year.

Referenced by CTime::CTime(), and CTime::operator=().

Helper method to set time from 'time_t' – If "t" not specified, then set to current time.

Definition at line 1710 of file ncbitime.cpp.

References CTime::TData::adjTimeDiff, CHECK_RANGE_NSEC, CTime::eLocal, CTime::GetCurrentTimeT(), CTime::GetTimeZone(), CTime::m_Data, CTime::TData::nanosec, NCBI_THROW, SET_DAY, SET_HOUR, SET_MIN, SET_MONTH, SET_SEC, SET_YEAR, t, and rapidjson::value.

Referenced by CTime::x_SetTimeMTSafe(), and CFastLocalTime::x_Tuneup().

Internal version of Tuneup()

Definition at line 3957 of file ncbitime.cpp.

References Daylight, int, CFastLocalTime::m_Daylight, CFastLocalTime::m_IsTuneup, CFastLocalTime::m_LastSysTime, CFastLocalTime::m_LastTuneupTime, CFastLocalTime::m_LocalTime, CFastLocalTime::m_Timezone, CFastLocalTime::m_TunedTime, NULL, CGuard< Resource, Lock, Unlock, ReportExceptions >::Release(), CTime::SetNanoSecond(), SwapPointers(), TimeZone, and CTime::x_SetTime().

Referenced by CFastLocalTime::GetLocalTime(), CFastLocalTime::GetLocalTimezone(), and CFastLocalTime::Tuneup().

Get year.

Year = 1900 .. AsString() format symbols "Y", "y".

Definition at line 2265 of file ncbitime.hpp.

References CTime::m_Data, and CTime::TData::year.

Referenced by CTime::AddMonth(), python::ConvertCVariant2PCObject(), CTimeToTimeTms(), CTime::DayOfWeek(), get_full_date(), CTime::IsEmpty(), CTime::IsEmptyDate(), CTime::IsLeap(), CTime::IsValid(), CTime::MonthWeekNumber(), CTime::operator<(), CTime::operator==(), CTime::operator>(), s_Date2Number(), s_TimeDump(), CCgiCookie::SetExpTime(), CDate_std::SetToTime(), CUser_object::UpdateNcbiCleanup(), and CTime::YearDayNumber().

The average length of the year in the Gregorian (modern) calendar (in days)

Definition at line 99 of file ncbitime.hpp.

Number of microseconds in one second.

Interval for it is from 0 to 999,999.

Definition at line 91 of file ncbitime.hpp.

Referenced by CDeadline::CDeadline(), CConnTest::ExtraCheckOnFailure(), CTimeout::Get(), CTime::GetCurrentTimeT(), CSystemInfo::GetUptime(), operator>(), CTL_CursorResultExpl::ReadItem(), s_SetTimeout(), CTimeout::Set(), CNcbiApplogApp::SetInfo(), CDirEntry::SetTime(), CRequestRateControl::Sleep(), SleepMicroSec(), SleepMilliSec(), SleepSec(), and CDeadline::x_SetNowPlus().

Number milliseconds in one second.

Interval for it is from 0 to 999.

Definition at line 96 of file ncbitime.hpp.

Referenced by CTimeout::GetAsMilliSeconds(), CSystemInfo::GetUptime(), SNetServiceImpl::Init(), CProcess::Kill(), CMainLoopThread::Main(), SRetryProcessing::operator()(), s_FileTimeToCTime(), s_GetTime(), s_Win_KillGroup(), SleepMicroSec(), and SleepMilliSec().

Number of nanoseconds in one second.

Interval for it is from 0 to 999,999,999.

Definition at line 86 of file ncbitime.hpp.

Referenced by CTime::AddNanoSecond(), CTimeSpan::AssignFromSmartString(), CDeadline::CDeadline(), CTimeSpan::CTimeSpan(), CTime::DiffNanoSecond(), CConnTest::ExtraCheckOnFailure(), CTimeout::Get(), CTimeSpan::GetAsDouble(), CTimeout::GetAsDouble(), CTimeout::GetAsMilliSeconds(), CTime::GetCurrentTimeT(), CTL_RowResult::GetItemInternal(), CDeadline::GetRemainingTime(), CTime::GetTimeDBI(), CSystemInfo::GetUptime(), CTime::IsValid(), CTime::Round(), s_FileTimeToCTime(), CTimeSpan::Set(), CTimeout::Set(), CNcbiApplogApp::SetInfo(), CTimeout::SetNano(), CDirEntry::SetTime(), CTime::SetTimeDBI(), SleepMicroSec(), CTimeSpan::x_AsSmartString_Precision(), CTimeSpan::x_AsSmartString_Smart_Big(), CTimeSpan::x_Normalize(), CDeadline::x_SetNowPlus(), and CBlockingQueue< TRequest >::x_WaitForPredicate().

Packed members.

Definition at line 1263 of file ncbitime.hpp.

Referenced by CTime::AddNanoSecond(), CTime::Clear(), CTime::CTime(), CTime::Day(), CTime::GetTimeZone(), CTime::GetTimeZonePrecision(), CTime::Hour(), CTime::IsLocalTime(), CTime::IsUniversalTime(), CTime::IsValid(), CTime::MicroSecond(), CTime::MilliSecond(), CTime::Minute(), CTime::Month(), CTime::NanoSecond(), CTime::operator=(), CTime::Round(), CTime::Second(), CTime::SetMicroSecond(), CTime::SetMilliSecond(), CTime::SetMonth(), CTime::SetNanoSecond(), CTime::SetTimeTM(), CTime::SetTimeZone(), CTime::SetTimeZonePrecision(), CTime::SetYear(), CTime::ToTime(), CTime::Truncate(), CTime::x_AdjustTimeImmediately(), CTime::x_Init(), CTime::x_SetTime(), and CTime::Year().

Nanoseconds after the second.

Definition at line 1680 of file ncbitime.hpp.

Referenced by CTimeSpan::AssignFromSmartString(), CTimeSpan::Clear(), CTimeSpan::CTimeSpan(), CTimeSpan::GetAsDouble(), CTimeSpan::GetNanoSecondsAfterSecond(), CTimeSpan::GetSign(), CTimeSpan::Invert(), CTimeSpan::IsEmpty(), CTimeSpan::operator+(), CTimeSpan::operator+=(), CTimeSpan::operator-(), CTimeSpan::operator-=(), CTimeSpan::operator<(), CTimeSpan::operator=(), CTimeSpan::operator==(), CTimeSpan::operator>(), CTimeSpan::Set(), CTimeSpan::x_Init(), and CTimeSpan::x_Normalize().

Nanoseconds part of the timeout.

Definition at line 1796 of file ncbitime.hpp.

Referenced by CTimeout::Get(), CTimeout::GetAsDouble(), CTimeout::GetAsMilliSeconds(), CTimeout::GetAsTimeSpan(), CTimeout::GetNano(), CTimeout::IsZero(), CTimeout::operator<(), CTimeout::operator<=(), CTimeout::operator==(), CTimeout::operator>(), CTimeout::operator>=(), CTimeout::Set(), and CTimeout::SetNano().

Seconds part of the time span.

Definition at line 1679 of file ncbitime.hpp.

Referenced by CTimeSpan::AssignFromSmartString(), CTimeSpan::Clear(), CTimeSpan::CTimeSpan(), CTimeSpan::GetAsDouble(), CTimeSpan::GetCompleteDays(), CTimeSpan::GetCompleteHours(), CTimeSpan::GetCompleteMinutes(), CTimeSpan::GetCompleteSeconds(), CTimeSpan::GetSign(), CTimeSpan::Invert(), CTimeSpan::IsEmpty(), CTimeSpan::operator+(), CTimeSpan::operator+=(), CTimeSpan::operator-(), CTimeSpan::operator-=(), CTimeSpan::operator<(), CTimeSpan::operator=(), CTimeSpan::operator==(), CTimeSpan::operator>(), CTimeSpan::Set(), CTimeSpan::x_Hour(), CTimeSpan::x_Init(), CTimeSpan::x_Minute(), CTimeSpan::x_Normalize(), and CTimeSpan::x_Second().

Seconds part of the timeout.

Definition at line 1795 of file ncbitime.hpp.

Referenced by CTimeout::Get(), CTimeout::GetAsDouble(), CTimeout::GetAsMilliSeconds(), CTimeout::GetAsTimeSpan(), CTimeout::GetNano(), CTimeout::IsZero(), CTimeout::operator<(), CTimeout::operator<=(), CTimeout::operator==(), CTimeout::operator>(), CTimeout::operator>=(), CTimeout::Set(), and CTimeout::SetNano().

Type of timeout.

Definition at line 1794 of file ncbitime.hpp.

Referenced by CTimeout::Get(), CTimeout::GetAsDouble(), CTimeout::GetAsMilliSeconds(), CTimeout::GetAsTimeSpan(), CTimeout::GetNano(), CTimeout::IsDefault(), CTimeout::IsFinite(), CTimeout::IsInfinite(), CTimeout::IsZero(), CTimeout::operator<(), CTimeout::operator<=(), CTimeout::operator==(), CTimeout::operator>(), CTimeout::operator>=(), CTimeout::Set(), and CTimeout::SetNano().

Definition at line 1261 of file ncbitime.hpp.

Referenced by CTime::AddNanoSecond(), CTime::Clear(), CTime::CTime(), CTime::MicroSecond(), CTime::MilliSecond(), CTime::NanoSecond(), CTime::Round(), CTime::SetMicroSecond(), CTime::SetMilliSecond(), CTime::SetNanoSecond(), CTime::SetTimeTM(), CTime::Truncate(), CTime::x_Init(), and CTime::x_SetTime().

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4