DateTimeExtensions Class
Definition
Namespace: DataStandardizer.Chronology
Extension methods that convert a DateTime to the system-time types UnixTime and DosDateTime, and that place a local wall clock time in a TzDataTimezone.
public static class DateTimeExtensions
Remarks
ToUnixTime treats a DateTime of kind Utc or Unspecified as UTC, and rejects one of kind Local; ToDosDateTime treats it as local time and packs the year, month, day, hour, minute, and second into the DOS format.
Placing a local time in a time zone
ToDateTimeOffset treats the DateTime as a time on the local clock of the time zone. It returns a DateTimeOffset that keeps that time, with the offset in effect at the instant the clock shows it. The result’s UtcDateTime gives the instant.
- The
DateTimemust be of kindUnspecified. The method appears on everyDateTime, but one of kindUtcorLocalthrowsArgumentException. - Unlike
DateTime.ToUniversalTime(), which uses the machine’s time zone,ToDateTimeOffsetuses the rules of the time zone passed to it. - A TzDataLocalTimeResolution decides what happens when the time falls in a gap, which the clock skips, or an overlap, which the clock shows twice:
Rfc5545follows RFC 5545, section 3.3.5. A time in a gap takes the offset in effect before the gap, which moves it forward by the length of the gap. A time in an overlap takes its first occurrence.StrictthrowsArgumentExceptionin either case.
DateTimeOffsetholds offsets only in whole minutes of at most 14 hours. An offset it can’t hold, such as some local mean time offsets before about 1900, throwsArgumentOutOfRangeException.default(TzDataTimezone)isEtc/UTC, so the result has an offset of 0.
For example, in America/New_York:
| Local time | Result with Rfc5545 | UTC |
|---|---|---|
| 2026-07-01 12:00 | 2026-07-01 12:00 -04:00 | 16:00 |
| 2026-03-08 02:30 (gap) | 2026-03-08 03:30 -04:00 | 07:30 |
| 2026-11-01 01:30 (overlap) | 2026-11-01 01:30 -04:00 | 05:30 |
To list every offset in effect at a local time instead, use TzDataExtensions.GetOffsetInfosForLocal.
Methods
Extension
| Method | Extends | Returns | Notes |
|---|---|---|---|
ToDateTimeOffset(TzDataTimezone timezone, TzDataLocalTimeResolution resolution) | DateTime | DateTimeOffset | DateTime must be of kind Unspecified, and is a time on the local clock of timezone. Throws ArgumentException for any other kind, and when resolution is Strict and the time falls in a gap or an overlap. Throws ArgumentOutOfRangeException when resolution is not defined, when the offset in effect can’t be held by a DateTimeOffset, and when the instant the time is placed at, or the result, falls outside the range of DateTime. |
ToDosDateTime() | DateTime | DosDateTime | DateTime assumed to be local time. |
ToUnixTime() | DateTime | UnixTime | A DateTime of kind Utc or Unspecified is read as UTC. Throws ArgumentException for kind Local; call ToUniversalTime() on it first. |
Applies to
Targets netstandard1.0, netstandard2.0, and net10.0.