Day Structure |
A time-zone-independent representation of a YYYY-MM-DD date.
Inheritance HierarchyNamespace: DegreeDays.Time
Assembly: DegreeDays (in DegreeDays.dll) Version: 1.4
SyntaxThe Day type exposes the following members.
Constructors| Name | Description | |
|---|---|---|
 | Day | Constructs a Day representing a date with the specified year, month, and day. |
Properties| Name | Description | |
|---|---|---|
 | DayOfMonth | Gets the number between 1 and 31 (inclusive) indicating the day-of-the-month component of this Day. |
| DayOfWeek | Gets the day of the week of this Day. |
| DayOfYear | Gets the number between 1 and 366 inclusive (365 for non-leap years) indicating the day of the year of this Day. |
| MonthOfYear | Gets the number between 1 (January) and 12 (December) indicating the month-of-the-year component of this Day. |
| Year | Gets the number indicating the year component of this Day. |
Methods| Name | Description | |
|---|---|---|
| After | Returns true if this Day is chronologically after the specified comparison Day; false otherwise. |
| AsRange | Returns a DayRange covering this Day only. |
| Before | Returns true if this Day is chronologically before the specified comparison Day; false otherwise. |
| CompareTo | Compares two Day instances for chronological ordering. |
| DaysAfter | Returns the number of days that this Day is after the specified comparison Day, which will be negative if this Day comes first chronologically. |
| DaysBefore | Returns the number of days that this Day is before the specified comparison Day, which will be negative if comparisonDay comes first chronologically. |
| Equals(Day) | Returns true if other represents the same date as this Day; false otherwise. |
| Equals(Object) |
Returns true if obj is a Day that represents the
same date as this Day; false otherwise.
(Overrides ValueTypeEquals(Object)) |
 | FromDateTime | Returns the Day represented by the specified DateTime. |
| FromString | Parses a string date in ISO YYYY-MM-DD format (the format used by XML schema's date type), or YYYYMMDD format. |
| GetHashCode |
Overridden to ensure consistency with Equals.
(Overrides ValueTypeGetHashCode) |
| MinusDays | Returns the Day that comes the specified numberOfDays before this Day in the calendar. |
| MinusMonths | Returns the Day that comes the specified numberOfMonths before this Day in the calendar. |
| MinusWeeks | Returns the Day that comes the specified numberOfWeeks before this Day in the calendar. |
| MinusYears | Returns the Day that comes the specified numberOfYears before this Day in the calendar. |
| Next | Returns the Day that comes immediately after this Day in the calendar. Will happily cross the borders between months and years. |
| PlusDays | Returns the Day that comes the specified numberOfDays after this Day in the calendar. |
| PlusMonths | Returns the Day that comes the specified numberOfMonths after this Day in the calendar. |
| PlusWeeks | Returns the Day that comes the specified numberOfWeeks after this Day in the calendar. |
| PlusYears | Returns the Day that comes the specified numberOfYears after this Day in the calendar. |
| Previous | Returns the Day that comes immediately before this Day in the calendar. Will happily cross the borders between months and years. |
| To(Day) | Returns the DayRange covering (inclusively) the days between this Day and firstOrLastDayInRange (which can be before, after, or equal to this Day). |
| To(Int32, Int32, Int32) | Returns the DayRange covering (inclusively) the days between this Day and the Day represented by the specified parameters (which can be before, after, or equal to this Day). |
| TodayInSystemTimeZone | Returns the Day representing the current date in the system time-zone. |
| TodayInUtc | Returns the Day representing the current date in the UTC time-zone. |
| ToNumericString | Returns a non-null, non-empty string representation of this Day in YYYYMMDD format. |
| ToString |
Returns a non-null, non-empty string representation of this
Day in YYYY-MM-DD format.
(Overrides ValueTypeToString) |
| TryFromString | Tries to parse a string date in ISO YYYY-MM-DD format (the format used by XML schema's date type), or YYYYMMDD format. Returns true if it succeeds. |
Operators| Name | Description | |
|---|---|---|
 | Equality(Day, Day) | Determines whether two specified Day instances are equal. |
| GreaterThan(Day, Day) | Determines whether one specified Day is later than another specified Day. |
| GreaterThanOrEqual(Day, Day) | Determines whether one specified Day is the same as or later than another specified Day. |
| Inequality(Day, Day) | Determines whether two specified Day instances are not equal. |
| LessThan(Day, Day) | Determines whether one specified Day is earlier than another specified Day. |
| LessThanOrEqual(Day, Day) | Determines whether one specified Day is the same as or earlier than another specified Day. |
RemarksInternally this class uses the modern Gregorian calendar for all validation and calculations. The Gregorian calendar was introduced in 1582 but this class applies it to earlier dates as well (so using what is known as the "proleptic Gregorian calendar"). This fits with the ISO 8601 standard and is how System.DateTime package works by default, but not all software systems work this way by default, so bear this in mind if you are working with dates from 1582 or before. You are of course unlikely to find good weather data from that far back, but we mention this just in case you find yourself using this class for other purposes as well!
Thread Safety
Instances of this struct are immutable and safe for use from multiple threads at once.
See Also