Time

public static TimeInstance Singleton { get; }

Borrowed wrapper of the global Time service. Repeated access uses a cached wrapper; do not Free/Dispose it. Use static methods for ordinary calls.

public static Reckfell.Collections.Dictionary GetDateDictFromSystem(bool utc = false);

Reads current OS year, month, day and weekday. utc=false selects local time; true selects UTC. A separate system-clock snapshot; other calls can cross a day boundary. Contains neither hour nor dst.

public static Reckfell.Collections.Dictionary GetDateDictFromUnixTime(long unixTimeVal);

Converts integer Unix seconds to year/month/day/weekday without a local-timezone shift. Month is 1…12; weekday 0 is Sunday. Negative seconds allow pre-epoch dates. Not a full datetime or an OS-setting change.

public static string GetDateStringFromSystem(bool utc = false);

Returns current OS date as YYYY-MM-DD. utc selects local/UTC; the string contains no offset or zone name. Not a localized user-interface date format.

public static string GetDateStringFromUnixTime(long unixTimeVal);

Formats integer Unix seconds as YYYY-MM-DD without applying the local zone. Accepts no fractional part because the argument is long. Use ticks rather than calendar strings for elapsed intervals.

public static Reckfell.Collections.Dictionary GetDatetimeDictFromDatetimeString(string datetime, bool weekday);

Parses components in YYYY-MM-DDTHH:MM:SS form, space instead of T, date-only or time-only. Missing parts use epoch defaults. C# requires weekday explicitly; true adds computed weekday. Not a validator: in 1.0.0 this method does not validate calendar/clock ranges and can return invalid fields. Validate before calling, especially with weekday=true; invalid months with weekday computation were not executed. Offset/Z suffixes and fractions are not full ISO support.

public static Reckfell.Collections.Dictionary GetDatetimeDictFromSystem(bool utc = false);

Reads current OS year, month, day, weekday, hour, minute, second and dst. The flag selects UTC; utc=false is local. dst describes the current OS snapshot rather than a historical arbitrary date. System clocks can change, so do not use this for elapsed timing.

public static Reckfell.Collections.Dictionary GetDatetimeDictFromUnixTime(long unixTimeVal);

Converts integer epoch seconds to seven fields: year/month/day/weekday/hour/minute/second. Adds no dst, offset or milliseconds and applies no local-zone settings. Tested negative and post-2038 timestamps; extreme int64 dates were not accepted.

public static string GetDatetimeStringFromDatetimeDict(Reckfell.Collections.Dictionary datetime, bool useSpace);

Formats a nonempty Dictionary as YYYY-MM-DDTHH:MM:SS or with a space. Missing year/month/day/hour/minute/second use epoch defaults; extra weekday/dst/bias do not convert zones. Checks date/time ranges, but failure produces an empty string with diagnostics rather than an Error. Invalid-field validation was source-reviewed only.

public static string GetDatetimeStringFromSystem(bool utc = false, bool useSpace = false);

Formats current OS datetime with fields through integer seconds. utc selects the zone and useSpace only the separator. Contains no Z/offset and describes no clock monotonicity. Multiple calls are not one atomic snapshot.

public static string GetDatetimeStringFromUnixTime(long unixTimeVal, bool useSpace = false);

Formats integer Unix seconds without a local shift. useSpace changes T to a space rather than the timezone. Includes no offset/Z or fractional seconds; do not append an arbitrary offset without a separate correct conversion.

public static string GetOffsetStringFromOffsetMinutes(long offsetMinutes);

Formats signed minutes as ±HH:MM: 330 → +05:30 and −210 → −03:30. Converts no timestamp, selects no DST and validates no timezone existence. Do not pass Unix seconds instead of minutes.

public static ulong GetTicksMsec();

Monotonic millisecond counter for the current runtime. Useful for differences between readings; not a date or epoch. Current backend truncates microseconds/1000. Do not persist as portable time across runs or assume 1 ms scheduler precision.

public static ulong GetTicksUsec();

Monotonic microsecond counter since this runtime started. Use (now−start)/1_000_000.0 for elapsed seconds. The unit does not guarantee physical 1 µs precision. Not UTC, Engine.TimeScale-adjusted game time or a shared timestamp across processes.

public static Reckfell.Collections.Dictionary GetTimeDictFromSystem(bool utc = false);

Returns current OS hour/minute/second. utc=false is local and true is UTC. Contains no date/offset: equal values can occur on different days; not a unique event timestamp.

public static Reckfell.Collections.Dictionary GetTimeDictFromUnixTime(long unixTimeVal);

Returns hour/minute/second within the day from an integer epoch timestamp without a timezone shift. −1 yields 23:59:59 rather than negative components. The result contains no date.

public static string GetTimeStringFromSystem(bool utc = false);

Formats current OS time as HH:MM:SS in the selected local/UTC zone. Includes no date, fractions or offset. Not for precise elapsed-duration measurement.

public static string GetTimeStringFromUnixTime(long unixTimeVal);

Formats the day-time portion of integer Unix seconds as HH:MM:SS. Applies no local zone and retains no day information. A time-of-day representation rather than a duration string.

public static Reckfell.Collections.Dictionary GetTimeZoneFromSystem();

Reads current OS bias and name. bias is signed UTC-offset minutes; name is an OS name rather than a guaranteed IANA ID. Windows includes the current standard/DST adjustment. Not a historical timezone database or arbitrary-date DST conversion API. QA changed no zone and checked the result schema.

public static long GetUnixTimeFromDatetimeDict(Reckfell.Collections.Dictionary datetime);

Converts a nonempty Dictionary to integer epoch seconds. Missing main fields use epoch defaults; weekday/dst/bias are ignored as conversion inputs. Local time is not automatically converted to UTC. Invalid ranges/empty Dictionary return 0 with native diagnostics; 0 is also the valid epoch, so this is not TryParse.

public static long GetUnixTimeFromDatetimeString(string datetime);

Parses supported components into integer seconds. Not a strict ISO/RFC3339 parser: +03:00 does not subtract three hours, fractions are not preserved, and an empty string yielded 0. Date-only means midnight; time-only uses 1970-01-01. Validate structure/ranges and handle timezone separately. Error branches return −1 or 0 with diagnostics; both numbers are also valid timestamps.

public static double GetUnixTimeFromSystem();

Current UTC epoch seconds from the system clock as double, possibly fractional. Not milliseconds. User/OS clock changes mean differences are not monotonic measurements. Use ticks for elapsed duration and explicitly choose UTC/local for display. Windows read-only behavior was tested without changing the clock.