oliverbooth/X10D
oliverbooth/X10D
1
0
Fork 0
mirror of https://github.com/oliverbooth/X10D synced 2024-11-10 02:45:41 +00:00
Code Issues

🛠 Various code cleanup

Browse Source 
* Remove obsolete methods
* Fix implementation of DateTime.Last
* Reword XMLDoc for DateTime.Age
* Add overload for DateTime.Age to support "as of" parameter
This commit is contained in:
Oliver Booth 2020-04-18 14:36:44 +01:00
parent 11bc2415fc
commit a2f113237d
No known key found for this signature in database
GPG Key ID: 0D7F2EF1C8D2B9C0
1 changed files with 26 additions and 41 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

67
X10D/src/DateTimeExtensions.cs
View File

@ -8,20 +8,32 @@
public static class DateTimeExtensions public static class DateTimeExtensions
{ {
/// <summary> /// <summary>
/// Calculates someone's age based on a date of birth. /// Returns a rounded integer of the number of years since a given date as of today.
/// </summary> /// </summary>
/// <param name="dateOfBirth">The date of birth.</param> /// <param name="date">The date from which to start.</param>
public static int Age(this DateTime dateOfBirth) /// <returns>Returns the number of years since <paramref name="date"/> as of today.</returns>
public static int Age(this DateTime date)
{ {
return (int) (((DateTime.Today - TimeSpan.FromDays(1) - dateOfBirth.Date).TotalDays + 1) / 365.2425); return date.Age(DateTime.Today);
} }
/// <summary> /// <summary>
/// Gets a DateTime representing the first specified day in the current month /// Returns a rounded integer of the number of years since a given date as of another given date.
/// </summary>
/// <param name="date">The date from which to start.</param>
/// <param name="asOf">The date at which to stop counting.</param>
/// <returns>Returns the number of years since <paramref name="date"/> as of <paramref name="asOf"/>.</returns>
public static int Age(this DateTime date, DateTime asOf)
{
return (int)(((asOf.Date - TimeSpan.FromDays(1) - date.Date).TotalDays + 1) / 365.2425);
}
/// <summary>
/// Gets a DateTime representing the first occurence of a specified day in the current month.
/// </summary> /// </summary>
/// <param name="current">The current day</param> /// <param name="current">The current day</param>
/// <param name="dayOfWeek">The current day of week</param> /// <param name="dayOfWeek">The current day of week</param>
/// <returns></returns> /// <returns>Returns a date which representing the first occurence of <paramref name="dayOfWeek"/>.</returns>
public static DateTime First(this DateTime current, DayOfWeek dayOfWeek) public static DateTime First(this DateTime current, DayOfWeek dayOfWeek)
{ {
DateTime first = current.FirstDayOfMonth(); DateTime first = current.FirstDayOfMonth();
@ -49,10 +61,8 @@
/// <param name="current">The current date.</param> /// <param name="current">The current date.</param>
public static DateTime LastDayOfMonth(this DateTime current) public static DateTime LastDayOfMonth(this DateTime current)
{ {
int daysInMonth = DateTime.DaysInMonth(current.Year, current.Month); var daysInMonth = DateTime.DaysInMonth(current.Year, current.Month);
return new DateTime(current.Year, current.Month, daysInMonth);
DateTime last = current.FirstDayOfMonth().AddDays(daysInMonth - 1);
return last;
} }
/// <summary> /// <summary>
@ -62,24 +72,13 @@
/// <param name="dayOfWeek">The current day of week.</param> /// <param name="dayOfWeek">The current day of week.</param>
public static DateTime Last(this DateTime current, DayOfWeek dayOfWeek) public static DateTime Last(this DateTime current, DayOfWeek dayOfWeek)
{ {
DateTime last = current.LastDayOfMonth(); DateTime last = current.LastDayOfMonth();
DayOfWeek lastDayOfWeek = last.DayOfWeek; DayOfWeek lastDayOfWeek = last.DayOfWeek;
int diff = -Math.Abs(dayOfWeek - lastDayOfWeek); var diff = dayOfWeek - lastDayOfWeek;
return last.AddDays(diff); var offset = diff > 0 ? diff - 7 : diff;
}
/// <summary> return last.AddDays(offset);
/// Gets a <see cref="DateTime"/> representing midnight on the current date.
/// </summary>
/// <param name="current">The current date.</param>
[Obsolete(
"This method has been deprecated in favor of Humanizer's fluent DateTime API. " +
"Please consider downloading the Humanizer package for more stable implementations of this method."
)]
public static DateTime Midnight(this DateTime current)
{
return new DateTime(current.Year, current.Month, current.Day, 0, 0, 0);
} }
/// <summary> /// <summary>
@ -90,28 +89,14 @@
/// <param name="dayOfWeek">The day of week for the next date to get.</param> /// <param name="dayOfWeek">The day of week for the next date to get.</param>
public static DateTime Next(this DateTime current, DayOfWeek dayOfWeek) public static DateTime Next(this DateTime current, DayOfWeek dayOfWeek)
{ {
int offsetDays = dayOfWeek - current.DayOfWeek; var offsetDays = dayOfWeek - current.DayOfWeek;
if (offsetDays <= 0) if (offsetDays <= 0)
{ {
offsetDays += 7; offsetDays += 7;
} }
DateTime result = current.AddDays(offsetDays); return current.AddDays(offsetDays);
return result;
}
/// <summary>
/// Gets a <see cref="DateTime"/> representing noon on the current date.
/// </summary>
/// <param name="current">The current date.</param>
[Obsolete(
"This method has been deprecated in favor of Humanizer's fluent DateTime API. " +
"Please consider downloading the Humanizer package for more stable implementations of this method."
)]
public static DateTime Noon(this DateTime current)
{
return new DateTime(current.Year, current.Month, current.Day, 12, 0, 0);
} }
/// <summary> /// <summary>